Show Menu
THEMEN×

Datendateien für Zielgruppenoptimierungsberichte

Eine Datendatei enthält Impressions-, Klick- oder Konversionsdaten. Bei ordnungsgemäßer Formatierung können Sie diese Daten in Audience Manager importieren und in den Berichten zur Zielgruppenoptimierung anzeigen. Formatieren Sie Ihre Datendateien gemäß den Spezifikationen in diesem Abschnitt.

Überblick

Mit einer ordnungsgemäß benannten und formatierten Datendatei können Sie Impressions-, Klick- oder Konversionsdaten in die Zielgruppenoptimierungsberichte importieren. Dies ist nützlich, wenn Sie mit einem Partner arbeiten, der nicht in die Report Suite integriert ist Audience Manager und mit diesen Daten arbeiten möchten. Dieser Prozess erfordert separate Dateien für Impressions-, Klick- und Konvertierungsdaten. Mischen Sie diese Ereignisse nicht in einer einzigen Datei.
Eine Datendatei muss von einer Metadatendatei begleitet sein. Der Inhalt der Metadatendatei stimmt mit den Datendateiinformationen mit den entsprechenden, für Menschen lesbaren Beschriftungen in den Berichtmenüs überein. Weitere Informationen finden Sie unter Übersicht und Zuordnungen für Metadatendateien .

Benennungsregeln für Datendateien

Die folgende Syntax definiert die Struktur eines gut formatierten Datendateinamens. Beachten Sie, dass kursiv ein Platzhalter für eine Variable angegeben wird, 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 Datumsstempel für ein Jahr.
  • Komprimieren Sie die Dateien vor dem Hochladen mit gzip und speichern Sie sie mit der .gz Dateierweiterung.
Benennen Sie Ihre Datendateien unter Berücksichtigung dieser Anforderungen nach ihrem Inhalt 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 der gut formatierten Datendatei. Beachten Sie, dass kursiv ein Platzhalter für eine Variable steht und in einer Datendatei durch eine Beschriftung ersetzt wird.
Syntax:
Kopfzeilenbeschriftung 1 | 

Kopfzeilenbeschriftung 2 ... 

Kopfzeilenbeschriftung n | 

version

Inhalt der Datei:
  • Die Kopfzeilenbeschriftungen müssen in der Reihenfolge wie in der folgenden Tabelle angezeigt werden. 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 müssen mit einer Versionsnummer enden. Die aktuelle Version ist 1.1.
  • Trennen Sie Datei-Kopfzeilen und -Inhalte mit dem nicht druckbaren ASCII-Zeichen 001. 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 Syntaxbeispiel oben nur eine Pipe "|" für Anzeigezwecke.
Feldbezeichnungen
In der folgenden Tabelle sind die Spaltenüberschriften für Ihre Datendatei aufgeführt und beschrieben. Bei Kopfzeilen wird die Groß-/Kleinschreibung beachtet 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 Uhrzeit für Impression, Klick oder Konversionsereignis. Verwenden Sie das Format JJJJ-TT-MM hh:mm:ss .
Benutzer-ID
Ihre ID für einen Sitebesucher, auch als eindeutige Benutzer-ID oder DPUUID des Datenanbieters bezeichnet.
Advertiser-ID
Die Datenquellen-ID oder der Integrationscode für Ihren Advertiser.
BU-ID
Geschäftseinheit-ID.
Campaign-ID
Kampagnen-ID.
Creative-ID
Creative-ID.
Site-ID
Site-ID.
Platzierungs-ID
Numerische Platzierungs-ID vom Anzeigen-Server.
Insertion-Order-ID
Einfügebestellungs-ID.
Tactic-ID
Tactic ID.
Vertikal-ID
ID für eine Branche oder Kategorie.
Quantität
Die Anzahl der Artikel, die in einem Konversionsereignis verkauft wurden.
Nur für Konversionsdatendateien.
Umsatz
Kauf- oder sonstiger Umrechnungsbetrag. Datentyp: Float.
Nur für Konversionsdatendateien.
other-data
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 Konvertierungsdatendatei angezeigt wird. Die aktuelle Version ist 1.1.

Bereitstellungsmethoden für Datendateien

Laden Sie Ihre Impressions-, Klick- oder Konvertierungsdatendateien in einen Amazon S3-Ordner für Ihr Audience Manager Konto hoch. Informationen zu Bereitstellungs-/Ordnerpfaden, Dateiverarbeitungszeiten und Aktualisierungen finden Sie in diesem Abschnitt.
Syntax und Beispiele für Bereitstellungspfad
Die Daten werden in einem separaten Namespace für jeden Kunden in einem Amazon S3-Ordner gespeichert. Der Dateipfad folgt der unten stehenden Syntax. Note, italics indicates a variable placeholder. Andere Elemente sind Konstanten oder Schlüssel und bleiben unverändert.
Syntax:
.../log_ingestion/pid= 

AAM ID

/dpid= 

d_src/logs/ 

Dateityp_

yyymmdd

In der folgenden Tabelle werden diese Elemente in einem Dateibereitstellungspfad definiert.
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, das Ihre Audience Manager -Kunden-ID enthält.
dpid= d_src
Dieses Schlüssel-Wert-Paar enthält die Datenquelle-ID, die bei einem Ereignisaufruf weitergegeben wird. Er identifiziert die Agentur, von der die Daten stammen, und verknüpft diese Daten mit einer unterstützenden Metadatendatei.
logs
Ein Ordner auf höherer Ebene für Datendateien.
Dateityp _ yyymmdd
Ein Dateitypname, der angibt, welche Art von Daten er enthält, und ein Zeitstempel für die Bereitstellung.
Beispielpfad und Dateiname für das Hochladen
Wenn Sie eine Datei hochladen, sieht der Pfad wie folgt aus:
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Dateiverarbeitungszeiten und -aktualisierungen
Datendateien werden in regelmäßigen Abständen viermal am Tag 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 sollten Sie die UTC-Zeit verwenden, 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 .