¿Cómo podemos ayudarte?

Búsqueda

Audiencias: configura identificadores adicionales para la creación de audiencias de Partners

  • Actualización

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. Desarrolladores—Configuren 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 adicionales—parámetros y formato
Identificador Nombre del parámetro Formato Valor de ejemplo (antes del hash)
Correo electrónico correo electrónico_sha256

SDK v7.0.0 y versiones anteriores:

  • Minúsculas
  • Sin espacios en blanco
  • Con hash en el cliente (SHA256) antes de enviarlo

SDK v7.0.1 y versiones posteriores: Texto sin formato. El SDK lo normaliza y aplica Hashing automáticamente.

 name@domain.com
Número de teléfono
(ver nota a continuación)

v7.0.0 y versiones anteriores (o S2S): phone_number_sha256

v7.0.1 y versiones posteriores: phone_number_hashed

v7.0.0 y versiones anteriores (o S2S):

  • Sin símbolos, letras ni ceros iniciales
  • Incluir código de país
  • Hash SHA256

v7.0.1 y versiones posteriores: Texto sin formato. El SDK concatena el código de país y el número, lo normaliza y aplica Hashing automáticamente.

 442070313000

Número de teléfono E164

(ver nota a continuación)

v7.0.0 y versiones anteriores (o S2S): phone_number_e164_sha256

v7.0.1 y versiones posteriores: phone_number_e164_hashed

v7.0.0 y versiones anteriores (o S2S):

  • Número de teléfono E164
  • Hash SHA256

v7.0.1 y versiones posteriores: Texto sin formato. El SDK concatena el código de país y el número, lo normaliza y aplica Hashing automáticamente.

 +442070313000

Nota

Diferentes socios publicitarios admiten distintos formatos de números de teléfono. Por tanto, si eliges usar el número de teléfono, configura 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
    • SDK v7.0.1 y versiones posteriores: usa setUserEmail.
    • SDK v7.0.0 y versiones anteriores: usa setUserEmails.
  • número de teléfono e164_sha256
    • SDK v7.0.1 y versiones posteriores: usa setUserPhone (recomendado).
    • SDK v7.0.0 y versiones anteriores: usa setAdditionalData con datos personalizados.

Advertencia

Recuerda los siguientes cambios según la versión:

  • Correo electrónico: A partir del SDK v7.0.1, setUserEmails (iOS/Android) se ha eliminado por completo y se ha sustituido por setUserEmail. Este es un cambio incompatible, no una descontinuación. Las apps en v7.0.0 y anteriores deben seguir usando setUserEmails. Las apps en v7.0.1 y posteriores deben cambiar a setUserEmail. Comprueba qué versión del SDK tienes integrada antes de elegir qué ejemplo seguir.
  • Teléfono: A partir del SDK v7.0.1, hay disponible una API específica setUserPhone. Es la forma recomendada de enviar identificadores de número de teléfono para Advanced Matching. Este no es un cambio disruptivo: setAdditionalData sigue funcionando. Para las nuevas integraciones y para los clientes que actualicen a la versión 7.0.1 y posteriores, recomendamos migrar a setUserPhone. Las aplicaciones con la versión 7.0.0 y anteriores deben seguir usando setAdditionalData, porque setUserPhone no existe en esas versiones del SDK.

Configuración del SDK para iOS

Para establecer el número de teléfono con hashing como identificador adicional de usuario:

SDK v7.0.0 y anteriores — setAdditionalData

Objective-C
NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];
Swift
número de teléfono_sha256

Audiencias: identificadores adicionales

Debes aplicar un hash previo a ambos valores (SHA-256) antes de pasarlos.

SDK v7.0.1 y versiones posteriores — setUserPhone (recomendado)

Firma del método

- (void)setUserPhone:(NSString *_Nonnull)countryCode
phoneNumber:(NSString *_Nonnull)phoneNumber;

Ejemplo de uso

Objective-C
[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];
Swift
AppsFlyerLib.shared().setUserPhone(countryCode: "1", phoneNumber: "(650) 555-1212")

Hash SHA256

Pasa el prefijo telefónico del país y el número local como texto sin formato. Se permiten símbolos y espacios en el número local. El SDK concatena, normaliza y aplica hash a ambos valores localmente (SHA-256). No apliques hash previamente.

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

SDK v7.0.0 y versiones anteriores

Firma del método

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

Ejemplo de uso

Objective-C
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType: EmailCryptTypeSHA256];
Swift
let emails: Array = ["name@domain.com"]
AppsFlyerLib.shared().setUserEmails(emails, with: EmailCryptTypeSHA256)

SDK v7.0.1 y versiones posteriores

Firma del método

- (void)setUserEmail:(NSString *_Nonnull)email;

Ejemplo de uso

Objective-C
[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];
Swift
AppsFlyerLib.shared().setUserEmail("name@domain.com")

Advertencia

Pasa el correo electrónico en texto sin formato. El SDK lo normaliza y aplica hashing localmente (SHA-256). No apliques hashing previamente. Solo se acepta un único correo electrónico por llamada: si vuelves a llamar a setUserEmail, se sobrescribe el valor establecido anteriormente en lugar de añadirse.

Configuración del SDK para Android

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

SDK v7.0.0 y versiones anteriores — setAdditionalData

Java
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);
Kotlin
val audiences = hashMapOf<String, Any>(
   "phone_number_sha256" to "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
   "phone_number_e164_sha256" to "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
)
val customDataMap = hashMapOf<String, Any>("audiences" to audiences)
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

Advertencia

Debes aplicar hashing previamente a ambos valores (SHA-256) antes de pasarlos.

SDK v7.0.1 y versiones posteriores — setUserPhone (recomendado)

Firma del método

public abstract void setUserPhone(String countryCode, String phoneNumber);

Ejemplo de uso

Java
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");
Kotlin
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212")

Nota:

Pasa el código de marcación del país y el número local en texto sin formato. El SDK concatena, normaliza y aplica hashing a ambos valores localmente (SHA-256). No les apliques hashing previamente.

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

SDK v7.0.0 y versiones anteriores

Firma del método

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

Ejemplo de uso

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

SDK v7.0.1 y versiones posteriores

Firma del método

public abstract void setUserEmail(String email);

Ejemplo de uso

AppsFlyerLib.getInstance().setUserEmail("name@domain.com");

Nota:

Solo se acepta un único correo electrónico por llamada en la versión 7.0.1 y posteriores. No se admiten varios correos electrónicos: si vuelves a llamar a setUserEmail, se sobrescribe el valor establecido anteriormente en lugar de añadirse.

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\"
     }
}

Véase también

  • Conexiones de partners de audiencias
  • Política de identificador de usuario de Audiencias

Tags