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

Cet atelier de programmation explique comment implémenter des événements personnalisés avec Google Analytics pour Firebase sur 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 de développement d'applications auquel nos clients sont confrontés. Pour une introduction plus douce à Firebase et AdMob sur iOS, commencez par Présentation d'AdMob et de Firebase pour Unity : configuration et principes de base des données analytiques.

Points abordés

• Initialiser GA4F (Google Analytics pour Firebase) dans Unity et iOS.
• Créer des événements et des paramètres personnalisés
• Importer des événements de 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 nouveau projet Unity

Créez une application Unity simple basée sur 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 "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, Événement personnalisé Firebase Unity).
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 avez déjà un projet Firebase et que Google Analytics n'est pas activé, vous pouvez l'activer dans 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), La valeur importante est l'ID du bundle iOS, que vous obtiendrez à l'étape suivante.

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, puis cliquer sur le bouton Switch Platform (Changer de plate-forme).

3. Après avoir changé de plate-forme, cliquez sur le bouton "Paramètres du lecteur" pour définir l'ID de lot. Vous pouvez voir le champ de texte autour de la zone Identification.
4. La valeur du champ "Bundle Identifier" correspond à l'ID du bundle iOS (par exemple, com.yourcompany.yourproject). Copiez cette valeur ou définissez-en une et copiez-la.
5. Dans la boîte de dialogue Firebase, collez l'ID de 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

Au cours de cette étape, vous allez 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 workflow de configuration. Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter une application pour afficher les options de la plate-forme.
3. Sélectionnez la cible de compilation de votre projet Unity que vous souhaitez enregistrer, ou vous pouvez même enregistrer les deux cibles en même temps.

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

4. Saisissez les ID propres à la plate-forme de votre projet Unity.

• Pour iOS : saisissez l'ID iOS de votre projet Unity dans le champ ID de 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 identifiant d'application sont souvent utilisés de façon interchangeable.

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

Remarque : Veillez à 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 ont été enregistrées dans votre projet Firebase.

6. (Facultatif) Saisissez le ou les surnoms spécifiques à la plate-forme de votre projet Unity. Ces pseudos sont des identifiants internes de commodité, qui 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 Download Firebase Unity SDK (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 (Éléments) > Import Package (Importer un package) > Custom 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 de 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 les 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, dans le workflow de configuration, cliquez sur Next (Suivant).

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

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

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

Firebase Analytics enregistre automatiquement certains événements à votre place. 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 vous aider à vérifier que les événements sont consignés correctement. 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 Exécuter dans le menu de gauche.
3. Sélectionnez l'onglet Arguments.
4. Dans la section 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

Votre événement consigné s'affichera dans la console Firebase dans quelques heures. Il se trouve dans Analytics → Événements. Vous pouvez également trouver les valeurs des paramètres en cliquant sur l'événement.

Pour marquer "text_search" comme 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" d'Analytics Firebase. En le marquant comme conversion, Google Ads pourra également l'importer en tant que conversion.

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

La configuration de Firebase pour iOS est terminée, et vous êtes prêt à lancer la campagne pour applications avec les événements d'action enregistrés. Commencez par 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.

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 maintenant à Google Ads et connectez-vous.

1. Pour importer des événements personnalisés en tant que conversions, accédez à Google Ads, connectez-vous, puis accédez à Outils et paramètres → Mesure → 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 qui cible 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 télécharger une application de production dans Google Play. Si vous n'êtes pas prêt à publier l'application, laissez 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 et continuez.
7. Cette fois, nous allons lancer une campagne de promotion d'applications et sélectionner l'option "Installations d'applications".

8. Recherchez votre application en fournissant le nom de l'application, du package ou de l'éditeur.
9. Dans la section "Enchères", sélectionnez "Actions dans l'application" dans la boîte de dépôt pour que les annonces ciblent les actions.
10. Votre événement personnalisé figure 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 le biais de tout autre canal.

9. Félicitations

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

Ce que vous avez appris

• Configurer Firebase pour la plate-forme iOS Unity
• 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