Coincidencias avanzadas

En este documento se explica cómo enviar los datos sobre los usuarios de los eventos de tu aplicación a Facebook para las coincidencias avanzadas. Esta información se cifra con hash antes de que la compartas con nosotros. Utilizamos la información cifrada con hash para determinar con mayor precisión qué usuarios actuaron en respuesta a tu anuncio. Con estos datos, Facebook puede establecer coincidencias de los eventos de conversión con tus clientes a fin de optimizar los anuncios y crear audiencias de remarketing mayores.

Después de llevar a cabo las coincidencias, Facebook descarta rápidamente los datos cifrados con hash.

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

• El SDK de Facebook: añade código a tu aplicación para móviles Android o iOS con el fin de enviar datos a Facebook manualmente.
• La API de eventos de la aplicación de Facebook: añade consultas a tu código para enviar datos a Facebook manualmente.
• El Administrador de eventos: configura la aplicación en el panel del Administrador de eventos para activar las coincidencias avanzadas automáticas con el fin de enviar datos a Facebook.
• El SDK para socios de evaluación de la actividad en móviles (MMP): añade código a tu aplicación Android o iOS para enviar datos al panel de Adjust.

Usar el SDK de Facebook

Si usas el SDK de Facebook para enviar datos sobre los eventos de la aplicación de los usuarios a Facebook, todos los datos estarán cifrados con hash. Estos datos cifrados con hash se mantendrán entre las instancias de la aplicación.

Requisitos

• SDK de Facebook 4.36 o posterior

Android

Define los datos de los usuarios cuando inicialices AppEventsLogger con la función setUserData. Esta función cifrará los datos de los usuarios con hash.

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

Define los datos de los usuarios cuando inicialices FBSDKAppEvents con la función setUserData. Estos datos de los usuarios se cifrarán con hash y se mantendrán entre las instancias de la aplicación.

Recomendaciones

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

Código de ejemplo para definir un tipo de datos

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

Código de ejemplo para definir varios 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 automáticamente para detectar y recibir datos de usuario junto con el evento o acción que ha tenido lugar en la aplicación. Estos datos se cifran con hash antes de enviarse a Facebook.

Para activar las coincidencias avanzadas automáticas, ve al Administrador de eventos, selecciona la pestaña Configuración de tu aplicación y establece la opción Automatic Advanced Matching (Coincidencias avanzadas automáticas) en ON (SÍ). También puedes compartir direcciones de correo electrónico y números de teléfono cifrados con hash.

Ten en cuenta que debes haber implementado la versión 5.8.0 del SDK de Facebook o una posterior.

Usar el SDK de Adjust

Añadir datos de clientes a los eventos de Adjust

Cuando uses el SDK de Adjust para socios de evaluación de la actividad en móviles (MMP), utiliza la función de hash como se indica en el ejemplo siguiente, ya que el SDK para MMP no utilizará el hash de forma automática. Si no usas una función de hash, nuestra API lanzará una excepción y no aceptará el texto sin formato.

Llama el método addPartnerParameter en tu instancia de ADJEvent para añadir parámetros de los datos de los clientes para que se transmitan a los socios de red, que se han activado en el panel de Adjust.

Ten en cuenta que no es necesario implementar el SDK de Facebook.

Ejemplo de código para 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 de Github.

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

Sigue los pasos siguientes para asignar el parámetro de Adjust al parámetro de Facebook en el panel de Adjust.

1. En el panel de Adjust, haz clic en la opción Configuración de la aplicación para la que desees asignar los parámetros de socio.
2. Selecciona Partner Setup (Configuración de socios).
3. Haz clic en el socio que quieras.
4. Selecciona Partner Parameter Mapping (Asignación de parámetros del socio).
5. Introduce los nombres de parámetro del socio tal y como se han enviado a Adjust mediante el SDK en la columna FROM APP de la izquierda. Esta columna debería ser la misma para todos los socios. Por ejemplo, si usas email como nombre de parámetro en el SDK de Adjust, escribe "email".
6. Introduce los nombres de parámetro del socio según indique dicho socio en la columna TO PARTNER de la derecha. Esta columna depende de cada socio. El parámetro usado en el SDK de Facebook debe tener el formato ud[pii_type_name]. Por ejemplo, "email" debe usar ud[em], "phone" debe usar ud[ph].

Para obtener más información, visita la documentación sobre Adjust.