Die allgemeine Dropbox für Feeds verwenden

Mit der generischen Feed-Dropbox können mehrere Feedtypen in eine einzelne Dropbox pro Umgebung hochgeladen werden. In diesem Leitfaden erfährst du, wie du die allgemeine Dropbox verwendest. Außerdem enthält sie Links zum entsprechenden Leitfaden für den jeweiligen Feed, den du verwenden möchtest.

Warnung: Dieser Leitfaden gilt nicht für die Dropboxes der Händler, der Dienste oder der Verfügbarkeit. Sie gilt nur für die allgemeine Dropbox.

Weitere Informationen finden Sie im Abschnitt Feeds (End-to-End) exportieren oder Feeds (Starter).

Hinweis:Für jeden Feedtyp, den du hochlädst, musst du eine Genehmigung erhalten. Wenn Sie einen Feedtyp hochladen, der nicht für die Integration genehmigt wurde, wird der Feed nicht verarbeitet. Wenn du dir nicht sicher bist, welche Feedtypen auf deine Einbindung zutreffen, wende dich bitte an deinen Ansprechpartner bei „Mit Google reservieren“.

Warnung:Du musst deinen SSH-Schlüssel möglicherweise zurücksetzen, um Uploads in die allgemeine Dropbox für Feeds zu ermöglichen. Weitere Informationen finden Sie in der Feedkonfiguration des Partner-Portals (Dokumentation).

Für die allgemeine Dropbox gelten zwei separate Uploads:

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

Hinweis: Wenn du einen Upload in die allgemeine Dropbox durchführst und im Partner-Portal keinen entsprechenden Eintrag siehst, kann das bedeuten, dass deine Deskriptordatei nicht hochgeladen wurde oder einen falschen Dateinamen hat. Wende dich an deinen Ansprechpartner bei „Mit Google reservieren“, wenn du Hilfe bei der Fehlerbehebung benötigst.

Deskriptorfeld strukturieren

Die Deskriptordatei wird hochgeladen und informiert unser System darüber, welchen Feedtyp du hochlädst. So können wir den Feed validieren und verarbeiten. Die Deskriptordatei sollte vor dem Feedinhalt hochgeladen werden und muss die folgenden Anforderungen für die Benennung erfüllen:

• Dateiendung „.filesetdesc.json“
• Jeder Deskriptordateiname muss eindeutig sein und kann nicht für mehrere Uploads verwendet 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 sind:

Unten sehen Sie eine JSON-Deskriptordatei für einen Angebotsfeed mit zwei Fragmenten:

{
  "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 Datei mit der Feedkonfigurationsdatei entspricht. 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 oder an einen anderen Speicherort hochgeladen wurde, wird der gesamte Feed nicht verarbeitet.

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

Jeder Dateiname einer Feed-Datei muss eindeutig sein und kann nicht für mehrere Uploads verwendet werden. Wir empfehlen, den Generierungszeitstempel und die Fragmentnummer (inkrementelle ID) in den Dateinamen aufzunehmen.

• Beispiel: offers_1524606581_1.json

Feeddateigrößen und Uploadhäufigkeit

• Feed-Dateigröße nach der Komprimierung unter 200 MB halten
• Die meisten Integrationen benötigen nur einen einzelnen Shard. Sie sollten so wenig Shards wie möglich verwenden. Es gibt maximal 1.000 Shards pro Feed.
• 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 werden die Daten gleichmäßig auf die Shards aufgeteilt, sodass alle Shard-Dateien eine ähnliche Größe haben.
• Verwenden Sie bei Bedarf gzip, um Feeds zu komprimieren. Das muss für jeden Feed-Shard einzeln geschehen.

Fehlerbehebung

Nachdem du deine Dateien (Deskriptor und Feeddateien) hochgeladen hast, rufe das Feedverlauf-Dashboard (Dokumentation) im Partner-Portal auf (navigiere zu 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 die Details zu den Fehlern und Warnungen aufzurufen.