Datendateien für Berichte zur Zielgruppenoptimierung und ausführbare Protokolldateien

Eine Datendatei enthält Impressions-, Klick- oder Konversionsdaten. Bei ordnungsgemäßer Formatierung können Sie diese Daten in Audience Manager importieren, um sie in den Audience Optimization-Berichten anzuzeigen und Eigenschaften mithilfe der Daten über Actionable Log Files zu erstellen. Formatieren Sie Ihre Datendateien gemäß den in diesem Abschnitt beschriebenen Spezifikationen.

Überblick

Mit einer ordnungsgemäß benannten und formatierten Datendatei können Sie Impressions-, Klick- oder Konversionsdaten in die Audience Optimization-Berichte importieren. Dies ist nützlich, wenn Sie mit einem Partner arbeiten, der nicht in Audience Manager integriert ist, und mit dessen Daten in dieser Report Suite arbeiten möchten. Dieser Prozess erfordert separate Dateien für Impression-, Klick- und Konversionsdaten. Mischen Sie diese Ereignisse nicht in einer Datei.

Eine Datendatei muss von einer Metadatendatei begleitet sein. Der Inhalt der Metadatendatei stimmt mit den Datendateiinformationen mit den zugehörigen, für Menschen lesbaren Bezeichnungen in den Berichtmenüs überein. Weitere Informationen finden Sie unter Übersicht und Zuordnungen für Metadatendateien.

Namenskonventionen für Datendateien

Die folgende Syntax definiert die Struktur eines korrekt formatierten Datendateinamens. Hinweis: kursiv gibt einen Variablenplatzhalter an, der sich je nach Dateiinhalt ändert.

Syntax:

Ereignistyp_yyymmdd

In einem Dateinamen:

  • Der Ereignistyp gibt an, dass die Datei Impressionen, Klicks oder Konversionen enthält. Erstellen Sie für jeden Ereignistyp eine separate Datei.
  • Ein Unterstrich trennt den Ereignistyp und einen Jahresmonatszeitstempel.
  • Komprimieren Sie vor dem Hochladen Ihre Dateien mit gzip und speichern Sie sie mit der Dateierweiterung .gz.

Benennen Sie Ihre Datendateien anhand dieser Anforderungen anhand ihres Inhalts wie folgt:

  • Impressionsdaten:
    impressions_yyymmdd.gz
  • Klickdaten:
    clicks_yyymmdd.gz
  • Konversionsdaten:
    conversions_yyymmdd.gz

Inhaltsformat für Datendateien

Die folgende Syntax definiert die Inhaltsstruktur in einer korrekt formatierten Datendatei. Hinweis: kursiv gibt einen Variablenplatzhalter an und wird in einer eigentlichen Datendatei durch eine Beschriftung ersetzt.

Syntax:

Kopfzeilenbezeichnung 1  |  Kopfzeilenbezeichnung 2Kopfzeilenbezeichnung n  |  Version

Im Dateiinhalt:

  • Die Kopfzeilenbeschriftungen müssen in der Reihenfolge angezeigt werden, wie in der Tabelle unten dargestellt. Impressionen und Klicks verwenden dieselben Bezeichnungen. Konvertierungsdateien enthalten zusätzliche Header.

  • Wenn Sie keine Daten für eine bestimmte Spalte haben, füllen Sie dieses Feld mit einem -1.

  • Dateien must enden mit einer Versionsnummer. Die aktuelle Version ist 1.1.

  • Trennen Sie Dateiüberschriften und -inhalte durch das nicht druckbare ASCII-001-Zeichen. Wenn Sie ASCII 001 nicht verwenden können, trennen Sie die Kopfzeilen und Daten durch ein Tabulatortrennzeichen. Da es sich hierbei um nicht druckbare Zeichen handelt, zeigt das oben stehende Syntaxbeispiel einen senkrechten Strich "|" nur zu Anzeigezwecken.

Feldbeschriftungen

In der folgenden Tabelle sind die Spaltenüberschriften für Ihre Datendatei aufgeführt und beschrieben. Bei Kopfzeilen wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen in der Tabelle in der Reihenfolge angezeigt werden. Sofern nicht anders angegeben, sind alle Datentypen Ganzzahlen (INT).

Beschriftung Beschreibung

Zeitstempel

Ein UTC-Datum und eine UTC-Uhrzeit für das Impression-, Klick- oder Konversionsereignis. Verwenden Sie das Format yyyy-MM-dd HH:mm:ss .

User-ID

