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

1. Introduction

Dernière mise à jour : 19/02/2021

Objectifs de l'atelier

Dans cet atelier de programmation, vous allez apprendre à implémenter des événements personnalisés avec GA4F iOS dans l'environnement Unity et à lancer des campagnes d'action via Google Ads.

Tout au long de cet atelier de programmation, vous pourrez découvrir l'ensemble du processus d'activité des applications auquel nos clients sont confrontés. Si vous souhaitez une introduction plus simple à Firebase et AdMob sur iOS, commencez par AdMob+Firebase 101 Unity: Setup & Analytics Basics.

Points abordés

• Initialiser Google Analytics pour Firebase dans Unity + iOS
• Créer des événements et des paramètres personnalisés
• Importer des événements depuis Firebase vers Google Ads
• Lancer des campagnes d'action avec des événements personnalisés

Prérequis

• Xcode
• Unity
• Compte Firebase
• Compte Google Ads

2. Démarrer un projet Unity

Créez une application Unity simple à partir d'un modèle. Vous allez modifier cette application simple pour créer l'application finale.

Lancer Unity

1. Si vous n'avez pas de projets ouverts, sélectionnez "create a new project" (créer un projet).
2. Sélectionnez des modèles 3D dans la boîte de dialogue.
3. Renseignez le nom du projet (par exemple, Unity Firebase Custom Event).
4. Sélectionnez un emplacement pour enregistrer votre projet, puis cliquez sur CRÉER.
5. Unity ouvre votre nouveau projet dans la fenêtre de l'espace de travail.

3. Créer et configurer un projet Firebase

Pour commencer à utiliser Firebase, vous devez créer et configurer un projet Firebase.

Si vous disposez d'un projet Firebase existant dans lequel Google Analytics n'est pas activé, vous pouvez l'activer depuis l'onglet "Intégrations" de vos paramètres > Paramètres du projet. Passez à l'étape de configuration de Firebase.

1. Connectez-vous à Firebase.

Dans la console Firebase, cliquez sur "Ajouter un projet" (ou "Créer un projet"), puis nommez votre projet Firebase "Firebase-iOS-Ads".

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.

4. Configuration Unity

1. Dans Unity > File > Build Settings (Fichier > Paramètres de compilation). Il est important d'indiquer l'ID du bundle iOS (voir l'étape suivante pour l'obtenir).

La boîte de dialogue ci-dessous s'affiche.

2. Dans votre projet Unity pour l'application iOS, ouvrez la boîte de dialogue "Build Settings" (Paramètres de compilation) : File > Build Settings (Fichier > Paramètres de compilation). Si la plate-forme n'est pas définie sur iOS, vous pouvez sélectionner la plate-forme iOS et cliquer sur le bouton Switch Platform (Changer de plate-forme).

