Customer Data Feeds

Información básica sobre Customer Data Feed (CDF) archivos e instrucciones sobre cómo empezar. Inicio aquí si está interesado en recibir CDF archivos o sólo desea 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 IDs y todos los demás parámetros capturados por una llamada de evento. Los sistemas Audience Manager internos procesan los datos de evento en un archivo CDF con contenido organizado en campos que aparecen en un orden establecido. 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 existe un proceso de autoservicio para el envío de archivos CDF de inicio. Póngase en contacto con su Audience Manager asesor o con el Servicio de atención al cliente para empezar. Durante la implementación, su Audience Manager representante:

• Configure el contenedor de almacenamiento Amazon S3.
• Proporcione las credenciales de autenticación S3 de sólo lectura al contenedor de almacenamiento de archivos. No podrá ver ni acceder a directorios y archivos que pertenezcan a otros clientes.

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

Pasos siguientes

Las secciones a continuación y las Preguntas más frecuentes sobre fuentes de datos del cliente pueden ayudarle a familiarizarse con este servicio.

Customer Data Feed Contenido definido

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

Definiciones

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

Campo	Tipo de datos	Descripción
Event Time	Marca de hora	Hora a la que los Servidores de recopilación de datos (DCS) procesaron un archivo CDF. La marca de tiempo utiliza el formato aaaa-mm-dd hh:mm:ss y se establece en la zona horaria UTC. Nota: El tiempo de Evento no es: La hora del evento de la página o de la llamada del evento, aunque puede estar cerca de esas horas. Relacionado con la hora de DCS en el nombre del archivo. Consulte también, Tiempos del nombre del archivo de la fuente de datos del cliente y Tiempos del contenido del archivo....
Device	Cadena	Es el ID de usuario único (UUID), que es un ID de dispositivo de 38 dígitos para el visitante del sitio. Consulte también Índice de ID en Audience Manager.
Container ID	Numérica	ID del contenedor que activa la sincronización de ID.
Realized Traits	Matriz numérica	Matriz de ID de características que contiene todas las características que un visitante realizó (para las que se calificó) en la llamada de evento. Tenga en cuenta que la matriz puede contener características para las que el visitante ha calificado antes y para las que se vuelven a calificar a través de esta llamada de evento.
Realized Segments	Matriz numérica	Matriz de ID de segmentos que contiene todos los segmentos que un visitante realizó (para los que se calificó) en la llamada de evento.
Request Parameters	Cadena	Una cadena que captura todos los parámetros (variables, ID, pares de clave-valor, ID de publicidad de dispositivo, etc.) pasó en la llamada de evento. Ejemplo abreviado: d_rtbd:json,c_contextData.a.CarrierName:mobile,c_contextData.a.adid:92D56353-49C5-431E-B474-FC528D585810,c_contextData.a,RunMode:Application,c_contextData.a.DaysSinceLastUpgrade:61,d_cid_ic:xid%01EACB6E40-AC65-4012-9FE9-ABD59965E9C4%011,c_contextData.a.PrevSessionLength:583
Referer Data Type	Cadena	Dirección URL no codificada de la página de referencia (si existe).
IP Data Type	Cadena	La dirección IP del visitante capturado en la llamada de evento.
MCDevice	Cadena	El ID de Experience Cloud (MID) asignado al visitante del sitio. Consulte también Cookies y el servicio de identidad de Experience Platform de Adobe.
All Segments	Matriz numérica	Matriz de ID de segmentos que contiene segmentos realizados anteriormente y segmentos nuevos para los que está cualificado el visitante.
All Traits	Matriz numérica	Matriz de ID de características de origen y de terceros que contiene características realizadas anteriormente y características nuevas para las que el visitante ha calificado desde la última fuente de datos generada.

Customer Data Feed Estructura de archivos

Lista y define la estructura de datos de un archivo CDF. Esto incluye secuencias de datos, delimitadores y separadores de campos, una asignación de archivos de datos y un archivo de muestra.

Identificadores de campo de datos y secuencia

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

Elemento de archivo CDF	Descripción
Separadores y delimitadores de campo	Estos caracteres no imprimibles definen los elementos y la estructura del archivo CDF: Ctrl + a (ASCII 001 o ^A) separa los datos de campos individuales con un indicador de espacio no imprimible. Ctrl + b (ASCII 002 o ^B) separa los datos y la matriz y los parámetros de solicitud. Ctrl + c (ASCII 003 o ^C) define pares clave-valor.
Secuencia de campos	Importante: Audience Manager se reserva el derecho de agregar nuevos campos al final del archivo CDF en futuras versiones. Esto significa que el diseño técnico del sistema de análisis de archivos no debe asumir un número fijo de columnas (aunque puede asumir un orden fijo para las columnas existentes). Los datos del archivo CDF aparecen en el orden que se muestra a continuación. Tiempo de evento Device ID de contenedor Características realizadas Segmentos realizados Parámetros de solicitud Referer Dirección IP ID del dispositivo Experience Cloud (o MID). Consulte también Cookies y Servicio de identidad de Adobe Experience Platform Todos los segmentos Todas las características Para ver las descripciones de los campos, consulte Contenido de fuente de datos del cliente definido.

CDF Asignación de archivos

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

Identificación de matrices

