Archivos de datos para informes de Audience Optimization y archivos de registro procesables data-files-for-audience-optimization-reports
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 verlos en los informes del Audience Optimization y crear características con los datos a través de archivos de registro procesables. Dé formato a los archivos de datos según las especificaciones de esta sección.
Información general overview
Un archivo de datos con nombre y formato adecuados le permite importar datos de impresión, clics o conversiones en Informes de Audience Optimization. Esto resulta útil cuando se trabaja con un socio que no está integrado con Audience Manager y se 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 hace coincidir la información del archivo de datos con las etiquetas relacionadas legibles en lenguaje natural en los menús del informe. Para obtener más información, vea Información general y asignaciones para archivos de metadatos.
Convenciones de nomenclatura para archivos de datos naming-conventions
La siguiente sintaxis define la estructura de un nombre de archivo de datos bien formado. Tenga en cuenta que cursiva indica un marcador de posición variable que cambia según el contenido del archivo.
Sintaxis:
tipo de evento_aaaammdd
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 guion bajo separa el tipo de evento y una marca de tiempo de año-mes-fecha.
- Antes de cargar, comprima los archivos con gzip y guárdelos con la extensión de archivo
.gz.
Dados estos requisitos, asigne un nombre a los archivos de datos en función de su contenido de esta manera:
-
Datos de impresión:
code language-none impresiones_aaaammdd.gz -
Datos de clics:
code language-none clicks_yyyymmdd.gz -
Datos de conversión:
code language-none conversiones_aaaammdd.gz
Formato de contenido para archivos de datos content-format
La siguiente sintaxis define la estructura de contenido en un archivo de datos bien formado. Tenga en cuenta que 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 | versión
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 un
-1. -
Los archivos deben finalizar 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 los datos con un delimitador de tabulación. Como se trata de caracteres no imprimibles, el ejemplo de sintaxis anterior muestra una barra vertical
"|"únicamente con fines de presentación.
Etiquetas de campo
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 se han ordenado en la tabla. Todos los tipos de datos son enteros (INT) a menos que se indique lo contrario.
yyyy-MM-dd HH:mm:ss.El número de artículos vendidos en un evento de conversión.
Solo para archivos de datos de conversión.
Importe de compra u otro importe de conversión. Tipo de datos: Flotante.
Solo para archivos de datos de conversión.
URL de la página de aterrizaje de conversión. Tipo de datos: String.
Solo para archivos de datos de conversión.
Tipo de conversión. Indica si una conversión coincide o no. Las opciones incluyen:
0: impresión1: clic-1: sin atribuir o desconocido
Solo para archivos de datos de conversión.
Métodos de envío para archivos de datos delivery-methods
Cargue los archivos de datos de impresión, clics o conversión en un directorio de Amazon S3 para la cuenta de Audience Manager. Consulte esta sección para obtener información sobre las rutas de entrega/directorio, los tiempos de procesamiento de archivos y las actualizaciones.
Sintaxis de la ruta de envío y ejemplos
Los datos se almacenan en un área de nombres independiente para cada cliente en un directorio Amazon S3. La ruta del archivo sigue la sintaxis que se muestra a continuación. Tenga en cuenta que cursiva indica un marcador de posición de variable. Otros elementos son constantes o claves y no cambian.
Sintaxis:
…/log_ingestion/pid= ID/dpid= d_src/logs/ tipo de archivo_aaaammdd
La siguiente tabla define cada uno de estos elementos en una ruta de envío de archivos.
.../log_ingestion/pid=AAM IDdpid=d_srclogsfile type_yyyymmddRuta de carga de muestra y nombre de archivo
Al cargar un archivo, la ruta será similar a la siguiente:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Actualizaciones y tiempos 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 en particular. En este caso, un día es el periodo de 24 horas entre una medianoche y la siguiente. Como práctica recomendada, es posible que desee utilizar la hora UTC para definir el intervalo de día.
Pasos siguientes next-steps
Revise los requisitos para nombrar y crear archivos de metadatos. Para empezar, consulte Información general y asignaciones para archivos de metadatos.