Show Menu
TEMAS×

Nombre del archivo de datos de salida: Sintaxis y ejemplos

Describe los campos requeridos, la sintaxis y las convenciones utilizadas para asignar un nombre a un archivo de datos saliente.
Los elementos de estilo ( monospaced text , cursiva , corchetes [ ] , ( ) etc.) en este documento, indique los elementos y las opciones del código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Elementos de sintaxis y nombre de archivo

Los nombres de archivo salientes contienen los siguientes elementos. Todos los elementos siguientes son opcionales.
[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Parámetros

La tabla define los elementos de un nombre de archivo de datos de salida.
Elemento Nombre de archivo Descripción
SYNC_TYPE
Se refiere a los métodos de transferencia de datos. Los métodos de transferencia incluyen:
  • FTP - Transferir mediante SFTP
  • Amazon S3 - Transferencia a Amazon AWS
DID
ID de destino.
En Audience Manager , un destino es la instancia de la integración donde puede asignar los segmentos objetivo. Los clientes pueden tener varios destinos, según los requisitos comerciales.
MASTER_DPID
Proveedor de datos o ID de fuente de datos. Este ID identifica el tipo de ID de usuario presente en el contenido del archivo. Las claves de ID de usuario más comunes son:
  • 2014 - ID del anunciante de Google (sin procesar, sin hash)
  • 2015 - ID de Apple para anunciantes (sin procesar, sin hash)
  • ID de proveedor: ID de usuario de terceros (web/cookie)
PID_ALIAS
El identificador de cliente de la plataforma de terceros.
SYNC_MODE
El modo de sincronización es un marcador de posición de macro que agrega una etiqueta al nombre del archivo en función del tipo de sincronización. Los tipos de sincronización incluyen total e incremental. Aparecerán en el nombre del archivo como iter o full .
  • iter : Indica una sincronización "iterativa" o incremental. Un archivo incremental sólo contiene los nuevos datos recopilados desde la última sincronización.
  • completo : Indica una sincronización "completa". Un archivo completamente sincronizado contiene datos antiguos y cualquier dato nuevo recopilado desde la última sincronización.
MARCA DE HORA
Marca de hora UNIX de 13 dígitos en milisegundos, en la zona horaria UTC.
SPLITNUM
Un entero. Identifica parte de un archivo dividido en varias partes para mejorar los tiempos de procesamiento. El número indica a qué parte del archivo original pertenecen los datos.
El entero debe tener al menos 3 dígitos de longitud, precedido de ceros, si el tamaño de división es inferior a 100 partes.
El archivo original no tendrá ningún número dividido. El primer archivo dividido finalizará con 001. Consulte los ejemplos siguientes.
.gz (opcional)
Compresión GZIP.

Ejemplos de nombres de archivo

Escenario 1

Archivos enviados a una Amazon S3 ubicación, con PID_ALIAS="XYZCustomer" y con Google Advertiser IDs el contenido del archivo.
Por ejemplo, archivos incrementales:
  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz
Por ejemplo, archivos completos:
  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Escenario 2

Archivos enviados a FTP ubicación, sin PID_ALIAS y con Apple Advertiser IDs el contenido del archivo:
Por ejemplo, archivos incrementales:
  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz
Por ejemplo, archivos completos:
  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz
Escenario 3 : Archivos enviados a la ubicación, con FTP y con ID de usuario de terceros en el contenido del archivo ( PID_ALIAS="XYZCustomer" Vendor ID=45454 ):
Por ejemplo, archivos incrementales:
  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
Por ejemplo, archivos completos:
  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Contenido del archivo de datos de salida: Sintaxis y parámetros

Describe los campos requeridos, la sintaxis y las convenciones utilizadas para organizar la información en un archivo de datos de salida. Dé formato a los datos según estas especificaciones.
Los elementos de estilo ( monospaced text , cursiva , corchetes [ ] , ( ) etc.) en este documento, indique los elementos y las opciones del código. Consulte Convenciones de estilo para elementos de código y texto para obtener más información.

Sintaxis

Los campos del archivo de datos aparecen en este orden:
UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parámetros

La tabla enumera las variables que definen el contenido de un archivo de datos.
Parámetro Descripción
UUID
ID de usuario único asignado por Audience Manager .
<SPACE>
Separe el UUID y los datos de segmentos con un espacio
SEGMENT_N
ID de segmento al que pertenece un visitante. Separe varios segmentos con una coma.
REMOVED_SEGMENT_N
ID del segmento desde el que se descalificó al usuario. Separe varios segmentos con una coma. Con una sincronización completa, puede ignorar los segmentos eliminados porque el archivo de datos contendrá la lista completa de los segmentos actuales para el usuario. Normalmente, desea conocer los segmentos a los que pertenece un usuario en lugar de aquellos de los que se han eliminado. Consulte también Nombre del archivo de datos de salida: Sintaxis y ejemplos .

Ejemplo: Formato de archivo básico

Un archivo de datos formateado correctamente podría tener un aspecto similar al siguiente ejemplo. Esta entrada de archivo indica que un usuario cumple los requisitos para los segmentos 24, 26 y 27. Si es necesario, un espacio separa los ID de segmento UUID y los ID de segmento. Otro espacio separa los conjuntos de ID de segmentos. En este ejemplo, un usuario pertenece a los segmentos 24, 26 y 27. Se han eliminado de los segmentos 25 y 28.
59767559181262060060278870901087098252  24,26,27  25,28