Datendateien zum Audience Optimization von Berichten und verwertbaren Protokolldateien data-files-for-audience-optimization-reports

Eine Datendatei enthält Impressions-, Klick- oder Konversionsdaten. Wenn Sie richtig formatiert sind, können Sie diese Daten in den Audience Manager importieren, um sie in den Audience Optimization-Berichten anzuzeigen und Eigenschaften mithilfe der Daten über " Protokolldateien“. Formatieren Sie Ihre Datendateien entsprechend den Spezifikationen in diesem Abschnitt.

Überblick overview

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

Zu einer Datendatei muss eine Metadatendatei gehören. Die Inhalte der Metadatendateien stimmen mit den Datendateiinformationen in Bezug auf menschenlesbare Kennzeichnungen in den Berichtsmenüs überein. Weitere Informationen finden Sie unter Übersicht und Zuordnungen für Metadatendateien.

Benennungskonventionen für Datendateien naming-conventions

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

Syntax:

Ereignistyp_JJJMMTT

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 Jahr-Monat-Zeitstempel.
  • Komprimieren Sie Ihre Dateien vor dem Hochladen mit gzip und speichern Sie sie mit der Dateierweiterung .gz.

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

  • Impressionsdaten:

    code language-none
    impressions_yyymmdd.gz
    
  • Klickdaten:

    code language-none
    clicks_yyymmdd.gz
    
  • Konvertierungsdaten:

    code language-none
    conversion_yyymmdd.gz
    

Inhaltsformat für Datendateien content-format

Die folgende Syntax definiert die Inhaltsstruktur in einer wohlgeformten Datendatei. Beachten Sie dass einen Variablenplatzhalter angibt und in einer Datendatei durch eine Beschriftung ersetzt wird.

Syntax:

Kopfzeilenbeschriftung 1 | Kopfzeilenbeschriftung 2 … Kopfzeilenbeschriftung N | version

Im Dateiinhalt:

  • Die Kopfzeilenbeschriftungen müssen in der in der folgenden Tabelle angegebenen Reihenfolge angezeigt werden. Impressionen und Klicks verwenden dieselben Beschriftungen. Konvertierungsdateien enthalten zusätzliche Header.

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

  • Dateien müssen mit einer Versionsnummer enden. Die aktuelle Version ist 1.1.

  • Trennen Sie Dateikopfzeilen und -inhalte durch das nicht druckbare ASCII 001-Zeichen. Wenn Sie ASCII 001 nicht verwenden können, trennen Sie die Kopfzeilen und Daten mit einem Tabulatortrennzeichen. Da es sich hierbei um nicht druckbare Zeichen handelt, zeigt das obige Syntaxbeispiel nur für Anzeigezwecke einen "|".

Feldbezeichnungen

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. Alle Datentypen sind Ganzzahlen (INT), sofern nicht anders angegeben.

Beschriftung
Beschreibung
Zeitstempel
Ein UTC-Datum und eine UTC-Uhrzeit für das Impression-, Klick- oder Konversionsereignis. Verwenden Sie das yyyy-MM-dd HH:mm:ss.
Benutzer-ID
Ihre ID für einen Site-Besucher, auch bekannt als eindeutige Benutzer-ID des -Datenanbieters DPUUID.
Advertiser-ID
Die Datenquellen-ID oder der Integrations-Code für Ihren Advertiser.
BU-ID
Kennung der Geschäftseinheit.
campaign-ID
Kampagnen-ID.
creative-id
Kreativ-ID.
site-id
Site-ID.
placement-id
Numerische Platzierungs-ID vom Anzeigen-Server.
insertion-order-id
ID des Einfügeauftrags.
TACTIC-ID
Taktische ID.
vertical-id
ID für eine Branche oder vertikale Kategorie.
Quantität

Die Anzahl der in einem Konversionsereignis verkauften Elemente.

Nur für Konversionsdatendateien.

Umsatz

Kauf- oder anderer Konversionsbetrag. Datentyp: float.

Nur für Konversionsdatendateien.

Other-Data

URL der Konversions-Landingpage. Datentyp: Zeichenfolge.

Nur für Konversionsdatendateien.

Ereignistyp

Konvertierungstyp Gibt an, ob eine Konversion abgeglichen wird 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 Impressions-, Klick- oder Konversionsdatendatei angezeigt wird. Die aktuelle Version ist 1.1.

Bereitstellungsmethoden für Datendateien delivery-methods

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

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

Syntax und Beispiele für Versandpfade

Die Daten werden für jeden Kunden in einem separaten Namespace in einem Amazon S3 Verzeichnis gespeichert. Der Dateipfad folgt der unten gezeigten 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_JJJJMMTT

In der folgenden Tabelle werden diese Elemente in einem Dateibereitstellungspfad definiert.

Dateiparameter
Beschreibung
.../log_ingestion/
Dies ist der Beginn des Speicherpfads für das Verzeichnis. Sie erhalten den vollständigen Pfad, wenn alles eingerichtet ist.
pid=AAM ID
Dieses Schlüssel-Wert-Paar enthält Ihren Audience Manager Kunden-ID.
dpid=d_src
Dieses Schlüssel-Wert-Paar enthält die Datenquellen-ID, die bei einem Ereignisaufruf übergeben wird. Sie identifiziert die Agentur, von der die Daten stammen, und verknüpft diese Daten mit einer unterstützenden Metadatendatei.
logs
Ein übergeordnetes Verzeichnis für Datendateien.
file type_yyyymmdd
Ein Dateitypname, der angibt, welche Art von Daten er enthält, und einen 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 einer Mitternacht zur nächsten. Als Best Practice empfiehlt sich die Verwendung der UTC-Zeit, um das Tagesintervall festzulegen.

Nächste Schritte next-steps

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695