> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-1/ap/ap-android.md). # AP 미디에이션(Android) ### 미디에이션이란? * 다양한 타 광고(NAM, AdFit, AdMob 등) 업체를 미리 연동해 둔 Mediation SDK를 활용하여 별다른 설정 없이 손쉽게 이용하실 수 있어 수익 극대화에 효과적인 기능입니다. * 저희 AdPopcornSSP에 각 업체별 Mediation을 설치하시면 각 업체별로 광고 load를 진행하지 않고 AdPopcornSSP load 만으로도 다양한 업체의 광고를 제공받으실 수 있습니다. {% hint style="warning" %} 애드팝콘 SSP 미디에이션 연동하기 전에 반드시 애드팝콘 SSP 연동이 진행 되어야 합니다. [\[애드팝콘 SSP : 안드로이드\]](https://www.notion.so/SSP-SDK-Android-Java-770727e8ff0b40b3a000c26a64f5deee?pvs=21) * 애드팝콘 SSP 미디에이션 연동 시 애드팝콘 최신 SSP 버전(**3.10.9**)과 각 업체별 호환 버전을 반드시 확인 후 연동을 진행 부탁 드립니다. * [각 업체별 호환 버전](#id-2.-sdk)은 아래 가이드 바로가기 링크에 기재되어 있으니 확인 부탁 드립니다. * Unity 환경의 경우 각 업체의 UnityPlugin은 사용할 필요 없이 아래 기재되어 있는 버전을 사용하시면 됩니다. {% endhint %} ## 1. 지원 중인 업체 목록
광고 업체배너네이티브전면전면비디오리워드비디오비디오믹스
NAMOOXXXX
AdFitOOXXXX
AppLovinOXOOOO
AppLovinMaxOOOOOO
UnityAdsOXOOOO
VungleOOXOOO
FaceBookOOOOOO
AdMob, AdForus, ADOPOOOOOO
GAMOOOOOO
FyberOOXOOO
MezzoMediaOXXXXX
CaulyOXOXXO
MintegralOOXOOX
PangleOOXOOO
MobwithOOOXXO
CoupangAdsOOOXXX
InMobiOOOOOO
MaioXXXOOO
MolocoOOOOOX
## 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 // 3.5.33 이하 버전 사용 시 /*maven { name = "GitHubPackages" url = uri("https://maven.pkg.github.com/cauly/Android-SDK/SDK") credentials { username = 'cauly' password = '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' } }*/ // 3.5.34 이상 사용 시 // Cauly SDK Repository Public Access Info maven { url 'https://cauly.github.io/cauly-sdk-android-maven/maven-repo' } // 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" } // Maio maven{ url "https://imobile-maio.github.io/maven" } } } ``` ### 2.2 Build.gradle (App Level)
광고 업체build.gradle(app level)링크
NAM
api platform('com.naver.gfpsdk:nam-bom:8.17.0')
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.22.2'
Link
AppLovin
api 'com.applovin:applovin-sdk:13.6.3'
Link
AppLovinMax
api 'com.applovin:applovin-sdk:13.6.3'
Link
UnityAds
api 'com.unity3d.ads:unity-ads:4.18.1'
Link
Vungle
api 'com.vungle:vungle-ads:7.7.5'
Link
FaceBook
api 'androidx.annotation:annotation:1.4.0'
api 'com.facebook.android:audience-network-sdk:6.21.0'
Link
AdMob, AdForus, ADOP
api 'com.google.android.gms:play-services-ads:25.4.0'
Link
GAM
api 'com.google.android.gms:play-services-ads:25.4.0'
Link
Fyber
api "com.fyber:marketplace-sdk:8.4.6"
Link
MezzoMedia
api 'androidx.appcompat:appcompat:1.2.0' api 'io.github.mezzo-platform:mezzo-sdk:3.1.1'
Link
Cauly
api 'com.google.android.gms:play-services-appset:16.0.0'
api 'com.fsn.cauly:cauly-sdk:3.5.41'
Link
Mintegral
api 'com.mbridge.msdk.oversea:mbridge\_android\_sdk:17.0.31'
Link
Pangle
api 'com.pangle.global:pag-sdk:8.1.0.3'
Link
MobWith
api 'io.github.mobon:mobwithSDK:1.0.84'
Link
CoupangAds
api "com.coupang:ads:1.3.0"
Link
InMobi
api 'com.inmobi.monetization:inmobi-ads-kotlin:11.1.1'
api 'com.google.android.gms:play-services-ads-identifier:18.0.1'
api 'androidx.browser:browser:1.8.0'
api 'com.squareup.picasso:picasso:2.8'
api "com.squareup.okhttp3:okhttp:3.14.9"
api "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.1"
api "androidx.core:core-ktx:1.5.0"
api "org.jetbrains.kotlin:kotlin-stdlib:2.1.21"
api "com.squareup.okio:okio:3.7.0"
api "androidx.media3:media3-exoplayer:1.4.1"
Link
Maio
api 'com.maio:android-sdk-v2:2.0.8\@aar'
Link
Moloco

