DocumentaciónAudience ManagerGuía del usuario de Audience Manager

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

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

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.

NOTE
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, las 200 primeras líneas se conservan y las 100 líneas adicionales se descartan. En el ejemplo siguiente, tiene razón porque envía tres líneas para el ID de usuario 1 y el ID de usuario 2. No aplicamos un límite al número de características o pares de clave-valor que se incluyen en una línea.
code language-none 
<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 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.

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 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
Separe el ID de usuario y los ID de rasgos con un solo delimitador de tabulación.
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.

Prefijo
Descripción
d_sid=
El 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

Pares clave-valor

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

Tipo de ID
Requisito
DPUUID
No hacer utilice dos puntos codificados ( %3A ) o el símbolo de dos puntos sin codificar ( : ) en los DPUUID.
ID de dispositivo móvil iOS (IDFA) o Android

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:

Carácter
Requisito
Carácter de comillas (")

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"

Carácter de guión (-)
Ignoramos las señales de guion al principio de las teclas. Por ejemplo, -product = camera se interpreta como product = camera .
TAB
No hacer use 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
No utilice caracteres de tabulación o de línea nueva ( \n, \t ) en claves o en valores.

Ejemplos de archivos de datos data-file-examples

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

con 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

Con pares clave-valor

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.

Tipo de ID/Operación
Usar d_sid para agregar características a un perfil de usuario
Use d_unsid para eliminar rasgos de un perfil de usuario
Envíe pares de clave-valor para añadir características a un perfil de usuario
Utilice el prefijo ic para añadir rasgos a un perfil de usuario
UUID DE AUDIENCE MANAGER
Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 4
ID de publicidad de Google 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 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
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695