Instructivo: Mide las conversiones de anuncios para iOS

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

Introducción: Mide las conversiones de los anuncios en iOS

Paso 1: Implementa una experiencia de acceso

Paso 2: Integra Google Analytics

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

Paso 4: Soluciona problemas comunes

Ahora que puedes recopilar las direcciones de correo electrónico y los números de teléfono de los usuarios, y tu app tiene el SDK de Google Analytics para 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.

Existen dos maneras de iniciar la medición:

• Cómo usar credenciales
• Usa credenciales con hash

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

Swift

Importa el módulo FirebaseAnalytics y pasa la dirección de correo electrónico o el número de teléfono a la API de initiateOnDeviceConversionMeasurement().

Nota: Se puede llamar a los métodos initiateOnDeviceConversionMeasurement(emailAddress:) y initiateOnDeviceConversionMeasurement(phoneNumber:) de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas posteriores a la API.

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

Importa el módulo FirebaseAnalytics y pasa la dirección de correo electrónico a la API de initiateOnDeviceConversionMeasurementWithEmailAddress: o el número de teléfono a la API de initiateOnDeviceConversionMeasurementWithPhoneNumber:.

Nota: Se puede llamar a los métodos initiateOnDeviceConversionMeasurementWithEmailAddress: y initiateOnDeviceConversionMeasurementWithPhoneNumber: de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas a la API posteriores.

@import FirebaseAnalytics;

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

Unity

Importa el espacio de nombres Firebase.Analytics y pasa la dirección de correo electrónico a la API de InitiateOnDeviceConversionMeasurementWithEmailAddress() o el número de teléfono a la API de InitiateOnDeviceConversionMeasurementWithPhoneNumber():

Nota: Se puede llamar a los métodos InitiateOnDeviceConversionMeasurementWithEmailAddress() y InitiateOnDeviceConversionMeasurementWithPhoneNumber() de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas a la API posteriores.

using Firebase.Analytics;

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

Nota: La coincidencia de correo electrónico y número de teléfono solo debe ocurrir una vez por instalación en el dispositivo y, de preferencia, lo más cerca posible del acceso.

Importante: Ten en cuenta que, si una acción o un evento en la aplicación previstos ocurren inmediatamente después de que un usuario se registra con su correo electrónico o número de teléfono, considera implementar una pequeña demora entre el inicio de la medición de conversiones en el dispositivo y el registro del evento.

Cómo usar 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 SHA256. Para mantener el control de los datos de tu usuario, realiza el 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, cámbiales el hash con SHA256 y, luego, llama a la API.

Cómo normalizar las direcciones de correo electrónico y los números de teléfono

En el caso de las direcciones de correo electrónico, la API de Google Analytics supone que se realiza una normalización particular antes de aplicar SHA256, por lo que sigue 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 dominio @googlemail.com por @gmail.com.

3. Para 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:

      • Para las letras I o i, o el dígito 1, sustituye la letra l.
      • Para el dígito 0, reemplaza la letra o.
      • Para el dígito 2, reemplaza la letra z.
      • Para el dígito 5, reemplaza la letra s.

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

• [e-mail] se convierte en [e-mail]
• [e-mail] se convierte en [e-mail]

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

Llama a la API con credenciales con hash

Swift

Importa el módulo FirebaseAnalytics y pasa la dirección de correo electrónico o el número de teléfono a la API de initiateOnDeviceConversionMeasurement().

Nota: Se puede llamar a los métodos initiateOnDeviceConversionMeasurement(hashedEmailAddress:) y initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas a la API posteriores.

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

Importa el módulo FirebaseAnalytics y pasa la dirección de correo electrónico a la API de initiateOnDeviceConversionMeasurementWithHashedEmailAddress: o el número de teléfono a la API de initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:.

Nota: Se puede llamar a los métodos initiateOnDeviceConversionMeasurementWithHashedEmailAddress: y initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas a la API posteriores.

@import FirebaseAnalytics;

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

Unity

Importa el espacio de nombres Firebase.Analytics y pasa la dirección de correo electrónico a la API de InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() o el número de teléfono a la API de InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

Nota: Se puede llamar a los métodos InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() y InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() de forma secuencial, pero solo se puede informar una coincidencia por usuario. Si se encuentra una coincidencia con cualquiera de las APIs, se ignoran las llamadas a la API posteriores.

using Firebase.Analytics;

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

Nota: La correlación de correo electrónico y número de teléfono solo debe ocurrir una vez por instalación en el dispositivo, y lo ideal es que ocurra lo más cerca posible del acceso.

Importante: Ten en cuenta que, si una acción o un evento previstos en la app ocurre inmediatamente después del registro telefónico o el correo electrónico del usuario, considera implementar un pequeño retraso entre el inicio de la medición de conversiones en el dispositivo y el registro del evento.

Verifica con los registros de depuración de Xcode (opcional)

Si habilitaste el modo de depuración, después de llamar a la API de Start Measurement, asegúrate de que aparezca un mensaje como el siguiente de registro en la consola de depuración de Xcode:

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

En Firebase 9.6.0 o versiones posteriores, si habilitaste el modo de depuración y, además, incluiste el argumento de inicio -DebugOnDeviceConversionMeasurement, llamar a la API de initiateOnDeviceConversionMeasurement() simulará una coincidencia.

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

---

Paso 2: Integra Google Analytics Paso 4: Soluciona problemas comunes

---