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

Campos, sintaxis y reglas requeridos que debe seguir al dar formato a un archivo de datos de rasgos entrantes.

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 de socios personalizadas.

NOTA

Tenemos un límite de 200 líneas que podemos procesar para 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 200 primeras líneas y se descartan las 100 líneas adicionales. En el siguiente ejemplo, es bueno porque está enviando 3 líneas cada una para el ID de usuario 1 y el ID de usuario 2. No se impone un límite en el número de rasgos 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 que se utilizan 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:

  • Un ID de usuario único asignado por el Audience Manager ( 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 de Android o iOS en su forma original sin modificar tal como lo expone 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

Separe el ID de usuario y los ID de rasgo con un delimitador de ficha único.

trait ID

El ID de rasgo del Audience Manager . Le pedimos que incluya solo los rasgos incorporados en los archivos de datos entrantes. No se procesa ningún otro tipo de rasgo en la transferencia de datos de entrada.

Nota: El ID de rasgo se puede encontrar usando el método de GET que devuelve detalles sobre todos sus rasgos. Para obtener más información, consulte Métodos de API de rasgos .

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 archivos de muestra para ver ejemplos.

Prefijo Descripción

d_sid=

El prefijo d_sid indica a nuestro sistema que el ID es un ID de rasgo del Audience Manager . Este es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con el método API GET . Consulte Métodos de API de rasgos .

d_unsid=

Los datos con el prefijo d_unsid eliminan usuarios de ese rasgo. El prefijo d_unsid se ignora en un archivo overwrite .

El prefijo d_unsid= indica a nuestro sistema que el ID es un ID de rasgo del Audience Manager . Este es el mismo ID que se muestra en la interfaz de usuario. También puede devolver ID de rasgos con el método API GET . Consulte Métodos de API de rasgos .

ic=

Las reglas de características permiten establecer criterios para la calificación de características. Si aplica formato de ic == trait ID a una regla de rasgos, puede enviar rasgos 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"

Estos rasgos están asociados a la clave ic . Esto permite crear una lista de rasgos más sencilla en el archivo de datos. Además, no es necesario incluir el prefijo ic . Como resultado, el contenido del archivo de datos podría tener este aspecto:

                 user ID <TAB> 123,456,789

Pares de clave-valor

Los datos de rasgos se pueden formatear como pares clave-valor usando cadenas alfanuméricas. Existen varias formas de aplicar 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 ejemplos de pares de clave-valor con formato correcto.

Caracteres no válidos en los pares Trait IDs, User IDs y clave-valor

Trait IDs

Trait IDs consiste únicamente en caracteres numéricos. Le pedimos que incluya soloonboarded traits en los archivos de datos de entrada. No procesamos ningún otro tipo trait en la transferencia de datos de entrada.

User IDs

Tipo de ID Requisito

DPUUID

No utilice dos puntos codificados ( %3A ) ni dos puntos sin codificar ( : ) en los DPUUID.

ID de dispositivo de iOS móvil (IDFA) o Android

Los ID de dispositivos móviles deben tener un formato estricto, tal y como 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 dar 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 esta manera:

  • 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 guión al principio de las teclas. Por ejemplo, -product = camera se interpreta como product = camera .

TAB

No utilice TAB en lugar de valores vacíos en pares clave-valor. Utilice TAB únicamente para separar variables en el archivo de datos de entrada.

\n, \t

No utilice los caracteres de nueva línea o tabulación ( \n, \t ) en las claves o en los valores.

Ejemplos de archivos de datos

Formato del archivo de datos Descripción y ejemplo

Con d_sid o d_unsid

Este archivo de datos muestra un usuario cualificado para los rasgos 24, 26, 27 y se ha eliminado de los rasgos 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 usar 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==

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&nbsp;&nbsp;30608,50354,50338,50352,30626

ID de cadena

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55

Con pares de clave-valor

Estos datos del archivo utilizan pares clave-valor para pasar datos al Audience Manager .

59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”

[] (assets/ftp_dpm_1234_1445374061.overwrite) 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

El gráfico siguiente muestra ejemplos de la forma correcta de dar formato a los archivos de entrada, en función del tipo de ID y del método por el que desea 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 en pares de clave-valor para añadir características a un perfil de usuario Utilice el prefijo ic para añadir características a un perfil de usuario

UUID de Audience Manager

Ejemplo 1

Ejemplo 2

Ejemplo 3

Ejemplo 4

Google Advertising ID para dispositivos Android

Ejemplo 5

Ejemplo 6

Ejemplo 7

Ejemplo 8

Apple IDFA para dispositivos iOS

Ejemplo 9

Ejemplo 10

Ejemplo 11

Ejemplo 12

Su propio ID de CRM (DPUUID)

Ejemplo 13

Ejemplo 14

Ejemplo 15

Ejemplo 16

Ejemplo 1

Utilice trait IDs para enviar la información de calificación trait para Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Ejemplo 2

Utilice 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

Envíe pares de clave-valor para agregar trait información de calificación para Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

o

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

Ejemplo 5

Utilice 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 4

Utilice trait IDs para enviar la información de calificación trait para dispositivos Android.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Ejemplo 6

Utilice trait IDs para enviar la información de descalificación trait para los 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

Ejemplo 7

Envíe pares de clave-valor para agregar información de calificación trait para dispositivos Android.

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

o

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

Ejemplo 8

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

Utilice trait IDs para enviar la información de calificación trait para dispositivos iOS.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Ejemplo 10

Utilice trait IDs para enviar la información de descalificación trait para los 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

Ejemplo 11

Envíe pares de clave-valor para agregar información de calificación trait para dispositivos iOS.

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

o

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

Ejemplo 12

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

Utilice trait IDs para enviar la información de calificación trait para DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Ejemplo 14

Utilice 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

Envíe pares de clave-valor para agregar información de calificación trait para DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

o

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

Ejemplo 16

Utilice 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

En esta página