Nombre del archivo de datos de salida: sintaxis y ejemplos

Última actualización: 20 de julio de 2024
  • Temas:

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

NOTE
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 archivoDescripció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 de , un destino es la instancia de la integración en la que puede asignar los segmentos de destino. 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_ALIASEl 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 de 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.
TIMESTAMPUna 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 una ubicación de 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 ubicación FTP, 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.

NOTE
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ámetroDescripción
UUIDIdentificador de usuario único asignado por el Audience Manager .
<SPACE>Separe el UUID y los datos del segmento con un espacio
SEGMENT_NEl ID del segmento al que pertenece un visitante. Separe varios segmentos con una coma.
REMOVED_SEGMENT_NID 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. Vea también Nombre de archivo de datos de salida: Sintaxis y ejemplos.