Coincidencias avanzadas

En este documento, se explica cómo enviar los datos de usuario de los eventos de la app a Facebook para realizar coincidencias avanzadas. La información se cifra antes de que la recibamos. La usamos para determinar con mayor exactitud qué personas realizaron acciones a partir de tu anuncio. Con estos datos, Facebook puede establecer coincidencias entre los eventos de conversión y tus clientes para optimizar tus anuncios y crear públicos más grandes de remarketing.

Después de realizada la coincidencia, Facebook descartará rápidamente la información cifrada.

Puedes configurar coincidencias avanzadas con alguno de los siguientes métodos:

• El SDK de Facebook: agrega código a la app móvil de Android o iOS para enviar datos de manera manual a Facebook.
• La API de eventos de la app de Facebook: agrega consultas a tu código de manera manual para enviar datos a Facebook.
• El administrador de eventos: configura tu app en el panel del administrador de eventos a fin de activar las coincidencias avanzadas automáticas para enviar datos a Facebook.
• El SDK de los socios de medición de dispositivos móviles (MMP): agrega código a tu app de Android o iOS para enviar datos al panel de Adjust.

Usar el SDK de Facebook

Cuando se utiliza el SDK de FB para enviar datos de los eventos de las apps de usuarios a Facebook, se cifrarán todos los datos de usuario. Los datos cifrados persistirán entre las instancias de la app.

Requisitos

• SDK de Facebook 4.36 o posterior

Android

Configura los datos de usuario mientras se inicializa AppEventsLogger con la función setUserData. Esta función cifrará los datos de usuario.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

Configura los datos de usuario mientras se inicializa FBSDKAppEvents con la función setUserData. Se aplicará la función hash a los datos del usuario y estos persistirán entre las instancias de la app.

Recomendaciones

• Para garantizar que las coincidencias avanzadas funcionen correctamente, recomendamos actualizar a la última versión de la versión del SDK de Facebook para iOS. Para obtener más información, consulta el registro de cambios del SDK para iOS.

Ejemplo de código para configurar un tipo de datos

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

Ejemplo de código para configurar múltiples tipos de datos

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

Usar el administrador de eventos

Las coincidencias avanzadas automáticas configuran el SDK de Facebook para que detecte y reciba datos de usuarios junto con el evento o la acción que se desarrolla en la app. Se cifran estos datos antes de enviarlos a Facebook.

Para activar las coincidencias avanzadas automáticas, ve al administrador de eventos, selecciona la pestaña Configuración y coloca las coincidencias avanzadas automáticas en ACTIVAR. También puedes compartir direcciones de correo electrónico y números de teléfono cifrados.

Nota: Debes haber implementado el SDK de Facebook 5.8.0 o posterior.

Usar el SDK de Adjust

Agregar datos de clientes para eventos de Adjust

Cuando utilices el SDK de los socios de medición de dispositivos móviles (MMP) en Adjust, usa la función de hash como se muestra en el ejemplo a continuación, dado que el SDK de los MMP no se cifrará de manera automática. Si no usas una función de cifrado, ocurrirá una excepción en nuestra API y no aceptará el texto sin formato.

Agrega los parámetros de los datos de los clientes para que se transmitan a los socios de red, que se activaron en el panel de Adjust , llamando el método addPartnerParameter en la instancia ADJEvent.

Nota: No necesitas implementar el SDK de Facebook.

Código de ejemplo de Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

Ejemplo de código para iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

Para obtener más información, visita los ejemplos de código en Github.

Asignar parámetros de Adjust para los parámetros de Facebook

Utiliza los siguientes pasos para asignar el parámetro de Adjust a los parámetros de Facebook en el panel de Adjust.

1. En el panel Adjust, haz clic en Configuración en la app para la que deseas asignar los parámetros de los socios.
2. Selecciona Configuración de socios.
3. Haz clic en el socio que te interese.
4. Selecciona Asignación de parámetros de socios.
5. Ingresa los nombres de los parámetros de socio como los envío el SDK a Adjust en la columna izquierda DESDE APP. Debe ser idéntico con todos los socios. Por ejemplo, si utilizas email como nombre de parámetro en el SDK de Adjust, ingresa "email".
6. Ingresa los nombres de los parámetros del socio como lo desee dicho socio en la columna derecha AL SOCIO. Es una especificación de socio. El parámetro utilizado en el SDK de Facebook debe tener el formato ud[pii_type_name]. Por ejemplo, "email" debe usar ud[em]; el teléfono debe utilizar ud[ph].

Visita la documentación de Adjust para obtener más información.