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: Cómo medir las conversiones de anuncios para 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: Solución de problemas y resolución de problemas habituales

Ahora que puedes recopilar datos direcciones de correo electrónico y números de teléfono, y tu app tiene la Google Analytics para el SDK de Firebase, puedes usar los dos para comenzar la medición de conversiones.

Llama a la API

Llama a la API de medición de conversiones con la dirección de correo electrónico o el teléfono obtenidos con consentimiento del paso 1, que se usa para medir las conversiones de los anuncios, sin lo que permite que cualquier información de identificación personal salga del dispositivo del usuario.

Existen dos maneras de iniciar la medición:

• Usa credenciales
• Usa credenciales con hash

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

Swift Objective-C Unity

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

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

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

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

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

@import FirebaseAnalytics;

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

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

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

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 correlación de correos electrónicos y números de teléfono solo debe ocurrir una vez por instalación en el y la coincidencia ocurre lo más cerca posible del acceso.

Importante: Ten en cuenta que si ocurre una acción o un evento en la app previstos inmediatamente después del registro por teléfono o correo electrónico de un usuario, considere implementar una poco tiempo de demora entre el inicio de la medición de conversiones en el dispositivo y registrar el 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 con SHA256. Tú puede mantener el control de los datos de sus usuarios mediante la generación de un hash en su código. antes de realizar llamadas al SDK.

Para usar credenciales con hash, normaliza direcciones y números, y genera un hash SHA256 y, luego, llamar a la API.

Normalizar direcciones de correo electrónico y números de teléfono

Para las direcciones de correo electrónico, la API de Google Analytics supone que un una normalización específica se realiza antes de que se aplique SHA256, por lo tanto, 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, reemplace el el dominio @googlemail.com con @gmail.com.

3. Para las direcciones que terminan en el dominio @gmail.com (incluidas las modificadas en el paso anterior):

   1. Quita todos los puntos de la sección del nombre de usuario.

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

      • Escribe las letras I o i, o el dígito 1, usa 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] pasa a ser [e-mail].
• [e-mail] pasa a ser [e-mail].

Para los números de teléfono, los números ya deben estar en formato E.164 (es decir, con +, de 1 a 3 dígitos para el código de país y máx. de 12 dígitos para el número de suscriptor) antes del con SHA256.

Llama a la API con credenciales con hash

Swift Objective-C Unity

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

Nota: Los componentes initiateOnDeviceConversionMeasurement(hashedEmailAddress:) y Los métodos initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) pueden ser pero solo se puede informar una coincidencia por usuario. Si hay una coincidencia con una de las dos APIs, las llamadas posteriores a la API se ignoran de forma eficaz.

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

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

Nota: Los componentes initiateOnDeviceConversionMeasurementWithHashedEmailAddress: y Los métodos initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: pueden ser pero solo se puede informar una coincidencia por usuario. Si hay una coincidencia con una de las dos APIs, las llamadas posteriores a la API se ignoran de forma eficaz.

@import FirebaseAnalytics;

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

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

Nota: Los componentes InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() y Los métodos InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() pueden ser pero solo se puede informar una coincidencia por usuario. Si hay una coincidencia con una de las dos APIs, las llamadas posteriores a la API se ignoran de forma eficaz.

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 correos electrónicos y números de teléfono solo debe ocurrir una vez por instalación en el y la coincidencia ocurre lo más cerca posible del acceso.

Importante: Ten en cuenta que si ocurre una acción o un evento en la app previstos inmediatamente después del registro por teléfono o correo electrónico de un usuario, considere implementar una poco tiempo de demora entre el inicio de la medición de conversiones en el dispositivo y registrar el evento.

Realiza la verificación 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 el archivo de depuración de Xcode consola:

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 los el argumento de inicio -DebugOnDeviceConversionMeasurement y, luego, llama al 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 y soluciona los problemas habituales

---