Contenido del archivo de datos de entrada: sintaxis, caracteres no válidos, variables y ejemplos inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Campos obligatorios, sintaxis y reglas que debe seguir al dar formato a un archivo de datos de rasgos de entrada.
Sintaxis del contenido del archivo file-content-syntax
Los campos del archivo de datos de entrada deben aparecer en el orden indicado a continuación. En este ejemplo, se han agregado los símbolos <
>
para ayudar a separar visualmente cada elemento. No es necesario que los incluya en el archivo de datos.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Para ver otros formatos de contenido de archivo aceptados, consulte Integraciones de socios personalizadas.
code language-none |
---|
|
Variables de archivo definidas file-variables-defined
La tabla enumera y define las variables utilizadas en un archivo de datos entrantes correctamente formateado. La letra en cursiva indica un marcador de posición de variable.
User ID
Un ID de usuario puede ser:
- Identificador de usuario único asignado por el Audience Manager de ( UUID de Audience Manager ).
- Un ID de usuario único asignado en su sistema CRM ( DPUUID, en el Audience Manager).
- Un ID de dispositivo móvil Android o iOS en su forma original sin modificar según lo expuesto por el sistema operativo móvil.
Para ID móviles:
- Formato IDFA: Los ID deben estar en mayúsculas y no tener hash. Por ejemplo,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: Los ID deben estar en minúsculas y no tener hash. Por ejemplo,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
El identificador de rasgo del Audience Manager . Le rogamos que incluya solo características integradas en los archivos de datos de entrada. No procesamos ningún otro tipo de rasgos en la transferencia de datos de entrada.
Nota: El ID de rasgo se puede encontrar mediante el método de GET que devuelve detalles sobre todos los rasgos. Para obtener más información, consulte Métodos de API de rasgos.
Formato Trait IDs formatting-trait-ids
En la tabla siguiente se describen los prefijos que identifican trait nombres o identificadores en un archivo de datos de entrada. Vea los archivos de ejemplo para ver ejemplos.
d_sid=
d_sid
indica a nuestro sistema que el identificador es un identificador de rasgo de Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con el método de API GET
. Consulte métodos de API de rasgos.d_unsid=
Los datos con el prefijo d_unsid
quitan a los usuarios de esa característica. El prefijo d_unsid
se omite en un archivo overwrite
.
El prefijo d_unsid=
indica a nuestro sistema que el identificador es un identificador de rasgo de Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con el método de API GET
. Consulte métodos de API de rasgos.
ic=
Las reglas de rasgosle permiten establecer criterios para la clasificación de rasgos. Si da formato a una regla de rasgos como ic == trait ID
, puede enviar rasgos en una lista simple con formato de coma.
Por ejemplo, supongamos que crea estas 3 reglas de rasgos:
ic == "123"
ic == "456"
ic == "789"
Estos rasgos están asociados con la clave ic
. Esto permite crear una lista de rasgos más sencilla en el archivo de datos. Además, no necesita incluir el prefijo ic
. Como resultado, el contenido del archivo de datos podría tener este aspecto:
user ID <TAB> 123,456,789
Los datos de rasgos se pueden formatear como pares clave-valor mediante cadenas alfanuméricas. Existen varias formas de dar formato a los pares clave-valor, como se muestra a continuación:
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
, "gender"=m
, model = "pickup truck"
, product = tablet
son todos ejemplos de pares clave-valor correctamente formateados.
Caracteres no válidos en Trait IDs, User IDs y pares clave-valor invalid-chars
Trait IDs
Trait IDs solo consta de caracteres numéricos. Le rogamos que incluya solamenteonboarded traits en los archivos de datos de entrada. No se procesa ningún otro tipo de trait en la transferencia de datos de entrada.
User IDs
%3A
) o no codificado ( : ) en los DPUUID.Los ID de dispositivos móviles deben tener el formato estricto que se muestra a continuación:
- Formato IDFA: Los ID deben estar en mayúsculas y no tener hash. Por ejemplo,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Formato Android: Los ID deben estar en minúsculas y no tener hash. Por ejemplo,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Pares de clave-valor
Los nombres de valores con formato incorrecto en un par clave-valor también causan problemas. Siga estas reglas al crear o asignar un nombre al valor en un par clave-valor:
Puede utilizar el carácter de comilla en la parte clave y valor del par clave-valor, de esta manera:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
se interpreta como product = camera
.TAB
TAB
en lugar de valores vacíos en pares clave-valor. Use solamente TAB
para separar variables en el archivo de datos de entrada.\n, \t
\n, \t
) en claves o valores.Ejemplos de archivos de datos data-file-examples
d_sid
o d_unsid
Este archivo de datos muestra un usuario cualificado para los rasgos 24, 26, 27 y que se ha eliminado de los rasgos 28 y 29.
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Nota:
En lugar de utilizar d_unsid, también puede quitar rasgos de los perfiles de usuario mediante la siguiente sintaxis:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Estos rasgos se han agregado a una regla de rasgos con el prefijo ic
. Como tal, puede agregarlos al archivo de datos separados por comas como se muestra. Una pestaña separa el UUID y los ID de rasgos. El prefijo ic
no es necesario en el archivo.
ID numéricos
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
Id. de cadena
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Estos datos de archivo utilizan pares de clave-valor para pasar datos al Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
Descargue el archivo de datos de ejemplo si necesita ejemplos adicionales. El archivo de descarga tiene una extensión de archivo .overwrite
. Puede abrirlo con un editor de texto sencillo.
Matriz de ejemplos examples-matrix
El gráfico siguiente muestra ejemplos de la forma correcta de dar formato a los archivos de entrada, según el tipo de identificadores y el método por el cual desee agregar traits a los perfiles.
Ejemplo 1 example-1
Use trait IDs para enviar información de calificación trait para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Ejemplo 2 example-2
Use trait IDs para enviar información de descalificación de trait para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
o
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
o
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
Ejemplo 3 example-3
Envíe pares de clave-valor para agregar información de calificación trait para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
o
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 4 example-4
Use el prefijo ic
para enviar la información de calificación trait para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
o
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Ejemplo 5 example-5
Use trait IDs para enviar información de calificación de trait para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 6 example-6
Use trait IDs para enviar información de descalificación de trait para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
o
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
o
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
Ejemplo 7 example-7
Envíe pares de clave-valor para agregar información de calificación trait para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
o
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 8 example-8
Use el prefijo ic
para enviar información de calificación trait para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
o
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Ejemplo 9 example-9
Use trait IDs para enviar información de calificación de trait para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 10 example-10
Use trait IDs para enviar información de descalificación de trait para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
o
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
o
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
Ejemplo 11 example-11
Envíe pares de clave-valor para agregar información de calificación trait para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
o
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 12 example-12
Use el prefijo ic
para enviar información de calificación trait para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
o
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Ejemplo 13 example-13
Use trait IDs para enviar información de calificación trait para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 14 example-14
Use trait IDs para enviar información de descalificación de trait para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
Ejemplo 15 example-15
Envíe pares de clave-valor para agregar la información de calificación trait para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 16 example-16
Use el prefijo ic
para enviar la información de calificación trait para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55