Die allgemeine Dropbox für Feeds verwenden

Über die allgemeine Feed-Dropbox können mehrere Feedtypen in eine eine Dropbox pro Umgebung. 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.

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 die gerade hochgeladen werden. 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:

• Dateiendung „.filesetdesc.json“ verwenden
• Jeder Name einer Deskriptordatei muss eindeutig sein und kann nicht für mehrere Uploads verwendet werden. Mi. 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:

Ein Beispiel für eine JSON-Deskriptordatei für einen Angebotsfeed mit zwei Shards ist verfügbar:

{
  "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, ein falsch benannt ist oder an einen anderen Speicherort hochgeladen haben, wird der gesamte Feed verarbeitet werden.

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

Jeder Dateiname eines Feeds muss eindeutig sein und kann nicht für mehrere Uploads verwendet werden. Wir empfehlen, einschließlich Erstellungszeitstempel und Shard-Nummer (inkrementelle ID) im Dateinamen.

• 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 als möglichst wenige Shards. Pro Feed sind maximal 1.000 Shards zulässig.
• Einzelne Datensätze, die in einem Shard gesendet werden, müssen nicht im selben Shard gesendet werden. Shard-Nummer in zukünftigen Feeds.
• Für eine bessere Leistung sollten Sie die Daten gleichmäßig auf die Shards aufteilen, dass die Shard-Dateien ähnlich groß sind.
• Verwenden Sie bei Bedarf gzip, um Feeds zu komprimieren. Tun Sie dies jedoch für jede individuellen Feed-Shard.

Fehlerbehebung

Gehen Sie nach dem Hochladen Ihrer Dateien (Deskriptor- und Feed-Dateien) zum Dashboard für Feedverlauf (Dokumentation) im Partner-Portal (unter Verlauf > Feeds) den Fortschritt der Feedaufnahme 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.