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 erfahren Sie, wie Sie die Allgemeine Dropbox und Links zum entsprechenden Leitfaden für die jeweilige Feed, den Sie verwenden möchten.

(Weitere Informationen finden Sie in der Feeds (End-to-End) oder Feeds (Starter) exportieren.

Die allgemeine Dropbox erfordert zwei separate Uploads:

1. Deskriptordatei: eine Beschreibung des Feedtyps wird hochgeladen
2. Feeddatei(en): der Inhalt des eigentlichen 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 Feed-Inhalt hochgeladen werden und den diese Anforderungen erfüllen:

• Für die Deskriptordatei musst du die Dateiendung .filesetdesc.json verwenden.
• Jeder Deskriptordateiname muss eindeutig sein und kann nicht für mehrere Uploads wiederverwendet werden. Mi. empfehlen, den Generierungszeitstempel und den Feednamen im Dateinamen anzugeben.
  • Beispiel: Offers_1524606581.filesetdesc.json
• In jeder Deskriptordatei müssen alle Datendateien im aktuellen Feed für den jeweiligen Feednamen aufgeführt sein.

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

Nach dem Hochladen der Deskriptordatei lädst du alle Feeddateien hoch. für den Feed-Datentyp, der der Feed-Konfigurationsdatei entspricht, die durch in Ihrer Deskriptordatei. Die Dateinamen und Pfadspeicherorte (relativ innerhalb der Dropbox) muss genau mit dem übereinstimmen, was in der data_file. Wenn eine Datei fehlt, falsch benannt ist oder an einen anderen Speicherort hochgeladen wurde, wird der gesamte Feed nicht verarbeitet.

Der Inhalt dieser Feed-Datendateien muss den relevanten Spezifikationen von den in der Deskriptordatei angegebenen Feed.

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 darf 2 GB nicht überschreiten.
• 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 nach der name, die Sie in der Deskriptordatei unter „Feedname“ eingegeben haben. um Ihren Feed zu finden.

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