SDK 초기화

이 페이지에서는 차세대 모바일 광고 SDK를 초기화하는 방법을 설명합니다.

시작하기 전에

차세대 모바일 광고 SDK를 사용하려면 미디에이션 없이 통합하거나 Ad Manager를 미디에이션 플랫폼으로 사용해야 합니다. 다른 미디에이션 플랫폼은 차세대 모바일 광고 SDK와 호환되지 않습니다.

차세대 모바일 광고 SDK용 빌드 구성

다음 섹션에서는 차세대 모바일 광고 SDK를 구성하는 데 필요한 단계를 보여줍니다.

차세대 모바일 광고 SDK 종속 항목 포함

차세대 모바일 광고 SDK에는 다른 Gradle 종속 항목이 필요합니다. 앱 수준 빌드 파일에서 현재 모바일 광고 SDK 종속 항목 참조를 삭제하고 새 아티팩트를 포함합니다.

Gradle 종속 항목
현재

Kotlin

dependencies {
  // ...
  implementation("com.google.android.gms:play-services-ads:24.4.0")
}

Groovy

dependencies {
  // ...
  implementation 'com.google.android.gms:play-services-ads:24.4.0'
}
차세대

Kotlin

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation("com.google.android.gms:play-services-ads:24.4.0")
  implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha02")
}

Groovy

dependencies {
  // ...
  // Comment out/remove play-services-ads.
  // implementation 'com.google.android.gms:play-services-ads:24.4.0'
  implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.17.0-alpha02'
}

미디에이션 통합에서 com.google.android.gms 모듈 제외

미디에이션 어댑터는 계속해서 현재 모바일 광고 SDK를 사용합니다. 하지만 차세대 모바일 광고 SDK에는 미디에이션 어댑터에 필요한 모든 클래스가 포함되어 있습니다. 중복 기호와 관련된 컴파일 오류를 방지하려면 현재 모바일 광고 SDK가 미디에이션 어댑터에 의해 종속 항목으로 가져오는 것을 제외해야 합니다.

앱 수준 빌드 파일에서 모든 종속 항목에서 play-services-ads 및 play-services-ads-lite 모듈을 전역적으로 제외합니다.

Kotlin

configurations.all {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

configurations {
  all {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
  }
}

최소 Android API 수준 및 컴파일 설정

차세대 모바일 광고 SDK를 사용하려면 Android API 수준 24 이상 및 컴파일 Android API 수준 34가 필요합니다. 앱 수준 빌드 파일에서 minSdk 및 compileSdk 값을 각각 24 이상 및 34 이상으로 조정합니다.

차세대 SDK 초기화

차세대 모바일 광고 SDK는 광고를 로드하기 전에 초기화가 필요합니다. 이는 초기화가 선택사항이지만 권장되는 현재 모바일 광고 SDK와는 다른 점입니다. 이전에 광고를 로드하기 전에 SDK를 초기화하지 않았다면 코드를 업데이트합니다.

이 섹션에서는 현재 모바일 광고 SDK와 차세대 모바일 광고 SDK 간의 SDK 초기화 구현 차이점을 설명합니다.

Ad Manager 앱 ID 설정

다음 예에서는 기존 및 차세대 모바일 광고 SDK에서 Ad Manager 앱 ID를 설정합니다.

현재

통합하려면 앱의 AndroidManifest.xml 파일 내에 Ad Manager 앱 ID가 포함된 android:name="com.google.android.gms.ads.APPLICATION_ID"가 있는 <meta-data> 태그가 필요합니다.

<manifest>
  <application>
    <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 -->
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="SAMPLE_APP_ID"/>
  </application>
</manifest>
차세대

SDK 초기화의 일부로 Ad Manager 앱 ID를 프로그래매틱 방식으로 제공합니다.

Kotlin

// Initialize the Google Mobile Ads SDK.
val initConfig = InitializationConfig.Builder("SAMPLE_APP_ID").build()
MobileAds.initialize(this@MainActivity, initConfig) {}

자바

// Initialize the Google Mobile Ads SDK.
InitializationConfig initConfig =
    new InitializationConfig.Builder("SAMPLE_APP_ID").build();
MobileAds.initialize(this, initConfig, initializationStatus -> {});

구현 변경사항 검토

다음 예에서는 기존 모바일 광고 SDK와 차세대 모바일 광고 SDK를 초기화합니다.

현재

MobileAds.initialize()를 호출하여 Google 모바일 광고 SDK를 초기화합니다. ANR을 줄이려면 백그라운드 스레드에서 초기화하는 것이 좋습니다.

Kotlin

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) {}
    }
  }
}

자바

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(this, initializationStatus -> {});
            })
        .start();
  }
}
차세대

MobileAds.initialize()를 호출하여 Google 모바일 광고 SDK를 초기화합니다. 백그라운드 스레드에서 호출해야 합니다. 그러지 않으면 '애플리케이션 응답 없음' (ANR) 오류가 발생할 수 있습니다.

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}
다음
백그라운드 스레드에서 콜백 처리