미디에이션 네트워크 준비

모바일 자산에 서드파티 SDK를 연동할 때, 해당 연동에 대한 책임은 전적으로 귀하에게 있습니다. 귀하와 서드파티 SDK 제공업체는 사용자 기준 또는 기기 기준의 개인정보 보호 선택 사항이나 플래그를 준수하여 데이터를 처리하고 다루어야 합니다.

    Android

    두 가지 방법으로 MAX mediation adapter를 다운로드하고 앱에 연동할 수 있습니다.

    Gradle
    AppLovin은 이 방식으로 adapter를 연동할 것을 권장합니다. AppLovin adapter의 POM 파일은 mediated network의 SDK 및 그 종속성을 자동으로 연동합니다.
    오픈 소스 어댑터
    연동 시 더 많은 유연성이 필요한 경우, AppLovin의 오픈 소스 adapter를 연동할 수 있습니다. 이 경우 mediated SDK 및 그 종속성을 연동할 책임은 귀하에게 있습니다. 이 adapter들은 AppLovn-MAX-SDK-Android GitHub 리포지토리에서 찾을 수 있습니다.

    adapter의 이름이나 패키지 이름을 변경하지 마십시오. 변경할 경우, MAX SDK가 adapter를 인식하지 못해 광고가 로드되지 않습니다.

    Gradle

    아래의 체크박스를 선택하여 연동하고자 하는 mediated ad networks를 선택하십시오. 체크박스를 선택하면, 이 페이지에 해당 network에 특화된 안내가 표시됩니다.

    또한 이 페이지는 귀하를 위한 맞춤형 UPL을 생성합니다. 아래의 맞춤형 UPL을 AppLovinMAX_UPL_Android.xml 파일에 복사하십시오.

  • BidMachine
  • BIGO Ads
  • Chartboost
  • DT Exchange
  • Google Ad Manager
  • Google Bidding and Google AdMob
  • HyprMX
  • InMobi
  • ironSource
  • Liftoff Monetize
  • LINE
  • Maio
  • Meta Audience Network
  • Mintegral
  • MobileFuse
  • Moloco
  • Ogury
  • Pangle
  • PubMatic
  • Smaato
  • Unity Ads
  • Verve
  • VK Ad Network
  • Yandex
  • YSO Network
  • <AARImports>
        <insertValue value="com.applovin.mediation,bidmachine-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,bigoads-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,chartboost-adapter,+" /> <insertNewline/>
        <insertValue value="com.google.android.gms,play-services-base,16.1.0" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,fyber-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,google-ad-manager-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,google-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,hyprmx-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,inmobi-adapter,+" /> <insertNewline/>
        <insertValue value="com.squareup.picasso,picasso,2.8" /> <insertNewline/>
        <insertValue value="androidx.recyclerview,recyclerview,1.1.0" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,ironsource-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,vungle-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,line-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,maio-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,facebook-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,mintegral-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,mobilefuse-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,moloco-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,ogury-presage-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,bytedance-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,pubmatic-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,smaato-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,unityads-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,verve-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,mytarget-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,yandex-adapter,+" /> <insertNewline/>
        <insertValue value="com.applovin.mediation,yso-network-adapter,+" /> <insertNewline/>
    
    </AARImports>
    
    <buildGradleAdditions>
        <insert>
            allprojects {
                // You may add any additional repositories for other ad networks here
                repositories {
                    maven { url "https://artifactory.bidmachine.io/bidmachine" }
                    maven { url "https://cboost.jfrog.io/artifactory/chartboost-ads/" }
                    maven { url "https://imobile-maio.github.io/maven" }
                    maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
                    maven { url "https://maven.ogury.co" }
                    maven { url "https://artifact.bytedance.com/repository/pangle" }
                    maven { url "https://repo.pubmatic.com/artifactory/public-repos" }
                    maven { url "https://s3.amazonaws.com/smaato-sdk-releases/" }
                    maven { url "https://verve.jfrog.io/artifactory/verve-gradle-release" }
                    maven { url "https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android" }
    
                }
            }
        </insert>
    </buildGradleAdditions>

    Google AdSense, AdManager 또는 AdMob을 사용하는 개발자 및 퍼블리셔는 Google이 인증한 동의 관리 플랫폼(CMP)을 사용해야 합니다. 유럽 경제 지역(EEA) 또는 영국의 사용자에게 광고를 게재할 때 CMP는 IAB의 Transparency and Consent Framework와 연동되어야 합니다. 자세한 내용은 개인정보 보호: “TCF v2 동의”를 참조하십시오.

    Google bidding 및 Google AdMob / Google Ad Manager 앱 ID 추가

    AppLovin MAX Unreal 플러그인의 AppLovinMAX_UPL_Android.xml에서 androidManifestUpdates 태그 아래에 Google bidding 및 Google AdMob 앱 ID를 추가합니다. 아래 예시에서 «your-admob-app-id» 부분을 귀하의 Google bidding 및 Google AdMob 앱 ID로 변경하십시오.

    <androidManifestUpdates>
    ⋮
        <addElements tag="application">
            <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="«your-admob-app-id»" />
        </addElements>
    ⋮
    </androidManifestUpdates>
    

    compileSdkVersion

    Google Mobile Ads SDK 버전 23.1.0 이상에서는 compileSdkVersion이 최소 34 이상이어야 합니다.

    Project Settings > Android SDK > SDK API Level에서 compileSdkVersionandroid-34 이상으로 설정하십시오.

    최신 compileSdkVersion 요구 사항은 Google Mobile Ads SDK 릴리스 노트를 참조하십시오.

    Gradle 에러

    Google AdMob은 Android Gradle 플러그인 버전 4.2.0 이상 및 Gradle 버전 6.7.1 이상을 요구합니다. 다음과 같은 에러가 발생하는 경우, Android Gradle 플러그인 및 Gradle 버전을 업데이트하십시오.

    AAPT: error: unexpected element <property> found in <manifest><application>.
    

    Android manifest 병합 에러

    일부 network SDK는 번들로 제공되는 Android Manifest 파일에 <queries> 요소를 포함하고 있습니다. 호환되지 않는 버전의 Android Gradle 플러그인을 사용하는 경우, 다음과 같은 빌드 에러 중 하나가 발생합니다:

    com.android.builder.internal.aapt.v2.Aapt2Exception: Android resource linking failed
    error: unexpected element <queries> found in <manifest>.
    

    이 에러를 해결하려면 Android Gradle 플러그인을 다음 버전 중 하나로 업그레이드하십시오. 이 버전들은 <queries> 요소를 지원합니다:

    Gradle Build Tools가 아닌 Android Gradle 플러그인을 업그레이드하십시오.

    현재 Android Gradle 플러그인 버전<queries> 요소를 지원하는 버전
    4.1.*전체
    4.0.*4.0.1+
    3.6.*3.6.4+
    3.5.*3.5.4+
    3.4.*3.4.3+
    3.3.*3.3.3+

    Android Gradle 플러그인을 업그레이드하려면 다음 단계를 따르십시오.

    1. 사용 중인 Unreal Engine 버전의 디렉토리로 이동합니다. 예를 들어, macOS에서 Unreal Engine 5.2의 기본 설치 경로는 /Users/Shared/Epic Games/UE_5.2/입니다.
    2. Engine/Source/Programs/UnrealBuildTool/Platform/Android/UEDeployAndroid.cs 파일에서 ANDROID_TOOLS_BUILD_GRADLE_VERSION 값을 업데이트합니다 («X.X.X» 부분을 적절한 버전 번호로 변경하십시오):
      private const string ANDROID_TOOLS_BUILD_GRADLE_VERSION = "com.android.tools.build:gradle:«X.X.X»";
      
    3. Engine/Build/Android/Java/gradle/build.gradle 파일에서 다음 라인을 업데이트합니다 («X.X.X» 부분을 적절한 버전 번호로 변경하십시오):
      classpath project.hasProperty('ANDROID_TOOLS_BUILD_GRADLE_VERSION') ? project.property('ANDROID_TOOLS_BUILD_GRADLE_VERSION') : 'com.android.tools.build:gradle:«X.X.X»'
      

    Meta Audience Network 데이터 처리 옵션

    제한적 데이터 사용(LDU) 모드를 활성화하지 않으려면 SetDataProcessingOptions()에 빈 문자열 배열을 전달하십시오.

    ⋮
    <gameActivityImportAdditions>
      ⋮
      import com.facebook.ads.AdSettings;
    </gameActivityImportAdditions>
    
    <gameActivityOnCreateAdditions>
      <insert>
        AdSettings.setDataProcessingOptions( new String[] {} );
      </insert>
    </gameActivityOnCreateAdditions>
    

    사용자에게 LDU를 활성화하고 사용자의 지리적 위치를 지정하려면 다음과 같은 형식으로 SetDataProcessingOptions()를 호출하십시오.

    <gameActivityOnCreateAdditions>
      <insert>
        AdSettings.setDataProcessingOptions( new String[] {"LDU"}, «country», «state» );
      </insert>
    </gameActivityOnCreateAdditions>
    

    캘리포니아주 사용자를 위한 Meta Audience Network 데이터 처리 옵션

    캘리포니아주에서 Meta Audience Network의 “제한적 데이터 사용” 플래그를 구현하는 방법을 알아보려면 Meta for Developers 문서를 읽어보십시오.

    난독화

    코드 난독화 또는 리소스 축소를 사용하는 경우, Pangle의 난독화 가이드라인을 따르십시오.

    어댑터 네트워크 정보

    Loading…

    iOS

    Unreal Engine에서는 iOS용 서드파티 프레임워크를 수동으로 연동해야 합니다. CocoaPods와 같은 종속성 관리자는 지원하지 않습니다. MAX Unreal GitHub 리포지토리에는 Podfile에서 종속성을 자동으로 설치하는 데 도움이 되는 Python 스크립트인 install_pods.py가 포함되어 있습니다. 이 스크립트는 AppLovin adapter 및 서드파티 종속성을 다운로드하고, 이를 연결하기 위한 빌드 설정으로 프로젝트를 구성합니다.

    이 스크립트는 특정 network의 서드파티 SDK를 자동으로 구성하지 못할 수 있습니다. 이 경우 수동으로 연동해야 합니다.

    요구 사항

    • Python 3.6+
    • CocoaPods

    최신 버전의 CocoaPods를 사용하고 있는지 확인하십시오. 다음 명령어를 실행하여 버전을 확인할 수 있습니다:

    pod --version
    

    CocoaPods를 업데이트하려면 다음 명령어 중 하나를 실행하십시오:

    brew upgrade cocoapods
    

    안내

    1. AppLovin의 MAX Unreal GitHub 리포지토리에서 install_pods.py를 다운로드합니다.
    2. 이 스크립트를 AppLovin MAX Unreal 플러그인의 Source/ThirdParty/IOS/ 디렉토리에 복사합니다.
    3. 연동하려는 adapter를 위해 해당 디렉토리에 Podfile을 생성합니다.
    4. install_pods.py를 실행하여 adapter 및 종속성을 다운로드합니다. 스크립트의 안내에 따라 설치를 완료하십시오.
    5. 미디에이션 네트워크 준비 (iOS)의 안내를 따르십시오. AppLovinMAX_UPL_IOS.xml에서 Info.plist에 필요한 변경 사항을 추가합니다.


search