Archivos de datos para informes de optimización de Audiencia y archivos de registro procesables

Un archivo de datos contiene datos de impresión, clics o conversión. Cuando tenga el formato correcto, puede importar estos datos en el Audience Manager para visualizarlos en la Informes del Audience Optimization y crear características utilizando los datos mediante Archivos de registro procesables. Dé formato a los archivos de datos según estas especificaciones en esta sección.

Información general

Un archivo de datos con un nombre y formato adecuados le permite importar datos de impresión, clics o conversiones en la variable Informes del Audience Optimization. Esto resulta útil cuando se trabaja con un socio que no está integrado con Audience Manager y desea trabajar con sus datos en ese grupo de informes. Este proceso requiere archivos independientes para los datos de impresión, clics y conversión. No mezcle estos eventos en un solo archivo.

Un archivo de datos debe ir acompañado de un archivo de metadatos. El contenido del archivo de metadatos coincide con la información del archivo de datos en etiquetas relacionadas y legibles en lenguaje natural de los menús de informes. Para obtener más información, consulte Información general y asignaciones para archivos de metadatos.

Convenciones de nomenclatura para archivos de datos

La siguiente sintaxis define la estructura de un nombre de archivo de datos bien formado. Nota: cursiva indica un marcador de posición de variable que cambia según el contenido del archivo.

Sintaxis:

tipo de evento_aaammdd

En un nombre de archivo:

El tipo de evento indica que el archivo contiene impresiones, clics o conversiones. Cree un archivo independiente para cada tipo de evento.
Un guión bajo separa el tipo de evento y una marca de fecha y mes de año.
Antes de cargar, comprima sus archivos con gzip y guárdelos con la variable .gz extensión de archivo.

Dados estos requisitos, nombre los archivos de datos en función de su contenido de esta manera:

Datos de impresión:
```
impresiones_aaammdd.gz
```
Datos de clic:
```
clicks_aaammdd.gz
```
Datos de conversión:
```
conversiones_aaammdd.gz
```

Formato de contenido para archivos de datos

La siguiente sintaxis define la estructura de contenido en un archivo de datos bien formado. Nota: cursiva indica un marcador de posición de variable y se reemplaza con una etiqueta en un archivo de datos real.

Sintaxis:

etiqueta de encabezado 1 | etiqueta de encabezado 2 … etiqueta de encabezado n | version

En el contenido del archivo:

Las etiquetas de encabezado deben aparecer en el orden indicado en la tabla siguiente. Las impresiones y los clics utilizan las mismas etiquetas. Los archivos de conversión contienen encabezados adicionales.
Si no tiene datos para una columna en particular, rellene ese campo con una -1.
Archivos must termine con un número de versión. La versión actual es 1.1.
Separe los encabezados y el contenido del archivo con el carácter ASCII 001 no imprimible. Si no puede utilizar ASCII 001, separe los encabezados y datos con un delimitador de tabulación. Como estos son caracteres no imprimibles, el ejemplo de sintaxis anterior muestra una barra vertical "|" solo con fines de visualización.

Etiquetas de campos

En la tabla siguiente se enumeran y describen los encabezados de columna del archivo de datos. Los encabezados distinguen entre mayúsculas y minúsculas y deben aparecer según lo dispuesto en la tabla. Todos los tipos de datos son números enteros (INT) a menos que se indique lo contrario.

Etiqueta	Descripción
Marca de tiempo	Fecha y hora UTC para la impresión, el clic o el evento de conversión. Utilice la variable `yyyy-MM-dd HH:mm:ss` formato.
User-ID	Su ID para un visitante del sitio, también conocido como ID de usuario único del proveedor de datos o DPUUID.
ID del anunciante	El ID de la fuente de datos o el código de integración para el anunciante.
BU-ID	ID de unidad de negocio.
ID de campaña	ID de campaña.
Creative-ID	ID del creativo.
ID del sitio	ID del sitio.
Placement-ID	ID de colocación numérica del servidor de publicidad.
Insertion-Order-ID	ID del orden de inserción.
Tactic-ID	ID táctico.
Vertical-ID	ID para una categoría o vertical del sector.
Cantidad	Número de artículos vendidos en un evento de conversión. Solo para archivos de datos de conversión.
Ingresos	Compra u otra cantidad de conversión. Tipo de datos: Flotante. Solo para archivos de datos de conversión.
Otros datos	URL de la página de aterrizaje de conversión. Tipo de datos: cadena. Solo para archivos de datos de conversión.
Event-Type	Tipo de conversión. Indica si una conversión coincide o no. Las opciones incluyen: `0`: Impresión `1`: Haga clic `-1`: No atribuido o desconocido Solo para archivos de datos de conversión.
Versión	Número de versión requerido que aparece al final de cada fila en un archivo de datos de impresión, clic o conversión. La versión actual es 1.1.

Métodos de envío para archivos de datos

Cargue los archivos de datos de impresión, clics o conversiones en un directorio de Amazon S3 para su Audience Manager cuenta. Consulte esta sección para obtener información sobre las rutas de entrega/directorio, los tiempos de procesamiento de los archivos y las actualizaciones.

IMPORTANTE

Póngase en contacto con su asesor de Audience Manager o con el Servicio de atención al cliente para empezar y configurar un Amazon S3 para sus archivos de datos.

Sintaxis y ejemplos de la ruta de entrega

Los datos se almacenan en un área de nombres independiente para cada cliente en una Amazon S3 directorio. La ruta del archivo sigue la sintaxis que se muestra a continuación. Nota: cursiva indica un marcador de posición de variable. Otros elementos son constantes o claves y no cambian.

Sintaxis:

…/log_ingestion/pid= ID de AAM/dpid= d_src/logs/ tipo de archivo_aaammdd

La siguiente tabla define cada uno de estos elementos en una ruta de entrega de archivos.

Parámetro de archivo	Descripción
`.../log_ingestion/`	Este es el inicio de la ruta de almacenamiento del directorio. Recibirá la ruta completa cuando todo esté configurado.
`pid=AAM ID`	Este par clave-valor contiene su Audience Manager ID de cliente.
`dpid=d_src`	Este par clave-valor contiene el ID de fuente de datos transferido en una llamada de evento. Identifica la agencia de la que proceden los datos y los vincula a un archivo de metadatos compatible.
`logs`	Un directorio de nivel superior para archivos de datos.
`file type_yyyymmdd`	Nombre de tipo de archivo que indica qué tipo de datos contiene y una marca de tiempo de entrega.

Ruta de carga de muestra y nombre de archivo

Al cargar un archivo, la ruta será similar a esta:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Tiempos y actualizaciones de procesamiento de archivos

Los archivos de datos se procesan cuatro veces al día, a intervalos regulares.

Para actualizar los datos, envíe un archivo que contenga todas las impresiones, clics o conversiones de un día concreto. En este caso, un día es el período de 24 horas desde una medianoche hasta la siguiente. Como práctica recomendada, es posible que desee utilizar la hora UTC para definir el intervalo de días.