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: Avaliar conversões de anúncios do iOS

Etapa 1: Implementar uma experiência de login

Etapa 2: integrar Google Analytics

Etapa 3: inicie 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 dos usuários e seu app tem o Google Analytics para o SDK do Firebase, use os dois para começar a medir conversões.

Chamar a API

Chame a API de medição de conversões com o endereço de e-mail ou número de telefone consentido da etapa 1, que é usado para a medição de conversões de anúncios, sem permitir que informações de identificação pessoal saiam do dispositivo do usuário.

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

• Como usar credenciais
• Como usar credenciais com hash

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

Swift

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

Observação: os métodos initiateOnDeviceConversionMeasurement(emailAddress:) e initiateOnDeviceConversionMeasurement(phoneNumber:) podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

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

Objective-C

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

Observação: os métodos initiateOnDeviceConversionMeasurementWithEmailAddress: e initiateOnDeviceConversionMeasurementWithPhoneNumber: podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

@import FirebaseAnalytics;

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

Unity

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

Observação: os métodos InitiateOnDeviceConversionMeasurementWithEmailAddress() e InitiateOnDeviceConversionMeasurementWithPhoneNumber() podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

using Firebase.Analytics;

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

Observação: a prática recomendada é chamar a API uma vez por instalação e o mais próximo possível do login.

Importante: se uma ação ou evento no app acontecer imediatamente após o registro de um e-mail ou telefone do usuário, implemente um pequeno atraso entre o início da medição de conversão no dispositivo e o registro do evento.

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

A API aceita endereços de e-mail e números de telefone criptografados com hash usando SHA256. Você pode manter o controle dos dados do usuário fazendo o hash no seu código antes de fazer chamadas para o SDK.

Para usar credenciais com hash, normalize endereços e números, gere hash com SHA256 e 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 uma normalização específica é realizada antes da aplicação do SHA256. Portanto, siga estas etapas para normalizar seus dados:

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

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

3. Para endereços que terminam no domínio @gmail.com (incluindo aqueles modificados na 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 pela 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, depois da normalização:

• [e-mail] passa a ser [e-mail]
• [e-mail] passa a ser [e-mail]

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, no máximo 12 dígitos para o número do assinante) antes do hash com SHA256.

O e-mail ou os números de telefone com hash SHA256 precisam ter 32 bytes de comprimento e não podem ser uma string hexadecimal.

Chamar a API com credenciais hash

Swift

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

Observação: os métodos initiateOnDeviceConversionMeasurement(hashedEmailAddress:) e initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

import FirebaseAnalytics

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

Objective-C

Importe o módulo FirebaseAnalytics e transmita o endereço de e-mail para a API initiateOnDeviceConversionMeasurementWithHashedEmailAddress: ou o número de telefone para a API initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:.

Observação: os métodos initiateOnDeviceConversionMeasurementWithHashedEmailAddress: e initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

@import FirebaseAnalytics;

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

Unity

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

Observação: os métodos InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() e InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() podem ser chamados sequencialmente, mas apenas uma correspondência pode ser informada por usuário. Se uma correspondência for encontrada com qualquer uma das APIs, as chamadas de API subsequentes serão ignoradas.

using Firebase.Analytics;

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

Observação: a prática recomendada é chamar a API uma vez por instalação e o mais próximo possível do login.

Importante: se uma ação ou evento no app acontecer imediatamente após o registro de um e-mail ou telefone do usuário, implemente um pequeno atraso entre o início da medição de conversão no dispositivo e o registro do evento.

Verificar a integração

Ative o modo de depuração. Depois de chamar a API initiate measurement, verifique se uma mensagem como esta aparece no console de depuração do Xcode:

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

Se você ativou o modo de depuração e incluiu o argumento de inicialização -DebugOnDeviceConversionMeasurement, chamar a API initiateOnDeviceConversionMeasurement() vai simular uma correspondência.

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

---

Etapa 2: integrar o Google Analytics Etapa 4: resolver problemas e lidar com questões comuns

---