Ihre ID für einen Site-Besucher, auch als Datenanbieter bezeichnet, eindeutige Benutzer-ID oder DPUUID.

Advertiser-ID

Die Datenquellen-ID oder der Integrationscode für Ihren Advertiser.

BU-ID

Kennung der Geschäftseinheit.

Campaign-ID

Kampagnen-ID.

Creative-ID

Creative-ID.

Site-ID

Site-ID.

Placement-ID

Numerische Platzierungs-ID vom Anzeigen-Server.

Insertion-Order-ID

Einfügebestellkennung.

Tactic-ID

Tactic ID.

Vertikal-ID

Kennung für einen vertikalen Markt oder eine Kategorie.

Quantität

Die Anzahl der bei einem Konversionsereignis verkauften Artikel.

Nur für Konversionsdatendateien.

Umsatz

Kauf- oder anderer Konversionsbetrag. Datentyp: Float.

Nur für Konversionsdatendateien.

Sonstige-Daten

URL der Konversions-Landingpage. Datentyp: Zeichenfolge.

Nur für Konversionsdatendateien.

Ereignistyp

Konvertierungstyp. Gibt an, ob eine Konvertierung übereinstimmt oder nicht. Zu den Optionen zählen:

  • 0: Impression
  • 1: Klicken
  • -1: Nicht zugeordnet oder unbekannt

Nur für Konversionsdatendateien.

Version

Eine erforderliche Versionsnummer, die am Ende jeder Zeile in einer Impression-, Klick- oder Konversionsdatendatei angezeigt wird. Die aktuelle Version ist 1.1.

Bereitstellungsmethoden für Datendateien

Laden Sie Ihre Impressions-, Klick- oder Konversionsdatendateien in ein Amazon S3-Verzeichnis für Ihr Audience Manager-Konto hoch. In diesem Abschnitt finden Sie Informationen zu Versand-/Ordnerpfaden, Dateiverarbeitungszeiten und Aktualisierungen.

WICHTIG

Wenden Sie sich an Ihren Audience Manager-Berater oder die Kundenunterstützung, um zu beginnen und ein Amazon S3-Verzeichnis für Ihre Datendateien einzurichten.

Syntax und Beispiele für Bereitstellungspfad

Die Daten werden in einem separaten Namespace für jeden Kunden in einem Amazon S3 -Verzeichnis gespeichert. Der Dateipfad folgt der unten dargestellten Syntax. Hinweis: kursiv gibt einen Variablenplatzhalter an. Andere Elemente sind Konstanten oder Schlüssel und ändern sich nicht.

Syntax:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ Dateityp_yyymmdd

Die folgende Tabelle definiert jedes dieser Elemente in einem Dateibereitstellungspfad.

Dateiparameter Beschreibung

.../log_ingestion/

Dies ist der Anfang des Ordnerspeicherpfads. Sie erhalten den vollständigen Pfad, wenn alles eingerichtet ist.

pid=AAM ID

Dieses Schlüssel-Wert-Paar enthält Ihre Audience Manager Kunden-ID.

dpid=d_src

Dieses Schlüssel-Wert-Paar enthält die Datenquellen-ID, die bei einem Ereignisaufruf übergeben wird. Er identifiziert die Agentur, aus der die Daten stammen, und verknüpft diese Daten mit einer unterstützenden Metadatendatei.

logs

Ein Ordner auf höherer Ebene für Datendateien.

file type_yyyymmdd

Ein Dateiname, der angibt, welche Art von Daten er enthält, und ein Versandzeitstempel.

Beispiel-Upload-Pfad und Dateiname

Wenn Sie eine Datei hochladen, sieht der Pfad in etwa wie folgt aus:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

Dateiverarbeitungszeiten und -aktualisierungen

Datendateien werden viermal täglich in regelmäßigen Abständen verarbeitet.

Um Ihre Daten zu aktualisieren, senden Sie eine Datei, die alle Impressionen, Klicks oder Konversionen für einen bestimmten Tag enthält. In diesem Fall ist ein Tag der 24-Stunden-Zeitraum von einem Mitternacht zum nächsten. Als Best Practice empfiehlt sich möglicherweise die Verwendung der UTC-Zeit, um Ihr Tagesintervall zu definieren.

Nächste Schritte

Überprüfen Sie die Anforderungen zum Benennen und Erstellen von Metadatendateien. Informationen zu den ersten Schritten finden Sie unter Übersicht und Zuordnungen für Metadatendateien.

Auf dieser Seite