Mediation 연동

Mediation는 ML 알고리즘으로 여러 네트워크에서 광고를 자동 선택해 수익을 극대화하는 플랫폼입니다. 설정은 모두 즉시 사용 가능하며, 네트워크마다 따로 디버깅할 필요가 없습니다.

이전에 Yandex Mobile Ads SDK를 Yandex 네트워크 하나만으로 사용했다면 Mediation으로 전환할 때 코드를 바꿀 필요가 없습니다. 외부 광고 네트워크 웹 인터페이스에서 유닛만 미리 구성하면 됩니다.

사전 준비

아래 절차에 따라 앱을 준비하세요.

앱 요구 사항

• Android Studio 2021 이상을 사용하세요.
• Android Gradle Plugin 8.7.0 이상을 사용하세요.
• 앱의 빌드 파일에 다음 값이 설정되어 있는지 확인하세요.
  • minSdkVersion 21 이상
  • compileSdkVersion 34 이상
• 모든 유형의 광고를 로드하려면 Android 4.1 이상이 필요합니다.
• 동영상 광고는 Android 5 이상인 기기에서만 선택됩니다.
• 앱에서 AppMetrica SDK를 사용하는 경우 7.2.1 이상(7 메이저 버전 범위 내)이 설치되어 있는지 확인하세요.

Yandex Advertising Network 계정에서 애플리케이션 설정

Yandex Advertising Network에 앱을 등록하는 방법은 다음과 같습니다.

1. Yandex Advertising Network에 로그인하거나 계정을 등록합니다.
2. Yandex Advertising Network에 앱을 등록합니다.

연동

개별 어댑터를 추가하려면 아래 안내에 따라 Yandex Ads SDK과 해당 어댑터를 연결하세요.

1. Yandex Advertising Network 인터페이스에서 미디에이션을 설정합니다.

2. 앱 모듈의 build.gradle 파일에 YandexMobileAds 종속 항목을 추가합니다.

   dependencies {
      ...
      implementation 'com.yandex.android:mobileads:x.x.x' // add supported version
   
      // Add dependencies on Mediation adapters.
   
   }
   

3. 앱 모듈의 build.gradle 파일에 Java 8 지원을 추가합니다.

   android {
   
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
   

4. 앱 모듈의 build.gradle 파일에 다음 코드를 추가합니다.

   // IronSource
   maven {
          url 'https://android-sdk.is.com/'
   }
   
   // Pangle
   maven {
          url 'https://artifact.bytedance.com/repository/pangle'
   }
   
   // Tapjoy
   maven {
          url "https://sdk.tapjoy.com/"
   }
   
   // Mintegral
   maven {
          url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
   }
   
   // Chartboost
   maven {
          url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
   }
   
   // AppNext
   maven {
          url "https://dl.appnext.com/"
   }
   

5. 광고 ID 사용 권한을 설정합니다(SDK 버전이 4.5.0 미만인 앱).

   광고 ID 사용 권한 설정 방법

   광고 ID는 맞춤형 광고에 동의한 사용자에게 광고를 표시하기 위해 Google Play 서비스가 제공하는 고유 식별자입니다. 사용자는 설정에서 광고 맞춤 설정을 끄거나 ID를 재설정할 수 있습니다. 이 경우 광고 네트워크는 해당 ID로 사용자에게 관련 광고를 선택할 수 없습니다.

   앱에서 Yandex Mobile Ads SDK 버전이 4.5 미만이면 AndroidManifest.xml 파일에 com.google.android.gms.permission.AD_ID를 추가하세요.

   <manifest>
       <application>
       <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
           <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
       </application>
   </manifest>
   

   4.5.0 버전부터 Yandex Mobile Ads SDK는 기본적으로 com.google.android.gms.permission.AD_ID를 추가합니다. 따라서 앱의 기본 매니페스트에 직접 명시할 필요가 없습니다. 이 권한으로 광고 네트워크에서 광고 ID를 사용해 보다 관련성 높은 광고를 선택할 수 있습니다.

   필요하면 권한을 제거할 수 있습니다. 예를 들어 Families 정책처럼 광고 선택에 ID 사용이 허용되지 않는 정책이 있는 경우입니다.

   앱의 기본 매니페스트에 권한이 추가되지 않게 하려면 AndroidManifest.xml에 다음 코드를 추가하세요.

   <manifest>
       <application>
           <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
       </application>
   </manifest>
   

   Важно

   이 권한과 ID에 대한 액세스가 없으면 광고 관련성이 떨어져 수익에 영향을 줄 수 있습니다.

6. 적절한 패키지를 사용해 필요한 어댑터를 하나씩 추가합니다.