Archivos de datos para informes Audience Optimization y Archivos de registro procesables data-files-for-audience-optimization-reports

Un archivo de datos contiene datos impresión, de clics o Conversión. Cuando se formatean correctamente, puede importar estos datos a Audience Manager para vista en los informes de Audience Optimization y crear características utilizando los datos a travésdel Archivos de registro procesable. Dé formato a los archivos de datos según las especificaciones de esta sección.

Información general overview

Un archivo de datos con el formato y el nombre correcto permite importar datos impresión, hacer clic o Conversión a los informes Audience Optimization. Esto resulta útil cuando se trabaja con una socio que no está integrada y Audience Manager se desea trabajar con sus datos de esa grupo de informes. Este proceso requiere archivos separados para impresión, clic y Conversión datos. No mezcle estos eventos en un solo archivo.

El archivo de datos debe ir acompañado de un archivo metadatos. El contenido del archivo de metadatos hace coincidir la información del archivo de datos con las etiquetas relacionadas legibles en lenguaje humano de los menús de informes. Para obtener más información, consulte Información general y asignaciones para Archivos 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 la cursiva indica un marcador de posición de 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. Crear un archivo separado para cada tipo de evento.
  • Un guión bajo separa la tipo de evento y una marca de tiempo año-mes-fecha.
  • Antes de cargar, comprima sus archivos usando gzip y guárdelos con la extensión de .gz archivo.

Dados estos requisitos, asigne un nombre a sus archivos de datos en función de su contenido gustar la siguiente manera:

  • Datos de impresión:

    code language-none
    impressions_aaaammdd.gz
    
  • Datos de clics:

    code language-none
    clicks_aaaammdd.gz
    
  • Datos de conversión:

    code language-none
    conversions_aaaammdd.gz
    

Formato de contenido para datos Archivos content-format

La siguiente sintaxis define la estructura contenido en un archivo de datos bien formado. Tenga en cuenta que la cursiva indica un marcador de posición variable y se sustituye por 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 que se muestra 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 concreta, rellene ese campo con un -1archivo .

  • Archivos debe finalizar con un número de versión. La versión actual es la 1.1.

  • Separe los encabezados y contenidos de archivo con el carácter ASCII 001 de no impresión. Si no puede utilizar ASCII 001, separe los encabezados y los datos con un delimitador pestaña. Dado que se trata de caracteres de no impresión, el ejemplo de sintaxis anterior muestra una barra vertical "|" únicamente con fines de visualización.

Etiquetas de campo

La tabla siguiente enumera y describe los encabezados de columna del archivo de datos. Los encabezados distinguen mayúsculas de minúsculas y deben aparecer como están ordenados en la tabla. Todos los tipos de datos son enteros (INT) a menos que se indique lo contrario.

Etiqueta
Descripción
Stamp tiempo
Fecha y hora UTC para la evento, de clic o de impresión, clic o Conversión. Utilice el yyyy-MM-dd HH:mm:ss formato.
ID de usuario
Su ID para una visitante del sitio, también conocida como ID de usuario exclusivo del proveedor de datos o DPUUID .
ID del anunciante
ID de fuente de datos o código de integración de su anunciante.
BU-ID
Empresa ID de la unidad.
ID Campaign
Campaign ID.
ID Creative
Creative ID.
ID del sitio
ID del sitio.
ID de colocación
ID de ubicación numérico del servidor de anuncios.
Inserción-Orden-ID
ID de pedido de inserción.
ID de táctica
ID de táctica.
ID vertical
ID para un sector o categoría.
Cantidad

Número de elementos vendidos en un Conversión evento.

Solo para Conversión archivos de datos.

Ingresos

Compra u otra cantidad Conversión. Tipo de datos: flotante.

Solo para Conversión archivos de datos.

Otros datos

URL del Conversión página de aterrizaje. Tipo de datos: cadena.

Solo para Conversión archivos de datos.

Tipo de evento

Tipo de conversión. Indica si una Conversión coincide o no. Las opciones incluyen:

  • 0:Impresión
  • 1:Clic
  • -1: Sin atribuir o desconocido

Solo para Conversión archivos de datos.

Versión
Número de versión requerido que aparece al final de cada fila de un archivo de datos de impresión, clic o Conversión. La versión actual es la 1.1.

Métodos de envío de datos Archivos delivery-methods

Cargue sus archivos de datos de impresión, haga clic o Conversión en un directorio de Amazon S3 para su Audience Manager cuenta. Consulte esta sección para obtener información sobre rutas de directorio/envío, tiempos de procesamiento de archivos y actualizaciones.

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

Sintaxis y ejemplos de la ruta de entrega

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

Sintaxis:

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

La tabla siguiente define cada uno de estos elementos en una ruta de envío de archivo.

Parámetro Archivo
Descripción
.../log_ingestion/
Este es el inicio del directorio almacenamiento ruta. 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 provienen los datos y vincula esos datos a un archivo de metadatos de apoyo.
logs
Un directorio de nivel superior para archivos de datos.
file type_yyyymmdd
Nombre de tipo de archivo que indica la clase de datos que contiene y una marca de tiempo envío.

Ejemplo de ruta de carga y nombre Archivo

Cuando cargar un archivo, la ruta de acceso tendrá un aspecto similar al siguiente:

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

Tiempos de procesamiento y actualizaciones de Archivo

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 determinado. En este caso, un día es el período de 24 horas desde una medianoche hasta la siguiente. Como práctica recomendada, puede que desee utilizar la hora UTC para definir el intervalo de días.

Pasos siguientes next-steps

Revise los requisitos para nombrar y crear metadatos archivos. Para empezar, consulte Información general y asignaciones para Archivos de metadatos.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695