Nombre del archivo de datos de salida: sintaxis y ejemplos

Última actualización: 2023-05-20

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

NOTA

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

DID

ID de destino.

Entrada Audience Manager , un destino es la instancia de la integración en la que puede asignar sus segmentos objetivo. Los clientes pueden tener varios destinos, según los requisitos comerciales.

MASTER_DPID

ID del proveedor de datos o 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:

  • 20914 - ID de anunciante de Google (sin procesar, sin hash)
  • 20915 - Apple ID para anunciantes (sin procesar, sin hash)
  • ID del proveedor - ID de usuarios de terceros (web/cookie)

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

PID_ALIAS

El identificador del 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 completa e incremental. Aparecerán en el nombre del archivo como iter o full .

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

TIMESTAMP

Una marca de tiempo UNIX de 13 dígitos en milisegundos, en el huso horario UTC.

SPLITNUM

Un entero. Identifica una 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 la división es inferior a 100 partes.

El archivo original no tendrá ningún número de división. 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 un Amazon S3 ubicación, 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 FTP ubicación, 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 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, sintaxis y 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, paréntesis [ ] ( ), etc.) en este documento, indique los elementos y las opciones de 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 del segmento con un espacio

SEGMENT_N

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

REMOVED_SEGMENT_N

ID del segmento del 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 los que se les 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 el formato correcto podría ser 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 la variable UUID ID de segmentos de y. 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