Tutorial: avaliar as conversões de anúncios no iOS

Etapa 3: iniciar a medição de conversões no dispositivo usando Google Analytics


Introdução: Medir as conversões de anúncios para iOS

Etapa 1: Implementar uma experiência de login

Etapa 2: integrar Google Analytics

Etapa 3: iniciar a medição de conversões no dispositivo usando Google Analytics

Etapa 4: Resolver problemas comuns


Agora que você pode coletar endereços de e-mail e números de telefone, e seu aplicativo tem a Google Analytics para o SDK do Firebase, é possível usar os dois para começar medir conversões.

Chamar a API

Chamar a API Conversion Measurement com o telefone ou endereço de e-mail consentido da etapa 1, que é usada para medir conversões de anúncios, sem permitindo que qualquer informação de identificação pessoal saia do dispositivo do usuário.

Há duas maneiras de iniciar a medição:

Usar endereço de e-mail ou número de telefone

Swift Objective-C Unity

Importe o módulo FirebaseAnalytics e transmita o endereço de e-mail ou o telefone para a API initiateOnDeviceConversionMeasurement().

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

Importe o módulo FirebaseAnalytics e transmita o endereço de e-mail para o API initiateOnDeviceConversionMeasurementWithEmailAddress: ou o smartphone para a API initiateOnDeviceConversionMeasurementWithPhoneNumber:.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

Importe o namespace Firebase.Analytics e transmita o endereço de e-mail para o API InitiateOnDeviceConversionMeasurementWithEmailAddress() ou o smartphone para a API InitiateOnDeviceConversionMeasurementWithPhoneNumber():

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

Use um endereço de e-mail ou número de telefone com hash

A API vai aceitar endereços de e-mail e números de telefone com hash com SHA256. Você pode manter o controle dos dados do usuário realizando o hash no código antes de fazer chamadas ao SDK.

Para usar credenciais com hash, normalize endereços e números e gere hash delas com SHA256 e, em seguida, chame a API.

Normalizar endereços de e-mail e números de telefone

Para endereços de e-mail, a API Google Analytics pressupõe que um uma normalização específica é executada antes da aplicação do SHA256. Portanto, siga estas etapas para normalizar seus dados:

  1. Converta todo o endereço de e-mail em letras minúsculas.

  2. Se o endereço de e-mail terminar no domínio @googlemail.com, substitua o Domínio @googlemail.com com @gmail.com.

  3. Para endereços que terminam no domínio @gmail.com, incluindo os modificados em etapa anterior):

    1. Remova todos os pontos da parte do nome de usuário.

    2. Faça as seguintes substituições na parte do nome de usuário:

      • Para as letras I ou i ou o dígito 1, substitua a letra l
      • Para o dígito 0, substitua a letra o
      • Para o dígito 2, substitua a letra z
      • Para o dígito 5, substitua a letra s

Por exemplo, após a normalização:

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

Para números de telefone, eles precisam estar no formato E.164 (ou seja, prefixo com +, 1 a 3 dígitos para o código do país, máximo 12 dígitos para número do assinante) antes de gerando hash com SHA256.

Chamar a API com credenciais com hash
Swift Objective-C Unity

Importe o módulo FirebaseAnalytics e transmita o endereço de e-mail ou o telefone para a API initiateOnDeviceConversionMeasurement().

import FirebaseAnalytics

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

Importe o módulo FirebaseAnalytics e transmita o endereço de e-mail para o API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: ou o smartphone para initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API.

@import FirebaseAnalytics;

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

Importe o namespace Firebase.Analytics e transmita o endereço de e-mail para o a API InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() ou a número de telefone para a API InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

using Firebase.Analytics;

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

Verificar com os registros de depuração do Xcode (opcional)

Se você tiver ativado o modo de depuração, depois de chamar a API de medição de inicialização, verifique se: que uma mensagem como a seguinte mensagem de registro apareça na depuração do Xcode console:

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

No Firebase 9.6.0 ou posterior, se você ativou o modo de depuração e incluiu o -DebugOnDeviceConversionMeasurement e, em seguida, chamar o A API initiateOnDeviceConversionMeasurement() vai simular uma correspondência.

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



Etapa 2: integrar o Google Analytics Etapa 4: resolver problemas comuns