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 pour 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 présentation plus détaillée de Firebase et d'AdMob sur iOS, commencez par lire le cours AdMob + Firebase 101 Unity: Configuration et configuration Principes de base d'Analytics.

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éer 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 "Créer un projet".
2. Sélectionnez des modèles 3D dans la boîte de dialogue.
3. Renseignez le champ Nom du projet: par exemple, Événement personnalisé Unity Firebase
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 Google Analytics n'est pas activé dans votre projet Firebase existant, 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 d'Unity

1. Dans Unity > Fichier > Paramètres de compilation. L'important est de définir 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 (Paramètres de compilation) (Si la plate-forme n'est pas définie sur iOS, vous pouvez sélectionner "iOS Platform" (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 "Player Settings" (Paramètres du lecteur) pour définir l'ID du bundle. Le champ de texte entoure la zone Identification.
4. La valeur du champ "Identifiant du bundle" correspond à l'ID du bundle iOS (un élément du type com.yourcompany.yourproject, par exemple). Copiez cette valeur ou définissez votre valeur 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 et 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. 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 à l'heure actuelle, vous pouvez toujours revenir au workflow de configuration ultérieurement 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 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 utilisé par votre projet. 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 pseudos 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 à l'emplacement qui vous convient.

• 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 (Importer un package) > Package personnalisé :
3. Dans le SDK décompressé, sélectionnez les produits Firebase compatibles que vous souhaitez utiliser dans votre application.

• Ajouter 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 les 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 cela, 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

Dans cette étape, vous allez apprendre à enregistrer des événements personnalisés avec Firebase Analytics dans l'application Unity pour 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

Après avoir configuré l'instance FirebaseApp, vous pouvez commencer à enregistrer des événements à l'aide de 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 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 > 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 Passed On Launch (Arguments transmis lors du 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

L'événement enregistré apparaîtra 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.

Vous allez marquer "text_search" comme conversion en faisant glisser le curseur sur "Marquer comme conversion" basculez vers la droite.

Pour vérifier si l'événement a bien été marqué comme conversion, accédez à l'onglet "Conversions" de Firebase Analytics. Si vous marquez l'événement 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. 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.

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. Accédez à Google Ads, connectez-vous, puis cliquez sur "Outils et Paramètres → Mesure → Conversions (importation d'é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 la case et 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 disposer d'une application de niveau 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. En attendant, nous allons lancer une campagne de promotion d'une application avec 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. Vous trouverez vos événements personnalisés dans la liste fournie. Définissez un coût par action cible, ainsi que les options souhaitées.

11. Configurez les paramètres de la campagne. Cela dépasse le cadre de l'atelier de programmation. Reportez-vous à ces documents ou contactez-nous par d'autres moyens pour optimiser les paramètres.

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 dans des campagnes pour l'action

Documents de référence

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