Compartir a través de

API de plataforma digital: formato de archivo BSS heredado

  • Artículo

El servicio batch segment proporciona la capacidad de cargar archivos de datos de segmento en una variedad de formatos. Para obtener más información, consulte los ejemplos siguientes.

Nota:

El formato Avro descrito en Formato de archivo de Avro de BSS proporciona compatibilidad con una variedad más amplia de identificadores de usuario. El método descrito en este tema ha sido el formato estándar en el pasado, pero se espera que esté en desuso en el futuro, ya que la identificación del usuario se basa cada vez más en los EID (identificadores extendidos) y los identificadores de primer fabricante del publicador en lugar de en las cookies.

Sugerencia

Hable con el representante de su cuenta para obtener ayuda con la configuración de nuestro sistema para aceptar su formato de archivo en particular.

Introducción al formato

Cada línea del archivo especificará un mínimo de uno UID (identificador de usuario) y uno o varios SEG bloques. Los separadores son configurables.

En la tabla siguiente se describe el orden de los bloques y separadores que componen cada línea.

| UID | | SEG | SEPARATOR1 | SEG | SEPARATOR2 | SEG | SEPARATOR4 | SEG | SEPARATOR2 | SEPARATOR5DOMINIO |

UID

Nombre Tipo Description Ejemplo
UID Entero Identificador de usuario de Xandr que se agrega a un segmento o se quita de este. 5727816213491965430

SEG Bloquear

El SEG bloque describe los segmentos a los que se va a agregar o quitar el usuario y contendrá datos como el identificador de segmento o un código de segmento definido por el usuario.

Construya un SEG bloque de la siguiente manera:

| SEG_FIELD | SEPARATOR3 | SEG_FIELD |

SEG_FIELD Bloquear

En la tabla siguiente se enumeran los valores posibles que se pueden incluir en el SEG_FIELD bloque. Cuando existan valores predeterminados, se aplicarán a menos que se especifique lo contrario.

Nota:

Cada SEG bloque debe ser normal, lo que significa que debe tener todos los campos que haya elegido incluir. Por ejemplo, si ha incluido el VALUE campo pero no tiene un valor para un usuario determinado, debe usar 0 como valor.

Nombre Tipo Description Ejemplo
SEG_ID Entero Identificador del segmento Xandr.
Predeterminado: Esto lo genera el sistema cuando se crea el segmento.		 1234567890
SEG_CODE string Nombre definido por el usuario para el segmento. Puede incluir SEG_CODE o SEG_ID pero no ambos. "18-35_autobuy"
EXPIRATION Entero Duración del segmento, empezando por el valor de TIMESTAMP. Se especifica en minutos. Un valor de 0 significa que el usuario expirará en el segmento después del máximo permitido de 180 días; -1 significa que el usuario se quitará de este segmento.

Predeterminado: El valor predeterminado se especifica en el nivel de segmento cuando se crea el segmento. Si no existe ninguna, se usa la configuración de la API de segmento de Batch. El uso de este campo invalidará el valor predeterminado.		 1440
TIMESTAMP Entero Hora a la que desea que su segmento entre en vigor. Marca de tiempo de UNIX, hasta el segundo. Si se envía una marca de tiempo a una mayor especificidad (hasta milisegundos, por ejemplo), el usuario no se escribirá correctamente en el segmento al cargarse.
Predeterminado: Hora actual.		 1278250469
VALUE Entero Valor numérico que desea asignar a un segmento. 310

Nota:
El valor máximo aceptado es 2147483647. (Si se incluye un valor por encima de esto, puede haber imprevisibilidad del comportamiento, como que el píxel no se active y no se procese. Por lo tanto, el usuario no se agregará al segmento. Otras veces, se procesará, sin embargo, el conjunto de valores será mucho más pequeño que lo que se pasó).
MEMBER_ID Entero Este campo solo es necesario si usa y SEG_CODE carga los datos de otros miembros además de los suyos propios.
Predeterminado: .member_id		 958

DOMAIN

Nombre Tipo Descripción
DOMAIN string Opcionalmente, puede especificar un dominio para asociarlo a este identificador de usuario.

Separadores

Siga leyendo para ver las definiciones de cada tipo de separador. Cada separador debe ser diferente, excepto para SEPARATOR1 y SEPARATOR3, que puede ser idéntico (SEPARATOR2 y SEPARATOR4, no puede ser idéntico). Cada separador debe tener solo 1 carácter de longitud.

Precaución

Caracteres no permitidos

Los caracteres siguientes no se permiten como separadores: [ ] ( ) { } $ \ / | ? * + -

SEPARATOR1

Separa el identificador de usuario de la lista de segmentos (o SEG bloque). Solo puede haber uno por línea. Obligatorio.

SEPARATOR2

Separa los segmentos dentro de la lista de segmentos. Puede haber muchos por línea, ya que se pueden asociar varios segmentos a un único UID. Obligatorio si hay más de un segmento.

SEPARATOR3

Separa los campos dentro de cada SEG bloque. Si se establece, debe seguir siendo el mismo para cada línea del archivo (excepto después SEPARATOR4de ). Obligatorio si hay más de un campo dentro de SEG.

SEPARATOR4

El usuario se quitará de los segmentos que aparecen después de este separador. Opcional.

SEPARATOR5

El usuario se agregará a DOMAIN o buscará en el conjunto designado directamente después de este separador. Opcional.

