Débutter

La première étape pour diffuser des annonces et générer des revenus consiste à intégrer le SDK Google Mobile Ads (bêta) à une application. Une fois le SDK intégré, vous pouvez choisir un format d'annonce (comme une annonce native ou une annonce vidéo avec récompense) et suivre les étapes pour l'implémenter.

Avant de commencer

Pour préparer votre application, procédez comme indiqué dans les sections suivantes.

Conditions requises pour l'application

• Assurez-vous que le fichier de compilation de votre application utilise les valeurs suivantes :

  • Version minimale du SDK : 24 ou version ultérieure
  • Version de compilation du SDK : 35 ou version ultérieure

• Pour les applications Kotlin, utilisez la version minimale de Kotlin 1.9.

Configurer votre application dans votre compte AdMob

Enregistrez votre application en tant qu'application AdMob en procédant comme suit :

1. Connectez-vous à votre compte AdMob ou inscrivez-vous.

2. Enregistrez votre application auprès d'AdMob. Cette étape permet de créer une application AdMob avec un ID d'application AdMob unique, qui sera nécessaire plus loin dans ce guide.

Configurer votre application

1. Dans votre fichier de paramètres Gradle, incluez le dépôt Maven de Google et le dépôt central Maven :

   Kotlin

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include(":app")

   Groovy

   pluginManagement {
     repositories {
       google()
       mavenCentral()
       gradlePluginPortal()
     }
   }
   
   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
       google()
       mavenCentral()
     }
   }
   
   rootProject.name = "My Application"
   include ':app'

2. Ajoutez les dépendances du SDK Google Mobile Ads (bêta) à votre fichier de build au niveau de l'application :

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
   }

   Groovy

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
   }

3. Cliquez sur Synch Now (Synchroniser). Pour en savoir plus sur la synchronisation, consultez Synchroniser des projets avec des fichiers Gradle.

Initialiser le SDK Google Mobile Ads (bêta)

Point clé : Vous devez initialiser le SDK Google Mobile Ads (bêta) avant de charger des annonces et d'interagir avec d'autres méthodes MobileAds, sauf indication contraire dans la documentation de référence de l'API (voir getVersion()). Sinon, une exception UninitializedPropertyAccessException peut être générée.

Appelez MobileAds.initialize() pour initialiser le SDK Google Mobile Ads (bêta). 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 Google Mobile Ads SDK (beta) 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.
      }
      // 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 Google Mobile Ads SDK (beta) 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.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

Cette méthode permet d'initialiser le SDK et d'appeler un écouteur d'achèvement une fois que l'initialisation du SDK Google Mobile Ads (bêta) et de l'adaptateur est terminée, ou après un délai de 30 secondes. Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement de l'application.

Remarque : Si vous utilisez la médiation AdMob, attendez que le gestionnaire d'achèvement soit appelé avant de charger les annonces. Cela permet de s'assurer que tous les adaptateurs de médiation sont initialisés.

Les annonces peuvent être préchargées par le SDK Google Mobile Ads (bêta) ou les SDK des partenaires de médiation lors de l'initialisation. Si vous devez obtenir le consentement des utilisateurs dans l'Espace économique européen (EEE), définissez les indicateurs spécifiques à la demande, tels que RequestConfiguration.TagForChildDirectedTreatment ou RequestConfiguration.TagForUnderAgeOfConsent, ou prenez d'autres mesures avant de charger les annonces. Assurez-vous de le faire avant d'initialiser le SDK Google Mobile Ads (bêta).

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads (bêta) est maintenant importé. Vous pouvez implémenter une annonce. AdMob propose différents formats d'annonces. Vous pouvez donc choisir celui qui convient le mieux à l'expérience utilisateur de votre application.

Bannière

Les blocs d'annonces de type bannière affichent des annonces rectangulaires qui occupent une partie de la mise en page d'une application. Ils peuvent être automatiquement actualisés selon un délai défini. Cela signifie que les utilisateurs verront une nouvelle annonce à intervalles réguliers, même s'ils restent sur le même écran dans votre application. Il s'agit également du format d'annonce le plus facile à implémenter.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles diffusent des annonces pleine page dans votre application. Placez-les lors des pauses ou des points de transition naturels dans l'interface de votre application, comme à la fin d'un niveau s'il s'agit d'une application de jeu.

Implémenter des annonces interstitielles

Avec récompense

Les annonces avec récompense permettent aux utilisateurs de jouer à des jeux, de répondre à des enquêtes ou de regarder des vidéos pour obtenir des récompenses dans l'application, par exemple des pièces, des vies supplémentaires ou des points. Vous pouvez définir différentes récompenses pour les blocs d'annonces, et indiquer leur valeur et leur nature.

Implémenter des annonces avec récompense

Interstitiel avec récompense

L'interstitiel avec récompense est un nouveau type de format incitatif qui vous permet de proposer des récompenses (comme des pièces de monnaie ou des vies supplémentaires) pour les annonces diffusées automatiquement aux points de transition naturels dans votre application.

Contrairement aux annonces avec récompense, les utilisateurs ne sont pas obligés de choisir de regarder un interstitiel avec récompense.

Au lieu de recevoir une invite d'activation, comme c'est le cas pour les annonces avec récompense, les interstitiels avec récompense nécessitent un écran d'introduction qui annonce la récompense et permet aux utilisateurs de les désactiver s'ils le souhaitent.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

Les annonces à l'ouverture d'une application sont un format d'annonce qui s'affiche lorsque les utilisateurs ouvrent votre application ou y reviennent. L'annonce se superpose à l'écran de chargement.

Implémenter des annonces à l'ouverture d'une application