Mobile Ads SDK 통합

시스템: Yandex Advertising Network, Adfox

앱에 Yandex Mobile Ads SDK를 통합하는 것은 광고 노출과 수익으로 가는 첫 단계입니다. SDK를 통합한 뒤 앱 수익화에 사용할 광고 형식(예: 배너 광고, 리워드 광고)을 선택하고 설정을 진행할 수 있습니다.

사전 요구 사항

앱을 준비하려면 아래 섹션에 설명된 단계를 따르세요.

앱 요구 사항

• Android Studio 2021 이상을 사용합니다.
• Android Gradle Plugin 8.7.0 이상을 사용합니다.
• 앱의 빌드 파일에 다음 값이 사용되는지 확인합니다.
  • MinSdkVersion 21 이상.
  • CompileSdkVersion 34 이상.
• 앱에서 AppMetrica SDK를 사용하는 경우 주 버전 7 안에서 7.2.1 이상이 설치되어 있는지 확인합니다.

Yandex Advertising Network 계정에서 앱 설정

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

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

앱 설정

1. 프로젝트 설정에 Google 저장소와 Maven Central 저장소를 추가합니다.

   프로젝트 빌드 설정에 따라 아래와 같이 프로젝트의 build.gradle 파일이나 settings.gradle의 repositories 섹션에 추가할 수 있습니다.

   build.gradle

   settings.gradle

   // Project-level build.gradle file
   buildscript {
       repositories {
           google()
           mavenCentral()
       }
   }
   
   allprojects {
       repositories {
           google()
           mavenCentral()
       }
   }
   

   // Project-level settings.gradle file
   pluginManagement {
       repositories {
           google()
           mavenCentral()
           gradlePluginPortal()
       }
   }
   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
       }
   }
   

2. 앱 모듈 수준의 Gradle 파일(보통 app/build.gradle)에 Yandex Mobile Ads SDK 의존성을 추가합니다.

   dependencies {
     implementation 'com.yandex.android:mobileads:7.18.5'
   }
   

3. 광고 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에 접근하지 못하면 관련성이 낮은 광고가 더 많이 게재되어 수익에 영향을 줄 수 있습니다.

Yandex Mobile Ads SDK 초기화

Yandex Mobile Ads SDK를 성공적으로 통합하는 것은 라이브러리를 올바르게 통합하는 데 중요한 전제 조건입니다. 기본적으로 앱을 실행하면 SDK가 자동으로 초기화됩니다. 광고 로드가 빨라져 앱 수익화 수익이 증가합니다.

앱에서 개인 데이터 개인정보 처리방침을 설정해야 하는 경우 Yandex Mobile Ads SDK를 초기화하기 전에 반드시 설정하세요.

AndroidManifest 파일로 설정하거나, 수동으로 SDK를 초기화하기 직전에 설정할 수 있습니다.

<manifest>
    <application>
        <!-- Disable the use of child's personal data for app monetization.  -->
        <meta-data
          android:name="@string/yandex_mobileads_age_restricted_user"
          android:value="true" />
    </application>
</manifest>

수동 SDK 초기화

필요하면 자동 초기화를 끈 뒤 initialize() 메서드로 라이브러리를 직접 초기화할 수 있습니다.

<manifest>
    <application>
        <!-- Disable automatic sdk initialization.  -->
        <meta-data
            android:name="com.yandex.mobile.ads.AUTOMATIC_SDK_INITIALIZATION"
            android:value="false" />
    </application>
</manifest>

초기화 코드는 Application 클래스의 onCreate 메서드에 넣는 것을 권장합니다. SDK를 초기화하기 전에 개인정보 처리방침을 설정하세요.

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // Configure the user data privacy policy before sdk init
        MobileAds.initialize(this) {
            // Now you can use ads
        }
    }
}

public class MyApplication extends Application {
    @Override
    public void onCreate() {
       super.onCreate();
        // Configure the user data privacy policy before sdk init
        MobileAds.initialize(this, () -> {
            // Now you can use ads
        });
    }
}

SDK 통합 테스트

내장 SDK 통합 테스트 도구로 라이브러리 통합이 성공했는지 확인할 수 있습니다.

SDK 통합을 테스트하려면 의존성을 추가하고 SDK를 초기화한 뒤 프로젝트를 다시 빌드합니다.

Logcat을 실행하고 키워드 Yandex Ads로 검색합니다.

이렇게 하면 SDK 통합 상태에 대한 로그가 생성됩니다. 통합이 성공하면 알림이 표시됩니다. 통합 중 오류가 발생하면 로그에 원인과 해결 방법에 대한 자세한 메시지가 포함됩니다.

mobileads$ adb logcat | grep 'Yandex Ads' -i
[Yandex Ads]  I  Yandex Mobile Ads 7.18.5 integrated successfully
[Yandex Ads]  I  Yandex Mobile Ads 7.18.5 initialized successfully

오래된 라이브러리 버전 표시기

Yandex Mobile Ads SDK의 오래된 버전 표시기는 라이브러리를 초기화하거나 광고를 로드할 때 토스트로 표시됩니다.

문제 세부 정보는 앱 로그에도 기록됩니다.

로그 예시:

***************************************************************************************
* The integrated version of the Yandex Mobile Ads SDK is outdated.                    *
* Please update com.yandex.android:mobileads to the latest version.                   *
* Learn more about the latest version of the SDK here:                                *
* https://yandex.ru/dev/mobile-ads/doc/android/quick-start/android-ads-component.html *
* Changelog: https://yandex.ru/dev/mobile-ads/doc/intro/changelog-android.html        *
***************************************************************************************

표시를 끄려면 enableDebugErrorIndicator 메서드를 false로 호출합니다.

MobileAds.enableDebugErrorIndicator(false)

최신 SDK 버전에 대한 Lint 검사

앱 릴리스 빌드 시 최신 SDK 버전에 대한 Lint 검사가 실행됩니다.

Lint 검사는 lintVitalRelease Gradle 작업을 호출해 수행됩니다. 광고 SDK 버전이 오래된 경우 작업이 실패합니다.

이 검사는 더 새로운 SDK 버전이 출시된 경우 앱 빌드를 막습니다.

최신 SDK 버전 검사를 끄려면 Lint 검사를 비활성화하는 표준 Gradle 코드를 사용합니다(자세한 내용은 Android 문서 참고).

android {
    lintOptions {
        disable 'MobileAdsSdkOutdatedVersion'
    }
}

다음 단계

Yandex Mobile Ads SDK 통합이 완료되면 광고 형식 구현으로 진행할 수 있습니다.

앱에 가장 잘 맞는 다음 광고 유형 중 하나를 선택하세요.