Customer Data Feeds

Información básica sobre Customer Data Feed (CDF) archivos e instrucciones sobre cómo empezar. Comience aquí si está interesado en recibir CDF o solo desea más información.

Contenido del archivo y propósito

Un archivo CDF contiene los mismos datos que una llamada de evento de Audience Manager (/event) envía a nuestros servidores. Esto incluye datos como los ID de usuario, trait IDs, segment IDsy todos los demás parámetros capturados por una llamada de evento. Internas Audience Manager los sistemas procesan los datos de evento en un CDF archivo con contenido organizado en campos que aparecen en un orden definido. Audience Manager intenta generar CDF archivos por hora y los almacena en un bloque seguro y específico para el cliente en un Amazon S3 servidor. Proporcionamos estos archivos para que pueda trabajar con Audience Manager datos fuera de los límites impuestos por nuestra interfaz de usuario.

Introducción

No hay ningún proceso de autoservicio que iniciar CDF entrega de archivos. Póngase en contacto con su Audience Manager para empezar. Durante la implementación, su Audience Manager representante:

• Configure su Amazon S3 depósito de almacenamiento.
• Proporcionar solo lectura S3 credenciales de autenticación en el espacio de almacenamiento de archivos. No podrá ver ni acceder a directorios y archivos que pertenezcan a otros clientes.

Notificaciones de archivos y CDF los archivos aparecerán en su S3 cuando estén listos para la descarga. Usted es el responsable de supervisar y descargar los archivos de su S3 directorio. Consulte Notificaciones sobre procesamiento de archivos de fuentes de datos de clientes.

Pasos siguientes

Las secciones siguientes y la Preguntas frecuentes sobre la Fuente de datos de clientes puede ayudarle a familiarizarse con este servicio.

Customer Data Feed Contenido definido

Enumera y define los elementos de datos y las matrices en una CDF por orden de aspecto. Las definiciones incluyen tipos de datos, pero esta información no forma parte de un CDF archivo.

Definiciones

A CDF incluye algunos o todos los campos definidos a continuación. Para obtener información sobre la organización de archivos internos, consulte Estructura del archivo de la fuente de datos del cliente.

Customer Data Feed Estructura del archivo

Enumera y define la estructura de datos de un CDF archivo. Esto incluye secuencia de datos, delimitadores y separadores de campos, un mapa de archivos de datos y un archivo de muestra.

Identificadores y secuencia de campos de datos

CDF los archivos no contienen columnas etiquetadas ni encabezados de campo. En su lugar, una CDF define campos y matrices con no impresión ASCII caracteres. Además, el CDF enumera cada campo y matriz en un orden específico. La comprensión de los identificadores de campo y el orden le ayudará a analizar el archivo correctamente.

CDF Mapa del archivo

CDF los datos del archivo aparecen en el orden que se muestra a continuación.

Identificación de matrices

Matrices en una CDF inicio y finalización del archivo con la variable Ctrl + a separador de campos. Esto hace que el primer elemento de una matriz aparezca como un campo de datos independiente. Por ejemplo, el valor traits la matriz empieza con ^A1234. El delimitador de matriz y el ID ^B5678 sigue esta entrada. Como resultado, es posible que esté tentado a pensar que el primer elemento de la sección traits matriz es ID 5678 (porque comienza con ^B). Este no es el caso, por lo que debe estar familiarizado con la secuencia y la estructura de un archivo de datos. Aunque el primer elemento de la trait (o cualquiera de las otras matrices de una CDF file) comienza con ^A, el orden de aparición o posición en el archivo define el inicio de una matriz. Y, el primer elemento de una matriz siempre se separa de la entrada anterior por ^A.

Ejemplo CDF Archivo

Un ejemplo CDF puede tener un aspecto similar al siguiente. Hemos insertado saltos de línea en este ejemplo para ayudarle a ajustar la página.

Customer Data Feed Convenciones de nomenclatura de archivos

Las secciones siguientes enumeran y definen los elementos de su CDF nombre del archivo.

CDF Nombre del archivo: Sintaxis y ejemplo

Una CDF nombre de archivo contiene los elementos que se enumeran a continuación. Nota: cursiva indica un marcador de posición de variable:

Sintaxis

s3://aam-cdf/YOUR-S3-BUCKET-NAME/day=yyyy-mm-dd/hour=hh/AAM-CDF_PARTNER-ID_FILE-SEQUENCE_0.gz

Ejemplo

s3://aam-cdf/dataCompany/day=2017-09-14/hour=17/AAM_CDF_1234_0_0_0.gz

En S3 espacio de almacenamiento, los archivos se ordenan en orden ascendente por ID de socio (PID), día y hora.

CDF Elementos de nombre de archivo definidos

La tabla siguiente enumera y define los elementos de una CDF nombre del archivo.

Customer Data Feed Notificaciones de procesamiento de archivos

Audience Manager escribe un .info para S3 para que sepa cuándo Customer Data File (CDF) está listo para la descarga. La variable .info también incluye JSON metadatos con formato sobre el contenido de su CDF archivos. Consulte esta sección para obtener información sobre la sintaxis y los campos utilizados por este archivo de notificación.

Archivo de información de muestra

Cada .info contiene un Files y Totals para obtener más información. La variable Files contiene una matriz que contiene métricas específicas para cada archivo por hora. La variable Totals contiene métricas agregadas en todas las CDF archivos para un día en particular. El contenido de su .info puede tener un aspecto similar al del siguiente ejemplo.

{
    "Files": [
        {
            "FileByteSize": 2709730,
            "FileChecksumMD5": "a9ea418e79511642cff11c2a898037dc-1",
            "FileName": "AAM_CDF_1109_000000_0.gz",
            "FileSequenceNumber": 1
        },
        {
            "FileByteSize": 2783351,
            "FileChecksumMD5": "7b469485d60274b6991acd0817855840-3",
            "FileName": "AAM_CDF_1109_000001_0.gz",
            "FileSequenceNumber": 2
        }
    ],
    "Totals": {
        "Day": "2017-09-26",
        "Hour": "18",
        "TotalByteSize": 150092997,
        "TotalNumberFiles": 2
    }
}

Campos del archivo de información definidos

Las tablas siguientes enumeran y definen los elementos de una CDF .info archivo.

Objeto Files

Objeto Totals

Customer Data Feed Los tiempos de los nombres de archivo y los tiempos de contenido de archivo son diferentes

Su CDF contiene marcas de hora en el nombre del archivo y en el contenido del archivo. Estas marcas de tiempo registran diferentes procesos de eventos para los mismos CDF archivo. No es raro ver diferentes marcas de tiempo en el nombre y contenido del mismo archivo. Comprender cada marca de tiempo puede ayudarle a evitar errores comunes al trabajar con estos datos o al intentar ordenarlos por tiempo.

Ubicación CDF Marcas de hora de archivo

CDF los archivos registran el tiempo de forma diferente en dos ubicaciones independientes.

Explicación de la diferencia entre marcas de hora

La siguiente tabla proporciona detalles adicionales sobre su CDF marcas de hora de archivo junto con información sobre cómo utilizarlas correctamente.