Google Ads avec Google Analytics pour les événements personnalisés Firebase – Android

1. Introduction

Dernière mise à jour : 2020-12-14

Ce que vous construirez

Dans cet atelier de programmation, vous apprendrez à mettre en œuvre des événements avec Google Analytics pour Firebase (GA4F) et à lancer des campagnes d'action via Google Ads.

Cet atelier de programmation se concentre sur la mise en œuvre d'événements avec GA4F et sur l'importation des événements dans Google Ads. Si vous souhaitez apprendre à créer une application Android avec Firebase, veuillez vous référer à Firebase Android Codelab-Build Friendly Chat .

Ce que vous apprendrez

  • Comment créer un projet Firebase
  • Comment implémenter le SDK Firebase dans l'application Android
  • Comment créer des événements et des paramètres.
  • Comment importer des événements de Firebase vers Google Ads
  • Lancez des campagnes d'action Google Ads avec des événements personnalisés.

Ce dont vous aurez besoin

  • Android Studio 3.6 ou supérieur
  • Compte Firebase
  • Compte Google Ads

2. Créez et configurez un projet Firebase

Pour démarrer avec Firebase, vous devrez créer et configurer un projet Firebase.

Créer un projet Firebase

  1. Connectez-vous à Firebase .

Dans la console Firebase, cliquez sur Ajouter un projet (ou Créer un projet) et nommez votre projet Firebase comme vous le souhaitez.

8525e77df3536fbb.png

  1. Cliquez sur les options de création de projet. Acceptez les conditions de Firebase si vous y êtes invité. Vous devez activer Google Analytics pour ce projet, car vous avez besoin d'événements Google Analytics pour suivre les événements d'action et les conversions.

e58151a081f0628.png

Pour en savoir plus sur les projets Firebase, consultez Comprendre les projets Firebase .

  1. Choisissez le compte Google Analytics. Si vous en avez un, choisissez-le ou créez-en un nouveau. Cliquez sur le bouton Créer un projet.

ac928e5947ba7cbf.png

  1. La construction du projet Firebase est désormais terminée !

À l'étape suivante, vous apprendrez comment ajouter Firebase à votre application Android.

3. Ajoutez Firebase à votre application Android

Enregistrer l'application

  1. Dans la console Firebase, sélectionnez Présentation du projet dans le menu de gauche, puis cliquez sur le bouton Android sous « Commencer par ajouter Firebase à votre application ».

6cbb33ad3e7c9132.png

  1. Remplissez les informations nécessaires.

3b7d3b33d81fe8ea.png

Pour le nom du package Android, dans le studio Android, accédez au répertoire de l'application, ouvrez un nom de fichier build.gradle . Dans le fichier, recherchez applicationId . Cette valeur est le nom du package Android. Copiez cette valeur et collez-la.

Nous n'avons pas besoin de la clé SHA-1 ici, sauf si vous prévoyez d'utiliser Google Sign In ou Firebase Dynamic Links (notez que ceux-ci ne font pas partie de cet atelier de programmation, pour plus d'informations sur la clé SHA-1, veuillez vous référer à ce document .) .

  1. Cliquez sur le bouton Enregistrer l'application.

Télécharger le fichier de configuration

  1. Cliquez sur le bouton Télécharger google-services.json pour télécharger le fichier de configuration google-services.json .

52f08aa18c8d59d0.png

  1. Dans le studio Android, accédez au répertoire app et déplacez le fichier google-services.json (que vous venez de télécharger ci-dessus) dans le répertoire app . De retour à la console Firebase, cliquez sur le bouton Suivant.

Activez Firebase dans votre application

  1. Vous avez besoin du plugin Google Services Gradle pour lire le fichier google-services.json généré par Firebase.
  2. Dans Android studio, ouvrez <project>/build.gradle , puis ajoutez les lignes suivantes dans le fichier :
buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}
  1. Ouvrez <project>/<app-module>/build.gradle , puis ajoutez les lignes suivantes dans le fichier :
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

Vous avez maintenant terminé d’ajouter Firebase à votre application Android !

À l'étape suivante, vous apprendrez comment ajouter le SDK Firebase à votre application.

4. Ajoutez le SDK Firebase à votre application

Au cours de cette étape, vous ajouterez le SDK Firebase, en particulier le SDK Firebase pour Google Analytics.

Nous utiliserons la BoM Android Firebase qui vous permet de gérer les versions de la bibliothèque Firebase que vous utilisez dans votre application en spécifiant la version de la BoM. Pour savoir quelles versions de la bibliothèque Firebase sont mappées à une version spécifique de la BoM, consultez les notes de version de cette version de la BoM.

  1. Ouvrez <project>/<app-module>/build.gradle , puis ajoutez les lignes suivantes dans le fichier :
dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

Comme vous pouvez le voir, en spécifiant uniquement la version de la BoM, vous n'avez pas besoin de spécifier la version de la bibliothèque Firebase Analytics. Mais si vous souhaitez utiliser la version souhaitée pour votre bibliothèque Firebase quelle que soit la version désignée dans le BoM, il vous suffit de préciser la version souhaitée comme ceci :

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
  1. Synchronisez maintenant votre application en cliquant sur le bouton Sync Now . 937206076c88ae5c.png

Vous avez maintenant terminé d'ajouter le SDK Firebase pour Google Analytics à votre application Android !

