Customer Data Feeds customer-data-feeds

Informations de base sur Customer Data Feed (CDF) et des instructions pour commencer. Commencez ici si vous souhaitez recevoir des CDF ou simplement pour obtenir 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 les données telles que les identifiants utilisateur, trait IDs, segment IDset tous les autres paramètres capturés par un appel d’événement. Interne Audience Manager système traite les données d’événement dans une CDF avec du contenu organisé en champs qui s’affichent dans un ordre défini. Audience Manager tente de générer CDF toutes les heures et les stocke dans un compartiment sécurisé spécifique au client sur une Amazon S3 serveur. Nous fournissons ces fichiers afin que vous puissiez travailler avec Audience Manager données en dehors des limites imposées par notre interface utilisateur.

Prise en main getting-started

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

Notifications de fichiers et CDF Les fichiers apparaîtront dans vos S3 lorsqu’ils sont prêts à être téléchargés. Vous êtes responsable de la surveillance et du téléchargement des fichiers à partir des S3 répertoire . Voir Notifications de traitement des fichiers de flux de données client.

Étapes suivantes next-steps

Les sections ci-dessous et le FAQ sur le flux de données client peut 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 une CDF par ordre d’apparition. Les définitions incluent les types de données, mais ces informations ne font pas partie d’une CDF fichier .

Définitions definitions

A 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’une CDF fichier . 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

CDF Les fichiers ne contiennent pas de colonnes ou d’en-têtes de champ étiquetés. Au lieu de cela, une CDF définit des champs et des tableaux sans impression ; ASCII caractères. En outre, la variable 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 Mappage de fichiers cdf-file-map

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

Identification des tableaux

Tableaux dans une CDF Le fichier commence et se termine par Ctrl + a séparateur de champ. Cela fait apparaître le premier élément d’un tableau comme un champ de données autonome. Par exemple, la variable traits Le tableau commence par ^A1234. Délimiteur et identifiant de tableau ^B5678 suit cette entrée. Par conséquent, vous pourriez être tenté de penser que le premier élément de la traits 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 dans la trait tableau (ou l’un des autres tableaux d’un CDF ) commence par ^A, l’ordre d’apparition 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 ^A.

Exemple CDF Fichier sample-file

Un exemple 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 CDF nom du fichier.

CDF Nom du fichier : Syntaxe et exemple cdf-file-name

Un CDF Le nom de fichier contient les éléments répertoriés ci-dessous. Remarque : 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 S3 compartiment de stockage, les fichiers sont triés dans l’ordre croissant par identifiant de partenaire (PID), jour et heure.

CDF Définition des éléments du nom de fichier cdf-file-name-elements

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

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

Audience Manager écrit une .info dans votre fichier S3 pour vous informer lorsque votre Customer Data File (CDF) est prête à être téléchargée. Le .info inclut également JSON métadonnées formatées sur le contenu de votre CDF fichiers . 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 .info contient un fichier Files et Totals . Le Files contient un tableau contenant des mesures spécifiques pour chaque fichier horaire. Le Totals contient des mesures agrégées dans toutes vos CDF fichiers pour un jour spécifique. Le contenu de votre .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’une CDF .info fichier .

Objet Fichiers

Objet Totaux

Customer Data Feed Les heures des noms de fichier et les heures du contenu du fichier diffèrent different-processing-times

Votre 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 CDF fichier . 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 CDF Horodatages du fichier locating-timestamps

CDF Les fichiers 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 votre CDF horodatages du fichier, ainsi que des informations sur la manière de les utiliser correctement.