3. Après avoir changé de plate-forme, cliquez sur le bouton "Player Settings" (Paramètres du lecteur) pour définir l'ID du bundle. Vous pouvez voir le champ de texte autour de la zone Identification.
4. La valeur du champ "Identifiant du bundle" correspond à l'ID du bundle iOS (du type com.yourcompany.yourproject). Copiez cette valeur ou définissez la vôtre, puis copiez-la.
5. Dans la boîte de dialogue Firebase, collez l'ID du bundle copié dans le champ iOS bundle ID.
6. Cliquez sur Register App (Enregistrer l'application).
7. Dans Firebase, suivez les instructions pour télécharger le fichier de configuration GoogleService-Info.plist.
8. Ouvrez la fenêtre "Project" (Projet) de votre projet Unity, puis déplacez vos fichiers de configuration dans le dossier Assets (Éléments).
9. Ignorez les étapes restantes, puis revenez à la page principale de la console Firebase.

5. Configurer Firebase Analytics dans Unity

Dans cette étape, vous allez commencer à ajouter le SDK Firebase à votre projet Unity.

1. Accédez à la console Firebase.
2. Au centre de la page de présentation du projet, cliquez sur l'icône Unity ( ) pour lancer le processus de configuration. Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter une application pour afficher les options de plate-forme.
3. Sélectionnez la cible de build de votre projet Unity que vous souhaitez enregistrer. Vous pouvez même choisir d'enregistrer les deux cibles en même temps.

Remarque : Si vous n'enregistrez qu'une seule cible de build de votre projet Unity maintenant, vous pourrez toujours revenir au workflow de configuration plus tard pour enregistrer l'autre cible de build.

4. Saisissez le ou les ID spécifiques à la plate-forme de votre projet Unity.

• Pour iOS : saisissez l'ID iOS de votre projet Unity dans le champ ID du bundle iOS.
• Pour Android : saisissez l'ID Android de votre projet Unity dans le champ Nom du package Android. Les termes nom du package et ID de l'application sont souvent utilisés de manière interchangeable.

5. Où trouver l'ID de votre projet Unity ?

Remarque : Assurez-vous de saisir l'ID que votre projet utilise réellement. La valeur de l'ID est sensible à la casse et ne peut pas être modifiée pour ces applications Firebase une fois qu'elles sont enregistrées dans votre projet Firebase.

6. (Facultatif) Saisissez le ou les pseudonymes spécifiques à la plate-forme de votre projet Unity. Ces noms sont des identifiants internes pratiques. Ils ne sont visibles que par vous dans la console Firebase.
7. Cliquez sur Enregistrer l'application.

Ajouter les SDK Unity Firebase Analytics

1. Dans la console Firebase, cliquez sur Télécharger le SDK Unity Firebase, puis décompressez le SDK dans un emplacement pratique.

• Vous pouvez télécharger à nouveau le SDK Unity Firebase à tout moment.
• Le SDK Unity Firebase n'est pas spécifique à une plate-forme.

2. Dans votre projet Unity ouvert, accédez à Assets > Import Package > Custom Package (Éléments > Importer un package > Package personnalisé).
3. Dans le SDK décompressé, sélectionnez les produits Firebase compatibles que vous souhaitez utiliser dans votre application.

• Ajoutez le package Firebase pour Google Analytics : FirebaseAnalytics.unitypackage.
• Ajoutez les packages pour tous les autres produits Firebase que vous souhaitez utiliser dans votre application. Par exemple, pour utiliser Firebase Authentication et Firebase Realtime Database : FirebaseAuth.unitypackage et FirebaseDatabase.unitypackage

Unity 5.x et versions antérieures utilisent le framework .NET 3.x. Importez donc le package dotnet3/. Unity 2017.x et versions ultérieures permettent d'utiliser le framework .NET 4.x. Si votre projet Unity utilise .NET 4.x, importez le package dotnet4/. Unity 2019 et versions ultérieures ne sont plus compatibles avec le framework .NET 3.x. Importez donc le package dotnet4/.

4. Dans la fenêtre Import Unity Package (Importer un package Unity), cliquez sur Import (Importer).
5. De retour dans la console Firebase, cliquez sur Suivant dans le workflow de configuration.

Important : Avec le SDK Firebase Unity pour iOS, ne désactivez pas le swizzling de méthode. Le swizzling est requis par le SDK. Sans lui, les principales fonctionnalités de Firebase (comme la gestion des jetons FCM) ne fonctionnent pas correctement.

6. Consigner des événements personnalisés avec Firebase Analytics

Dans cette étape, vous allez apprendre à consigner des événements personnalisés avec Firebase Analytics dans l'application Unity iOS.

Firebase Analytics enregistre automatiquement certains événements. Vous n'avez pas besoin d'ajouter de code pour les recevoir. Si votre application doit collecter des données supplémentaires, vous pouvez enregistrer jusqu'à 500 types d'événements personnalisés Analytics différents dans votre application.

Consigner des événements

Une fois l'instance FirebaseApp configurée, vous pouvez commencer à consigner des événements avec la méthode logEvent().

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Afficher les événements dans la console de débogage Xcode

Vous pouvez activer la journalisation détaillée pour surveiller la journalisation des événements par le SDK et vérifier que les événements sont correctement enregistrés. Cela inclut les événements enregistrés automatiquement et manuellement.

Vous pouvez activer la journalisation détaillée comme suit :

1. Dans Xcode, sélectionnez Product > Scheme > Edit scheme… (Produit > Schéma > Modifier le schéma…).
2. Sélectionnez Run (Exécuter) dans le menu de gauche.
3. Sélectionnez l'onglet Arguments.
4. Dans la section Arguments Passed On Launch (Arguments transmis au lancement), ajoutez "-FIRAnalyticsDebugEnabled".

La prochaine fois que vous exécuterez votre application, vos événements s'afficheront dans la console de débogage Xcode, ce qui vous aidera à vérifier immédiatement que les événements sont envoyés.

Afficher les événements dans le tableau de bord

Dans quelques heures, vous pourrez voir votre événement consigné dans la console Firebase. Il se trouve dans Analytics > Événements. Vous pouvez également trouver les valeurs des paramètres en cliquant sur l'événement.

Pour marquer l'événement "text_search" en tant que conversion, faites glisser le bouton bascule "Marquer comme conversion" vers la droite.

Vous pouvez vérifier si l'événement a bien été marqué comme conversion dans l'onglet "Conversions" de Firebase Analytics. Une fois que vous avez marqué l'événement comme conversion, Google Ads peut également l'importer en tant que conversion.

7. Importer des événements d'analyse dans Google Ads

La configuration de Firebase-iOS est terminée. Vous pouvez lancer la campagne pour applications avec les é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 apprendre davantage sur les audiences et améliorer leurs connaissances, ce qui se traduit généralement par de meilleures performances et plus de conversions.

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 un compte Google Ads.

Attention : Si l'événement cible n'est pas marqué comme conversion, Google Ads ne pourra pas l'importer. Vérifiez s'il est bien marqué comme conversion.

La partie dans Firebase est maintenant terminée.

Accédez à Google Ads et connectez-vous.

1. Accédez à Google Ads, connectez-vous, puis accédez à Outils et paramètres > Mesure > Conversions pour importer des événements personnalisés en tant que conversions.
2. Cliquez sur le bouton "+" pour ajouter une action de conversion.

3. Sélectionnez les propriétés Google Analytics 4 (Firebase), puis cliquez sur "Continuer".

4. Vous pouvez consulter tous les événements d'analyse marqués comme conversions. Recherchez l'événement clicked_counter que nous avons implémenté précédemment.

5. Cochez l'événement, puis cliquez sur le bouton "Importer et continuer".

Après avoir défini text_search comme action de conversion, il est temps de lancer une campagne ciblant les utilisateurs susceptibles de déclencher des événements text_search.

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

Important : Pour lancer une campagne pour applications, vous devez disposer d'une application de production dans Google Play. Si vous n'êtes pas prêt à publier l'application, ignorez cette étape pour le moment.

6. Accédez à l'onglet "Campagne" de votre compte actuel et créez une campagne en cliquant sur le bouton "+". Cliquez sur la nouvelle campagne, puis continuez.
7. Pour le moment, nous allons lancer une campagne de promotion d'applications et sélectionner l'option "Installations d'applications".

8. Recherchez votre application en indiquant son nom, le nom du package ou l'éditeur.
9. Dans la section "Enchères", sélectionnez "Actions dans l'application" dans le menu déroulant pour que Ads se concentre sur les actions.
10. Vos événements personnalisés figurent dans la liste affichée. Définissez un coût par action cible, ainsi que les options souhaitées.

11. Configurez les paramètres de la campagne. Ce point n'est pas abordé dans cet atelier de programmation. Pour optimiser les paramètres, consultez ces documents ou contactez-nous par d'autres canaux.

9. Félicitations

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

Ce que vous avez appris

• Configurer Firebase pour la plate-forme Unity iOS
• Consigner des événements personnalisés avec Unity et Firebase Analytics
• Importer des événements et les utiliser pour des campagnes d'action

Documents de référence

• Ajouter Firebase à votre projet Unity
• GitHub : firebase/quickstart-unity