api 'com.moloco.sdk:moloco-sdk:4.7.0'
## 3. 적용 방법 1. **사용하고자 하는 미디에이션 업체의 SDK를 위 리스트의 가이드 링크에서 확인 하신 뒤 build.gradle 혹은 직접 다운로드 하여 포함시켜 주시기 바랍니다.** 2. 각 업체 별 proguard 설정이 필요한 경우, 가이드 링크에서 확인 하신 뒤 반드시 설정해 주시기 바랍니다. 3. 위 리스트에 적힌 호환 버전 이외의 버전을 사용하고자 하는 경우 반드시 애드팝콘 SSP 사업팀 () 문의 후 사용하시기 바랍니다. 4. 일부 업체의 광고 타입의 경우 앱의 activity life cycle에 따라 추가 연동이 필요할 수 있습니다. 이 부분도 아래 추가 연동 부분을 참고하여 연동해 주시기 바랍니다. ## 4. 애드팝콘 SSP 주요 버전 별 변경 사항 ### AdPopcornSSP v3.10.8 * AdFit v3.22.2 * AdMob v25.4.0 * AppLovin v13.6.3 * Vungle v7.7.5 * Fyber v8.4.6 * MobWith v1.0.84 (반드시 해당 버전 사용 필요) * NAM v8.17.0 * Pangle v8.1.0.3 ### AdPopcornSSP v3.10.3 * Moloco v4.7.0 (신규 추가) * UnityAds v4.18.1 ### AdPopcornSSP v3.10.2 * AppLovin v13.6.2 * Pangle v7.9.1.3 * Vungle v7.7.2 * UnityAds v4.17.0 ### AdPopcornSSP v3.10.0 * InMobi v11.1.1 (신규 추가) * Maio v2.0.8 (신규 추가) ### AdPopcornSSP v3.9.4 * UnityAds v4.16.5 ### AdPopcornSSP v3.9.3 * AdFit v3.21.10 * NAM v8.10.3 * ADMOB, GAM, v24.8.0 * UnityAds 4.16.4 * Mintegral v17.0.31 * Cauly v3.5.41 * Mobwith v1.0.67 * AppLovin v13.5.1 * Vungle v7.6.1 * Pangle v7.8.0.7 * Fyber v8.4.1 * FAN v6.21.0 ### AdPopcornSSP v3.8.8 * Pangle v7.5.0.2 * UnityAds v4.16.1 * Vungle v7.5.1 ### AdPopcornSSP v3.8.7 * NAM v8.8.0 * AppLovin v13.4.0 ### AdPopcornSSP v3.8.4 * NAM v8.6.1 * Cauly v3.5.39 * gradle 저장소 설정이 변경되었습니다. 자세한 설정은 [가이드](https://adpopcornssp.gitbook.io/ssp-sdk/android/android/cauly)를 확인해 주세요. * UnityAds v4.16.0 * AppLovin v13.3.1 * LiftOff(Vungle) v7.5.0 * Pangle v7.3.0.4 * MezzoMediai v3.1.1 * AAR 파일로 제공되는 형태에서 gradle 형태로 제공 방식이 변경 되었습니다. [가이드](https://adpopcornssp.gitbook.io/ssp-sdk/android/android/mezzomedia)를 확인해 주세요. * Fyber v8.3.7 * Admob, GAM v24.5.0 * MobWith v1.0.58 * FAN(Meta) v6.20.0 ### AdPopcornSSP v3.8.3 * MobWith v1.0.55 * NAM v8.5.1 ### 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에서 아래 내용이 제거되어야 합니다. ```xml ``` ## 5. 애드팝콘 SSP 버전별 주요 호환 정보
SDK 버전호환성
AdPopcornSSP v3.10.0
  • Inmobi v11.1.1
  • Maio v.2.0.8
AdPopcornSSP v3.9.4
  • UnityAds v4.16.5
AdPopcornSSP v3.9.3
  • AdFit v3.21.10
  • NAM v8.10.3
  • ADMOB, GAM, v24.8.0
  • UnityAds 4.16.4
  • Mintegral v17.0.31
  • Cauly v3.5.41
  • Mobwith v1.0.67
  • AppLovin v13.5.1
  • Vungle v7.6.1
  • Pangle v7.8.0.7
  • Fyber v8.4.1
  • FAN v6.21.0
AdPopcornSSP v3.8.8
  • Pangle v7.5.0.2
  • UnityAds v4.16.1
  • Vungle v7.5.1
AdPopcornSSP v3.8.7
  • NAM v8.8.0
  • AppLovin v13.4.0
AdPopcornSSP v3.8.4
  • NAM v8.6.1
  • Cauly v3.5.39
  • UnityAds v4.16.0
  • AppLovin v13.3.1
  • LiftOff(Vungle) v7.5.0
  • Pangle v7.3.0.4
  • MezzoMediai v3.1.1
  • Fyber v8.3.7
  • Admob, GAM v24.5.0
  • MobWith v1.0.58
  • FAN(Meta) v6.20.0
AdPopcornSSP_v3.8.3
  • NAM v8.5.1
  • MobWith v1.0.55
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 대응