Show Menu
TEMAS×

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

Un archivo de datos contiene datos de impresión, clic o conversión. Si el formato es correcto, puede importar estos datos en Audience Manager para verlos en los informes de optimización de público y crear características mediante los datos mediante los 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 nombre y formato adecuados le permite importar datos de impresión, clic o conversión en los informes de optimización de audiencias. 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, clic 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 con etiquetas relacionadas legibles por el usuario en los menús del informe. 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. Tenga en cuenta que la cursiva indica un marcador de posición de variable que cambia según el contenido del archivo.
Sintaxis:
event type_

yyyymmdd

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 subrayado separa el tipo de evento y una marca de fecha de año-mes.
  • Antes de cargar, comprima los archivos con gzip y guárdelos con la extensión de .gz archivo.
Dados estos requisitos, asigne un nombre a los archivos de datos en función de su contenido de la siguiente manera:
  • Datos de impresión:
    impressions_
    
    yyyymmdd.gz
    
    
  • Haga clic en los datos:
    clicks_
    
    yyyymmdd.gz
    
    
  • Datos de conversión:
    conversions_
    
    yyyymmdd.gz
    
    

Formato de contenido para archivos de datos

La siguiente sintaxis define la estructura de contenido en un archivo de datos bien formado. Tenga en cuenta que la cursiva indica un marcador de posición de 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 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 terminar con un número de versión. La versión actual es 1.1.
  • Separe los encabezados y el contenido de los archivos 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. Dado que se trata de caracteres no imprimibles, el ejemplo de sintaxis anterior muestra una barra vertical "|" únicamente para fines de visualización.
Etiquetas de campo
La tabla siguiente enumera y describe los encabezados de columna del archivo de datos. Los encabezados distinguen entre mayúsculas y minúsculas y deben aparecer según lo ordenado en la tabla. Todos los tipos de datos son enteros (INT) a menos que se indique lo contrario.
Etiqueta Descripción
Marca de hora
Una fecha y hora UTC para el evento de impresión, clic o conversión. Utilice el 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.
Advertiser-ID
El ID de fuente de datos o código de integración del 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.
Id. de ubicación
ID de ubicación numérica desde el servidor de publicidad.
Insertion-Order-ID
ID de orden de inserción.
Tactic-ID
ID táctica.
Vertical-ID
ID para una categoría o 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
Dirección 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 conversión, de impresión o de clic. La versión actual es 1.1.

Métodos de envío para archivos de datos

Cargue los archivos de datos de impresión, 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 entrega/directorio, tiempos de procesamiento de archivos y actualizaciones.
Sintaxis y ejemplos de la ruta de entrega
Los datos se almacenan en un espacio de nombres independiente para cada cliente en un directorio de Amazon S3. La ruta del archivo sigue la sintaxis que se muestra a continuación. Note, italics indicates a variable placeholder. Otros elementos son constantes o claves y no cambian.
Sintaxis:
 .../log_ingestion/pid= 

AAM ID

/dpid= 

d_src/logs/ tipo 

de archivo_

yyyymmdd

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ás la ruta completa cuando todo esté configurado.
pid= AAM ID
Este par clave-valor que contiene el ID de cliente de Audience Manager .
dpid= d_src
Este par clave-valor contiene la ID de la fuente de datos que se pasa en una llamada de evento. Identifica la agencia de la que provienen 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 el tipo de datos que contiene y una marca de hora 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 determinado. En este caso, un día es el período de 24 horas de una medianoche a otra. Se recomienda utilizar la hora UTC para definir el intervalo de días.

Pasos siguientes

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