Customer Data Feeds customer-data-feeds

Informations de base sur les fichiers Customer Data Feed (CDF) et instructions pour commencer. Commencez ici si vous souhaitez recevoir des fichiers CDF ou simplement plus d’informations.

Contenu et objectif du fichier file-contents-purpose

Un fichier CDF contient les mêmes données que celles envoyées à nos serveurs par un appel d’événement Audience Manager (/event). Cela inclut des données telles que les identifiants utilisateur, trait IDs, segment IDs et tous les autres paramètres capturés par un appel d’événement. Les systèmes internes Audience Manager traitent les données d’événement dans un fichier CDF dont le contenu est organisé en champs qui s’affichent dans un ordre défini. Audience Manager tente de générer des fichiers CDF toutes les heures et les stocke dans un compartiment sécurisé spécifique au client sur un serveur Amazon S3. Nous fournissons ces fichiers afin que vous puissiez travailler avec des données Audience Manager en dehors des limites imposées par notre interface utilisateur.

Prise en main getting-started

Il n'existe aucun processus en libre-service pour démarrer la diffusion de fichiers CDF. Contactez votre consultant Audience Manager ou l’assistance clientèle pour commencer. Pendant la mise en oeuvre, votre représentant Audience Manager :

Les notifications de fichiers et les fichiers CDF apparaîtront dans votre compartiment S3 lorsqu’ils seront prêts à être téléchargés. Vous êtes responsable de la surveillance et du téléchargement des fichiers à partir du répertoire S3 qui vous est assigné. Voir Notifications de traitement des fichiers de flux de données client.

Étapes suivantes next-steps

Les sections ci-dessous et la FAQ sur le flux de données client peuvent vous aider à vous familiariser avec ce service.

Customer Data Feed Contenu défini cdf-defined

Répertorie et définit les éléments de données et les tableaux dans un fichier CDF, par ordre d’apparition. Les définitions incluent les types de données, mais ces informations ne font pas partie d’un fichier CDF.

Définitions definitions

Un fichier CDF comprend certains ou tous les champs définis ci-dessous. Pour plus d’informations sur l’organisation interne des fichiers, voir Structure de fichier de flux de données client.

Customer Data Feed Structure de fichier cdf-file-structure

Répertorie et définit la structure de données d’un fichier CDF. Cela inclut la séquence de données, les délimiteurs et les séparateurs de champ, un mappage de fichier de données et un fichier d’exemple.

Identifiants de champ de données et séquence identifiers-and-sequence

Les fichiers CDF ne contiennent pas de colonnes ou d’en-têtes de champ étiquetés. À la place, un fichier CDF définit des champs et des tableaux avec des caractères ASCII non imprimables. En outre, le fichier CDF répertorie chaque champ et tableau dans un ordre spécifique. La compréhension des identifiants de champ et de l’ordre vous aidera à analyser correctement le fichier.

CDF File Map cdf-file-map

Les données de fichier CDF apparaissent dans l’ordre indiqué ci-dessous.

Identification des tableaux

Les tableaux d’un fichier CDF commencent et se terminent par le séparateur de champ Ctrl + a. Cela fait apparaître le premier élément d’un tableau comme un champ de données autonome. Par exemple, le tableau traits réalisé commence par ^A1234. Le délimiteur de tableau et l’ID ^B5678 suit cette entrée. Par conséquent, vous pouvez être tenté de penser que le premier élément du tableau traits réalisé est l’ID 5678 (car il commence par ^B). Ce n’est pas le cas, c’est pourquoi vous devez connaître la séquence et la structure d’un fichier de données. Même si le premier élément du tableau trait réalisé (ou de l’un des autres tableaux d’un fichier CDF) commence par ^A, l’ordre d’apparition ou la position dans le fichier définit le début d’un tableau. De plus, le premier élément d’un tableau est toujours séparé de l’entrée précédente par ^A.

Exemple de fichier CDF sample-file

Un exemple de fichier CDF peut ressembler à ce qui suit. Nous avons inséré des sauts de ligne dans cet exemple pour l’aider à s’adapter à la page.

Customer Data Feed Conventions de dénomination des fichiers cdf-naming-conventions

Les sections ci-dessous répertorient et définissent les éléments de votre nom de fichier CDF.

CDF Nom de fichier : syntaxe et exemple cdf-file-name

Un nom de fichier CDF type contient les éléments répertoriés ci-dessous. Remarque : italics indique un espace réservé de variable :

Syntaxe

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

Exemple

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

Dans votre compartiment de stockage S3, les fichiers sont triés par ordre croissant par identifiant de partenaire (PID), jour et heure.

CDF Éléments de nom de fichier définis cdf-file-name-elements

Le tableau suivant répertorie et définit les éléments d’un nom de fichier CDF.

Customer Data Feed Notifications de traitement de fichier cdf-file-processing-notifications

Audience Manager écrit un fichier .info dans votre répertoire S3 pour vous informer du moment où votre Customer Data File (CDF) est prêt pour le téléchargement. Le fichier .info comprend également des métadonnées JSON formatées sur le contenu de vos fichiers CDF. Consultez cette section pour plus d’informations sur la syntaxe et les champs utilisés par ce fichier de notification.

Exemple de fichier d’informations sample-info-file

Chaque fichier .info contient une section Files et Totals. La section Files contient un tableau contenant des mesures spécifiques pour chaque fichier horaire. La section Totals contient des mesures agrégées dans tous vos fichiers CDF pour un jour particulier. Le contenu de votre fichier .info peut ressembler à l’exemple suivant.

{
    "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
    }
}

Champs du fichier d’informations définis info-file-fields-defined

Les tableaux suivants répertorient et définissent les éléments d’un fichier CDF .info.

Objet Fichiers

Objet Totaux

Customer Data Feed Les heures de nom de fichier et les heures de contenu de fichier sont différentes different-processing-times

Votre fichier CDF contient des horodatages dans le nom de fichier et le contenu du fichier. Ces horodatages enregistrent différents processus d’événement pour le même fichier CDF. Il n’est pas rare de voir des horodatages différents dans le nom et le contenu d’un même fichier. La compréhension de chaque horodatage peut vous aider à éviter les erreurs courantes lorsque vous utilisez ces données ou essayez de les trier par heure.

Localisation des horodatages de fichier CDF locating-timestamps

Les fichiers CDF enregistrent le temps différemment dans 2 emplacements distincts.

Présentation de la différence entre les horodatages understanding-timestamps

Le tableau suivant fournit des détails supplémentaires sur les horodatages de vos fichiers CDF, ainsi que des informations sur la manière de les utiliser correctement.