미디에이션(Android)

디스플레이 광고지면에 타 광고네트워크의 광고를 라이브 할 수 있는 기능을 의미하며, 내부/자체 광고의 운영 및 여러 국내/해외의 외부 광고를 노출시킬 수 있어 수익 극대화에 효과적입니다.

미디에이션이란?

• 다양한 타 광고(NAM, AdFit, AdMob 등) 업체를 미리 연동해 둔 Mediation SDK를 활용하여 별다른 설정 없이 손쉽게 이용하실 수 있어 수익 극대화에 효과적인 기능입니다.

• 저희 AdPopcornSSP에 각 업체별 Mediation을 설치하시면 각 업체별로 광고 load를 진행하지 않고 AdPopcornSSP load 만으로도 다양한 업체의 광고를 제공받으실 수 있습니다.

애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [애드팝콘 SSP : 안드로이드]

• 애드팝콘 SSP 미디에이션 연동 시 애드팝콘 최신 SSP 버전(3.8.2)과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다.

• 각 업체별 호환 버전은 아래 가이드 바로가기 링크에 기재되어 있으니 확인 부탁 드립니다.

• Unity 환경의 경우 각 업체의 UnityPlugin은 사용할 필요 없이 아래 기재되어 있는 버전을 사용하시면 됩니다.

1. 지원 중인 업체 목록

광고 업체	Banner	Native	Interstitial	InterstitialVideo	RewardVideo
NAM	O	O	X	X	X
AdFit	O	O	X	X	X
AppLovin	O	X	O	O	O
AppLovinMax	O	O	O	O	O
UnityAds	O	X	O	O	O
Vungle	O	O	X	O	O
FaceBook	O	O	O	O	O
AdMob	O	O	O	O	O
GAM	O	O	O	O	O
Fyber	X	X	X	O (AdPopcornSDK v3.8.1 부터 지원)	O
MezzoMedia	O	X	X	X	X
Cauly	O	X	O	X	X
Mintegral	O	O	X	O	O
Pangle	O	O	X	O	O
Mobwith	O	O	O	X	X
CoupangAds	O	O	O	X	X

2. 설치 방법

각 미디에이션 업체의 SDK는 Gradle을 활용한 설치를 지원합니다. 아래 설정을 참고해 주세요

2.1 Build.gradle (Project Level)

allprojects {
    repositories {
        // common
        google()
        mavenCentral()
        maven{
            url "https://maven.google.com"
        }

        // AdFit
        maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }

        // Pangle
        maven {
            url 'https://artifact.bytedance.com/repository/pangle'
        }

        // Cauly
        maven {
            name = "GitHubPackages"
            url = uri("https://maven.pkg.github.com/cauly/Android-SDK/SDK")
            credentials {
                username = 'cauly'
                password = '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'
            }
        }

        // Coupang
        maven {
            url "https://raw.githubusercontent.com/coupang-ads-sdk/android/main"
        }
				
	// Mintegral
        maven {
            url  "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
        }
    }
}

2.2 Build.gradle (App Level)

광고 업체	build.gradle(app level)	링크
NAM	api platform('com.naver.gfpsdk:nam-bom:8.4.2') api 'com.naver.gfpsdk:nam-core' // NAM 7.x.x 버전에는 아래 sdk 포함 필요 api 'com.naver.gfpsdk:nam-nda' // NAM 8.x.x 버전에서는 아래 sdk 포함 필요. api 'com.naver.gfpsdk.mediation:nam-nda'	Link
AdFit	api 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.4.10' api 'com.kakao.adfit:ads-base:3.17.2'	Link
AppLovin	api 'com.applovin:applovin-sdk:13.1.0'	Link
AppLovinMax	api 'com.applovin:applovin-sdk:13.1.0'	Link
UnityAds	api 'com.unity3d.ads:unity-ads:4.14.1'	Link
Vungle	api 'com.vungle:vungle-ads:7.4.3'	Link
FaceBook	api 'androidx.annotation:annotation:1.4.0' api 'com.facebook.android:audience-network-sdk:6.19.0'	Link
AdMob	api 'com.google.android.gms:play-services-ads:24.1.0'	Link
GAM	api 'com.google.android.gms:play-services-ads:24.1.0'	Link
Fyber	api "com.fyber:marketplace-sdk:8.3.6"	Link
MezzoMedia	library 수동설치(다운로드 페이지)	Link
Cauly	api 'com.google.android.gms:play-services-appset:16.0.0' api 'com.fsn.cauly:cauly-sdk:3.5.35'	Link
Mintegral	api 'com.mbridge.msdk.oversea:mbridge_android_sdk:16.9.61'	Link
Pangle	api 'com.pangle.global:pag-sdk:7.1.0.4'	Link
MobWith	api 'io.github.mobon:mobwithSDK:1.0.50'	Link
CoupangAds	api "com.coupang:ads:1.3.0"	Link

