Tutoriel: Mesurer les conversions Ads iOS

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

Introduction: Mesurer les conversions iOS Ads

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

Étape 2: Intégrez Google Analytics

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

Étape 4: Résoudre et gérer les problèmes courants

Maintenant que vous pouvez collecter adresses e-mail et numéros de téléphone, et que votre application dispose Google Analytics pour le SDK Firebase, vous pouvez utiliser les deux en mesurant 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 l'adresse e-mail ou le numéro de téléphone

Swift Objective-C Unity

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 ou l'autre 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]")

Importez le module FirebaseAnalytics et transmettez l'adresse e-mail à l'API initiateOnDeviceConversionMeasurementWithEmailAddress: ou le 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]"];

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

Remarque :Les commandes InitiateOnDeviceConversionMeasurementWithEmailAddress() et Les méthodes 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 ou l'autre 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 être effectuée qu'une seule fois par installation sur le appareil, et la mise en correspondance s'effectue idéalement le plus près possible de la connexion.

Important :Si une action ou un événement prévus dans l'application se produit, immédiatement après l'inscription d'un utilisateur par e-mail ou par téléphone, envisagez d'implémenter un un délai court entre le lancement de la mesure des conversions sur les appareils et journaliser 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 en SHA256. Toi peut 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'API Google Analytics suppose qu'un une normalisation particulière est effectuée avant l'application de SHA256. pour normaliser vos données:

1. Convertissez l'adresse e-mail complète 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 dans l'étape précédente):

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

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

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

Par exemple, après normalisation:

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

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

Appeler l'API avec des identifiants hachés

Swift Objective-C Unity

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 détecté avec l'une ou l'autre des API, les appels d'API suivants sont effectivement ignoré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)

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

Remarque :Les commandes initiateOnDeviceConversionMeasurementWithHashedEmailAddress: et initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: méthodes peuvent être sont appelées de façon séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est détecté avec l'une ou l'autre 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];

Importez l'espace de noms Firebase.Analytics et transmettez l'adresse e-mail à l'API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() ou à l'API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

Remarque :Les commandes InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() et InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() méthodes peuvent être sont appelées de façon séquentielle, mais une seule correspondance peut être signalée par utilisateur. Si une correspondance est détecté avec l'une ou l'autre 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 être effectuée qu'une seule fois par installation sur le appareil, et la mise en correspondance s'effectue idéalement le plus près possible de la connexion.

Important :Si une action ou un événement prévus dans l'application se produit, immédiatement après l'inscription d'un utilisateur par e-mail ou par téléphone, envisagez d'implémenter un un délai court entre le lancement de la mesure des conversions sur les appareils et journaliser 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 lancement de mesure, assurez-vous qu'un message semblable au suivant s'affiche dans l'outil de débogage Xcode console:

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 le paramètre l'argument de lancement -DebugOnDeviceConversionMeasurement, puis en appelant la méthode L'API initiateOnDeviceConversionMeasurement() simule une correspondance.

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

---

Étape 2: Intégrer Google Analytics Étape 4: Résolvez les problèmes courants et gérez-les.

---