Customer Data Feeds

Grundlegende Informationen Customer Data Feed (CDF) Dateien und Anweisungen zu den ersten Schritten. Beginnen Sie hier, wenn Sie Interesse haben CDF oder Sie benötigen einfach weitere Informationen.

Dateiinhalt und Zweck

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 IDsund alle anderen Parameter, die von einem Ereignisaufruf erfasst werden. intern Audience Manager Systeme verarbeitet Ereignisdaten in einer CDF -Datei mit Inhalten, die in Feldern angeordnet sind, die in einer bestimmten Reihenfolge angezeigt werden. Audience Manager Versuche, CDF Dateien stündlich speichern und 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.

Erste Schritte

Es gibt keinen zu startenden Self-Service-Prozess CDF Dateibereitstellung. Wenden Sie sich an Audience Manager -Berater oder Kundenunterstützung . Während der Implementierung Audience Manager wird

• Richten Sie Ihre Amazon S3 Speicherbehälter.
• Schreibgeschützt bereitstellen S3 Authentifizierungsberechtigungen für Ihren Dateispeicherbehälter. Sie können Verzeichnisse und Dateien, die zu anderen Kunden gehören, nicht sehen oder darauf zugreifen.

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

Nächste Schritte

Die folgenden Abschnitte und die Häufig gestellte Fragen zu Kundendaten-Feeds kann Ihnen dabei helfen, sich mit diesem Dienst besser vertraut zu machen.

Customer Data Feed Definierte Inhalte

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

Definitionen

A CDF enthält einige oder alle unten definierten Felder. Informationen zur internen Dateiorganisation finden Sie unter Dateistruktur des Kundendaten-Feeds.

Customer Data Feed Dateistruktur

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

Datenfeld-IDs und -Sequenzen

CDF -Dateien enthalten keine gekennzeichneten Spalten oder Feldkopfzeilen. Stattdessen wird eine CDF -Datei definiert Felder und Arrays ohne Drucken ASCII Zeichen. Außerdem wird die CDF -Datei listet jedes Feld und Array in einer bestimmten Reihenfolge auf. Mithilfe der Kennungen und der Reihenfolge der Felder können Sie die Datei richtig analysieren.

CDF Dateizuordnung

CDF -Dateidaten werden in der unten gezeigten Reihenfolge angezeigt.

Identifizieren von Arrays

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

Beispiel CDF Datei

Beispiel CDF -Datei 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 Namenskonventionen für Dateien

In den folgenden Abschnitten werden die Elemente in der CDF Dateiname.

CDF Dateiname: Syntax und Beispiel

Eine typische CDF Der 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 S3 -Speicher, werden die Dateien in aufsteigender Reihenfolge nach Partner-ID (PID), Tag und Stunde.

CDF Definierte Dateinamenelemente

In der folgenden Tabelle sind die Elemente in einer CDF Dateiname.

Customer Data Feed Dateiverarbeitungsbenachrichtigungen

Audience Manager schreibt eine .info Datei S3 -Verzeichnis, über das Sie erfahren können, wann Ihre Customer Data File (CDF) kann heruntergeladen werden. Die .info 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

Jeder .info -Datei enthält Files und Totals Abschnitt. Die Files -Abschnitt enthält ein Array, das spezifische Metriken für jede stündliche Datei enthält. Die Totals enthält Metriken, die über all Ihre CDF -Dateien für einen bestimmten Tag. Der Inhalt Ihrer .info -Datei ähnlich 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

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

Dateiobjekt

Gesamtobjekt

Customer Data Feed Dateinamenzeiten und Dateiinhaltszeiten sind unterschiedlich

Ihre CDF enthält Zeitstempel im Dateinamen und Dateiinhalt. Diese Zeitstempel zeichnen unterschiedliche Ereignisprozesse für dieselben auf CDF -Datei. 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.

Standort CDF Datei-Zeitstempel

CDF -Dateien verzeichnen die Zeit an zwei verschiedenen Speicherorten unterschiedlich.

Unterschiede zwischen Zeitstempeln verstehen

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

Ressourcen für Business.Adobe.com

Device Graph Mobile App Analytics Customer Journey Analytics Data Ingestion Cohort Analysis Ad Hoc Analysis