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 archivos o simplemente desea obtener más información.

Contenido y propósito del archivo

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 ID de usuario, trait IDs, segment IDsy todos los demás parámetros capturados por una llamada de evento. Interno Audience Manager procesa los datos de evento en una 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 espacio seguro y específico del 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 para iniciar CDF envío de archivos. Póngase en contacto con su Audience Manager consultor o con el Servicio de atención al cliente para empezar. Durante la implementación, su Audience Manager el representante:

• Configure su Amazon S3 cubo de almacenamiento.
• Proporcionar solo lectura S3 credenciales de autenticación en el contenedor 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 cubos cuando estén listos para descargar. Usted es responsable de supervisar y descargar archivos de su asignado S3 directorio. Consulte Notificaciones sobre procesamiento de archivos de fuentes de datos de clientes.

Pasos siguientes

Las secciones siguientes y la Preguntas frecuentes sobre fuentes 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 de una CDF archivo, por orden de aparición. 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 interna de archivos, consulte Estructura de archivo de fuente de datos del cliente.

Customer Data Feed Estructura de archivos

Enumera y define la estructura de datos de un CDF archivo. 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

CDF los archivos no contienen columnas etiquetadas ni encabezados de campo. En su lugar, un CDF define campos y matrices con elementos no imprimibles ASCII caracteres. Además, la variable CDF El archivo 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.

CDF Mapa de archivos

CDF los datos del archivo aparecen en el orden mostrado a continuación.

Identificación de matrices

Matrices en una CDF inicio y final del archivo con Ctrl + a separador de campos. Esto hace que el primer elemento de una matriz parezca un campo de datos independiente. Por ejemplo, la cuenta traits la matriz empieza por ^A1234. El delimitador de matriz y el ID ^B5678 sigue esta entrada. Como resultado, puede sentirse tentado a pensar que el primer elemento de la imagen realizada traits La matriz es el ID 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. A pesar de que el primer elemento en el realizado trait matriz (o cualquiera de las otras matrices de una CDF file) empieza 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 se separa de la entrada anterior por ^A.

Muestra CDF Archivo

Una 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 nomenclatura de archivos

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

CDF Nombre del archivo: sintaxis y ejemplo

Un típico CDF file name contiene los elementos que se enumeran a continuación. Nota, cursiva indica un marcador de posición 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 su S3 , los archivos se ordenan en orden ascendente por ID de socio (PID), día y hora.

CDF Elementos de nombre de archivo definidos

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

Customer Data Feed Notificaciones de procesamiento de archivos

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

Cada .info el archivo contiene un Files y Totals sección. El Files contiene una matriz que contiene métricas específicas para cada archivo por hora. El Totals contiene métricas agregadas en todas sus CDF archivos de un día en particular. El contenido de su .info podría ser similar al 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

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

Objeto Files

Objeto Totals

Customer Data Feed Las horas del nombre del archivo y las horas del contenido del archivo son diferentes

Su CDF el archivo contiene marcas de hora en su nombre y contenido. Estas marcas de tiempo registran diferentes procesos de evento para el mismo CDF archivo. 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.

Localización CDF Marcas horarias de archivo

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

Explicación de la diferencia entre marcas de tiempo

La siguiente tabla proporciona detalles adicionales sobre su CDF las marcas de tiempo de los archivos, junto con información sobre cómo utilizarlas correctamente.

Recursos de Business.Adobe.com

Device Graph Mobile App Analytics Customer Journey Analytics Data Ingestion Cohort Analysis Ad Hoc Analysis