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

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

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

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

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:

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

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

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

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

arrow_back_ios Etapa 2 : Integrar o Google Analytics Etapa 4 : Solucionar e lidar com problemas comuns arrow_forward_ios