Przejdź na pakiet SDK nowej generacji do reklam mobilnych Google

Na tej stronie znajdziesz instrukcje inicjowania GMA Next-Gen SDK.

Zanim zaczniesz

Ten przewodnik jest przeznaczony dla wydawców i platform zewnętrznych, które bezpośrednio integrują się z GMA Next-Gen SDK.

Jeśli łączysz się z AdMob za pomocą zewnętrznej platformy zapośredniczenia, która obsługuje określanie stawek przez partnera, sprawdź w poniższej tabeli, czy ta platforma jest zgodna z GMA Next-Gen SDK.

Platforma zapośredniczenia Zgodne z: GMA Next-Gen SDK
AdMost
AppLovin MAX
Chartboost Mediation
DT Fairbid
Gravite
Nimbus
TopOn
TradPlus VisiM
Unity LevelPlay

Jeśli chcesz używać platformy zapośredniczenia, która nie jest zgodna z GMA Next-Gen SDK, skontaktuj się z jej zespołem pomocy.

Konfigurowanie kompilacji dla: GMA Next-Gen SDK

W sekcjach poniżej znajdziesz instrukcje konfigurowania GMA Next-Gen SDK.

Uwzględnij zależność GMA Next-Gen SDK

GMA Next-Gen SDK wymaga innej zależności Gradle. W pliku kompilacji na poziomie aplikacji usuń odwołanie do zależności Google Mobile Ads SDK (Legacy) i dołącz nowy artefakt.

Zależności Gradle
Google Mobile Ads SDK (Legacy)

Kotlin

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

Zakręcony

dependencies {
  // ...
  implementation 'com.google.android.gms:play-services-ads:25.5.0'
}
GMA Next-Gen SDK

Kotlin

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

Zakręcony

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

Wyklucz moduły com.google.android.gms w integracjach zapośredniczenia

Adaptery zapośredniczenia nadal zależą od Google Mobile Ads SDK (Legacy). Jednak GMA Next-Gen SDK zawiera wszystkie klasy wymagane przez adaptery zapośredniczenia. Aby uniknąć błędów kompilacji związanych ze zduplikowanymi symbolami, musisz wykluczyć Google Mobile Ads SDK (Legacy) z pobierania jako zależności przez adaptery zapośredniczenia.

W pliku kompilacji na poziomie aplikacji wyklucz moduły play-services-ads i play-services-ads-lite globalnie ze wszystkich zależności.

Kotlin

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

Zakręcony

configurations.configureEach {
    exclude group: "com.google.android.gms", module: "play-services-ads"
    exclude group: "com.google.android.gms", module: "play-services-ads-lite"
}

Ustawianie minimalnego i kompilowanego poziomu interfejsu API Androida

GMA Next-Gen SDK wymaga interfejsu Android API na poziomie co najmniej 24 i interfejsu Android API do kompilacji na poziomie 34. Dostosuj wartości minSdk i compileSdk w pliku kompilacji na poziomie aplikacji odpowiednio do 24 lub wyższej i 34 lub wyższej.

Zainicjuj GMA Next-Gen SDK

GMA Next-Gen SDK wymaga inicjalizacji przed wczytaniem reklam, co stanowi zmianę w porównaniu z Google Mobile Ads SDK (Legacy), gdzie inicjalizacja jest opcjonalna, ale zalecana. Jeśli pakiet SDK nie był wcześniej inicjowany przed wczytaniem reklam, zaktualizuj kod.

W tej sekcji znajdziesz informacje o różnicach we wdrażaniu inicjowania pakietu SDK między Google Mobile Ads SDK (Legacy) a GMA Next-Gen SDK.

Ustawianie identyfikatora aplikacji w AdMob

Te przykłady pokazują, jak ustawić identyfikator aplikacji w AdMob w plikach Google Mobile Ads SDK (Legacy) i GMA Next-Gen SDK:

Google Mobile Ads SDK (Legacy)

Integracja wymaga tagu <meta-data> z atrybutem android:name="com.google.android.gms.ads.APPLICATION_ID" zawierającym identyfikator aplikacji w AdMob w pliku AndroidManifest.xml aplikacji.

<manifest>
  <application>
    <!-- Sample AdMob 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>
GMA Next-Gen SDK

Podaj identyfikator aplikacji w AdMob automatycznie w ramach inicjowania pakietu SDK.

Kotlin

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

Java

// Initialize GMA Next-Gen SDK.
InitializationConfig initConfig =
    new InitializationConfig.Builder("SAMPLE_APP_ID").build();
MobileAds.initialize(this, initConfig, initializationStatus -> {});

Sprawdź zmiany we wdrażaniu

Poniższe przykłady inicjują Google Mobile Ads SDK (Legacy) i GMA Next-Gen SDK:

Google Mobile Ads SDK (Legacy)

Wywołaj metodę MobileAds.initialize(), aby zainicjować pakiet SDK do reklam mobilnych Google. Aby zmniejszyć liczbę błędów ANR, zalecamy inicjowanie w wątku w tle.

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) {}
    }
  }
}

Java

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();
  }
}
GMA Next-Gen SDK

Wywołaj MobileAds.initialize(), aby zainicjować GMA Next-Gen SDK. Należy ją wywołać w wątku w tle. W przeciwnym razie może wystąpić błąd „Aplikacja nie odpowiada” (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 GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // SDK initialization is complete. If you don't want to wait for bidding adapters to finish
      // initializing, start loading ads now.
    }
  }
}

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 GMA Next-Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // SDK initialization is complete. If you don't want to wait for bidding adapters to
              // finish initializing, start loading ads now.
            })
        .start();
  }
}
Wstecz
Poznaj korzyści z migracji
Dalej
Obsługa wywołań z wątku w tle