Tutoriel : Mesurer les conversions d'annonces iOS

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

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 les deux 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 la mesure des conversions publicitaires, sans permettre à aucune information personnelle identifiable de quitter l'appareil de l'utilisateur.

Il existe deux manières de lancer la mesure :

• Utilisation des informations d'identification
• Utiliser des informations d'identification hachées

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

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

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

L'API acceptera les adresses e-mail et les numéros de téléphone hachés avec SHA256. Vous pouvez garder le contrôle des données de votre utilisateur en effectuant le hachage dans votre code avant d'appeler le SDK.

Pour utiliser des informations d'identification hachées, normalisez les adresses et les numéros, 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 nom d'utilisateur.

   2. Effectuez les substitutions suivantes dans la partie nom d'utilisateur :

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

Par exemple, après normalisation :

• an.email.user0125@googlemail.com devient anemlluserolzs@gmail.com
• CAPSUSER0125@provider.net devient capsuser0125@provider.net

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

Appeler l'API avec des informations d'identification hachées

import FirebaseAnalytics

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

@import FirebaseAnalytics;

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

using Firebase.Analytics;

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

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

Si vous avez activé le mode débogage, après avoir appelé l'API d'initiation de mesure, assurez-vous qu'un message tel que le message de journal suivant apparaît 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

arrow_back_ios Étape 2 : Intégrer Google Analytics Étape 4 : Dépanner et gérer les problèmes courants arrow_forward_ios