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

1. Introduction

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

Objectifs de l'atelier

Cet atelier de programmation explique comment implémenter des événements avec Google Analytics pour Firebase(GA4F) et lancer des campagnes d'action via Google Ads.

Cet atelier de programmation explique comment implémenter des événements avec GA4F et les importer dans Google Ads. Pour savoir comment créer une application Android avec Firebase, consultez l'atelier de programmation Firebase Android : créer une discussion conviviale.

Points abordés

• Créer un projet Firebase
• Implémenter le SDK Firebase dans une application Android
• Créer des événements et des paramètres
• Importer des événements depuis Firebase vers Google Ads
• Lancer des campagnes d'action Google Ads avec des événements personnalisés

Prérequis

• Android Studio 3.6 ou version ultérieure
• Compte Firebase
• Compte Google Ads

2. Créer et configurer un projet Firebase

Pour commencer à utiliser Firebase, vous devez 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"), puis nommez votre projet Firebase comme vous le souhaitez.

2. Cliquez sur les options souhaitées. Si vous y êtes invité, acceptez les conditions d'utilisation de Firebase. Nous vous conseillons d'activer Google Analytics pour ce projet, car vous aurez besoin d'événements Google Analytics pour suivre les événements d'action et les conversions.

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

3. Choisissez un compte Google Analytics. Si vous en avez un, sélectionnez-le ou créez-en un. Cliquez sur le bouton "Créer un projet".

4. La compilation du projet Firebase est maintenant terminée.

À l'étape suivante, vous allez apprendre à ajouter Firebase à votre application Android.

3. Ajouter Firebase à votre application Android

Enregistrer une application

1. Dans la console Firebase, sélectionnez "Vue d'ensemble du projet" dans le menu de navigation de gauche, puis cliquez sur le bouton Android sous "Lancez-vous en ajoutant Firebase à votre application".

2. Renseignez les informations nécessaires.

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

La clé SHA-1 n'est pas nécessaire ici, sauf si vous comptez utiliser Google Sign In ou Firebase Dynamic Links (notez que ces fonctionnalités ne sont pas utilisées dans cet atelier de programmation). Pour en savoir plus sur la clé SHA-1, consultez ce document.

3. 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.

2. Dans Android Studio, 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. Dans la console Firebase, cliquez sur le bouton "Suivant".

Activer Firebase dans votre application

1. Vous avez besoin du plug-in Gradle des services Google 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
      ...
      }
   }
}

3. 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 ajouté Firebase à votre application Android.

Dans l'étape suivante, vous allez apprendre à ajouter le SDK Firebase à votre application.

4. Ajouter le SDK Firebase à votre application

À cette étape, vous allez ajouter le SDK Firebase, plus précisément le SDK Firebase pour Google Analytics.

Nous utiliserons la nomenclature Firebase Android, 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 nomenclature. Pour savoir quelles versions de bibliothèque Firebase sont mappées à une version de nomenclature spécifique, consultez les notes de version de cette version de nomenclature.

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 constater, en ne spécifiant que la version de la nomenclature, vous n'avez pas besoin de spécifier la version de la bibliothèque Firebase Analytics. Toutefois, si vous souhaitez utiliser la version souhaitée pour votre bibliothèque Firebase, quelle que soit la version désignée dans la nomenclature, il vous suffit de spécifier la version souhaitée comme suit:

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'

2. Synchronisez maintenant votre application en cliquant sur le bouton Sync Now.

Vous avez maintenant ajouté le SDK Firebase pour Google Analytics à votre application Android.

À l'étape suivante, vous allez apprendre à consigner des événements Firebase dans votre application Android.

5. Consigner des événements avec Firebase Analytics

À cette étape, vous allez apprendre à consigner des événements avec Firebase Analytics dans l'application Android.

Il existe deux façons de journaliser des événements: à l'aide d'événements suggérés ou d'événements personnalisés.

Utiliser les suggestions d'événements

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, comme les jeux, le commerce de détail, les voyages et l'e-commerce. Certains événements suggérés nécessitent des paramètres prescrits. Grâce à ces paramètres, vous pouvez maximiser les informations disponibles dans vos rapports Firebase. ( Documentation de référence sur les événements suggérés)

1. Déclarez l'objet FirebaseAnalytics en haut de l'activité:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. Initialisez l'objet dans la méthode onCreate():

firebaseAnalytics = Firebase.analytics

3. Commencez à enregistrer des é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 suggestions, 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 consulter des données agrégées et des rapports sur vos événements dans la console Firebase. Toutefois, les mises à jour ont lieu régulièrement tout au long de la journée. Vous ne pouvez donc pas afficher ces événements immédiatement après les avoir enregistrés dans votre application.

Pour tester et déboguer immédiatement l'application, vous pouvez utiliser Firebase DebugView. DebugView vous permet d'afficher les données d'événement enregistrées par votre application sur les appareils de développement en temps quasi réel. Pour DebugView, consultez la section Événement de débogage.

Vous avez maintenant terminé de consigner des événements dans votre application Android.

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

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

La configuration Firebase-Android est terminée. Vous pouvez maintenant lancer la campagne pour applications avec des événements d'action enregistrés. Vous devez d'abord associer Firebase à Google Ads. En associant Firebase à Google Ads, les campagnes pour applications pourront en savoir plus sur les audiences et améliorer leurs apprentissages, ce qui se traduit généralement par de meilleures performances et des conversions plus nombreuses.

Associer Firebase et Google Ads

1. Cliquez sur le bouton situé à côté de "Vue d'ensemble du projet" pour accéder aux paramètres de Firebase.

2. Dans l'onglet "Intégrations", Google Ads et un bouton "Associer" sont affichés. Cliquez sur "Associer", puis sur "Continuer".

3. Sélectionnez le compte Google Ads que vous souhaitez associer.

Vous avez maintenant associé Firebase et Google Ads. Importons des é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 comme conversion.

2. Accédez maintenant à Google Ads et connectez-vous au compte que vous associez à Firebase.
3. Dans Google Ads, accédez à Outils → Mesure → Conversions 
4. Cliquez sur le bouton + .
5. Sélectionnez "Application" → "Propriétés Google Analytics 4 (Firebase)", puis cliquez sur "Continuer".
6. Vous pouvez consulter 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 implémenté précédemment. Cliquez sur le bouton "Importer et continuer".
7. Vous avez bien importé un événement de conversion à partir de Firebase.

Vous avez maintenant terminé d'importer des événements Firebase dans Google Ads.

À l'étape suivante, vous allez apprendre à lancer une campagne pour l'action avec l'événement que vous venez d'importer.

7. Lancer des campagnes d'action dans l'application avec des événements importés

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

2. Nous allons lancer une campagne de promotion d'applications et sélectionner l'option "Installations d'applications". En bas de la page, sélectionnez l'application que vous souhaitez promouvoir, puis cliquez sur "Continuer".
3. 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.

4. Définissez les autres paramètres de la campagne, et le tour est joué.

8. Félicitations

Félicitations, vous avez intégré Firebase et Google Ads ! Vous pourrez ainsi améliorer les performances de votre campagne.

Ce que vous avez appris

• Configurer Firebase Analytics pour Android
• Consigner des événements avec Firebase Analytics dans une application Android
• Importer des événements et les utiliser pour des campagnes d'action