Tutorial: medir las conversiones de anuncios de iOS

Paso 3: inicie la medición de conversiones en el dispositivo mediante Google Analytics

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

Llame a la API

Llame a la API de medición de conversiones con la dirección de correo electrónico o el número de teléfono consentidos en el Paso 1, que se utiliza 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:

• Usando credenciales
• Usando credenciales hash

Utilice la dirección de correo electrónico o el 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");

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

La API aceptará direcciones de correo electrónico y números de teléfono con hash SHA256. Puede mantener el control de los datos de su usuario realizando el hash en su código antes de realizar llamadas al SDK.

Para usar credenciales con hash, normalice direcciones y números, haga un hash con SHA256 y luego llame 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 se realiza una normalización particular antes de aplicar SHA256, así que siga estos pasos para normalizar sus datos:

1. Convierta la dirección de correo electrónico completa a minúsculas.

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

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

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

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

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

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

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

Para 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 del hash con SHA256.

Llame a la API con credenciales 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);

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

Si habilitó el modo de depuración, después de llamar a la API de inicio de medición, asegúrese de que aparezca un mensaje como el siguiente mensaje 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 posterior, si habilitaste el modo de depuración e incluiste el argumento de inicio -DebugOnDeviceConversionMeasurement , llamar a la API initiateOnDeviceConversionMeasurement() simulará una coincidencia.

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

arrow_back_ios Paso 2 : Integrar Google Analytics Paso 4 : Solucionar y gestionar problemas comunes arrow_forward_ios