MAX 미디에이션(Beta, Unity AOS)

1. 문서 목적

• 본 문서는 매체사가 AdPopcornSSP SDK를 통해 AppLovin MAX 기반 광고 수익화 구조를 연동하는 방법을 안내합니다.

• 실제 미디에이션 네트워크 구성과 운영은 내부 운영팀이 관리하며, 매체사는 SDK 연동과 광고 호출 코드 적용만 진행하면 됩니다.

• 실제 네트워크 구성은 내부 운영 기준에 따라 설정됩니다.

단독연동을 사용하고자하는 경우, 애드팝콘 SSP 사업팀 ([e-mail])으로 연락부탁드립니다.

• Android 환경에서 미디에이션 기능을 사용하기 위해서는 build.gradle / AndroidManifest.xml 파일 내 추가 설정만 진행하면 됩니다.

다만, 일부 미디에이션의 경우 AGP 버전이 구버전일 경우, 빌드에 실패하므로, UnityTool 최신 버전을 사용해 주셔야 합니다.

2. 적용 네트워크

별도 예외 협의가 없는 경우, 아래 최대 범위 네트워크 기준으로 운영됩니다.

네트워크	리워드비디오	전면비디오	전면배너	네이티브	배너
AppLovin	O	O	O	O	O
AppLovin Exchange	O	O	O	O	O
BidMachine	O	O	O	O	O
Google Bidding	O	O	O	O	O
IronSource	O	O	O		O
Meta	O	O	O	O	O
Mintegral	O	O	O	O	O
Moloco	O	O	O	O	O
Unity	O	O	O		O
DT Exchange	O	O	O		O
Liftoff Monetize	O	O	O	O	O
Liftoff Monetize Native				O
Pangle	O	O	O	O	O
Pangle Native				O
Meta Native				O
InMobi	O	O	O	O	O
Google Ad Manager	O	O	O	O	O

3. Build.gradle(Project Level)

Pangle SDK를 사용하고자 하는 경우에는 아래 Pangle 부분을 추가해 주시면 됩니다.

3.1 Custom Gradle Settings Template 활성화 확인

Unity에서 프로젝트 레벨의 설정을 변경하려면 이 템플릿이 활성화되어 있어야 합니다.

• Unity 에디터 > Edit > Project Settings > Player > Android 탭 > Publishing Settings에서 **Custom Gradle Settings Template**가 체크되어 있는지 확인합니다.

3.2 settingsTemplate.gradle 파일 수정

프로젝트 레벨 설정 파일인 Assets/Plugins/Android/settingsTemplate.gradle 파일을 열고, allprojects { repositories { ... } } 블록 내에 Pangle/Bytedance 저장소 URL을 추가해야 합니다.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        **ARTIFACTORYREPOSITORY**
        google()
        mavenCentral()		
        // BidMachine
        maven { url "https://artifactory.bidmachine.io/bidmachine" }
        // Mintegral
        maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
        // Pangle
        maven { url "https://artifact.bytedance.com/repository/pangle" }
        flatDir {
            dirs "${project(':unityLibrary').projectDir}/libs"
        }
    }
}

4. Build.gradle(App Level)

아래 설정 중, Common 라이브러리와 사용 예정인 업체의 SDK만 탑재하면 됩니다.

4.1 Custom Base Gradle Template 활성화 확인

Unity에서 프로젝트 레벨의 설정을 변경하려면 이 템플릿이 활성화되어 있어야 합니다.

• Unity 에디터 > Edit > Project Settings > Player > Android 탭 > Publishing Settings에서 **Custom Main Gradle Template**가 체크되어 있는지 확인합니다.

4.2 mainTemplate.gradle 파일 수정

위 설정을 활성화하면, Unity는 프로젝트 내의 특정 폴더에 기본 템플릿 파일을 생성합니다.

• 생성된 파일 경로: Assets/Plugins/Android/mainTemplate.gradle

dependencies{
    // Common
    implementation 'com.igaworks.ssp:IgawAdPopcornSSP:3.10.0'
    api 'com.google.android.gms:play-services-ads-identifier:18.2.0'
    implementation 'com.applovin:applovin-sdk:13.5.1'
    
    // Mediation
    implementation 'com.applovin.mediation:bidmachine-adapter:+'
    implementation 'com.applovin.mediation:fyber-adapter:+'
    implementation 'com.applovin.mediation:google-ad-manager-adapter:+'
    implementation 'com.applovin.mediation:google-adapter:+'
    implementation 'com.applovin.mediation:ironsource-adapter:+'
    implementation 'com.applovin.mediation:vungle-adapter:+'
    implementation 'com.applovin.mediation:facebook-adapter:+'
    implementation 'com.applovin.mediation:mintegral-adapter:+'
    implementation 'com.applovin.mediation:moloco-adapter:+'
    implementation 'com.applovin.mediation:bytedance-adapter:+'
    implementation 'com.applovin.mediation:unityads-adapter:+'
    
    // Start Inmobi dependency 
    implementation 'com.applovin.mediation:inmobi-adapter:+'
    implementation 'com.squareup.picasso:picasso:2.8'
    implementation 'androidx.recyclerview:recyclerview:1.1.0'
    // End Inmobi dependency    
}

5. AndroidManifest.xml

AdMob SDK를 사용하는 경우에는 아래의 설정을 추가해 줍니다.

입력해야 되는 키 값에 대해서는 사업팀([e-mail])에 문의해 주세요

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>