Initialiser le SDK

Cette page explique comment initialiser GMA Next-Gen SDK.

Avant de commencer

Pour utiliser GMA Next-Gen SDK, vous devez effectuer l'intégration sans médiation ou utiliser Ad Manager comme plate-forme de médiation. Les autres plates-formes de médiation ne sont pas compatibles avec GMA Next-Gen SDK.

Configurer votre build pour GMA Next-Gen SDK

Les sections suivantes vous expliquent comment configurer GMA Next-Gen SDK.

Inclure la dépendance GMA Next-Gen SDK

GMA Next-Gen SDK nécessite une autre dépendance Gradle. Dans le fichier de build au niveau de l'application, supprimez la référence à la dépendance actuelle du SDK Mobile Ads et incluez le nouvel artefact.

Dépendances Gradle
Actuel

Kotlin

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

Groovy

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

Kotlin

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

Groovy

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

Exclure les modules com.google.android.gms dans les intégrations de médiation

Les adaptateurs de médiation continuent de dépendre du SDK Mobile Ads actuel. Toutefois, GMA Next-Gen SDK inclut toutes les classes requises par les adaptateurs de médiation. Pour éviter les erreurs de compilation liées aux symboles en double, vous devez empêcher l'extraction du SDK Mobile Ads actuel en tant que dépendance par les adaptateurs de médiation.

Dans le fichier de compilation au niveau de l'application, excluez globalement les modules play-services-ads et play-services-ads-lite de toutes les dépendances.

Kotlin

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

Groovy

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

Définir les niveaux d'API Android minimal et de compilation

GMA Next-Gen SDK nécessite un niveau d'API Android minimal de 24 et un niveau d'API Android de compilation de 34. Ajustez les valeurs minSdk et compileSdk dans le fichier build au niveau de l'application sur 24 ou plus et 34 ou plus, respectivement.

Initialiser GMA Next-Gen SDK

GMA Next-Gen SDK nécessite une initialisation avant le chargement des annonces. Il s'agit d'un changement par rapport au SDK Mobile Ads actuel, où l'initialisation est facultative, mais recommandée. Mettez à jour votre code si vous n'initialisiez pas le SDK avant de charger les annonces.

Cette section décrit les différences d'implémentation de l'initialisation du SDK entre la version actuelle et GMA Next-Gen SDK.

Définir l'ID d'application Ad Manager

Les exemples suivants définissent l'ID d'application Ad Manager dans les GMA Next-Gen SDK et actuels :

Actuel

L'intégration nécessite une balise <meta-data> avec android:name="com.google.android.gms.ads.APPLICATION_ID" contenant l'ID d'application Ad Manager dans le fichier AndroidManifest.xml de votre application.

<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>
GMA Next-Gen SDK

Fournissez l'ID de votre application Ad Manager par programmation lors de l'initialisation du 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 -> {});

Examiner les modifications apportées à l'implémentation

Les exemples suivants initialisent la valeur actuelle et GMA Next-Gen SDK :

Actuel

Appelez MobileAds.initialize() pour initialiser le SDK Google Mobile Ads. Nous vous recommandons d'effectuer l'initialisation sur un thread d'arrière-plan pour réduire les 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) {}
    }
  }
}

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

Appelez MobileAds.initialize() pour initialiser GMA Next-Gen SDK. Cette méthode doit être appelée sur un thread d'arrière-plan. Si ce n'est pas le cas, une erreur "L'application ne répond pas" (ANR) peut se produire.

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 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 GMA Next-Gen 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();
  }
}
Précédent
Découvrez les avantages de la migration
Suivant
Gérer les rappels à partir d'un thread d'arrière-plan