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 Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

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, se han agregado los 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:

  • Identificador de usuario único asignado por el Audience Manager de ( 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 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 identificador de rasgo del Audience Manager . Le rogamos que incluya solo características integradas en los 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 identificadores en un archivo de datos de entrada. Vea los archivos de ejemplo para ver ejemplos.

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

Los datos con el prefijo d_unsid quitan a los usuarios de esa característica. El prefijo d_unsid se omite en un archivo overwrite .

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

ic=

Las reglas de rasgosle permiten establecer criterios para la clasificación de rasgos. Si da formato a una regla de rasgos como ic == trait ID , puede enviar rasgos en una lista simple 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 con la clave ic . Esto permite crear una lista de rasgos más sencilla en el archivo de datos. Además, no necesita incluir el prefijo ic . 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 son todos ejemplos de pares clave-valor correctamente formateados.

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

Trait IDs

Trait IDs solo consta de caracteres numéricos. Le rogamos que incluya solamenteonboarded traits en los archivos de datos de entrada. No se procesa ningún otro tipo de trait en la transferencia de datos de entrada.

User IDs

Tipo de ID
Requisito
DPUUID
No use un símbolo de dos puntos codificado ( %3A ) o no codificado ( : ) 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 use TAB en lugar de valores vacíos en pares clave-valor. Use solamente TAB 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 claves o 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 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  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 al Audience Manager .

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

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

El gráfico siguiente muestra ejemplos de la forma correcta de dar formato a los archivos de entrada, según el tipo de identificadores y el método por el cual desee agregar traits a los 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
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 example-1

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

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

Ejemplo 2 example-2

Use trait IDs para enviar información de descalificación de trait 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 agregar información de calificación trait para Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

o

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

Ejemplo 4 example-4

Use 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 5 example-5

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

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

Ejemplo 6 example-6

Use trait IDs para enviar información de descalificación de trait 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 agregar información de calificación trait 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

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

Ejemplo 9 example-9

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

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

Ejemplo 10 example-10

Use trait IDs para enviar información de descalificación de trait 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 agregar información de calificación trait 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

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

Ejemplo 13 example-13

Use trait IDs para enviar información de calificación trait para DPUUIDs.

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

Ejemplo 14 example-14

Use trait IDs para enviar información de descalificación de trait 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 agregar la información de calificación trait para DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

o

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

Ejemplo 16 example-16

Use 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
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695