À l'étape suivante, vous apprendrez comment enregistrer les événements Firebase dans votre application Android.

5. Enregistrez les événements avec Firebase Analytics

Dans cette étape, vous apprendrez à enregistrer des événements avec Firebase Analytics dans l'application Android.

Il existe deux manières de consigner les événements : en utilisant des événements suggérés ou des événements personnalisés.

Utiliser les événements suggérés

Le SDK Firebase Analytics définit un certain nombre d'événements suggérés qui peuvent être utilisés dans différents types d'applications telles que les jeux, la vente au détail, les voyages et le commerce électronique. Certains événements suggérés nécessitent également les paramètres prescrits et, avec ces paramètres, vous pouvez maximiser les détails disponibles dans vos rapports Firebase. ( Référence d'événements suggérés )

  1. Déclarez l'objet FirebaseAnalytics en haut de l'activité :
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. Initialisez l'objet dans la méthode onCreate() :
firebaseAnalytics = Firebase.analytics
  1. Commencez à enregistrer les événements avec la méthode logEvent() . Le code suivant enregistre un événement PURCHASE lorsqu'un utilisateur achète un ou plusieurs articles dans l'application :
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

Utiliser des événements personnalisés

Si vous avez besoin d'événements non couverts par les événements suggérés, vous pouvez enregistrer vos propres événements personnalisés avec des paramètres personnalisés :

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

Événements de débogage

Vous pouvez afficher des données agrégées et des rapports sur vos événements dans la console Firebase. Mais les mises à jour ont lieu périodiquement tout au long de la journée, vous ne pouvez pas visualiser ces événements immédiatement après les avoir connectés à votre application.

À des fins de test et de débogage immédiats, vous pouvez utiliser Firebase Debugview. DebugView vous permet de voir les données d'événements enregistrées par votre application sur les appareils de développement en temps quasi réel. Pour DebugView, veuillez vous référer à la section Événement de débogage .

Vous avez maintenant terminé la journalisation des événements sur votre application Android !

À l'étape suivante, vous apprendrez comment importer ces événements dans Google Ads.

6. Importez des événements Firebase dans Google Ads

Votre configuration Firebase-Android est terminée et vous êtes prêt à lancer la campagne pour applications avec les événements d'action enregistrés. Vous commencerez par associer Firebase à Google Ads. En associant Firebase à Google Ads, les campagnes pour applications pourront en apprendre davantage sur les audiences et améliorer les enseignements des campagnes pour applications, ce qui conduit généralement à de meilleures performances et conversions.

  1. Accédez aux paramètres Firebase en cliquant sur le bouton juste à côté de Présentation du projet.

412830708c61fdc0.png

  1. Dans l'onglet Intégrations, vous verrez Google Ads et un bouton Lien. Cliquez sur Lien et Continuer.

796c921fb2b873ae.png

  1. Choisissez le compte Google Ads que vous souhaitez associer.

Vous avez maintenant terminé d'associer Firebase et Google Ads. Importons les événements Firebase dans Google Ads.

Importer des événements Firebase

  1. Dans la console Firebase, accédez au menu Événements et marquez l'événement que vous souhaitez importer en tant que conversion.

a5f302ba01a1863c.png

  1. Maintenant, accédez à Google Ads et connectez-vous au compte que vous associez à Firebase.
  2. Dans Google Ads, accédez à Outils → Mesure → Conversions 7acf268d7e799a7e.png
  3. Cliquez sur le bouton + d0eed72946d038d8.png
  4. Choisissez Application → Propriétés Google Analytics 4 (Firebase) et cliquez sur Continuer. 983f06edb15724de.png
  5. Vous pouvez voir tous les événements d'analyse marqués comme conversions. Recherchez l'événement que vous souhaitez importer. Dans ce cas, choisissez l'événement delete_item que nous avons déjà implémenté. Cliquez sur le bouton Importer et continuer. f9bdee80c0d40999.png
  6. Vous avez importé avec succès un événement de conversion depuis Firebase. be75f6a11913236.png

Vous avez maintenant terminé l'importation des événements Firebase dans Google Ads.

À l'étape suivante, vous apprendrez comment lancer une campagne d'action avec l'événement que vous venez d'importer.

7. Lancement de campagnes d'action d'application avec des événements importés

  1. Accédez à l'onglet Campagnes pour applications de votre compte Google Ads actuel et démarrez une nouvelle campagne en cliquant sur le bouton +.

19856a65ab999ad7.png

  1. Nous lancerons une campagne de promotion d'applications avec l'option Installations d'applications. En bas, choisissez l'application que vous souhaitez promouvoir et cliquez sur Continuer. 8146b5a7a4f961bd.png
  2. Dans la section Enchères, si vous sélectionnez Actions dans l'application dans le menu déroulant, vous pouvez afficher les événements. Choisissez un ou plusieurs événements sur lesquels vous souhaitez vous concentrer.

b75e410c7dbdfec8.png

  1. Définissez le reste des paramètres de la campagne et c'est terminé.

8. Félicitations

Félicitations, vous avez réussi à intégrer votre Firebase et Google Ads ! Cela vous aidera à améliorer les performances de votre campagne.

Vous avez appris

  • Comment configurer Firebase Analytics pour Android
  • Comment enregistrer des événements avec Firebase Analytics dans une application Android.
  • Comment importer des événements et les utiliser pour des campagnes d'action.