3. 적용 방법

1. 사용하고자 하는 미디에이션 업체의 SDK를 위 리스트의 가이드 링크에서 확인 하신 뒤 build.gradle 혹은 직접 다운로드 하여 포함시켜 주시기 바랍니다.

2. 각 업체 별 proguard 설정이 필요한 경우, 가이드 링크에서 확인 하신 뒤 반드시 설정해 주시기 바랍니다.

3. 위 리스트에 적힌 호환 버전 이외의 버전을 사용하고자 하는 경우 반드시 애드팝콘 SSP 사업팀 ([e-mail]) 문의 후 사용하시기 바랍니다.

4. 일부 업체의 광고 타입의 경우 앱의 activity life cycle에 따라 추가 연동이 필요할 수 있습니다. 이 부분도 아래 추가 연동 부분을 참고하여 연동해 주시기 바랍니다.

4. 애드팝콘 SSP 주요 버전 별 변경 사항

AdPopcornSSP v3.8.1

• MobWith v1.0.50

• NAM v8.4.2

AdPopcornSSP v3.7.5

• AdMob, GAM v24.1.0

• AdFit v3.17.2

• Mintegral v16.9.5

  • 저장소 이름 변경

  com.mbridge.msdk.oversea:xxxxx -> com.mbridge.msdk.oversea:mbridge_android_sdk

• Fyber v8.3.6

• NAM v8.3.0

• Cauly v3.5.35

  • Cauly v3.5.35 버전 사용시에는 반드시 AdPopcornSSP v3.7.5 사용 필요

  • build.gradle 저장소 주소 변경

• MobWith v1.0.46

  • MobWith v1.0.46 버전 사용시에는 반드시 AdPopcornSSP v3.7.5 사용 필요

• Pangle v7.1.0.4

  • 저장소 이름 변경

  com.pangle.global:ads-sdk -> com.pangle.global:pag-sdk

• UnityAds v4.14.1

• AppLovin, AppLovinMaxDynamicBid v13.1.0

• MezzoMedia v300(250210 버전)

AdPopcornSSP v3.7.4

• targetSdkVersion 35 지원에 따른 일부 SDK 호환성 검증

  • Vungle(LiftOff) v7.4.3

  • FAN v6.19.0

  • Pangle v6.5.0.4

AdPopcornSSP v3.7.1

• Fyber 8.3.5

• NAM 8.2.5

  • NAM 8.x.x 버전부터 일부gradle 주소가 변경되었으니, 변경 필요

  • NAM 8.x.x 버전 사용 시에는, 반드시 AdPopcornSSP v3.7.1 이상 사용 필요

AdPopcornSSP v3.7.0

• FacebookAudienceNetwork(FAN) v6.17.0

  • Banner, Native 인앱 비딩 지원

AdPopcornSSP v3.6.8

• AppLovin 13.0.1

  • 애드팝콘 v3.6.8 버전에는 반드시 앱러빈 13.0.1 버전을 사용해야 크래시 오류가 발생하지 않습니다.

• AdForus 미디에이션 업체 추가

AdPopcornSSP v3.6.2

• AppLovin 초기화 설정 제거

