Événements personnalisés Google Ads avec Google Analytics pour Firebase – iOS

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 personnalisés avec le SDK GA4F pour iOS et à lancer des campagnes d'action via Google Ads.

Cet atelier de programmation vous permet de découvrir l'ensemble du processus commercial pour applications auquel nos clients sont confrontés. Si vous souhaitez une introduction plus simple à Firebase pour iOS, commencez par l'atelier de programmation Firebase pour iOS (Swift).

Points abordés

• Initialiser Google Analytics pour Firebase dans iOS Swift
• 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
• Compte Firebase
• Compte Google Ads

2. Démarrer un nouveau projet iOS Swift

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

Commencez par lancer Xcode.

1. Si vous n'avez pas de projets ouverts, sélectionnez "Create a new Xcode project" (Créer un projet Xcode) sur la page d'accueil.
2. Sélectionnez "iOS" en haut de la boîte de dialogue.
3. Dans la section "Application", sélectionnez "App", puis cliquez sur "Next" (Suivant).
4. Dans la boîte de dialogue qui s'affiche, utilisez les valeurs suivantes pour nommer votre application et choisir des options supplémentaires pour votre projet, puis cliquez sur "Next" (Suivant) :
5. Nom du produit : par exemple, ios-app

Xcode utilise le nom de produit que vous avez saisi pour nommer votre projet et l'application.

2. Équipe : si ce champ n'est pas rempli automatiquement, définissez l'équipe sur "None" (Aucune).
3. Nom de l'organisation : nom de votre organisation ou votre propre nom.
4. Identifiant du bundle : cette valeur est générée automatiquement en fonction du nom de votre produit et de l'identifiant de votre organisation.
5. Langue : Swift
6. Sélectionnez un emplacement pour enregistrer votre projet, puis cliquez sur "Create" (Créer).
7. Xcode 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.

Créer un projet Firebase

Si vous avez un projet Firebase existant où Google Analytics n'est pas activé, vous pouvez l'activer dans l'onglet "Intégrations" de "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 de Firebase

1. Dans la console Firebase, sélectionnez "Vue d'ensemble du projet" > "Paramètres du projet" dans le menu de navigation de gauche, puis cliquez sur le bouton iOS sous "Général" > "Vos applications".

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

2. La valeur importante à indiquer est l'ID du bundle iOS (voir l'étape suivante pour l'obtenir).
3. Dans votre projet Xcode pour l'application iOS, sélectionnez l'application de premier niveau dans le navigateur de projets, puis sélectionnez l'onglet "General" (Général).
4. La valeur du champ "Bundle Identifier" (Identifiant du bundle) correspond à l'ID du bundle iOS (par exemple, com.yourcompany.yourproject). Copiez cette valeur.
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. Accédez à votre projet Xcode, puis déplacez le fichier GoogleService-Info.plist (que vous venez de télécharger) à la racine de votre projet Xcode.
9. Ignorez les étapes restantes, puis revenez à la page principale de la console Firebase.

5. Configurer Firebase Analytics dans Xcode

Au cours de cette étape, vous allez commencer à ajouter le SDK Firebase à votre projet Xcode.

Remarque : Les services Google utilisent CocoaPods pour installer et gérer les dépendances. Si vous n'avez jamais utilisé CocoaPods auparavant, vous devez d'abord l'installer en exécutant la commande suivante dans votre terminal :

$ sudo gem install cocoapods

1. Ouvrez une fenêtre de terminal, puis accédez à l'emplacement du projet Xcode de votre application.
2. Créez un fichier Podfile si vous n'en possédez pas :

$ pod init

3. Ouvrez votre fichier Podfile et ajoutez :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Enregistrez le fichier et exécutez :

$ pod install

5. Ajoutez le code d'initialisation :

Pour associer Firebase au démarrage de votre application, ajoutez le code d'initialisation ci-dessous à votre classe AppDelegate principale.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Vous avez terminé. Accédez à la console.

Vous êtes maintenant prêt à déclencher des journaux d'événements personnalisés.

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

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

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

Consigner des événements

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Définir des paramètres d'événement par défaut

Vous pouvez consigner des paramètres pour tous les événements à l'aide de setDefaultEventParameters. Les paramètres par défaut sont associés à tous les événements futurs consignés.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

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

Vous pouvez activer la journalisation détaillée pour surveiller la consignation des événements par le SDK et vérifier qu'ils sont correctement consignés. Cela inclut les événements consigné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 permettra de vérifier immédiatement qu'ils 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" en tant que conversion, faites glisser le bouton bascule "Marquer comme conversion" vers la droite.

Vous pouvez vérifier que l'événement est bien 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 maintenant lancer la campagne pour applications avec des événements d'action consignés. Vous allez commencer par associer Firebase à Google Ads. Une fois cette association effectuée, les campagnes pour applications pourront en savoir plus sur les audiences et améliorer leur apprentissage, ce qui se traduit généralement par de meilleures performances et 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 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, vous pouvez 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 la liste déroulante pour que les annonces se concentrent 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 en savoir plus, consultez ces documents ou contactez-nous par d'autres canaux pour optimiser les paramètres.

9. Félicitations

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

Vous avez installé le script, créé et mis en scène une nouvelle liste de modifications pour l'atelier de programmation, mis à jour et mis en scène la liste de modifications en attente pour l'atelier de programmation, examiné et approuvé la liste de modifications pour l'atelier de programmation, puis envoyé et publié la liste de modifications pour l'atelier de programmation.

Ce que vous avez appris

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