Customer Data Feeds customer-data-feeds

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

Contenido y propósito del archivo file-contents-purpose

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

Introducción getting-started

No hay ningún proceso de autoservicio para iniciar la entrega de archivos de CDF. Póngase en contacto con su asesor de Audience Manager o con el Servicio de atención al cliente para comenzar. Durante la implementación, su representante de Audience Manager:

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

Pasos siguientes next-steps

Las secciones siguientes y las Preguntas frecuentes sobre la fuente de datos del cliente pueden ayudarle a familiarizarse con este servicio.

Customer Data Feed contenidos definidos cdf-defined

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

Definiciones definitions

Un archivo de CDF incluye algunos o todos los campos definidos a continuación. Para obtener información acerca de la organización interna de archivos, consulte Estructura de archivos de fuentes de datos de clientes.

Estructura de archivos de Customer Data Feed cdf-file-structure

Enumera y define la estructura de datos de un archivo de CDF. Esto incluye la secuencia de datos, los delimitadores y separadores de campo, un mapa del archivo de datos y un archivo de muestra.

Identificadores y secuencia de campos de datos identifiers-and-sequence

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

Asignación de archivo de CDF cdf-file-map

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

Identificación de matrices

Las matrices de un archivo CDF comienzan y finalizan con el separador de campos Ctrl + a. Esto hace que el primer elemento de una matriz parezca un campo de datos independiente. Por ejemplo, la matriz traits realizada comienza con ^A1234. El delimitador de matriz y el identificador ^B5678 siguen esta entrada. Como resultado, puede sentirse tentado a pensar que el primer elemento de la matriz traits realizada es el identificador 5678 (porque comienza con ^B). Este no es el caso, por lo que debe estar familiarizado con la secuencia y estructura de un archivo de datos. Aunque el primer elemento de la matriz trait realizada (o cualquiera de las demás matrices de un archivo CDF) comience por ^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 está separado de la entrada anterior por ^A.

Archivo de muestra CDF sample-file

Un archivo de muestra CDF podría tener un aspecto similar al siguiente. Hemos insertado saltos de línea en este ejemplo para que se ajuste a la página.

Customer Data Feed Convenciones de nombres de archivos cdf-naming-conventions

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

CDF Nombre de archivo: sintaxis y ejemplo cdf-file-name

Un nombre de archivo típico de CDF contiene los elementos que se enumeran a continuación. Tenga en cuenta que 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 el espacio de almacenamiento de S3, los archivos se ordenan en orden ascendente por id. de socio (PID), día y hora.

CDF elementos de nombre de archivo definidos cdf-file-name-elements

En la tabla siguiente se enumeran y definen los elementos de un nombre de archivo de CDF.

Customer Data Feed notificaciones de procesamiento de archivos cdf-file-processing-notifications

Audience Manager escribe un archivo de .info en el directorio S3 para que sepa cuándo su Customer Data File (CDF) está listo para su descarga. El archivo .info también incluye JSON metadatos con formato acerca del contenido de los archivos CDF. Revise 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 sample-info-file

Cada archivo .info contiene una sección Files y Totals. La sección Files contiene una matriz que contiene métricas específicas para cada archivo por hora. La sección Totals contiene métricas agregadas en todos sus archivos de CDF para un día en particular. El contenido del archivo .info podría ser 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 de archivo de información definidos info-file-fields-defined

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

Objeto Files

Objeto Totals

Customer Data Feed Las horas de nombre de archivo y las horas de contenido de archivo son diferentes different-processing-times

El archivo CDF contiene marcas de tiempo en el nombre y el contenido del archivo. Estas marcas de tiempo registran diferentes procesos de evento para el mismo archivo CDF. No es raro ver marcas de tiempo diferentes en el nombre y el 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.

Buscando CDF marcas de tiempo de archivos locating-timestamps

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

Explicación de la diferencia entre marcas de tiempo understanding-timestamps

La siguiente tabla proporciona detalles adicionales sobre las marcas de tiempo del archivo CDF, así como información sobre cómo utilizarlas correctamente.