1. Introduction
Dernière mise à jour : 14/12/2020
Objectifs de l'atelier
Cet atelier de programmation explique comment implémenter des événements personnalisés avec le SDK iOS GA4F et lancer des campagnes d'action via Google Ads.
Cet atelier de programmation vous permet de découvrir l'ensemble du processus de création d'applications auquel nos clients sont confrontés. Si vous souhaitez découvrir Firebase iOS plus en douceur, 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émarrer un nouveau projet iOS Swift
Créez une application iOS Swift à partir d'un modèle simple. Vous modifierez cette application de démarrage pour créer l'application finale.
Commencez par lancer Xcode.
- 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.
- Sélectionnez "iOS" en haut de la boîte de dialogue.
- Dans la section "Application", sélectionnez "Application", puis cliquez sur "Suivant".
- 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 "Suivant" :
- Nom du produit: par exemple, ios-app
Xcode utilise le nom du produit que vous avez saisi pour nommer votre projet et l'application.
- Équipe: si ce champ n'est pas renseigné automatiquement, définissez l'équipe sur "Aucune".
- Nom de l'organisation: nom de votre organisation ou votre propre nom.
- Identifiant du lot : cette valeur est générée automatiquement en fonction du nom de votre produit et de l'identifiant de votre organisation.
- Langue: Swift
- Sélectionnez un emplacement pour enregistrer votre projet, puis cliquez sur "Créer".
- 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.
- 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".
- 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
- 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.
- Il est important d'indiquer l'ID du bundle iOS (voir l'étape suivante pour l'obtenir).
- Dans le projet Xcode de l'application iOS, sélectionnez l'application de premier niveau dans le navigateur de projets, puis sélectionnez l'onglet "General" (Général).
- La valeur du champ "Identifiant du bundle" correspond à l'ID du bundle iOS (un élément du type
com.yourcompany.yourproject
). Copiez cette valeur. - Dans la boîte de dialogue Firebase, collez l'ID de bundle copié dans le champ
iOS bundle ID
. - Cliquez sur Register App (Enregistrer l'application).
- Dans Firebase, suivez les instructions pour télécharger le fichier de configuration
GoogleService-Info.plist
.
- 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. - 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.
- Ouvrez une fenêtre de terminal et accédez à l'emplacement du projet Xcode de votre application.
- Créez un fichier Podfile si vous n'en possédez pas :
$ pod init
- Ouvrez votre fichier Podfile et ajoutez :
$ vi Podfile
$ pod 'Firebase/Analytics'
- Enregistrez le fichier et exécutez :
$ pod install
- 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
}
}
- 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
À cette étape, vous allez apprendre à consigner des événements personnalisés avec Firebase Analytics dans l'application iOS.
Firebase Analytics enregistre automatiquement certains événements pour vous. 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().
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 enregistré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 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 :
- Dans Xcode, sélectionnez Product > Scheme > Edit scheme (Produit > Schéma > Modifier le schéma).
- Sélectionnez Exécuter dans le menu de gauche.
- Sélectionnez l'onglet Arguments.
- 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 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" 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 Firebase-iOS est terminée. Vous pouvez lancer la campagne pour applications avec des événements d'action enregistrés. Pour commencer, associez 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.
- Cliquez sur le bouton situé à côté de "Vue d'ensemble du projet" pour accéder aux paramètres de Firebase.
- Dans l'onglet "Intégrations", Google Ads et un bouton "Associer" sont affichés. Cliquez sur "Associer", puis sur "Continuer".
- Sélectionnez un compte Google Ads.
La partie dans Firebase est maintenant terminée.
Accédez maintenant à Google Ads et connectez-vous.
- 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.
- Cliquez sur le bouton + pour ajouter une action de conversion.
- Sélectionnez les propriétés Google Analytics 4 (Firebase), puis cliquez sur "Continuer".
- 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.
- 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
- 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.
- Cette fois, nous allons lancer une campagne de promotion d'applications et sélectionner l'option "Installations d'applications".
- Recherchez votre application en fournissant le nom de l'application, du package ou de l'éditeur.
- 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.
- 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.
- 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 et Google Ads ! Vous pourrez ainsi améliorer les performances de votre campagne.
Vous avez installé le script, créé et mis en scène une nouvelle liste de modifications d'atelier de programmation, mis à jour et mis en scène la liste de modifications d'atelier de programmation en attente, examiné et approuvé la liste de modifications d'atelier de programmation, puis envoyé et publié la liste de modifications d'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