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 lista 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
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 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 rasgo con un único delimitador de tabulación.
trait ID
ID de característica del Audience Manager. Le pedimos que incluya solo características integradas en los 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 Trait IDs

En la tabla siguiente se describen los prefijos que identifican trait nombres o ID en un archivo de datos de entrada. Consulte los ejemplos en los archivos de ejemplo.
Prefijo Descripción
d_sid=
El d_sid prefijo indica a nuestro sistema que el ID es un ID de característica Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de características con el GET método API. 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 d_unsid prefijo se ignora en un overwrite archivo.
El d_unsid= prefijo indica a nuestro sistema que el ID es un ID de característica Audience Manager . Es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de características con el GET método API. 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 == trait ID , puede enviar características en una simple lista 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 ic clave. Esto le 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
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 = value
  • "key" = value
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet son todos ejemplos de pares de clave-valor formateados correctamente.

Caracteres no válidos en pares Trait IDsy clave-valor User IDs

Trait IDs

Trait IDs consiste únicamente en caracteres numéricos. Le pedimos que incluya solamenteonboarded traits ​en los archivos de datos de entrada. No procesamos ningún otrotraittipo en la transferencia de datos de entrada.

User IDs

Tipo de ID Requisito
DPUUID
No utilice dos puntos ( %3A ) o dos puntos (: ) 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 = "New York", d_city = "San Francisco"
  • "d_city" = "New York", "d_city" = "San Francisco"
Carácter de guión (-)
Ignoramos las señales de guiones en el inicio de las llaves. Por ejemplo, -product = camera se interpreta como product = camera .
TAB
No utilice valores en TAB lugar de valores vacíos en pares clave-valor. Utilice sólo 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 que se ha 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 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 ic prefijo . 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. El ic prefijo no es obligatorio en el archivo.
ID numéricos
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626
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 al Audience Manager .
59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_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 traits a los perfiles.
Tipo de ID / Operación Usar d_sid para agregar características a un perfil de usuario Usar 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

Se utiliza trait IDs para enviar información trait de cualificación para Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Utilícelo trait IDs para enviar información trait 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

Example 3

Envíe pares de clave-valor para agregar trait información de calificación para UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

Utilice el ic prefijo para enviar la información de trait cualificación para UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

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

Example 5

Se utiliza trait IDs para enviar información trait de cualificación para Android dispositivos.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Se utiliza trait IDs para enviar información de trait 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

Example 7

Envíe pares de clave-valor para agregar 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"

Example 8

Utilice el ic prefijo para enviar información trait 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

Example 9

Se utiliza trait IDs para enviar información trait de cualificación para iOS dispositivos.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Se utiliza trait IDs para enviar información de trait 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

Example 11

Envíe pares de clave-valor para agregar 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"

Example 12

Utilice el ic prefijo para enviar información trait 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

Example 13

Se utiliza trait IDs para enviar información trait de cualificación para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Utilícelo trait IDs para enviar información trait 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

Example 15

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

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

Example 16

Utilice el ic prefijo para enviar información trait de cualificación para DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

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