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, la variable <
>
se han agregado 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:
- ID de usuario único asignado por Audience Manager ( UUID DE AUDIENCE MANAGER).
- Un ID de usuario único asignado en su sistema CRM ( DPUUID, en 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 Audience Manager ID de rasgo. Le pedimos que incluya solo características integradas en 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 ID en un archivo de datos de entrada. Consulte la archivos de muestra para ver ejemplos.
d_sid=
d_sid
indica a su sistema que el ID es un Audience Manager ID de rasgo. Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con la API GET
método. Consulte Métodos de API de rasgos.d_unsid=
Datos con el prefijo d_unsid
elimina usuarios de ese rasgo. El d_unsid
el prefijo se omite en un overwrite
archivo.
El d_unsid=
indica a su sistema que el ID es un Audience Manager ID de rasgo. Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con la API GET
método. Consulte Métodos de API de rasgos.
ic=
Reglas de rasgospermite definir criterios para la clasificación de rasgos. Si da formato a una regla de rasgos como ic == trait ID
, puede enviar los rasgos en una lista sencilla 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 a la variable ic
clave. Esto permite crear una lista de rasgos más sencilla en el archivo de datos. Y, no es necesario incluir el ic
prefijo. 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
Estos son todos ejemplos de pares de clave-valor con un formato correcto.
Caracteres no válidos en Trait IDs, User IDs y pares clave-valor invalid-chars
Trait IDs
Trait IDs constar solo de caracteres numéricos. Le pedimos que incluya solamenteonboarded traits en archivos de datos de entrada. No procesamos ningún otro trait tipos en la transferencia de datos de entrada.
User IDs
%3A
) o el símbolo de dos puntos sin codificar ( : ) 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. Usar solo TAB
para separar variables en el archivo de datos de entrada.\n, \t
\n, \t
) en claves o en 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 añadido a una regla de rasgos con la variable ic
prefijo. 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 ic
no se requiere el prefijo 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 a Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
Descargar Seleccione el archivo de datos de ejemplo si necesita ejemplos adicionales. El archivo de descarga tiene un .overwrite
extensión de archivo. 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 entrantes, según la variable tipo de ID y el método por el que desea agregar traits a perfiles.
Ejemplo 1 example-1
Uso trait IDs para enviar trait información de cualificación para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Ejemplo 2 example-2
Uso trait IDs para enviar trait información de descalificación 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 añadir trait información de cualificación para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
o
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 4 example-4
Utilice el ic
prefijo para enviar trait información de cualificación para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
o
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Ejemplo 5 example-5
Uso trait IDs para enviar trait información de cualificación para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 6 example-6
Uso trait IDs para enviar trait información de descalificación 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 añadir trait información de cualificación 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
Utilice el ic
prefijo para enviar trait información de cualificación para Android dispositivos.
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
Uso trait IDs para enviar trait información de cualificación para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 10 example-10
Uso trait IDs para enviar trait información de descalificación 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 añadir trait información de cualificación 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
Utilice el ic
prefijo para enviar trait información de cualificación para iOS dispositivos.
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
Uso trait IDs para enviar trait información de cualificación para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Ejemplo 14 example-14
Uso trait IDs para enviar trait información de descalificación 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 añadir trait información de cualificación para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Ejemplo 16 example-16
Utilice el ic
prefijo para enviar trait información de cualificación para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55