Commencer

La première étape pour diffuser des annonces et générer des revenus consiste à intégrer le SDK Google Mobile Ads à une application. Une fois le SDK intégré, vous pouvez choisir un format d'annonce (comme une vidéo native ou 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 21 ou ultérieure
    • Version du SDK de compilation 34 ou ultérieure

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 à votre fichier de compilation au niveau de l'application:

    Kotlin

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

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:23.5.0'
}

  3. Ajoutez votre ID d'application Ad Manager, tel qu'il s'affiche dans l'interface Web Ad Manager, au fichier AndroidManifest.xml de votre application. Pour ce faire, ajoutez une balise <meta-data> avec android:name="com.google.android.gms.ads.APPLICATION_ID". Vous trouverez votre ID d'application dans l'interface Web Ad Manager. Pour android:value, insérez votre propre ID d'application Ad Manager et entourez-le de guillemets.

    <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="
/<network_code>~<application_id>"/>
  </application>
</manifest>

    Dans une application réelle, remplacez l'exemple d'ID d'application par votre ID d'application Ad Manager réel. Vous pouvez utiliser l'ID d'exemple si vous testez simplement le SDK dans une application Hello World.

    Notez également que si vous n'ajoutez pas la balise <meta-data> exactement comme indiqué, un plantage se produit avec le message suivant:

    Missing application ID.

    (Facultatif) Déclarez l'autorisation AD_ID pour que les versions précédentes fonctionnent avec Android 13.

    Si votre application utilise la version 20.4.0 ou ultérieure du SDK Google Mobile Ads, vous pouvez ignorer cette étape, car le SDK déclare automatiquement l'autorisation com.google.android.gms.permission.AD_ID et peut accéder à l'identifiant publicitaire lorsqu'il est disponible.

    Pour les applications qui utilisent la version 20.3.0 ou antérieure du SDK Google Mobile Ads et qui ciblent Android 13, vous devez ajouter l'autorisation com.google.android.gms.permission.AD_ID dans le fichier AndroidManifest.xml pour que le SDK Google Mobile Ads puisse accéder à l'identifiant publicitaire:

    <manifest>
 <application>
   <meta-data
       android:name="com.google.android.gms.ads.APPLICATION_ID"
       android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

   <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower -->
   <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

 </application>
</manifest>

    Pour en savoir plus sur la déclaration d'autorisation com.google.android.gms.permission.AD_ID et pour comprendre comment la désactiver, consultez cet article de la Play Console.

Initialiser le SDK Google Mobile Ads

Avant de charger les annonces, initialisez le SDK Google Mobile Ads en appelant MobileAds.initialize().

Cette méthode initialise le SDK et appelle un écouteur d'achèvement une fois que l'initialisation du SDK Google Mobile Ads 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 démarrage de l'application.

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

Voici un exemple d'appel de la méthode initialize() sur un thread d'arrière-plan dans une activité:

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();
  }
}

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

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est maintenant importé et vous pouvez implémenter une annonce. Ad Manager propose différents formats d'annonces. Vous pouvez ainsi choisir celui qui correspond le mieux à l'expérience utilisateur de votre application.

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

Natif

Les annonces natives vous permettent de personnaliser la façon dont les composants tels que les titres et les incitations à l'action sont présentés dans vos applications. En créant vous-même le style de l'annonce, vous pouvez créer des présentations d'annonces naturelles et non intrusives qui peuvent enrichir l'expérience utilisateur.

Google Ad Manager propose deux façons d'implémenter des annonces natives: les styles natifs et les annonces natives standards via l'affichage personnalisé.

Les styles natifs ont été conçus pour simplifier l'implémentation des annonces natives. C'est un excellent choix si vous ne connaissez pas ce format. Le rendu personnalisé a été conçu pour vous offrir une liberté maximale dans la création de vos présentations.

Implémenter des styles natifs Implémenter des annonces natives (affichage personnalisé)

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, comme 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 d'activer les interstitiels 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

L'annonce à l'ouverture d'une application est 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

Ressources supplémentaires

Le dépôt Google Mobile Ads sur GitHub explique comment utiliser les différents formats d'annonces proposés par cette API.