Tutoriel: Mesurer les conversions Ads iOS

Étape 3: Lancer la mesure des conversions sur les appareils à l'aide de Google Analytics

Introduction : Mesurer les conversions des annonces iOS

étape 1 : Implémentez une expérience de connexion

Étape 2: Intégrez Google Analytics

Étape 3: Lancer la mesure des conversions sur l'appareil à l'aide de Google Analytics

Étape 4 : Résolvez les problèmes courants et gérez-les

Maintenant que vous pouvez collecter les adresses e-mail et les numéros de téléphone des utilisateurs, et que votre application dispose du SDK Google Analytics pour Firebase, vous pouvez utiliser ces deux éléments pour commencer à mesurer les conversions.

Appeler l'API

Appelez l'API de mesure des conversions avec l'adresse e-mail ou le numéro de téléphone consenti à l'étape 1, qui est utilisé pour mesurer les conversions des annonces, sans autoriser aucune information permettant d'identifier personnellement l'utilisateur à quitter l'appareil.

Il existe deux façons de lancer la mesure:

• Utiliser des identifiants
• Utiliser des identifiants hachés

Utiliser une adresse e-mail ou un numéro de téléphone

Swift

Importez le module FirebaseAnalytics et transmettez l'adresse e-mail ou le numéro de téléphone à l'API initiateOnDeviceConversionMeasurement().

Remarque :Les méthodes initiateOnDeviceConversionMeasurement(emailAddress:) et initiateOnDeviceConversionMeasurement(phoneNumber:) peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une des API, les appels d'API suivants sont effectivement ignorés.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "[e-mail]")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "[phone]")

Objective-C

Importez le module FirebaseAnalytics et transmettez l'adresse e-mail à l'API initiateOnDeviceConversionMeasurementWithEmailAddress: ou le numéro de téléphone à l'API initiateOnDeviceConversionMeasurementWithPhoneNumber:.

Remarque :Les méthodes initiateOnDeviceConversionMeasurementWithEmailAddress: et initiateOnDeviceConversionMeasurementWithPhoneNumber: peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une des API, les appels d'API suivants sont effectivement ignorés.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

Unity

Importez l'espace de noms Firebase.Analytics et transmettez l'adresse e-mail à l'API InitiateOnDeviceConversionMeasurementWithEmailAddress() ou le numéro de téléphone à l'API InitiateOnDeviceConversionMeasurementWithPhoneNumber():

Remarque :Les méthodes InitiateOnDeviceConversionMeasurementWithEmailAddress() et InitiateOnDeviceConversionMeasurementWithPhoneNumber() peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une des API, les appels d'API suivants sont effectivement ignorés.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

Remarque:La mise en correspondance de l'adresse e-mail et du numéro de téléphone ne doit avoir lieu qu'une seule fois par installation sur l'appareil. Idéalement, la mise en correspondance doit avoir lieu le plus près possible de la connexion.

Important:Si une action ou un événement prévus dans l'application se produisent immédiatement après l'enregistrement de l'adresse e-mail ou du numéro de téléphone de l'utilisateur, envisagez d'implémenter un léger délai entre le lancement de la mesure des conversions sur l'appareil et la journalisation de l'événement.

Utiliser une adresse e-mail ou un numéro de téléphone hachés

L'API accepte les adresses e-mail et les numéros de téléphone hachés avec SHA256. Vous pouvez conserver le contrôle des données de vos utilisateurs en effectuant le hachage dans votre code avant d'effectuer des appels au SDK.

Pour utiliser des identifiants hachés, normalisez les adresses et les nombres, hachez-les avec SHA256, puis appelez l'API.

Normaliser les adresses e-mail et les numéros de téléphone

Pour les adresses e-mail, l'API Google Analytics suppose qu'une normalisation particulière est effectuée avant l'application de SHA256. Suivez donc ces étapes pour normaliser vos données:

1. Convertissez l'intégralité de l'adresse e-mail en minuscules.

2. Si l'adresse e-mail se termine par le domaine @googlemail.com, remplacez le domaine @googlemail.com par @gmail.com.

3. Pour les adresses se terminant par le domaine @gmail.com (y compris celles modifiées à l'étape précédente):

   1. Supprimez tous les points de la partie du nom d'utilisateur.

   2. Effectuez les remplacements suivants dans la partie du nom d'utilisateur:

      • Remplacez les lettres I ou i, ou le chiffre 1, par la lettre l.
      • Remplacez le chiffre 0 par la lettre o.
      • Pour le chiffre 2, remplacez la lettre z.
      • Remplacez le chiffre 5 par la lettre s.

Par exemple, après normalisation:

• [e-mail] devient [e-mail]
• [e-mail] devient [e-mail]

Pour les numéros de téléphone, ils doivent déjà être au format E.164 (c'est-à-dire précédés du signe plus +, 1 à 3 chiffres pour le code pays et 12 chiffres maximum pour le numéro de l'abonné) avant d'être hachés avec SHA256.

Appeler l'API avec des identifiants hachés

Swift

Importez le module FirebaseAnalytics et transmettez l'adresse e-mail ou le numéro de téléphone à l'API initiateOnDeviceConversionMeasurement().

Remarque :Les méthodes initiateOnDeviceConversionMeasurement(hashedEmailAddress:) et initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une ou l'autre des API, l'appel d'API suivant est effectivement ignoré.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

Objective-C

Importez le module FirebaseAnalytics et transmettez l'adresse e-mail à l'API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: ou le numéro de téléphone à l'API initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:.

Remarque :Les méthodes initiateOnDeviceConversionMeasurementWithHashedEmailAddress: et initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une des API, les appels d'API suivants sont effectivement ignorés.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

Unity

Importez l'espace de noms Firebase.Analytics et transmettez l'adresse e-mail à l'API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() ou le numéro de téléphone à l'API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

Remarque :Les méthodes InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() et InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() peuvent être appelées de manière séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est trouvée avec l'une des API, les appels d'API suivants sont effectivement ignorés.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

Remarque:La mise en correspondance de l'adresse e-mail et du numéro de téléphone ne doit avoir lieu qu'une seule fois par installation sur l'appareil. Dans l'idéal, la mise en correspondance est effectuée le plus près possible de la connexion.

Important:Sachez que si une action ou un événement prévu se produit immédiatement après l'inscription d'un utilisateur ou d'un numéro de téléphone, envisagez de définir un court délai entre le lancement de la mesure des conversions sur l'appareil et la journalisation de l'événement.

Vérifier avec les journaux de débogage Xcode (facultatif)

Si vous avez activé le mode débogage, après avoir appelé l'API de démarrage de la mesure, assurez-vous qu'un message semblable au message de journal suivant s'affiche dans la console de débogage Xcode:

9.0.0 - [FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

Dans Firebase 9.6.0 ou version ultérieure, si vous avez activé le mode débogage et inclus l'argument de lancement -DebugOnDeviceConversionMeasurement, l'appel de l'API initiateOnDeviceConversionMeasurement() simulera une correspondance.

9.6.0 - [FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

---

Étape 2: Intégrer Google Analytics Étape 4: Résoudre les problèmes courants et les gérer

---