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
- 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.
- Desarrolladores—Configuren los identificadores seleccionados, utilizando:
- Parámetros y requisitos de formato según aparecen en la tabla de identificadores disponibles.
- La referencia y los ejemplos de código para SDK y S2S.
- En el panel de Audiencias:
- Establezca su política de identificadores de usuario a nivel de cuenta.
- Seleccione los identificadores que se cargarán en cada una de sus conexiones de socios.
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) |
|---|---|---|---|
| Dirección de correo electrónico | correo electrónico_sha256 |
SDK v7.0.0 y versiones anteriores:
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):
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):
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.
- SDK v7.0.1 y versiones posteriores: usa
- 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
setAdditionalDatacon datos personalizados.
- SDK v7.0.1 y versiones posteriores: usa
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 porsetUserEmail. Es un cambio que rompe la compatibilidad, no una deprecación. Las aplicaciones con la v7.0.0 o versiones anteriores deben seguir usandosetUserEmails. Las aplicaciones con la v7.0.1 o versiones posteriores deben cambiar asetUserEmail. 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:setAdditionalDatasigue funcionando. Para las integraciones nuevas y para los clientes que actualicen a la v7.0.1 o posterior, recomendamos migrar asetUserPhone. Las apps con la v7.0.0 o anterior deben seguir usandosetAdditionalData, porquesetUserPhoneno 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
NSDictionary *customData = @{
@"audiences": @{
@"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
@"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
}
};
[[AppsFlyerLib shared] setAdditionalData:customData];número de teléfono_sha256Nota
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 | |
| Ejemplo de uso | |
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 | |
| Ejemplo de uso | |
SDK v7.0.1 y versiones posteriores
| Firma del método | |
| Ejemplo de uso | |
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
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);
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)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 | |
| Ejemplo de uso | |
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 | |
| Ejemplo de uso | |
SDK v7.0.1 y versiones posteriores
| Firma del método | |
| Ejemplo de uso | |
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\"
}
}
Véase también
This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.