Nombre del archivo de datos de salida: sintaxis y ejemplos

Describe los campos, la sintaxis y las convenciones requeridos que se usan para asignar un nombre a un archivo de datos de salida.

NOTA

Los elementos de estilo (monospaced text, cursiva, corchetes [ ] ( ), etc.) en este documento, indique los elementos de código y las opciones. 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: transferencia mediante SFTP
  • Amazon S3 - Transferir a Amazon AWS

DID

ID de destino.

En el Audience Manager , un destino es la instancia de la integración en la que 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 - Apple ID para anunciantes (sin procesar y sin hash)
  • ID de proveedor: ID de usuario de terceros (web/cookie)

Consulte Fuentes de datos globales para obtener más información.

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 añade una etiqueta al nombre del archivo en función del tipo de sincronización. Los tipos de sincronización incluyen completo e incremental. Aparecerán en el nombre del archivo como iter o full .

  • iter : Indica una sincronización "iterativa" o incremental. Un archivo incremental solo contiene los nuevos datos recopilados desde la última sincronización.
  • full : Indica una sincronización "completa". Un archivo completamente sincronizado contiene datos antiguos y cualquier dato nuevo recopilado desde la última sincronización.

TIMESTAMP

Marca de tiempo UNIX de 13 dígitos en milisegundos, en la zona horaria UTC.

SPLITNUM

Un entero. Identifica parte de un archivo que se ha 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, precedidos 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 (optional)

Compresión GZIP.

Ejemplos de nombres de archivo

Escenario 1

Archivos enviados a una ubicación Amazon S3, con PID_ALIAS="XYZCustomer" y con Google Advertiser IDs en 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 la ubicación FTP, sin PID_ALIAS y con Apple Advertiser IDs en 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 FTP ubicación, con PID_ALIAS="XYZCustomer" y con ID de usuario de terceros en el contenido del archivo ( 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, la sintaxis y las convenciones necesarios para organizar la información en un archivo de datos de salida. Dé formato a los datos según estas especificaciones.

NOTA

Los elementos de estilo (monospaced text, cursiva, corchetes [ ] ( ), etc.) en este documento, indique los elementos de código y las opciones. 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 el Audience Manager .

<SPACE>

Separe el UUID y los datos de segmentos con un espacio

SEGMENT_N

El ID de segmento al que pertenece un visitante. Separe varios segmentos con una coma.

REMOVED_SEGMENT_N

El ID de 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 segmentos actuales para el usuario. Normalmente, le interesa conocer los segmentos a los que pertenece un usuario, en lugar de aquellos a los que se ha eliminado. Consulte también Nombre del archivo de datos de salida: Sintaxis y ejemplos .

Ejemplo: Formato de archivo básico

Un archivo de datos con formato correcto podría tener un aspecto similar al del siguiente ejemplo. Esta entrada de archivo indica que un usuario cumple los requisitos para los segmentos 24, 26 y 27. Como sea necesario, un espacio separa los UUID e ID de segmento. Otro espacio separa los conjuntos de ID de segmento. 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

En esta página