Customer Data Feeds customer-data-feeds

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

Contenu et objectif du fichier file-contents-purpose

Un fichier CDF contient les mêmes données qu’un appel d’événement Audience Manager (/event) envoie à nos serveurs. Cela inclut les données telles que les identifiants d’utilisateur, les trait IDs, les segment IDs et tous les autres paramètres capturés par un appel d’événement. Les systèmes de Audience Manager internes traitent les données d’événement dans un fichier CDF avec le contenu organisé en champs qui apparaissent 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é et 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 CDF diffusion de fichiers. Contactez votre consultant Audience Manager ou l’assistance clientèle pour commencer. Pendant la mise en œuvre, 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 a été attribué. Voir Notifications de traitement des fichiers de flux de données client.

Étapes suivantes next-steps

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

Contenu Customer Data Feed défini cdf-defined

Répertorie et définit les éléments de données et les tableaux d’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 du flux de données client.

Structure de fichier Customer Data Feed cdf-file-structure

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

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

Les fichiers CDF ne contiennent pas de colonnes ou d’en-têtes de champ libellé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. Comprendre l’ordre et les identifiants des champs vous aidera à analyser correctement le fichier.

Mappage de fichier CDF cdf-file-map

CDF données du fichier s’affichent dans l’ordre indiqué ci-dessous.

Identification de tableaux

Les tableaux d’un fichier CDF commencent et se terminent par le séparateur de champs Ctrl + a. Ainsi, le premier élément d’un tableau ressemble à un champ de données autonome. Par exemple, le tableau de traits réalisé commence par ^A1234. Le délimiteur de tableau et l’ID ^B5678 suivent cette entrée. Par conséquent, vous pouvez être tenté de penser que le premier élément du tableau de 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 de trait réalisé (ou de tout autre tableau d’un fichier CDF) commence par ^A, l’ordre d’aspect ou de 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 des ^A.

Exemple de fichier CDF sample-file

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

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

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

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

Un nom de fichier CDF type contient les éléments répertoriés ci-dessous. Remarque : l’italique 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.

Éléments De Nom De Fichier CDF Définis cdf-file-name-elements

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

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

Audience Manager écrit un fichier .info dans votre répertoire S3 pour vous informer lorsque votre Customer Data File (CDF) est prêt à être téléchargé. Le fichier .info comprend également JSON métadonnées 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 qui contient 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 spécifique. 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 de 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.

File, objet

Totaux, objet

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

Votre fichier CDF contient des horodatages dans le nom 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. Comprendre chaque horodatage peut vous aider à éviter les erreurs courantes lors de l’utilisation de ces données ou d’essayer de les trier par heure.

Localisation des horodatages de fichier CDF locating-timestamps

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

Comprendre 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 leur utilisation correcte.