Tutoriel: Mesurer les conversions Ads 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 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 consentis à l'étape 1, qui sont utilisés pour la mesure des conversions d'annonces, sans autoriser la transmission d'informations permettant d'identifier personnellement l'utilisateur hors de son 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

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és

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

Pour utiliser des identifiants hachés, 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 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 du nom d'utilisateur :

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

Par exemple, après normalisation :

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

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

Notez que les adresses e-mail ou numéros de téléphone hachés SHA256 doivent comporter 32 octets et ne pas être une chaîne hexadécimale.

Appeler l'API avec des identifiants hachés

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érifier l'intégration

Activez le mode de débogage. Après avoir appelé l'API initiate measurement, assurez-vous qu'un message semblable à celui du journal suivant s'affiche dans la console de débogage Xcode :

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

Si vous avez activé le mode débogage et inclus l'argument de lancement -DebugOnDeviceConversionMeasurement, l'appel de l'API initiateOnDeviceConversionMeasurement() simulera un match.

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

arrow_back_iosÉtape 2 : Intégrer Google Analytics Étape 4 : Résoudre les problèmes courantsarrow_forward_ios