Über die allgemeine Dropbox können mehrere Feedtypen pro Umgebung in eine einzige Dropbox hochgeladen werden. In diesem Leitfaden wird Schritt für Schritt erklärt, wie du die allgemeine Dropbox verwendest. Außerdem findest du dort Links zum entsprechenden Leitfaden für den jeweiligen Feed, den du verwenden möchtest.
Für die allgemeine Dropbox werden zwei separate Uploads durchgeführt:
- Deskriptordatei: beschreibt den Feedtyp, den Sie hochladen
- Feeddatei(en): der Inhalt des Feeds
Deskriptorfeld strukturieren
Durch die Deskriptordatei wird unserem System mitgeteilt, welchen Feedtyp Sie hochladen. So können wir den Feed validieren und korrekt verarbeiten. Die Deskriptordatei muss vor den Feedinhalten hochgeladen werden und muss den folgenden Benennungsanforderungen entsprechen:
- Dateiendung „.filesetdesc.json“ verwenden
- Jeder Name der Deskriptordatei muss eindeutig sein und darf nicht in mehreren Uploads wiederverwendet werden. Wir empfehlen, den Zeitstempel der Generierung in den Dateinamen aufzunehmen.
- Beispiel: offers_1524606581.filesetdesc.json
message FilesetDescriptor {
// The timestamp at which this feed was generated, in Unix time format
// (seconds since the epoch). (required)
int64 generation_timestamp = 1;
// Identifies the name of this feed. (required)
string name = 2;
// Paths (relative to the dropbox root) specifying data files included in this
// feed. (required)
repeated string data_file = 3;
}
Mögliche Werte für das Feld name:
- reservewithgoogle.conversion_data
Im Folgenden finden Sie ein Beispiel für eine JSON-Deskriptordatei für einen Angebotsfeed mit zwei Shards:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
Feedinhalte strukturieren
Nach dem Hochladen der Deskriptordatei laden Sie alle Feeddateien für den Feeddatentyp hoch, die der in Ihrer Deskriptordatei benannten Feedkonfigurationsdatei entsprechen. Die Dateinamen und Pfadspeicherorte (relativ in der Dropbox) müssen genau mit den Angaben im Feld data_file übereinstimmen. Wenn eine Datei fehlt, falsch benannt ist oder an einen anderen Speicherort hochgeladen wurde, wird nicht der gesamte Feed verarbeitet.
Der Inhalt dieser Feeddatendateien muss der entsprechenden Feedspezifikation entsprechen, die in der Deskriptordatei angegeben wurde.
Jede Feeddatei-Datei muss eindeutig sein und darf nicht in mehreren Uploads wiederverwendet werden. Wir empfehlen, den Zeitstempel der Generierung und die Shard-Nummer (inkrementelle ID) in den Dateinamen aufzunehmen.
- Beispiel: Offers_1524606581_1.json
Feeddateigrößen und Uploadhäufigkeit
- Die Feed-Datei darf nach der Komprimierung nicht größer als 200 MB sein.
- Die meisten Integrationen benötigen nur einen einzelnen Shard. Sie sollten so wenige Shards wie möglich verwenden. Pro Feed sind maximal 1.000 Shards zulässig.
- Einzelne Datensätze, die in einem Shard gesendet werden, müssen in zukünftigen Feeds nicht in derselben Shard-Nummer gesendet werden.
- Für eine bessere Leistung sollten Sie die Daten gleichmäßig auf die Shards aufteilen, damit alle Shard-Dateien eine ähnliche Größe haben.
- Verwenden Sie gegebenenfalls gzip, um Feeds zu komprimieren. Tun Sie dies jedoch für jeden einzelnen Feed-Shard.
Fehlerbehebung
Nachdem Sie Ihre Dateien (Deskriptor- und Feeddateien) hochgeladen haben, rufen Sie das Dashboard „Feedverlauf“ (Dokumentation) im Partner-Portal auf (unter Verlauf > Feeds), um den Fortschritt der Feedaufnahme zu verfolgen.
Suchen Sie nach dem name, den Sie in der Deskriptordatei in der Spalte „Feedname“ eingegeben haben, um Ihren Feed zu finden.
Sobald der Feed aufgenommen wurde (Status Success oder Fail), können Sie auf die entsprechende Zeile klicken, um sich die Details der Fehler und Warnungen anzusehen.