Audiencias: identificadores adicionales

De un vistazo: Configure identificadores de usuario adicionales para enviar audiencias personalizadas a socios publicitarios.

Acerca de los identificadores adicionales

AppsFlyer Audiences admite automáticamente los siguientes identificadores de dispositivos al enviar audiencias personalizadas a socios publicitarios:

  • iOS: IDFA
  • Android (Google Play): GAID
  • Android (tiendas de aplicaciones de terceros): OAID y IMEI

Algunos socios publicitarios también admiten la coincidencia de audiencias personalizadas basándose en identificadores de usuario adicionales. Audiences le ofrece la opción de utilizar estos identificadores si los configura específicamente a través del SDK de AppsFlyer o la API S2S-mobile.

Estos identificadores adicionales pueden incluir números de teléfono y correos electrónicos, pero solo se pueden utilizar si están cifrados con el hash SHA256.  El uso de dichos identificadores adicionales está sujeto a los Términos de uso de identificadores adicionales.

Próximos pasos

  1. Seleccione los identificadores adicionales que desea utilizar (si hay alguno) de la tabla de identificadores disponibles. Tenga en cuenta que no todos los socios publicitarios admiten todos los identificadores.
  2. DesarrolladoresConfiguren los identificadores seleccionados, utilizando:
  3. En el panel de Audiencias:

Identificadores disponibles

Puede optar por configurar uno o más identificadores, que se muestran en la siguiente tabla.

Identificadores adicionalesparámetros y formato

Identificador Nombre del parámetro Formato Valor de ejemplo (antes del hash)
Dirección de correo electrónico correo electrónico_sha256
  • Minúsculas
  • Sin espacios en blanco
  • Hash SHA256
nombre@dominio.com
Número de teléfono
(ver nota a continuación)
número de teléfono_sha256
  • Sin símbolos, letras ni ceros iniciales.
  • Incluya el código de país
  • Hash SHA256
442070313000

Número de teléfono E164

(ver nota a continuación)

número de teléfono e164_sha256
  • Número de teléfono E164
  • Hash SHA256
+442070313000

Nota 

Diferentes socios publicitarios admiten distintos formatos de números de teléfono. Por lo tanto, si decide utilizar el número de teléfono, configure ambos identificadores: Número de teléfono y Número de teléfono E164.

Referencia del SDK y ejemplos de código

Al enviar identificadores para audiencias mediante el SDK:

  • Para identificadores distintos de la dirección de correo electrónico codificada , use
  • Para la dirección de correo electrónico codificada , use

Configuración del SDK para iOS

Para establecer un número de teléfono codificado como identificador de usuario adicional:

Objective-C Swift
NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];

Para establecer una dirección de correo electrónico codificada como un identificador de usuario adicional:

Firma del método

- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;

Ejemplo de uso

Objective-C Swift
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

Configuración del SDK para Android

Para establecer un número de teléfono codificado como identificador de usuario adicional:

Java Kotlin
HashMap<String, Object> audiences = new HashMap<>();
audiences.put("phone_number_sha256", "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37");
audiences.put("phone_number_e164_sha256", "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E");
HashMap<String, Object> customDataMap = new HashMap<>();
customDataMap.put("audiences", audiences);
AppsFlyerLib.getInstance().setAdditionalData(customDataMap);

Para establecer una dirección de correo electrónico codificada como un identificador de usuario adicional:

Firma del método

public abstract void setUserEmails(
  AppsFlyerProperties.EmailsCryptType cryptMethod,
  String... emails
);

Ejemplo de uso

JavaKotlin
AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

Referencia y ejemplos de código S2S

Al enviar identificadores para audiencias mediante S2S, use el parámetro para todos los identificadores (incluyendo la dirección de correo electrónico codificada ). Puede enviar uno o más identificadores.

Envío de identificadores vía S2S

Formato:

  • JSON anidado
  • El valor de la clave debe ser audiences
  • Todos los valores deben estar en formato cadena, como se muestra en el siguiente ejemplo de código
  • Los nombres de los parámetros deben coincidir con los listados en la tabla de identificadores disponibles indicada arriba

Formato genérico:

"custom_data" : { 
\"audiences\" : { \"parameter_name_a\" : \"hashed_identifer_a\", \"parameter_name_a\" : \"hashed_identifer_b\", \"parameter_name_c\" : \"hashed_identifer_c\" } }

Ejemplo con valores para el número de teléfono codificado y la dirección de correo electrónico codificada:

"custom_data" : {
\"audiences\" : { \"phone_number_sha256\" : \"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37\", \"phone_number_e164_sha256\" : \"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E\", \"email_sha256\" : \"34D31BE18022626DE6B311D6A76E791176D2691B6EEF406F524D8F56364C187A\" } }