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:
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()
.
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")
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:
.
@import FirebaseAnalytics; // ... // If you're using an email address.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"]; // If you're using a phone number.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];
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()
:
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");
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:
Converter todo o endereço de e-mail em letras minúsculas.
Se o endereço de e-mail terminar com o domínio @googlemail.com, substitua o domínio @googlemail.com por @gmail.com.
Para endereços que terminam no domínio @gmail.com (incluindo aqueles modificados na etapa anterior):
Remova todos os pontos da parte do nome de usuário.
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:
an.email.user0125@googlemail.com
passa a seranemalluserolzs@gmail.com
CAPSUSER0125@provider.net
passa a sercapsuser0125@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, 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()
.
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:
.
@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()
:
using Firebase.Analytics; // ... // If you're using an email address.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress); // If you're using a phone number.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);
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
Google Analytics Etapa 2: integrar o Etapa 4: resolver problemas e lidar com questões comuns