É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 pour l'action via Google Ads.

Dans cet atelier de programmation, vous allez 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 iOS, commencez par l'atelier de programmation Firebase iOS Swift.

Points abordés

• Initialiser GA4F (Google Analytics pour Firebase) sous 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émarrez un nouveau projet iOS Swift

Créez une application iOS Swift à partir d'un modèle simple. Vous allez modifier cette application de démarrage 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 "Application", puis cliquez sur "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, application-ios

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 renseigné automatiquement, définissez l'équipe sur "Aucune".
3. Nom de l'organisation: nom de votre organisation ou votre propre nom.
4. Identifiant de groupe: cette valeur est générée automatiquement à partir du nom de votre produit et de l'identifiant de l'organisation.
5. Langue: Swift
6. Sélectionnez un emplacement pour enregistrer votre projet, puis cliquez sur "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 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 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 applis

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

2. La valeur importante à indiquer est l'ID du bundle iOS, que vous obtiendrez à l'étape suivante.
3. Dans le projet Xcode de l'application iOS, sélectionnez l'application de premier niveau dans le navigateur de projets, puis l'onglet "Général".
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.
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. 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 et revenez à la page principale de la console Firebase.

5. Configurer Firebase Analytics dans Xcode

Au cours de cette étape, vous allez 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 et 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 Podfile et ajoutez :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Enregistrez le fichier et exécutez la commande suivante :

$ pod install

5. Ajoutez le code d'initialisation :

Pour connecter 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 à enregistrer des événements personnalisés avec Firebase Analytics dans l'application 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().

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

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

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

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

Afficher des é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 et Google Ads ! Cela vous aidera à améliorer les performances de votre campagne.

Vous avez installé le script, créé et préparé une nouvelle liste de modifications de l'atelier de programmation, mis à jour et préparé la liste de modifications en attente de l'atelier de programmation, examiné et approuvé la liste de modifications de l'atelier de programmation, puis envoyé et publié la liste de modifications de 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 dans des campagnes pour l'action