Tutorial: misurare le conversioni degli annunci per iOS

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

Introduzione: Misurare le conversioni degli annunci per iOS

Passaggio 1: Implementa un'esperienza di accesso

Passaggio 2: integra Google Analytics

Passaggio 3. Avvia la misurazione delle conversioni sul dispositivo utilizzando Google Analytics

Passaggio 4 – Risolvere e gestire i problemi più comuni

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

Chiama l'API

Chiama l'API Conversion Measurement con l'indirizzo email o il telefono per i quali è stato fornito il consenso numero del Passaggio 1, che viene utilizzato per la misurazione delle conversioni degli annunci, senza consentendo a qualsiasi informazione che consente l'identificazione personale di lasciare il 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

Swift Objective-C Unity

Importa il modulo FirebaseAnalytics e la tessera nell'indirizzo email o nel telefono di accesso all'API initiateOnDeviceConversionMeasurement().

Nota: i metodi initiateOnDeviceConversionMeasurement(emailAddress:) e initiateOnDeviceConversionMeasurement(phoneNumber:) possono essere chiamati sempliciamente, ma è possibile registrare una sola corrispondenza per utente. Se viene trovata una corrispondenza con una delle due API, le successive chiamate API vengono effettivamente ignorate.

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

Importa il modulo FirebaseAnalytics e passa l'indirizzo email al API initiateOnDeviceConversionMeasurementWithEmailAddress: o il telefono di accesso all'API initiateOnDeviceConversionMeasurementWithPhoneNumber:.

Nota: i initiateOnDeviceConversionMeasurementWithEmailAddress: e È possibile chiamare i metodi initiateOnDeviceConversionMeasurementWithPhoneNumber: in sequenza, ma può essere segnalata una sola corrispondenza per utente. Se viene trovata una corrispondenza con una delle due API, le successive chiamate API vengono effettivamente ignorate.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

Importa lo spazio dei nomi Firebase.Analytics e passa l'indirizzo email all'API InitiateOnDeviceConversionMeasurementWithEmailAddress() o il numero di telefono all'API InitiateOnDeviceConversionMeasurementWithPhoneNumber():

Nota: i metodi InitiateOnDeviceConversionMeasurementWithEmailAddress() e InitiateOnDeviceConversionMeasurementWithPhoneNumber() possono essere chiamati sequenzialmente, ma è possibile registrare una sola corrispondenza per utente. Se viene trovata una corrispondenza con una delle due API, le successive chiamate API vengono effettivamente ignorate.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

Nota: la corrispondenza dell'email e del numero di telefono deve avvenire una sola volta per installazione sul dispositivo e, idealmente, il più vicino possibile al momento dell'accesso.

Importante: tieni presente che se un evento o un'azione in-app prevista si verifica immediatamente dopo la registrazione dell'email o del numero di telefono di un utente, ti consigliamo di implementare un piccolo ritardo tra l'avvio della misurazione delle conversioni sul dispositivo e la registrazione dell'evento.

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

L'API accetterà indirizzi email e numeri di telefono sottoposti ad hashing con SHA256. Tu possono mantenere il controllo dei dati degli utenti eseguendo l'hashing nel codice prima di effettuare chiamate all'SDK.

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

Normalizza indirizzi email e numeri di telefono

Per gli indirizzi email, l'API Google Analytics presuppone che un una particolare normalizzazione viene eseguita prima dell'applicazione di SHA256, quindi segui queste 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 valore Dominio @googlemail.com con @gmail.com.

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

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

   2. Nella parte del nome utente, apporta le seguenti sostituzioni:

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

Ad esempio, dopo la normalizzazione:

• [e-mail] diventa [e-mail]
• [e-mail] diventa [e-mail]

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

Chiamare l'API con credenziali sottoposte ad hashing

Swift Objective-C Unity

Importa il modulo FirebaseAnalytics e la tessera nell'indirizzo email o nel telefono di accesso all'API initiateOnDeviceConversionMeasurement().

Nota: i initiateOnDeviceConversionMeasurement(hashedEmailAddress:) e I metodi initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) possono essere in sequenza, ma può essere segnalata una sola corrispondenza per utente. Se corrisponde viene rilevata con una delle due API, le successive chiamate API vengono effettivamente ignorate.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

Importa il modulo FirebaseAnalytics e passa l'indirizzo email al API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: o il telefono numero al initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: tramite Google Cloud CLI o tramite l'API Compute Engine.

Nota: i initiateOnDeviceConversionMeasurementWithHashedEmailAddress: e I metodi initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: possono essere in sequenza, ma può essere segnalata una sola corrispondenza per utente. Se corrisponde viene rilevata con una delle due API, le successive chiamate API vengono effettivamente ignorate.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

Importa lo spazio dei nomi Firebase.Analytics e passa l'indirizzo email all'API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() o il numero di telefono all'API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

Nota: i InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() e I metodi InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() possono essere in sequenza, ma può essere segnalata una sola corrispondenza per utente. Se corrisponde viene rilevata con una delle due API, le successive chiamate API vengono effettivamente ignorate.

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

Nota: la corrispondenza dell'indirizzo email e del numero di telefono deve avvenire solo una volta per ogni installazione sul dispositivo e l'associazione idealmente avviene il più vicino possibile all'accesso.

Importante: tieni presente che se si verifica un'azione o un evento in-app previsto immediatamente dopo la registrazione telefonica o dell'email di un utente, valuta la possibilità di implementare una un piccolo ritardo tra l'avvio della misurazione delle conversioni sul dispositivo e registrando l'evento.

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 incluso il parametro -DebugOnDeviceConversionMeasurement, quindi chiamata all'argomento L'API initiateOnDeviceConversionMeasurement() simulerà una corrispondenza.

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

---

Passaggio 2: esegui l'integrazione di Google Analytics Passaggio 4: risolvi e gestisci i problemi comuni

---