Tutorial: Medir conversões de anúncios para iOS

Etapa 3: inicie a medição de conversão no dispositivo usando o Google Analytics

Introdução: avalie as conversões de anúncios do iOS

Etapa 1: implementar uma experiência de login

Etapa 2: Integrar o Google Analytics

Etapa 3: inicie a medição de conversão no dispositivo usando o Google Analytics

Etapa 4: solucionar e lidar com problemas comuns

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

Chame a API

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

Existem duas maneiras de iniciar a medição:

• Usando credenciais
• Usando credenciais com hash

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

Rápido

Importe o módulo FirebaseAnalytics e passe 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 relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente 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]")

Objetivo-C

Importe o módulo FirebaseAnalytics e passe 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 somente uma correspondência pode ser relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente ignoradas.

@import FirebaseAnalytics;

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

Unidade

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

Nota: Os métodos InitiateOnDeviceConversionMeasurementWithEmailAddress() e InitiateOnDeviceConversionMeasurementWithPhoneNumber() podem ser chamados sequencialmente, mas apenas uma correspondência pode ser relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente 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 correspondência de e-mail e número de telefone só precisa ocorrer uma vez por instalação no dispositivo e, idealmente, a correspondência ocorre o mais próximo possível do login.

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

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

Para usar credenciais com hash, normalize endereços e números, faça hash deles com SHA256 e chame a API.

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

Para endereços de e-mail , a API do Google Analytics pressupõe que uma normalização específica seja 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 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 letras I ou i, ou 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:

• [e-mail] torna-se [e-mail]
• [e-mail] torna-se [e-mail]

Para números de telefone , os números já devem 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.

Chame a API com credenciais com hash

Rápido

Importe o módulo FirebaseAnalytics e passe 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 relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente 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)

Objetivo-C

Importe o módulo FirebaseAnalytics e passe 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 somente uma correspondência pode ser relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente ignoradas.

@import FirebaseAnalytics;

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

Unidade

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

Nota: Os métodos InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() e InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() podem ser chamados sequencialmente, mas apenas uma correspondência pode ser relatada por usuário. Se for encontrada uma correspondência com qualquer uma das APIs, as chamadas de API subsequentes serão efetivamente 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 correspondência de e-mail e número de telefone só precisa ocorrer uma vez por instalação no dispositivo e, idealmente, a correspondência ocorre o mais próximo possível do login.

Verifique com logs de depuração do Xcode (opcional)

Se você ativou o modo de depuração, depois de chamar a API de medição inicial, certifique-se de que uma mensagem como a seguinte mensagem de log apareça no console de depuração do Xcode:

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 argumento de inicialização -DebugOnDeviceConversionMeasurement , chamar a API initiateOnDeviceConversionMeasurement() 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 : Solucionar e lidar com problemas comuns

---