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 AdMob autonome .

Si vous ne l'avez pas encore fait, découvrez tous les avantages de l'utilisation conjointe d'AdMob, Firebase et Google Analytics.

Avant que tu commences

• Si vous n'avez pas encore de projet Firebase ni d'application Firebase, suivez le guide de démarrage de Firebase : Ajoutez Firebase à votre projet Android .

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

  • Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le workflow de création du projet.

  • Si vous disposez d'un projet Firebase existant sur lequel Google Analytics n'est pas activé, vous pouvez activer Google Analytics à partir de l'onglet Intégrations de votre settings > Paramètres du projet .

Étape 1 : Configurez votre application dans votre compte AdMob

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

   1. Connectez-vous ou créez un compte AdMob.

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

   Il vous sera demandé d'ajouter le SDK Mobile Ads à votre application. Trouvez 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 fortement recommandée. Découvrez les avantages de l'activation des statistiques utilisateur et de l'association de votre application AdMob à Firebase.

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

   1. Activez les statistiques 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 Firebase et à votre application Firebase existants.

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

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

Ajoutez votre identifiant 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 au fichier Gradle de votre 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:22.5.0")
   

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

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

   Voici un exemple de la façon d'appeler 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 : Afficher les métriques utilisateur et les données analytiques

Après son initialisation, le SDK Mobile Ads démarre automatiquement la journalisation des événements d'analyse et des propriétés utilisateur à partir de votre application. Vous pouvez afficher ces données sans ajouter de code supplémentaire à votre application ni mettre en œuvre d'annonces. Voici où vous pouvez voir ces données analytiques :

• Dans la fiche Statistiques utilisateur de votre compte AdMob (tableau de bord Accueil ou Applications ), vous pouvez afficher les statistiques utilisateur sélectionnées dérivées des données d'analyse collectées, telles que la durée moyenne de session, l'ARPU et la rétention.

• Dans le tableau de bord Analytics de la console Firebase, vous pouvez afficher des statistiques agrégées et des résumés des métriques clés . Si vous ajoutez le SDK Firebase pour Google Analytics , vous pouvez également marquer les conversions pour les campagnes publicitaires et créer des audiences personnalisées dans la console Firebase.

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

Étape 5 : (Facultatif) Utilisez davantage de fonctionnalités de Google Analytics et Firebase

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

• Ajouter et utiliser le SDK Firebase pour Google Analytics

  • Implémentez la journalisation des événements personnalisée dans votre application.

  • Marquez les conversions pour les campagnes publicitaires personnalisées .

  • Incluez les données d'événement ecommerce_purchase dans le calcul des revenus pour les métriques ARPU et ARPPU .

  Pour en savoir plus, consultez le guide d' utilisation de Google Analytics et Firebase avec les applications AdMob .

• Utiliser d'autres produits Firebase dans votre application

  Après avoir ajouté le SDK Firebase pour Google Analytics, utilisez d'autres produits Firebase pour optimiser les annonces dans votre application.

  • Remote Config vous permet de modifier le comportement et l'apparence de votre application sans publier de mise à jour d'application, sans frais, pour un nombre illimité d'utilisateurs actifs quotidiens.

  • Les tests A/B vous donnent le pouvoir de tester les modifications apportées à l'interface utilisateur, aux fonctionnalités ou aux campagnes d'engagement de votre application pour savoir si elles ont un impact sur vos indicateurs clés (comme les revenus et la fidélisation) avant de déployer les modifications à grande échelle.

• Optimisez la monétisation des publicités 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 la mise en œuvre de l'annonce pour tous vos utilisateurs. Pour en savoir plus, consultez les didacticiels suivants :

  • Testez l'adoption d'un nouveau format d'annonce ( présentation | mise en œuvre ).

  • Optimiser la fréquence des annonces ( aperçu | mise en œuvre ).

Étape 6 : Choisissez un format d'annonce à mettre en œuvre dans votre application

AdMob propose un certain nombre de formats d'annonces différents. Vous pouvez donc choisir celui qui correspond le mieux à l'expérience utilisateur de votre application. Cliquez sur le bouton d'un format d'annonce pour afficher les instructions détaillées de mise en œuvre dans la documentation AdMob.

Bannière

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

Les bannières publicitaires restent à l'écran pendant que les utilisateurs interagissent avec l'application et peuvent s'actualiser automatiquement après un certain temps. Si vous débutez dans la publicité mobile, c'est un excellent point de départ.