Arreglos en un inicio de archivo CDF y termina con el separador de campo Ctrl + a. Esto hace que el primer elemento de una matriz aparezca como un campo de datos independiente. Por ejemplo, la matriz traits realizada inicio con ^A1234. El delimitador de matriz y la ID ^B5678 siguen a esta entrada. Como resultado, podría sentir la tentación de pensar que el primer elemento de la matriz traits realizada es el ID 5678 (porque inicio 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 matriz trait (o cualquiera de los otros arreglos de discos de un archivo CDF) se encuentre en inicio 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 está separado de la entrada anterior por ^A.

Archivo CDF de muestra

Un archivo CDF de muestra podría 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 a continuación lista y definen los elementos en el nombre del archivo CDF.

CDF Nombre del archivo: Sintaxis y ejemplo

Un nombre de archivo CDF típico contiene los elementos que se enumeran a continuación. Nota: italics 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-AAM PROCESS-ID_0.gz

Ejemplo

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

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

CDF Elementos de nombre de archivo definidos

La siguiente tabla lista y define los elementos en un nombre de archivo CDF.

Elemento Nombre de archivo	Descripción
s3://aam-cdf/	Este es el bloque de almacenamiento raíz predeterminado para el archivo CDF en un servidor Amazon S3.
your S3 bucket name	Nombre del contenedor S3 de sólo lectura que contiene los archivos CDF.
day=yyyy-mm-dd	La fecha en que se procesó el archivo.
hour=hh	Un valor de hora expresado en notación de 24 horas y definido en la zona horaria UTC. Consulte también, Tiempos del nombre del archivo de la fuente de datos del cliente y Tiempos del contenido del archivo....
partner ID	Su ID de socio.
AAM process ID_0	Un identificador de proceso Audience Manager interno.
.gz	Extensión de archivo gzip. Los archivos CDF están comprimidos gzip.

Customer Data Feed Notificaciones de procesamiento de archivos

Audience Manager escribe un .info archivo en el S3 directorio para informarle cuando el Customer Data File (CDF) está listo para la descarga. El archivo .info también incluye metadatos con formato JSON sobre el contenido de los archivos CDF. 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 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 los archivos CDF de un día en particular. El contenido del archivo .info podría 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 siguientes tablas lista y definen los elementos en un archivo CDF .info.

Objeto Files

Campo	Descripción
Files	Inicio la matriz que contiene metadatos sobre los archivos CDF.
FileByteSize	Tamaño del archivo en bytes.
FileChecksumMD5	El Amazon S3 ETag. El número que sigue al guión muestra el número de partes utilizadas para crear el archivo durante la carga de varias partes. El ETag no es idéntico a la suma de comprobación MD5 del archivo.
FileName	El nombre del archivo. Consulte Convenciones de nomenclatura de archivos de fuentes de datos de clientes.
FileSequenceNumber	Un número de índice para cada archivo.

Totals (objeto)

Campo	Descripción
Totals	Inicio el objeto que contiene datos agregados sobre todos los archivos CDF.
Day	El día para el que están disponibles los datos. Utiliza formato aaaa-mm-dd.
Hour	La hora para la que están disponibles los datos. Utiliza el formato de 24 horas establecido en la zona horaria UTC.
TotalByteSize	Tamaño total de todos los archivos CDF para esa fecha en bytes.
TotalNumberFiles	Número total de archivos cargados en el directorio S3.

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

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

Localización de CDF Marcas de hora de archivo

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

Explicación de la diferencia entre marcas de hora

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

Ubicación de marca de hora	Descripción
Nombre del archivo	La marca de tiempo del nombre de archivo CDF marca la hora en que Audience Manager comenzó a preparar el archivo para envío. Esta marca de tiempo se establece en el huso horario UTC. Utiliza el parámetro hour=, con el formato de hora de 2 dígitos en notación de 24 horas. Esta hora puede ser diferente a la hora de evento registrada en el contenido del archivo. Al trabajar con archivos CDF, a veces notará que su bloque S3 está vacío durante una hora en particular. Un depósito vacío significa cualquiera de los siguientes: No hay datos para esa hora en particular. Nuestros servidores están bajo cargas pesadas y no pueden procesar archivos durante una hora en particular. Cuando el servidor se pone al día, coloca los archivos que deberían haber pasado en un bloque de tiempo anterior en un bloque con un valor de tiempo posterior. Por ejemplo, verá esto cuando un archivo que debería estar en el bloque de hora 17 aparezca en el bloque de hora 18 (con hour=18 en el nombre del archivo). En este caso, es probable que el servidor haya empezado a procesar el archivo en la hora 17, pero no pueda completarlo dentro de ese intervalo de tiempo. En su lugar, el archivo se inserta en el siguiente bloque de tiempo por hora. Importante: No utilice la marca de tiempo del nombre del archivo para agrupar eventos por tiempo. Si necesita agrupar por tiempo, utilice la marca de tiempo EventTime en el contenido del archivo.
Contenido del archivo	La marca de tiempo en el contenido del archivo CDF marca la hora en que Data Collection Servers comenzó a procesar el archivo. Esta marca de tiempo se establece en el huso horario UTC. Utiliza el campo EventTime, con el formato de tiempo yyyy-mm-dd hh:mm:ss. Esta hora está cerca de la hora real del evento en la página, pero puede ser diferente al indicador de hora en el nombre del archivo. Sugerencia: A diferencia de la hour= marca de tiempo en el nombre del archivo, puede utilizarla EventTime para agrupar los datos por tiempo.