Nombre del archivo de datos de salida: sintaxis y ejemplos outbound-data-file-name-syntax-and-examples
Describe los campos, sintaxis y convenciones requeridos que se utilizan para asignar un nombre a un archivo de datos de salida.
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 syntax-file-name
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.
SYNC_TYPESe 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
DIDID 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_DPIDID 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_ALIASSYNC_MODEEl 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.
TIMESTAMPSPLITNUMUn 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)Ejemplos de nombres de archivo file-name-examples
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.gzS3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gzS3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz
Por ejemplo, archivos completos:
S3_1234_20914_XYZCustomer_full_1486140844000.sync.gzS3_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.gzftp_1234_20915_iter_1486140843000001.sync.gz
Por ejemplo, archivos completos:
ftp_1234_20915_full_1486140843000.sync.gzftp_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.gzftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gzftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
Por ejemplo, archivos completos:
ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gzftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz
Contenido del archivo de datos de salida: sintaxis y parámetros outbound-contents-syntax
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.
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.
UUID<SPACE>SEGMENT_NREMOVED_SEGMENT_NEjemplo: 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, hay un espacio entre 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