Generischen SFTP-Server verwenden

Auf dem SFTP-Server für generische Feeds können mehrere Feedtypen pro Umgebung hochgeladen werden. In dieser Anleitung wird beschrieben, wie Sie den generischen SFTP-Server verwenden. Außerdem finden Sie Links zur entsprechenden Anleitung für den jeweiligen Feed, den Sie verwenden möchten.

Beim generischen SFTP-Server sind zwei separate Uploads erforderlich:

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

Deskriptorfeld strukturieren

Die Deskriptordatei wird hochgeladen, um unserem System mitzuteilen, welchen Feedtyp Sie hochladen. So können wir den Feed richtig validieren und verarbeiten. Die Deskriptordatei sollte vor den Feedinhalten hochgeladen werden und muss die folgenden Benennungsanforderungen erfüllen:

• Die Deskriptordatei muss die Dateiendung .filesetdesc.json haben.
• Jeder Deskriptor-Dateiname muss eindeutig sein und darf nicht für mehrere Uploads verwendet werden. Wir empfehlen, den Zeitstempel der Generierung und den Feednamen in den Dateinamen aufzunehmen.
  • Beispiel: offers_1524606581.filesetdesc.json
• In jeder Deskriptordatei müssen alle Datendateien im neuesten Feed für den entsprechenden 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;
}

Zulässige Werte für das Feld name:

Unten 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

Nachdem Sie die Deskriptordatei hochgeladen haben, laden Sie alle Feeddateien für den Feeddatentyp hoch, der in der Feedkonfigurationsdatei angegeben ist, die in Ihrer Deskriptordatei genannt wird. Die Dateinamen und Pfadpositionen (relativ innerhalb des SFTP-Servers) müssen genau mit den Angaben im Feld data_file übereinstimmen. Wenn eine Datei fehlt, falsch benannt oder an einem anderen Ort hochgeladen wurde, wird der gesamte Feed nicht verarbeitet.

Die Inhalte dieser Feeddatendateien müssen der relevanten Spezifikation des Feeds entsprechen, der in der Deskriptordatei angegeben wurde.

Jeder Feed-Dateiname muss eindeutig sein und kann nicht für mehrere Uploads verwendet werden. Wir empfehlen, den Zeitstempel der Generierung und die Shard-Nummer (fortlaufende ID) in den Dateinamen aufzunehmen.

• Beispiel: offers_1524606581_1.json

Feeddateigrößen und Uploadhäufigkeit

• Die Größe der Feeddatei darf nach der Komprimierung maximal 200 MB betragen.
• Die Größe jeder dekomprimierten Datendatei sollte weniger als 2 GB betragen.
• Die meisten Integrationen benötigen nur einen einzelnen Shard. Verwenden Sie so wenige Shards wie möglich. 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 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 (Deskriptor- und Feeddateien) hochgeladen haben, können Sie den Fortschritt der Feedaufnahme im Ingestion Viewer (Dokumentation) im Partner-Portal (Aufnahme > Verlauf) verfolgen.

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

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