1. Introduction
Dernière mise à jour:14/12/2020
Objectifs de l'atelier
Dans cet atelier de programmation, vous allez apprendre à implémenter des événements avec Google Analytics pour Firebase(GA4F) et à lancer des campagnes pour l'action via Google Ads.
Cet atelier de programmation explique comment implémenter des événements avec GA4F et les importer dans Google Ads. Si vous souhaitez apprendre à créer une application Android avec Firebase, consultez Chat adapté à la création de l'atelier de programmation Firebase pour Android.
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
- Lancez des campagnes Google Ads pour l'action avec des événements personnalisés.
Prérequis
- Android Studio version 3.6 ou 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
- Connectez-vous à Firebase.
Dans la console Firebase, cliquez sur "Ajouter un projet" (ou "Créer un projet"), puis nommez votre projet Firebase.
- 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.
- Sélectionnez un compte Google Analytics. Si vous en avez une, sélectionnez celle-ci ou créez-en une. Cliquez sur le bouton "Créer un projet".
- La compilation du projet Firebase est maintenant terminée.
À l'étape suivante, vous découvrirez comment ajouter Firebase à votre application Android.
3. Ajouter Firebase à votre application Android
Enregistrer l'application
- 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".
- Fournissez les informations requises.
Pour le nom du package Android, accédez au répertoire de l'application dans Android Studio, 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 prévoyez d'utiliser Google Sign-In ou Firebase Dynamic Links. Notez que ces fonctionnalités ne font pas partie de cet atelier de programmation. Pour en savoir plus sur les clés SHA-1, veuillez consulter ce document.
- Cliquez sur le bouton Enregistrer l'application.
Télécharger le fichier de configuration
- Cliquez sur le bouton Télécharger le fichier google-services.json pour télécharger le fichier de configuration
google-services.json
.
- Dans Android Studio, accédez au répertoire
app
, puis déplacez le fichiergoogle-services.json
(que vous venez de télécharger ci-dessus) dans le répertoireapp
. Revenez à la console Firebase, puis cliquez sur le bouton "Suivant".
Activer Firebase dans votre application
- Pour lire le fichier
google-services.json
généré par Firebase, vous avez besoin du plug-in Gradle des services Google. - Dans Android Studio, ouvrez
<project>/build.gradle
, puis ajoutez les lignes suivantes au 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
...
}
}
}
- Ouvrez
<project>/<app-module>/build.gradle
, puis ajoutez les lignes suivantes au fichier:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'
Vous avez terminé d'ajouter Firebase à votre application Android.
À l'étape suivante, vous découvrirez comment ajouter le SDK Firebase à votre application.
4. Ajouter le SDK Firebase à votre application
Au cours de cette étape, vous allez ajouter le SDK Firebase, en particulier 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 la bibliothèque Firebase sont associées à une version de nomenclature spécifique, consultez les notes de version correspondantes.
- Ouvrez
<project>/<app-module>/build.gradle
, puis ajoutez les lignes suivantes au 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, vous n'avez pas besoin d'indiquer la version de la bibliothèque Firebase Analytics si vous ne spécifiez que la version de la nomenclature. 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'
- Synchronisez maintenant votre application en cliquant sur le bouton
Sync Now
.
Vous avez terminé d'ajouter le SDK Firebase pour Google Analytics à votre application Android.
À l'étape suivante, vous allez apprendre à enregistrer les événements Firebase dans votre application Android.
5. Consigner des événements avec Firebase Analytics
Au cours de cette étape, vous allez apprendre à enregistrer des événements avec Firebase Analytics dans l'application Android.
Il existe deux façons de consigner les événements: à l'aide d'événements suggérés ou d'é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 (jeux, commerce, voyages, e-commerce, etc.). Certains événements suggérés nécessitent les paramètres qui leur sont associés. Grâce à ces paramètres, vous pouvez maximiser les informations disponibles dans vos rapports Firebase. ( Liste des événements suggérés)
- Déclarez l'objet FirebaseAnalytics en haut de l'activité:
private lateinit var firebaseAnalytics: FirebaseAnalytics
- Initialisez l'objet dans la méthode
onCreate()
:
firebaseAnalytics = Firebase.analytics
- Commencez à consigner les événements à l'aide de 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 consulter des données globales 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 connectés à votre application.
Vous pouvez utiliser Firebase Debugview à des fins de test et de débogage immédiats. DebugView vous permet d'afficher les données d'événement enregistrées par votre application sur les appareils de développement, quasiment en temps réel. Pour DebugView, veuillez consulter la section Événement de débogage.
Vous avez terminé l'enregistrement des événements dans votre application Android.
À l'étape suivante, vous découvrirez comment importer ces événements dans Google Ads.
6. Importer des événements Firebase dans Google Ads
Votre configuration Firebase pour Android est terminée, et vous êtes prêt à lancer la campagne pour applications avec les événements d'action enregistrés. Pour commencer, associez Firebase à Google Ads. Associer Firebase à Google Ads permet aux campagnes pour applications d'en savoir plus sur les audiences et d'améliorer les enseignements tirés de ces campagnes, ce qui entraîne généralement de meilleures performances et de meilleures conversions.
Associer Firebase et Google Ads
- Cliquez sur le bouton situé à côté de "Vue d'ensemble du projet" pour accéder aux paramètres de Firebase.
- Dans l'onglet "Intégrations", Google Ads et un bouton "Associer" sont affichés. Cliquez sur "Associer", puis sur "Continuer".
- Sélectionnez le compte Google Ads que vous souhaitez associer.
Vous avez maintenant terminé d'associer Firebase et Google Ads. Importez les événements Firebase dans Google Ads.
Importer des événements Firebase
- Dans la console Firebase, accédez au menu "Événements" et marquez l'événement que vous souhaitez importer en tant que conversion.
- Accédez maintenant à Google Ads et connectez-vous au compte que vous associez à Firebase.
- Dans Google Ads, accédez à Outils → Mesure → Conversions
- Cliquez sur le bouton +
.
- Sélectionnez Application → Propriétés Google Analytics 4 (Firebase), puis cliquez sur "Continuer".
- 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. - Vous venez d'importer un événement de conversion à partir de Firebase.
Vous avez terminé d'importer les événements Firebase dans Google Ads.
À l'étape suivante, vous découvrirez comment 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
- Accédez à l'onglet "Campagnes pour applications" de votre compte Google Ads actuel, puis créez une campagne en cliquant sur le bouton +.
- Nous allons lancer une campagne de promotion d'applications avec l'option "Installations d'applications". En bas de la page, sélectionnez l'application que vous souhaitez promouvoir, puis cliquez sur "Continuer".
- Dans la section "Enchères", si vous sélectionnez "Actions dans l'application" dans le menu déroulant, vous pouvez afficher les événements. Sélectionnez un ou plusieurs événements à privilégier.
- Définissez les autres paramètres de la campagne et c'est terminé.
8. Félicitations
Félicitations, vous avez intégré Firebase et Google Ads ! Cela vous aidera à 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