Tutorial: misura le conversioni degli annunci iOS

Passaggio 3: avvia la misurazione delle conversioni sul dispositivo utilizzando Google Analytics

Ora che puoi raccogliere gli indirizzi email e i numeri di telefono degli utenti e che la tua app dispone dell'SDK di Google Analytics per Firebase, puoi utilizzare entrambi per iniziare a misurare le conversioni.

Chiama l'API

Chiama l'API di misurazione delle conversioni con l'indirizzo email o il numero di telefono acconsentito dal passaggio 1, che viene utilizzato per la misurazione delle conversioni degli annunci, senza consentire che le informazioni di identificazione personale lascino il dispositivo dell'utente.

Esistono due modi per avviare la misurazione:

• Utilizzo delle credenziali
• Utilizzo di credenziali con hash

Utilizza l'indirizzo email o il numero di telefono

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");

Utilizza un indirizzo email o un numero di telefono con hash

L'API accetterà indirizzi email e numeri di telefono sottoposti a hashing con SHA256. Puoi mantenere il controllo dei dati dell'utente eseguendo l'hashing nel codice prima di effettuare chiamate all'SDK.

Per utilizzare le credenziali con hash, normalizza indirizzi e numeri, sottoponili ad hash con SHA256, quindi chiama l'API.

Normalizza indirizzi email e numeri di telefono

Per gli indirizzi email , l'API di Google Analytics presuppone che venga eseguita una particolare normalizzazione prima dell'applicazione di SHA256, quindi segui questi passaggi per normalizzare i tuoi dati:

1. Converti l'intero indirizzo email in minuscolo.

2. Se l'indirizzo email termina con dominio @googlemail.com , sostituisci il dominio @googlemail.com con @gmail.com .

3. Per gli indirizzi che terminano con dominio @gmail.com (compresi quelli modificati nel passaggio precedente):

   1. Rimuovi tutti i punti dalla parte del nome utente.

   2. Effettua le seguenti sostituzioni nella parte del nome utente:

      • Per le lettere I o i, o la cifra 1, sostituire la lettera l
      • Per la cifra 0, sostituire la lettera o
      • Per la cifra 2, sostituire la lettera z
      • Per la cifra 5, sostituire la lettera s

Ad esempio, dopo la normalizzazione:

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

Per i numeri di telefono , i numeri devono essere già in formato E.164 (ovvero, prefisso con +, 1-3 cifre per il codice paese, massimo 12 cifre per il numero dell'abbonato) prima dell'hashing con SHA256.

Chiama l'API con credenziali con hash

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);

Verifica con i log di debug di Xcode (facoltativo)

Se hai abilitato la modalità debug, dopo aver chiamato l'API di avvio misurazione, assicurati che nella console di debug Xcode venga visualizzato un messaggio simile al seguente messaggio di registro:

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

In Firebase 9.6.0 o versioni successive, se hai abilitato la modalità debug e incluso l'argomento di avvio -DebugOnDeviceConversionMeasurement , la chiamata all'API initiateOnDeviceConversionMeasurement() simulerà una corrispondenza.

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

arrow_back_ios Passaggio 2 : integra Google Analytics Passaggio 4 : risoluzione e gestione dei problemi comuni arrow_forward_ios