Commencer

L'intégration du SDK Google Mobile Ads dans une application est la première étape pour diffuser des annonces et générer des revenus. Une fois le SDK intégré, vous pouvez choisir un format d'annonce (annonce native ou vidéo avec récompense, par exemple) 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 : 19 ou version ultérieure
    • Compiler la version du SDK 33 ou version ultérieure

Configurer votre application

  1. Dans le fichier build.gradle au niveau du projet, incluez le dépôt Maven de Google et le dépôt central Maven dans vos sections buildscript et allprojects:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Ajoutez les dépendances du SDK Google Mobile Ads au fichier Gradle au niveau de l'application de votre module, généralement app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:23.0.0'
    }
    
  3. Ajoutez l' Ad Manager ID de votre application, tel qu'identifié dans l'interface WebAd 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 l'ID de votre application dans l' Ad Manager interface Web. Pour android:value, insérez votre propre Ad Manager ID d'application, entouré 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="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      </application>
    </manifest>
    

    Dans une application réelle, remplacez l'ID d'application exemple par votre ID d'applicationAd Manager réel. Vous pouvez utiliser l'exemple d'ID si vous ne faites que tester le SDK dans une application Hello World.

    Notez également que si vous n'ajoutez pas la balise <meta-data> exactement telle qu'elle apparaît, cela entraîne un plantage avec le message suivant:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (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. En effet, le SDK déclare automatiquement l'autorisation com.google.android.gms.permission.AD_ID et peut accéder à l'identifiant publicitaire chaque fois qu'il est disponible.

    Pour les applications qui utilisent la version 20.3.0 du SDK Google Mobile Ads ou une version antérieure 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 découvrir 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 les initialisations du SDK Google Mobile Ads et de l'adaptateur terminées, ou après un délai d'inactivité de 30 secondes. Cette opération ne doit être effectuée qu'une seule fois, idéalement au lancement 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 aux demandes, tels que setTagForChildDirectedTreatment(), setTagForUnderAgeOfConsent(), , ou agissez avant de charger des annonces, veillez à le faire avant d'initialiser le SDK Google Mobile Ads.

Voici un exemple d'appel de la méthode initialize() 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);

    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {
        }
    });
  }
}

Kotlin

import com.google.android.gms.ads.MobileAds

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

    MobileAds.initialize(this) {}
  }
}

Sélectionnez un format d'annonce

Le SDK Google Mobile Ads est maintenant importé et vous êtes prêt à intégrer une annonce. Ad Manager Propose différents formats d'annonces. Vous pouvez donc 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. Elles peuvent être actualisées automatiquement après une période donnée. Cela signifie que les utilisateurs voient 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 simple à implémenter.

Implémenter des bannières

Interstitiel

Les blocs d'annonces interstitielles affichent des annonces en pleine page dans votre application. Placez-les lors des pauses ou des points de transition naturels dans l'interface de votre application, par exemple à la fin d'un niveau dans une application de jeu.

Intégrer des annonces interstitielles

Natif

Les annonces natives sont des annonces qui 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 appliquant vous-même un style à l'annonce, vous pouvez créer des présentations naturelles et discrètes qui enrichiront l'expérience utilisateur.

Google Ad Manager propose deux méthodes pour intégrer 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. Il s'agit d'un excellent choix si vous débutez. L'affichage personnalisé a été conçu pour maximiser la liberté de création de vos présentations.

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

Accordé

Les blocs d'annonces avec récompense permettent aux utilisateurs de jouer à des jeux, de répondre à des enquêtes ou de regarder des vidéos pour gagner des récompenses dans l'application, telles que des pièces, des vies supplémentaires ou des points. Vous pouvez définir différentes récompenses en fonction des blocs d'annonces, et indiquer les valeurs et les éléments de récompense que l'utilisateur a reçus.

Intégrer des annonces avec récompense

Interstitiel avec récompense

L'interstitiel avec récompense est un nouveau type de format d'annonce incitative qui vous permet d'offrir des récompenses, telles que des pièces ou des vies supplémentaires, pour les annonces qui s'affichent automatiquement lors des transitions naturelles dans l'application.

Contrairement aux annonces avec récompense, les utilisateurs ne sont pas obligés d'activer l'affichage d'un interstitiel avec récompense.

Au lieu d'une invite d'activation dans 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 la désactiver s'ils le souhaitent.

Implémenter des annonces interstitielles avec récompense

Annonce à l'ouverture

Il s'agit d'un format d'annonce qui apparaît lorsque les utilisateurs ouvrent votre application ou y retournent. 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 montre comment utiliser les différents formats d'annonces proposés par cette API.