Customer Data Feeds customer-data-feeds

Grundlegende Informationen zu Customer Data Feed (CDF)-Dateien und Anweisungen zu den ersten Schritten. Beginnen Sie hier, wenn Sie an CDF-Dateien interessiert sind oder einfach weitere Informationen wünschen.

Dateiinhalte und -zweck file-contents-purpose

Eine CDF-Datei enthält dieselben Daten, die ein Audience Manager-Ereignisaufruf (/event) an unsere Server sendet. Dazu gehören Daten wie Benutzer-IDs, trait IDs, segment IDs und alle anderen Parameter, die von einem Ereignisaufruf erfasst werden. Interne Audience Manager verarbeitet Ereignisdaten in eine CDF Datei, deren Inhalt in Feldern organisiert ist, die in einer festgelegten Reihenfolge erscheinen. Audience Manager versucht, CDF Dateien stündlich zu generieren und speichert sie in einem sicheren, kundenspezifischen Behälter auf einem Amazon S3. Wir stellen Ihnen diese Dateien zur Verfügung, damit Sie mit Audience Manager Daten außerhalb der durch unsere Benutzeroberfläche gesetzten Grenzen arbeiten können.

Erste Schritte getting-started

Es gibt keinen Self-Service-Prozess, um CDF Dateibereitstellung zu starten. Wenden Sie sich an Ihren Audience Manager oder die Kundenunterstützung, um zu beginnen. Während der Implementierung hat Ihr Audience Manager folgende Aufgaben:

Dateibenachrichtigungen und CDF werden in Ihrem S3 angezeigt, wenn sie zum Download bereit sind. Sie sind für das Überwachen und Herunterladen von Dateien aus Ihrem zugewiesenen S3-Verzeichnis verantwortlich. Siehe Verarbeitungsbenachrichtigungen für CDF-Dateien.

Nächste Schritte next-steps

Die folgenden Abschnitte und die Häufig gestellte Fragen zu Kundendaten können Ihnen dabei helfen, sich mit diesem Service vertraut zu machen.

Customer Data Feed Inhalte definiert cdf-defined

Listet die Datenelemente und Arrays in einer CDF auf und definiert sie in der Reihenfolge ihres Erscheinungsbildes. Definitionen beinhalten Datentypen, diese Informationen sind jedoch nicht Teil einer CDF.

Definitionen definitions

Eine CDF-Datei enthält einige oder alle der unten definierten Felder. Informationen zur internen Dateiorganisation finden Sie unter Struktur der Daten-Feed-Datei.

Customer Data Feed Dateistruktur cdf-file-structure

Listet die Datenstruktur einer CDF auf und definiert sie. Dazu gehören die Datensequenz, Feldtrennzeichen und -trennzeichen, eine Datendateizuordnung und eine Beispieldatei.

Datenfeldkennungen und Sequenzen identifiers-and-sequence

CDF Dateien enthalten keine Spalten mit Beschriftungen oder Feldüberschriften. Stattdessen definiert eine CDF Felder und Arrays mit nicht druckbaren ASCII. Außerdem listet die Datei CDF jedes Feld und Array in einer bestimmten Reihenfolge auf. Wenn Sie die Feldkennungen und die Reihenfolge verstehen, können Sie die Datei ordnungsgemäß analysieren.

CDF Dateizuordnung cdf-file-map

CDF Dateidaten werden in der unten gezeigten Reihenfolge angezeigt.

Arrays identifizieren

Arrays in einer CDF beginnen und enden mit dem Ctrl + a. Dadurch erscheint das erste Element in einem Array wie ein eigenständiges Datenfeld. Beispielsweise beginnt das realisierte traits-Array mit ^A1234. Das Array-Trennzeichen und die ID ^B5678 folgen diesem Eintrag. Daher könnten Sie versucht sein zu glauben, dass das erste Element im realisierten traits die ID 5678 ist (da es mit ^B beginnt). Dies ist nicht der Fall, weshalb Sie mit der Reihenfolge und Struktur einer Datendatei vertraut sein müssen. Obwohl das erste Element im realisierten trait-Array (oder eines der anderen Arrays in einer CDF-Datei) mit ^A beginnt, definiert die Reihenfolge der Darstellung oder Position in der Datei den Beginn eines Arrays. Und das erste Element in einem Array wird immer durch ^A vom vorangehenden Eintrag getrennt.

CDF sample-file

Eine Beispieldatei für CDF könnte in etwa wie folgt aussehen. Wir haben Zeilenumbrüche in dieses Beispiel eingefügt, damit es auf die Seite passt.

Customer Data Feed Dateibenennungskonventionen cdf-naming-conventions

In den folgenden Abschnitten werden die Elemente in Ihrem CDF-Dateinamen aufgelistet und definiert.

CDF Dateiname: Syntax und Beispiel cdf-file-name

Ein typischer CDF-Dateiname enthält die unten aufgeführten Elemente. Hinweis: Kursiv gibt einen Variablenplatzhalter an:

Syntax

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

Beispiel

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

In Ihrem S3-Speicher-Bucket werden die Dateien in aufsteigender Reihenfolge nach Partner-ID (PID), Tag und Stunde sortiert.

CDF Dateinamenelemente definiert cdf-file-name-elements

In der folgenden Tabelle werden die -Elemente in einem CDF-Dateinamen aufgelistet und definiert.

Customer Data Feed von Dateiverarbeitungsbenachrichtigungen cdf-file-processing-notifications

Audience Manager schreibt eine .info-Datei in Ihr S3-Verzeichnis, um Sie darüber zu informieren, wann Ihr Customer Data File (CDF) zum Download bereit ist. Die .info enthält auch JSON formatierte Metadaten zum Inhalt Ihrer CDF. In diesem Abschnitt finden Sie Informationen über die Syntax und die von dieser Benachrichtigungsdatei verwendeten Felder.

Beispiel-Informationsdatei sample-info-file

Jede .info enthält einen Files und Totals Abschnitt. Der Abschnitt Files enthält ein -Array, das spezifische Metriken für jede stündliche Datei enthält. Der Abschnitt Totals enthält Metriken, die für alle CDF-Dateien eines bestimmten Tages aggregiert wurden. Der Inhalt Ihrer .info könnte dem folgenden Beispiel ähneln.

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

Definierte Felder der Informationsdatei info-file-fields-defined

In den folgenden Tabellen werden die Elemente in einer CDF .info-Datei aufgelistet und definiert.

Dateiobjekt

Gesamtobjekt

Customer Data Feed Zeiten für Dateinamen und Dateiinhalt sind unterschiedlich different-processing-times

Ihre CDF enthält Zeitstempel im Dateinamen und im Dateiinhalt. Diese Zeitstempel zeichnen verschiedene Ereignisprozesse für dieselbe CDF auf. Es ist nicht ungewöhnlich, dass im Namen und Inhalt derselben Datei unterschiedliche Zeitstempel angezeigt werden. Wenn Sie die einzelnen Zeitstempel verstehen, können Sie häufige Fehler bei der Arbeit mit diesen Daten oder beim Versuch, sie nach Zeit zu sortieren, vermeiden.

Suchen CDF Dateizeitstempeln locating-timestamps

CDF Dateien zeichnen die Zeit an zwei verschiedenen Orten unterschiedlich auf.

Unterschiede zwischen Zeitstempeln understanding-timestamps

Die folgende Tabelle enthält zusätzliche Informationen zu den Zeitstempeln Ihrer CDF-Datei sowie Informationen zu ihrer ordnungsgemäßen Verwendung.