Die allgemeine Dropbox für Feeds verwenden

Mit der allgemeinen Dropbox für Feeds können mehrere Feedtypen in eine einzelne Dropbox pro Umgebung hochgeladen werden. In diesem Leitfaden wird die Verwendung der allgemeinen Dropbox erläutert. Außerdem finden Sie Links zu den entsprechenden Leitfäden für den Feed, den Sie verwenden möchten.

Für die allgemeine Dropbox sind zwei separate Uploads erforderlich:

1. Deskriptordatei:Beschreibt den Feedtyp, den Sie hochladen.
2. Feeddatei(en): der Inhalt des Feeds

Deskriptorfeld strukturieren

Die Deskriptordatei wird hochgeladen, um unser System darüber zu informieren, welchen Feedtyp Sie hochladen. So können wir den Feed korrekt validieren und verarbeiten. Die Deskriptordatei muss vor dem Feedinhalt hochgeladen werden und den folgenden Benennungsanforderungen entsprechen:

• Sie müssen die Dateiendung .filesetdesc.json für die Deskriptordatei verwenden.
• Jeder Deskriptordateiname muss eindeutig sein und kann nicht für mehrere Uploads wiederverwendet werden. Wir empfehlen, den Generierungszeitstempel und den Feednamen in den Dateinamen aufzunehmen.
  • Beispiel: offers_1524606581.filesetdesc.json
• Jede Deskriptordatei muss alle Datendateien im aktuellen Feed für den entsprechenden Feednamen enthalten.

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:

Unten finden Sie eine Beispiel-JSON-Beschreibungsdatei 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

Nachdem Sie die Deskriptordatei hochgeladen haben, laden Sie alle Feeddateien für den Feeddatentyp hoch, der der Feedkonfigurationsdatei entspricht, die in Ihrer Deskriptordatei angegeben ist. Die Dateinamen und Pfadspeicherorte (relativ innerhalb des Dropbox-Ordners) 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 der gesamte Feed nicht verarbeitet.

Der Inhalt dieser Feeddatendateien muss der entsprechenden Spezifikation des Feeds entsprechen, die in der Deskriptordatei angegeben wurde.

Der Dateiname jeder Feeddatei muss eindeutig sein und kann nicht für mehrere Uploads verwendet werden. Wir empfehlen, den Generierungszeitstempel und die Shard-Nummer (inkrementelle ID) in den Dateinamen aufzunehmen.

• Beispiel: offers_1524606581_1.json

Feeddateigrößen und Uploadhäufigkeit

• Die Feeddatei darf nach der Komprimierung maximal 200 MB groß sein.
• Die Größe jeder dekomprimierten Datendatei sollte unter 2 GB liegen.
• Für die meisten Integrationen ist nur ein einzelner Shard erforderlich. Sie sollten möglichst wenige Shards 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 mit derselben Shard-Nummer gesendet werden.
• Für eine bessere Leistung sollten die Daten gleichmäßig auf die Shards aufgeteilt werden, sodass alle Shard-Dateien eine ähnliche Größe haben.
• Bei Bedarf kannst du gzip verwenden, um Feeds zu komprimieren. Das muss für jeden Feed-Shard einzeln erledigt werden.

Fehlerbehebung

Nachdem Sie Ihre Dateien (Beschreibungs- und Feeddateien) hochgeladen haben, rufen Sie das Dashboard „Feedverlauf“ (Dokumentation) im Partner-Portal auf (Verlauf > Feeds), um den Fortschritt der Feedaufnahme zu verfolgen.

Suchen Sie in der Spalte „Feedname“ nach der name, die Sie in der Deskriptordatei eingegeben haben, um Ihren Feed zu finden.

Sobald der Feed aufgenommen wurde (Status Success oder Fail), können Sie auf die Zeile klicken, um Details zu den Fehlern und Warnungen aufzurufen.