Nota:

Campos de datos de id. de dispositivo móvil

Para pasar los identificadores de dispositivo desde dispositivos móviles, pase SEPARATOR5 al final de una línea seguida de uno de los números que se muestran en la tabla siguiente. Cada número corresponde a un esquema de identificación de dispositivos móviles diferente. En esta tabla se supone que ^ se usa como SEPARATOR5:

Separador y número Valor
^3 Idfa
^4 sha1udid
^5 md5udid
^7 openudid
^8 aaid
^9 windowsadid
^10 Rida

^6 sha1mac quedó en desuso a partir del 7 de mayo de 2019. No lo use.

Ejemplos

En los ejemplos siguientes se muestran escenarios derivados de casos de uso reales.

Nota:

En los ejemplos siguientes se muestran valores de separador que pueden diferir de los que se configuraron en la configuración inicial del segmento de lote. Póngase en contacto con nuestro equipo de servicios si desea actualizar la configuración.

Ejemplo 1

Un cliente está agregando usuario 12345678900987654321 a segmentos 10000 y 10001 con una hora de expiración de 1440 (un día). El cliente también está quitando el usuario 12345678900987654321 de los segmentos 10002 y 10003.

Campo Valor
UID Id. de usuario de Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEG_FIELD [SEG_ID, EXPIRATION] 
12345678900987654321,10000:1440;10001:1440;10002:-1;10003:-1

Ejemplo 2

Un cliente agrega un usuario 12345678900987654321 a segmentos con códigos "auto_intender" y "nike_shopper" con el tiempo de expiración predeterminado. El cliente también está quitando (mediante SEPARATOR4) el usuario 12345678900987654321 de los segmentos con códigos "bicycle_intender" y "newbalance_shopper".

Campo Valor
UID Id. de usuario de Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR4 "\t"
SEG_FIELD [SEG_CODE]

Nota:

\t hace referencia al carácter de tabulación horizontal. Mueve el cursor un ancho de tabulación. En el ejemplo siguiente se usa \t para mostrar dónde aparecerá el espacio.

12345678900987654321,auto_intender;nike_shopper\tbicycle_intender;newbalance_shopper

Ejemplo 3

En el ejemplo siguiente, el cliente agrega 12345678900987654321 usuario a segmentos 10000 y 10001 sin expiración (lo que significa que el usuario expirará en el segmento después del máximo permitido de 180 días) y está quitando al usuario del segmento 10002.

Campo Valor
UID Id. de usuario de Xandr
SEPARATOR1 "\t"
SEPARATOR3 "\t"
SEG_FIELD [TIMESTAMP, SEG_ID, VALUE, EXPIRATION]

Advertencia

\t hace referencia al carácter de tabulación horizontal. Mueve el cursor un ancho de tabulación. En el ejemplo siguiente se usa \t para mostrar dónde aparecerá el espacio.

12345678900987654321\t1320689131\t10000\t0\t0
12345678900987654321\t1320689131\t10001\t0\t0
12345678900987654321\t1320689131\t10002\t0\t-1

Ejemplo 4

Un cliente está agregando usuario "abcdefg" a segmentos 10000 y 10001 con una hora de expiración de 1440 (un día). El cliente también está agregando usuario "abcdefg" a segmentos cruzados 10002 y 10003.

Sugerencia

Este cliente se establece como miembro XSEG .

Campo Valor
UID Id. de usuario de Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEG_FIELD [SEG_ID, EXPIRATION]
uses_external_uids true 
abcdefg,10000:1440;10001:1440
abcdefg,10002:1440;10003:1440

Ejemplo 5

Un cliente agrega un usuario 12345678900987654321 a segmentos con código "car_like" y "bike_like" con el tiempo de expiración predeterminado.

Sugerencia

Este cliente usa SEG_CODE y carga bajo diferentes nombres de miembros.

Campo Valor
UID Id. de usuario de Xandr
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEPARATOR4 "\t"
SEG_FIELD [MEMBER_ID, SEG_CODE]

Nota:

\t hace referencia al carácter de tabulación horizontal. Mueve el cursor un ancho de tabulación.

12345678900987654321,400:car_like;500:bike_like

Ejemplo 6

Un cliente está agregando id. de usuario móvil (id. para anunciantes) AEBE52E7-03EE-455A-B3C4-E57283966239 a los segmentos 10000, 10001, 10002, 10003 durante distintas cantidades de tiempo, a través del servicio batch segment. Este método a menudo tiene tasas de coincidencias bajas en nuestra plataforma porque incluso si los identificadores se envían correctamente a nuestro servicio, no significa que el identificador de dispositivo se haya visto realmente en nuestra plataforma. Nota, separador5 anexado que designa el uso de identificadores móviles. El valor "3", designa el valor IDFA de Apple; otros valores se pueden encontrar anteriormente en la tabla Campos de datos de id. de dispositivo móvil .

Campo Valor
IDFA Id. de Apple para anunciantes.
SEPARATOR1 ","
SEPARATOR2 ";"
SEPARATOR3 ":"
SEPARATOR4 "\t"
SEPARATOR5 "^"
SEG_FIELD [SEG_ID,EXPIRATION]

Nota:

\t hace referencia al carácter de tabulación horizontal. Mueve el cursor un ancho de tabulación.

AEBE52E7-03EE-455A-B3C4-E57283966239,10000:1440;10001:1440;10002:-1;10003:-1^3