Tutorial: misurare le conversioni degli annunci per 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 la tua app dispone dell'Google Analytics per l'SDK 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 per cui è stato dato il consenso del passaggio 1, che viene utilizzato per la misurazione delle conversioni degli annunci, senza consentire a informazioni che consentono l'identificazione personale di lasciare il dispositivo dell'utente.

Esistono due modi per avviare la misurazione:

• Utilizzo delle credenziali
• Utilizzare le credenziali sottoposte ad hashing

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

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. Puoi mantenere il controllo dei dati dei tuoi utenti eseguendo l'hashing nel codice prima di effettuare chiamate all'SDK.

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

Normalizzare indirizzi email e numeri di telefono

Per gli indirizzi email, l'API Google Analytics presuppone che venga eseguita una determinata 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 la cifra 1, sostituisci la lettera l
      • Per la cifra 0, sostituisci la lettera o
      • Per la seconda cifra, sostituisci la lettera z
      • Per la cifra 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 dell'hashing con SHA256.

Tieni presente che l'indirizzo email o i numeri di telefono SHA256 sottoposti ad hashing devono essere lunghi 32 byte e non una stringa esadecimale.

Chiamare l'API con le 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 l'integrazione

Attiva la modalità di debug. Dopo aver chiamato l'API initiate measurement, assicurati che nella console di debug di Xcode venga visualizzato un messaggio simile al seguente:

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

Se hai attivato la modalità di debug e incluso l'argomento di avvio -DebugOnDeviceConversionMeasurement, la chiamata all'API initiateOnDeviceConversionMeasurement() simulerà una corrispondenza.

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

arrow_back_iosPassaggio 2: integra Google Analytics Passaggio 4: risolvi i problemi e gestisci quelli comuniarrow_forward_ios