Tutorial: misurare le conversioni degli annunci per iOS

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

Ora che sei in grado di raccogliere gli indirizzi email e i numeri di telefono degli utenti e che la tua app dispone dell'SDK Google Analytics per Firebase, puoi utilizzare i due strumenti 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 per cui è stato fornito il consenso nel passaggio 1, che viene utilizzato per la misurazione delle conversioni degli annunci, senza consentire alle informazioni che consentono l'identificazione personale di uscire dal dispositivo dell'utente.

Esistono due modi per avviare la misurazione:

• Utilizzare le credenziali
• Utilizzare le credenziali sottoposte ad hashing

Usa indirizzo email o 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");

Utilizzare un indirizzo email o un numero di telefono sottoposti ad hashing

L'API accetterà gli indirizzi email e i numeri di telefono sottoposti ad hashing con SHA256. Puoi mantenere il controllo dei dati degli utenti eseguendo l'hashing nel codice prima di chiamare l'SDK.

Per utilizzare le credenziali sottoposte ad hashing, normalizza indirizzi e numeri, esegui l'hashing con SHA256 e poi chiama l'API.

Normalizzare indirizzi email e numeri di telefono

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

1. Converti l'intero indirizzo email in minuscolo.

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

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

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

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

      • Per le lettere I o i o per il numero 1, sostituisci la lettera l
      • Per la cifra 0, sostituisci la lettera O
      • Per la cifra 2, sostituisci la lettera z
      • Per il numero 5, sostituisci la lettera S

Ad esempio, dopo la normalizzazione:

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

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

Chiama l'API con credenziali sottoposte ad hashing

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 attivato la modalità di debug, dopo aver chiamato l'API di avvio della misurazione, assicurati che nella console di debug di Xcode venga visualizzato un messaggio simile al seguente:

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

In Firebase 9.6.0 o versioni successive, se hai attivato la modalità di debug e hai 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_iosPassaggio 2: esegui l'integrazione di Google Analytics Passaggio 4: risolvi e gestisci i problemi comuniarrow_forward_ios