How can we help?

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

  • Actualización

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

SDK v7.0.0 y versiones anteriores:

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

SDK v7.0.1 y versiones posteriores: Texto sin formato. El SDK lo normaliza y lo 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.
  • Incluya el 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 le 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 le aplica Hashing automáticamente.

+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
    • 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.

 Nota:

Recuerda los siguientes cambios en función de 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. Es un cambio que rompe la compatibilidad, no una deprecación. Las aplicaciones con la v7.0.0 o versiones anteriores deben seguir usando setUserEmails. Las aplicaciones con la v7.0.1 o versiones posteriores deben cambiar a setUserEmail. Comprueba la versión del SDK integrado antes de elegir qué ejemplo seguir.
  • Teléfono: A partir del SDK v7.0.1, hay disponible una API específica de setUserPhone. Es la forma recomendada de enviar identificadores de número de teléfono para Advanced Matching. Esto no supone un cambio incompatible: setAdditionalData sigue funcionando. Para las integraciones nuevas y para los clientes que actualicen a la v7.0.1 o posterior, recomendamos migrar a setUserPhone. Las apps con la v7.0.0 o anterior deben seguir usando setAdditionalData, porque setUserPhone no existe en esas versiones del SDK.

Configuración del SDK para iOS

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

SDK v7.0.0 y versiones anteriores — setAdditionalData

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

Nota

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 Swift
[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];

Advertencia

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 Swift
NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType: EmailCryptTypeSHA256];

SDK v7.0.1 y versiones posteriores

Firma del método
- (void)setUserEmail:(NSString *_Nonnull)email;
Ejemplo de uso
Objective-C Swift
[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];

Audiencias: identificadores adicionales

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 configurado 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 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);

Hash SHA256

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
JavaKotlin
AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");

Advertencia

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
JavaKotlin
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");

Advertencia

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 configurado anteriormente en lugar de añadirlo.

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

This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.

Share article: