Show Menu
TEMAS×

Contenido del archivo de datos de entrada: Sintaxis, caracteres no válidos, variables y ejemplos

Campos requeridos, sintaxis y reglas que debe seguir al dar formato a un archivo de datos de características de entrada.

Sintaxis del contenido del archivo

Los campos del archivo de datos de entrada deben aparecer en el orden que se muestra a continuación. En este ejemplo, se han agregado los <``> símbolos para ayudar a separar visualmente cada elemento. No es necesario incluirlos 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 personalizadas de socios .
Tenemos un límite de 200 líneas que podemos procesar por cada ID de usuario enviado en el archivo de datos de entrada. Por ejemplo, si envía 300 líneas para un ID de usuario, se conservan las primeras 200 líneas y se descartan las 100 líneas adicionales. En el ejemplo siguiente, es bueno porque está enviando 3 líneas para el ID de usuario 1 y el ID de usuario 2. No se impone un límite en el número de atributos o pares de clave-valor que se incluyen en una línea.
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>

Variables de archivo definidas

La tabla enumera y define las variables utilizadas en un archivo de datos de entrada con el formato correcto. La letra en cursiva indica un marcador de posición de variable.
Variable Descripción
ID de usuario
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 el sistema CRM ( DPUUID, en Audience Manager ).
  • Un ID de dispositivo móvil Android o iOS en su formulario original sin modificar tal como lo expone el sistema operativo móvil.
Para ID móviles:
  • Formato IDFA: Los ID deben escribirse en mayúsculas y no con hash. Por ejemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: Los ID deben escribirse en minúsculas y no con hash. Por ejemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Separe el ID de usuario y los ID de características con un único delimitador de ficha.
ID de característica
ID de característica de Audience Manager . Le pedimos que incluya solo características integradas en archivos de datos de entrada. No procesamos ningún otro tipo de característica en la transferencia de datos de entrada.
Nota: La ID de característica se puede encontrar usando el método GET que devuelve detalles sobre todas sus características. Para obtener más información, consulte Métodos de API de características .

Formato de ID de características

En la tabla siguiente se describen los prefijos que identifican los nombres o ID de características en un archivo de datos de entrada. Consulte los ejemplos en los archivos de ejemplo.
Prefijo Descripción
d_sid=
El prefijo d_sid indica a nuestro sistema que el ID es un ID de característica de Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de características con el método API GET. Consulte Métodos de API de características .
d_unsid=
Los datos con el prefijo d_unsid eliminan a los usuarios de esa característica. El prefijo d_unsid se omite en un archivo de sobrescritura.
El prefijo d_unsid= indica a nuestro sistema que el ID es un ID de característica de Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de características con el método API GET. Consulte Métodos de API de características .
ic=
Las reglas de características permiten establecer criterios para la calificación de características. Si da formato a una regla de características como ic == ID de característica , puede enviar características en una lista sencilla con formato de coma.
Por ejemplo, supongamos que crea estas 3 reglas de características:
  • ic == "123"
  • ic == "456"
  • ic == "789"
Estas características están asociadas con la tecla ic. Esto le permite crear una lista de características más sencilla en el archivo de datos. Y no es necesario incluir el prefijo ic . Como resultado, el contenido del archivo de datos podría tener este aspecto:
                 ID de usuario <TAB> 123.456.789
Par clave-valor
Los datos de características se pueden formatear como pares de clave-valor mediante cadenas alfanuméricas. Existen varias formas de dar formato a los pares clave-valor, como se muestra a continuación:
  • key = valor
  • "key" = valor
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup" , product = tablet son todos ejemplos de pares de clave-valor formateados correctamente.

Caracteres no válidos en ID de características, ID de usuario y pares de clave-valor

ID de características

Las ID de características solo constan de caracteres numéricos. Le pedimos que incluya solo características integradas en archivos de datos de entrada. No procesamos ningún otro tipo de característica en la transferencia de datos de entrada.

ID de usuarios

Tipo de ID Requisito
DPUUID
No utilice dos puntos codificados ( %3A ) ni dos puntos sin codificar ( : ) en DPUUID.
ID de dispositivo móvil iOS (IDFA) o Android
Los ID de dispositivos móviles deben tener un formato estricto, como se muestra a continuación:
  • Formato IDFA: Los ID deben escribirse en mayúsculas y no con hash. Por ejemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Formato Android: Los ID deben escribirse en minúsculas y no con hash. Por ejemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Par de clave-valor

Los nombres de valores con formato incorrecto en un par de clave-valor también causan problemas. Siga estas reglas cuando cree o asigne un nombre al valor en un par clave-valor:
Carácter Requisito
Carácter de comillas (")
Puede utilizar el carácter de comillas en la clave y en la parte de valor del par clave-valor, de este modo:
  • d_city = "Nueva York", d_city = "San Francisco"
  • "d_city" = "Nueva York", "d_city" = "San Francisco"
Carácter de guión (-)
Ignoramos las señales de guiones al comienzo de las llaves. Por ejemplo, -product = cámara se interpreta como producto = cámara .
TAB
No utilice TAB en lugar de valores vacíos en pares clave-valor. Utilice únicamente TAB para separar variables en el archivo de datos de entrada.
\n, \t
No utilice la nueva línea o los caracteres de tabulación ( \n, \t ) en claves o en valores.

Ejemplos de archivos de datos

Formato de archivo de datos Descripción y ejemplo
Con d_sid o d_unsid
Este archivo de datos muestra un usuario cualificado para las características 24, 26, 27 y eliminado de las características 28 y 29.
59767559181262060060278870901087098252&nbsp;&nbsp;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 eliminar características de los perfiles de usuario mediante la siguiente sintaxis:
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29 1
Con ic==
Estas características se han agregado a una regla de características con el prefijo ic. Como tal, puede agregarlos al archivo de datos separados por comas, como se muestra. Una ficha separa el UUID y los ID de características. No se requiere el prefijo ic en el archivo.
ID numéricos
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30 626
ID de cadena
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55
Con pares de clave-valor
Los datos de este archivo utilizan pares clave-valor para pasar datos a Audience Manager .
59767559181262060060278870901087098252&nbsp;"gender"="yes","lujo_shopper"="yes""
Descargue el archivo de datos de ejemplo si necesita ejemplos adicionales. El archivo de descarga tiene una extensión .overwrite de archivo. Puede abrirlo con un editor de texto sencillo.

Matriz de ejemplos

El gráfico siguiente muestra ejemplos de la forma correcta de dar formato a los archivos entrantes, según el tipo de ID y el método por el que desee agregar características a los perfiles.
Tipo de ID / Operación Usar d_sid para agregar características a un perfil de usuario Utilice d_unsid para eliminar características de un perfil de usuario Enviar pares de clave-valor para agregar características a un perfil de usuario Utilice el prefijo ic para agregar características a un perfil de usuario
UUID de Audience Manager
ID de publicidad de Google para dispositivos Android
Apple IDFA para dispositivos iOS
Su propio ID de CRM (DPUUID)

Example 1

Utilice los ID de características para enviar información de cualificación de características para los UUID de Audience Manager.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Utilice los ID de características para enviar información de descalificación de características para los UUID de Audience Manager.
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

Example 3

Envíe pares de clave-valor para agregar información de calificación de características para los UUID de Audience Manager.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

o
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

Example 4

Utilice el prefijo ic para enviar información de cualificación de características para los UUID de Audience Manager.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

o
59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

Use los ID de características para enviar información de cualificación de características para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Use los ID de características para enviar información de descalificación de características para dispositivos Android.
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

Example 7

Envíe pares de clave-valor para añadir información de cualificación de características para dispositivos Android.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

o
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

Example 8

Utilice el prefijo ic para enviar información de cualificación de características 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

Example 9

Utilice los ID de características para enviar información de cualificación de características para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Use los ID de características para enviar información de descalificación de características para dispositivos iOS.
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

Example 11

Envíe pares de clave-valor para añadir información de cualificación de características para dispositivos iOS.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

o
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

Example 12

Utilice el prefijo ic para enviar información de cualificación de características 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

Example 13

Use ID de características para enviar información de cualificación de características para DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Use ID de características para enviar información de descalificación de características para DPUUID.
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

Example 15

Envíe pares de clave-valor para agregar información de cualificación de características para DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

Example 16

Utilice el prefijo ic para enviar información de cualificación de características para DPUUID.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

o
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55