DocumentaciónAudience ManagerGuía del usuario de Audience Manager

Contenido Archivo datos de entrada: Sintaxis, caracteres no válidos, variables y ejemplos inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Campos obligatorios, sintaxis y reglas que se deben seguir al formatear un fichero de datos de rasgos de entrada.

Sintaxis de contenido de Archivo file-content-syntax

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 necesita incluirlas en el archivo de datos.

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

Para conocer otros formatos aceptados contenido archivos, consulte Integraciones personalizadas de socios.

NOTE
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, las primeras 200 líneas se mantienen y las 100 líneas adicionales se descartan. En el siguiente ejemplo, está bien porque está enviando 3 líneas cada una para usuario ID 1 y usuario ID 2. No imponemos un límite en el número de rasgos o pares 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 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 ( Audience Manager UUID).
  • ID de usuario únicos asignados en el sistema de CRM ( DPUUID, en Audience Manager).
  • Un ID de dispositivos móvil de Android o iOS en su forma original, sin modificar según lo expuesto por el sistema operativo móvil.

Para los ID móviles:

  • formato IDFA: los ID deben estar en mayúsculas y no tener hash. Por ejemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android formato: 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 características con un único delimitador pestaña.
trait ID

La Audience Manager ID de rasgos. Le pedimos que incluya solo las características integradas en los archivos de datos de entrada. No procesamos ningún otro tipo de rasgo en la transferencia de datos entrante.

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

Formateo Trait IDs formatting-trait-ids

La tabla siguiente describe los prefijos que identifican trait nombres o ID en un archivo de datos de entrada. Consulte los archivos demuestra para ver ejemplos.

Prefijo
Descripción
d_sid=
El d_sid prefijo le dice a nuestro sistema que el ID es un ID de rasgo 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 derasgos .
d_unsid=

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

El d_unsid= prefijo le dice a nuestro sistema que el ID es un ID de rasgo 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 derasgos .

ic=

Las reglas derasgos permiten establecer criterios para la calificación de los rasgos. Si formato un rasgo regla como ic == trait ID , puede enviar características en un 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 se asocian con la ic clave. Esto permite crear un lista de rasgos más sencillo en el archivo de datos. Y no es necesario que incluya el ic prefijo. Como resultado, el contenido del archivo de datos podría verse gustar esto:

                 user ID <TAB> 123,456,789

Pares clave-valor

Los datos de rasgos se pueden formatear como pares clave-valor mediante cadenas alfanuméricas. Hay 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" , son product = tablet todos ejemplos de pares clave-valor con formato correcto.

Caracteres no válidos en Trait IDsy User IDs pares Valor clave invalid-chars

Trait IDs

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

User IDs

Tipo de ID
Requisito
DPUUID
No utilice dos puntos codificados ( %3A ) ni dos puntos no codificados ( : ) en DPUUID.
ID de dispositivos móvil de iOS (IDFA) o Android

Los ID de dispositivos móviles deben tener un formato estricto como se muestra aquí:

  • formato IDFA: los ID deben estar en mayúsculas y no tener hash. Por ejemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android formato: los ID deben estar en minúsculas y no tener hash. Por ejemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Pares clave-Valor

El formato incorrecto de los nombres de valores en un par clave-valor también causa problemas. Siga estas reglas al crear o nombrar el valor en un par clave-valor:

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

Puede usar el carácter de comillas en la parte clave y en la parte de valor del par clave-valor, gustar así:

  • 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 en la inicio de teclas. Por ejemplo, -product = camera se interpreta como product = camera .
TAB
No utilice TAB en lugar de valores vacíos en pares de clave-valor. Solo se utiliza TAB para separar variables en el archivo de datos de entrada.
\n, \t
No utilice las nuevas líneas ni pestaña caracteres ( \n, \t ) en claves o valores.

Ejemplos de Archivo de datos data-file-examples

Formato Archivo datos
Descripción y ejemplo
Con d_sid o d_unsid

Este archivo de datos muestra un usuario calificado 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 usar d_unsid, también puede quitar características de usuario perfiles mediante la siguiente sintaxis:

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 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 a continuación. Un pestaña separa el UUID y el ID de rasgo. El ic prefijo no es necesario en el archivo.

ID numéricas

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

ID de cadena

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

Con pares de clave-valor

Los datos de este archivo utilizan pares de clave-valor para pasar los datos a Audience Manager .

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

Descargue el archivo de datos de ejemplo si necesita ejemplos adicionales. El archivo descargar tiene una .overwrite extensión de archivo. Puede abrirlo con una simple editor de texto.

Matriz de ejemplos examples-matrix

El siguiente gráfico muestra ejemplos de la forma correcta de formato los archivos entrantes, según el tipo de ID y el método mediante el cual desee agregara los traitsperfiles.

Tipo de ID / Operación
Utilice d_sid para agregar características a una usuario perfil
Utilice d_unsid para eliminar características de una usuario perfil
Enviar pares de clave-valor para añadir características a una perfil de usuario
Use el prefijo ic para agregar características a una perfil de usuario
Audience Manager UUID
Ejemplo 1
Ejemplo 2
Ejemplo 3
Ejemplo 4
ID de publicidad de Google para dispositivos Android
Ejemplo 5
Ejemplo 6
Ejemplo 7
Ejemplo 8
IDFA de Apple para iOS dispositivos
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

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

Se utiliza 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 agregar 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 prefijo para enviar información de ic cualificación para trait Audience Manager.UUIDs

59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

o

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Ejemplo 5 example-5

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

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

Ejemplo 6 example-6

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

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

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

Ejemplo 10 example-10

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

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

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