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 CDF-Dateien erhalten möchten oder einfach mehr Informationen benötigen.

Dateiinhalt 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 Systeme verarbeiten Ereignisdaten in einer CDF -Datei, deren Inhalt in Felder unterteilt ist, die in einer bestimmten Reihenfolge angezeigt werden. Audience Manager versucht, CDF -Dateien stündlich zu generieren und speichert sie in einem sicheren, kundenspezifischen Behälter auf einem Amazon S3 -Server. Wir stellen diese Dateien bereit, damit Sie mit Audience Manager -Daten außerhalb der durch unsere Benutzeroberfläche festgelegten Grenzen arbeiten können.

Erste Schritte getting-started

Es gibt keinen Self-Service-Prozess zum Starten des CDF-Dateiversands. Wenden Sie sich an Ihren Audience Manager -Berater oder die Kundenunterstützung, um zu beginnen. Während der Implementierung wird Ihr Audience Manager -Support-Mitarbeiter:

Dateibenachrichtigungen und CDF -Dateien werden in Ihrem S3 -Bucket angezeigt, wenn sie zum Download bereit sind. Sie sind für die Überwachung und das 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 FAQ zum Kundendaten-Feed können Ihnen dabei helfen, sich mit diesem Dienst besser vertraut zu machen.

Customer Data Feed Definierte Inhalte cdf-defined

Führt die Datenelemente und Arrays in einer CDF -Datei in der Reihenfolge ihres Erscheinungsbilds auf und definiert sie. Definitionen umfassen Datentypen, diese Informationen sind jedoch nicht Teil einer CDF -Datei.

Definitionen definitions

Eine CDF -Datei enthält einige oder alle unten definierten Felder. Weitere Informationen zur internen Dateiorganisation finden Sie unter Struktur der CDF-Datei für Kunden-Daten-Feeds.

Customer Data Feed Dateistruktur cdf-file-structure

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

Datenfeld-IDs und Sequenz identifiers-and-sequence

CDF -Dateien enthalten keine gekennzeichneten Spalten oder Feldkopfzeilen. Stattdessen definiert eine CDF -Datei Felder und Arrays mit nicht druckbaren ASCII -Zeichen. Außerdem werden in der Datei "CDF"jedes Feld und Array in einer bestimmten Reihenfolge aufgelistet. Mithilfe der Kennungen und der Reihenfolge der Felder können Sie die Datei richtig analysieren.

CDF Dateizuordnung cdf-file-map

CDF -Dateidaten werden in der unten gezeigten Reihenfolge angezeigt.

Identifizieren von Arrays

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

Beispieldatei CDF sample-file

Eine Beispiel-Datei mit dem Namen CDF könnte in etwa wie folgt aussehen: Wir haben Zeilenumbrüche in dieses Beispiel eingefügt, damit es an die Seite angepasst werden kann.

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 -Speicherbehälter werden die Dateien in aufsteigender Reihenfolge nach Partner-ID (PID), Tag und Stunde sortiert.

CDF Definierte Dateinamenelemente cdf-file-name-elements

In der folgenden Tabelle sind die Elemente in einem CDF -Dateinamen aufgeführt und definiert.

Customer Data Feed 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 Datei .info enthält auch JSON formatierte Metadaten zum Inhalt Ihrer CDF -Dateien. In diesem Abschnitt finden Sie Informationen zur Syntax und zu den Feldern, die von dieser Benachrichtigungsdatei verwendet werden.

Beispiel-Info-Datei sample-info-file

Jede .info -Datei enthält einen Abschnitt Files und Totals. 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 über all Ihre CDF -Dateien für einen bestimmten Tag hinweg aggregiert werden. Der Inhalt Ihrer .info -Datei könnte in etwa wie im folgenden Beispiel aussehen.

{
    "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 Informationsdateifelder info-file-fields-defined

In den folgenden Tabellen sind die Elemente in einer Datei vom Typ CDF .info aufgeführt und definiert.

Dateiobjekt

Gesamtobjekt

Customer Data Feed Dateinamenzeiten und Dateiinhaltszeiten sind unterschiedlich different-processing-times

Ihre CDF-Datei enthält Zeitstempel im Dateinamen und Dateiinhalt. Diese Zeitstempel zeichnen verschiedene Ereignisprozesse für dieselbe CDF -Datei auf. Es ist nicht ungewöhnlich, verschiedene Zeitstempel im Namen und Inhalt derselben Datei zu sehen. Die Kenntnis jedes Zeitstempels kann Ihnen dabei helfen, häufige Fehler beim Arbeiten mit diesen Daten oder beim Versuch, sie nach Zeit zu sortieren, zu vermeiden.

Suchen von CDF Datei-Zeitstempeln locating-timestamps

CDF -Dateien zeichnen die Zeit an zwei verschiedenen Speicherorten unterschiedlich auf.

Unterschiede zwischen Zeitstempeln verstehen understanding-timestamps

Die folgende Tabelle enthält weitere Details zu Ihren CDF-Datei-Zeitstempeln sowie Informationen zu ihrer ordnungsgemäßen Verwendung.