Instructivo: Mide las conversiones de anuncios para iOS

Paso 3: Inicia la medición de conversiones en el dispositivo con Google Analytics

Ahora que puedes recopilar las direcciones de correo electrónico y los números de teléfono de los usuarios, y que tu app tiene el Google Analytics SDK de Firebase, puedes usar ambos para comenzar a medir las conversiones.

Llama a la API

Llama a la API de medición de conversiones con la dirección de correo electrónico o el número de teléfono obtenidos con consentimiento del Paso 1, que se usa para la medición de conversiones de anuncios, sin permitir que ninguna información de identificación personal salga del dispositivo del usuario.

Hay dos formas de iniciar la medición:

• Usar credenciales
• Usar credenciales con codificación hash

Usa una dirección de correo electrónico o un número de teléfono

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

Usa una dirección de correo electrónico o un número de teléfono con codificación hash

La API aceptará direcciones de correo electrónico y números de teléfono con codificación hash con SHA256. Puedes mantener el control de los datos de tus usuarios realizando la codificación hash en tu código antes de realizar llamadas al SDK.

Para usar credenciales con codificación hash, normaliza las direcciones y los números, genera un hash con SHA256 y, luego, llama a la API.

Normaliza las direcciones de correo electrónico y los números de teléfono

En el caso de las direcciones de correo electrónico, la Google Analytics API supone que se realiza una normalización específica antes de aplicar SHA256, por lo que debes seguir estos pasos para normalizar tus datos:

1. Convierte toda la dirección de correo electrónico a minúsculas.

2. Si la dirección de correo electrónico termina en el dominio @googlemail.com, reemplaza el @googlemail.com dominio por @gmail.com.

3. En el caso de las direcciones que terminan en el dominio @gmail.com (incluidas las que se modificaron en el paso anterior), haz lo siguiente:

   1. Quita todos los puntos de la parte del nombre de usuario.

   2. Realiza las siguientes sustituciones en la parte del nombre de usuario:

      • En el caso de las letras I o i, o el dígito 1, sustituye la letra l.
      • En el caso del dígito 0, sustituye la letra o.
      • En el caso del dígito 2, sustituye la letra z.
      • En el caso del dígito 5, sustituye la letra s.

Por ejemplo, después de la normalización, sucede lo siguiente:

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

En el caso de los números de teléfono, los números ya deben estar en formato E.164 (es decir, prefijo con +, 1 a 3 dígitos para el código de país, máximo 12 dígitos para el número de suscriptor) antes de generar un hash con SHA256.

Ten en cuenta que el correo electrónico o los números de teléfono con codificación hash SHA256 deben tener 32 bytes de longitud y no ser una cadena hexadecimal.

Llama a la API con credenciales con codificación 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);

Verifica la integración

Habilita el modo de depuración. Después de llamar a la API de medición de inicio, asegúrate de que aparezca un mensaje de registro como el siguiente en la consola de depuración de Xcode:

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

Si habilitaste el modo de depuración y agregaste el argumento de inicio -DebugOnDeviceConversionMeasurement, llamar a la API initiateOnDeviceConversionMeasurement() simulará una coincidencia.

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

arrow_back_iosPaso 2: Integra Google Analytics Paso 4: Soluciona problemas comunesarrow_forward_ios