Tutoriel: Mesurer les conversions Ads iOS

Étape 3 : Lancer la mesure des conversions sur les appareils à 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 Google Analytics pour Firebase SDK, 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 fourni à l'étape 1, qui est utilisé pour mesurer les conversions des annonces, sans autoriser la transmission d'informations permettant d'identifier personnellement l'utilisateur en dehors de son appareil.

Vous pouvez lancer la mesure de deux manières :

• À l'aide d'identifiants
• À l'aide d'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é

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 des 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'Google Analytics API 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 @googlemail.com domaine 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-les par la lettre l.
      • Pour le chiffre 0, remplacez-le par la lettre o.
      • Pour le chiffre 2, remplacez-le par la lettre z.
      • Pour le chiffre 5, remplacez-le 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, les numéros doivent déjà être au format E.164 (c'est-à-dire précédés de +, de 1 à 3 chiffres pour le code pays et de 12 chiffres maximum pour le numéro d'abonné) avant d'être hachés avec SHA256.

Notez que l'adresse e-mail ou le numéro de téléphone haché SHA256 doit 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 de mesure de lancement, assurez-vous qu'un message semblable au message de 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 de débogage et inclus l'argument de lancement -DebugOnDeviceConversionMeasurement, l'appel de l'API initiateOnDeviceConversionMeasurement() simulera une correspondance.

[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