AppLovin SDK 초기화 방식 변경으로 인해 아래 AppLovinSDKKey 설정은 애드팝콘 v3.6.2 버전부터는 AndroidManifest에서 아래 내용이 제거되어야 합니다.

<meta-data android:name="applovin.sdk.key"
            android:value="YOUR_APPLOVIN_SDK_KEY"  />

5. 애드팝콘 SSP 버전별 주요 호환 정보

SDK 버전	호환성
AdPopcornSSP_v3.8.1	NAM v8.4.2 MobWith v1.0.50
AdPopcornSSP_v3.7.5	AdMob, GAM v24.1.0 AdFit v3.17.2 NAM v8.3.0 Cauly v3.5.35 UnityAds v4.14.1 AppLovin 13.1.0 Pangle v7.1.0.4 Mintegral 16.9.5 Fyber v8.3.6 MezzoMedia v300(20250210) MobWith v1.0.46
AdPopcornSSP_v3.7.4	FAN 6.19.0 Vungle(LiftOff) 7.4.3 Pangle 6.5.0.4
AdPopcornSSP_v3.7.1	Fyber 8.3.5 NAM 8.2.5
AdPopcornSSP_v3.7.0	Facebook Audience Network v6.17.0
AdPopcornSSP_v3.6.8	AppLovin 13.0.1 AdForus 23.3.0
AdPopcornSSP_v3.6.7	MezzoMedia v300(20241031)
AdPopcornSSP_v3.6.5	UnityAds 4.12.3 NAM 7.8.1
AdPopcornSSP_v3.6.3	AdMob 23.3.0 GAM 23.3.0 ADOP 23.3.0
AdPopcornSSP_v3.6.2	AdFit v3.16.0 Cauly v3.5.31 Mintegral v16.8.11 MezzoMedia v300(20240830) Vungle v7.4.1 Fyber v8.3.1 Pangle v 6.2.0.4 AppLovin v12.6.1 NAM v7.7.1 UnityAds v4.12.2 MobWith v1.0.30
AdPopcornSSP_v3.6.0	Mobon v1.0.0.65 MezzoMedia v300
AdPopcornSSP_v3.5.3	Coupang v1.3.0 Pangle v6.0.0.8 Mobon v1.0.0.64
AdPopcornSSP_v3.5.0	NAM 7.5.1 호환 검증 완료
AdPopcornSSP_v3.4.1	TapJoy 13.3.0 호환 검증 완료
AdPopcornSSP_v3.3.5	NAM v7.2.0
AdPopcornSSP_v3.3.4	Vungle 7.1.0 지원 UnityAds 4.9.2 지원 AdFit 3.15.2 지원
AdPopcornSSP_v3.3.2	AppLovin 12.1.0 지원 FAN 6.16.0 지원 Fyber 8.2.4 지원 Mintegral 16.5.81 지원 TapJoy 12.11.1 지원 UnityAds 4.7.0 지원 AdColony 4.8.0 지원 AdFit 3.13.6 지원 NAM 6.6.1 지원
AdPopcornSSP_v3.2.10	NAM 6.4.2 (v3.2.10 부터 지원) Cauly 3.5.26 Mintegral 16.5.31
AdPopcornSSP_v3.2.6	NAM 6.1.1
AdPopcornSSP_v3.1.9	Adfit 3.12.15 AdMob, GAM, ADOP 21.4.0 APPLOVIN MAX DYNAMIC BID 11.6.0 Pangle 5.0.0.7
AdPopcornSSP_v3.1.7	AppLovin 11.6.0 대응 Mintegral 16.3.11 대응 Cauly 3.5.24 대응 pangle 4.7.1.3 대응 NAM 네이티브 로드 실패 이벤트 전달 오류 수정
AdPopcornSSP_v3.1.3	AdMob, GAM 21.2.0 대응 NAM 4.4.0 대응
AdPopcornSSP_v3.1.2	Pangle SDK v4.6.0.9 대응
AdPopcornSSP_v3.0.18	Coupang v1.2.1 대응