Premiers pas avec AdMob dans votre projet Android

Ce guide de démarrage rapide s'adresse aux éditeurs et aux développeurs qui souhaitent utiliser AdMob pour monétiser une application créée avec Firebase. Si vous ne prévoyez pas d'inclure Firebase dans votre application, consultez plutôt le guide autonome sur AdMob.

Si ce n'est pas déjà fait, découvrez tous les avantages de l'utilisation combinée de AdMob, Firebase et Google Analytics.

Avant de commencer

  • Si vous ne disposez pas encore d'un projet Firebase ni d'une application Firebase, suivez le guide de démarrage de Firebase : Ajouter Firebase à votre projet Android.

  • Assurez-vous que Google Analytics est activé dans votre projet Firebase:

    • Si vous créez un projet Firebase, activez Google Analytics au cours du workflow de création du projet.

    • Si vous avez un projet Firebase existant pour lequel Google Analytics n'est pas activé, vous pouvez l'activer dans l'onglet Intégrations de  > Paramètres du projet.Google Analytics

Étape 1:Configurez votre application dans votre compte AdMob

  1. Enregistrez votre application en tant qu'application AdMob.

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

    2. Enregistrez votre application auprès de AdMob. Cette étape crée une application AdMob avec un ID d'application AdMob unique dont vous aurez besoin plus tard dans ce guide.

    Vous serez invité à ajouter le SDK Mobile Ads à votre application. Vous trouverez des instructions détaillées pour cette tâche plus loin dans ce guide.

  2. Associez votre application AdMob à votre application Firebase.

    Cette étape est facultative, mais vivement recommandée. Découvrez les avantages d'activer les métriques utilisateur et d'associer votre application AdMob à Firebase.

    Effectuez les deux étapes suivantes dans le tableau de bord Applications de votre compte AdMob:

    1. Activez les métriques utilisateur pour permettre à AdMob de traiter et d'afficher des données analytiques sélectionnées dans votre compte AdMob. Il s'agit également d'un paramètre obligatoire pour associer votre application AdMob à Firebase.

    2. Associez votre application AdMob à votre projet et application Firebase existants.

      Assurez-vous de saisir le même nom de package que celui que vous avez saisi pour votre application Firebase. Vous trouverez le nom de package de votre application Firebase dans la fiche Vos applications de  > Project settings (Paramètres du projet).

Étape 2:Ajoutez votre ID d'application AdMob à votre fichier AndroidManifest.xml

Ajoutez votre ID d'application AdMob au fichier AndroidManifest.xml de votre application en ajoutant la balise <meta-data>, comme indiqué ci-dessous.

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

Étape 3:Ajoutez et initialisez le SDK Mobile Ads

  1. Ajoutez la dépendance du SDK Google Mobile Ads à votre fichier Gradle de module (au niveau de l'application) (généralement <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle):

    implementation("com.google.android.gms:play-services-ads:23.6.0")

  2. Avant de charger les annonces, appelez la méthode MobileAds.initialize().

    Cet appel initialise le SDK et appelle un écouteur d'achèvement une fois l'initialisation terminée (ou après un délai de 30 secondes). N'appelez cette méthode qu'une seule fois et le plus tôt possible, idéalement au démarrage de l'application.

    Voici un exemple d'appel de la méthode initialize() dans une activité:

    Kotlin+KTX 

    override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}
    MainActivity.kt

    Java 

    @Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}
    MainActivity.java

Étape 4:Affichez les métriques utilisateur et les données analytiques

Après son initialisation, le SDK Mobile Ads commence automatiquement à consigner les événements d'analyse et les propriétés utilisateur à partir de votre application. Vous pouvez afficher ces données sans ajouter de code supplémentaire à votre application ni implémenter d'annonces. Vous pouvez consulter ces données analytiques:

Notez que pour mieux représenter les métriques ARPU et ARPPU, vous pouvez inclure les données d'un événement personnalisé d'analyse appelé ecommerce_purchase dans le calcul des revenus pour ces métriques (découvrez comment).

Étape 5:(Facultatif) Utiliser d'autres fonctionnalités de Google Analytics et de Firebase

Profitez de plus d'opportunités et de plus de fonctionnalités pour améliorer la monétisation des applications et l'engagement utilisateur:

  • Optimiser la monétisation des annonces pour votre application

    Essayez différents formats ou configurations d'annonces avec un petit sous-ensemble d'utilisateurs, puis prenez des décisions basées sur les données concernant l'implémentation de l'annonce pour tous vos utilisateurs. Pour en savoir plus, consultez les tutoriels suivants:

Étape 6:Choisissez un format d'annonce à implémenter dans votre application

AdMob propose plusieurs formats d'annonces différents. Vous pouvez donc choisir celui qui convient le mieux à l'expérience utilisateur de votre application. Cliquez sur un bouton correspondant à un format d'annonce pour afficher des instructions d'implémentation détaillées dans la documentation AdMob.

Annonces rectangulaires qui s'affichent en haut ou en bas de l'écran de l'appareil

Les bannières restent à l'écran lorsque les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement au bout d'un certain temps. Si vous débutez dans la publicité mobile, elles constituent un excellent point de départ.

Implémenter des bannières

Interstitiel

Annonces en plein écran qui recouvrent l'interface d'une application jusqu'à ce que l'utilisateur les ferme

Les annonces interstitielles sont mieux utilisées lors des pauses naturelles dans le flux d'exécution d'une application, par exemple entre les niveaux d'un jeu ou juste après la fin d'une tâche.

Implémenter des annonces interstitielles

Natif

Annonces personnalisables qui s'adaptent à l'apparence de votre application

Les annonces natives sont un format d'annonce basé sur des composants. C'est vous qui décidez où et comment les annonces natives sont placées afin d'harmoniser leur mise en page avec celle de votre application. En choisissant vous-même des polices, des couleurs et d'autres détails, vous pouvez créer des présentations d'annonces naturelles et non intrusives qui peuvent enrichir l'expérience utilisateur.

Implémenter les annonces natives avancées

Avec récompense

Annonces récompensant les utilisateurs qui regardent des vidéos courtes et qui interagissent avec des annonces jouables et des enquêtes

Les annonces avec récompense (ou "basées sur des récompenses") peuvent vous aider à monétiser les utilisateurs de jeux sans frais.

Implémenter les annonces avec récompense Implémenter les annonces avec récompense (nouvelles API)