Feeds

Feeds erstellen

Feeds müssen Google regelmäßig zur Verfügung gestellt werden, damit die Daten direkt auf Google angezeigt werden können. Die folgenden Feeds sind erforderlich.

Feed Beschreibung Frequenz
Händler Hier werden Ihre Händler beschrieben. Alle 24 Stunden
Dienste Beschreibt die Dienstleistungen, die Ihre Händler anbieten Alle 24 Stunden
Verfügbarkeit Verfügbare Slots für Dienstleistungen, die Ihre Händler anbieten. Die Gewährleistung muss mindestens 30 Tage umfassen. Alle 24 Stunden

Füge in jeden Feed Metadaten ein, die Google anweisen, wie der Feed zu interpretieren ist.

Das Feedformat wird mit der Protokollpuffer-3-Syntax beschrieben. Sie können Ihre Feeds jedoch auch als das entsprechende JSON-Format hochladen. Das JSON-Format finden Sie in den Feedbeispielen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.

Größe, Fragmentierung und Komprimierung von Feeddateien

In den folgenden Anleitungen wird die Komprimierung und Shards beschrieben:

Beachte die folgenden Richtlinien, um die Größe der Feeds zu bestimmen (ein Feed kann aus mehreren Dateien bestehen, die als „Shards“ bezeichnet werden):

  • Vorgeschlagene Feedfragmentierung:
    • Händlerfeed: 1 Shard
    • Dienstleistungsfeed: 1 Shard
    • Verfügbarkeitsfeed: weniger als 20 Shards
  • Größe der Feeddateien und Fragmentierung:
    • Komprimierte Shard-Dateien dürfen maximal 200 MB groß sein. Verwenden Sie bei Bedarf mehrere Shards.
    • Einzelne Datensätze, die in einem Shard gesendet werden, müssen in zukünftigen Feeds nicht im selben Shard gesendet werden.
    • Für eine bessere Leistung sollten die Daten gleichmäßig auf die Shards aufgeteilt werden, damit alle Shard-Dateien eine ähnliche Größe haben.
    • Bei Bedarf kannst du gzip verwenden, um JSON-Feeds im Nur-Text-Format zu komprimieren. Tun Sie dies jedoch für jeden einzelnen Feed-Shard.

Feeds in deine SFTP-Dropbox hochladen

Laden Sie Ihre Feeds in die Sandbox-Umgebung hoch. Entsprechende Informationen finden Sie auf der Seite Feedkonfiguration im Partner-Portal. Der SFTP-Server von Google ist unter sftp://partnerupload.google.com auf Port 19321 verfügbar.

Du solltest den hochgeladenen Dateien eindeutige Namen geben. Beispielsweise kann es hilfreich sein, jedem Dateinamen einen Zeitstempel hinzuzufügen. So lassen sich Probleme leichter beheben und der Feedstatus abfragen.

Daten prüfen

Melde dich im Partner-Portal an. Wechseln Sie zur Sandbox-Umgebung, um die folgenden Seiten im Bereich Dashboards zu finden.

Feeds
Zeigt Zusammenfassungsstatistiken des Feeds an und weist auf Fehler während des Feeduploads hin.

Wenn du prüfen möchtest, ob deine Daten nach dem ersten Upload in die Sandbox-Umgebung korrekt angezeigt werden, prüfe die Seite Feeds auf Feedfehler. Prüfen Sie dann die Seite Inventarzusammenfassung auf Datenprobleme. Zu den häufigsten Problemen gehören das Hochladen von Händlern ohne Dienstleistungen oder das Hochladen von Dienstleistungen ohne verfügbare Slots in Zukunft.

Das Sandbox-Front-End, das die Live-UI emuliert, zeigt, wie die Daten aus der Perspektive des Nutzers dargestellt werden. Für den Zugriff darauf muss die Umgebungsauswahl oben auf „Sandbox“ eingestellt sein. Gehen Sie dann zu Inventar > Inventar und suchen Sie einen Händler, der entweder „Bereit“ oder „Live (in Sandbox)“ ist. Klicken Sie dann entweder auf den Link in der Spalte ganz rechts (falls verfügbar) oder klicken Sie auf die Zeile und dann auf den Link „RwG – E2E“. Wenn kein Händler mit dem Status „Bereit“ oder „Live (in Sandbox)“ vorhanden ist, öffne einen deaktivierten Händler und behebe alle rechts aufgeführten Probleme (z. B. dass zukünftige Verfügbarkeitsangaben hochgeladen wurden).

Wenn du nicht auf das Sandbox-Front-End zugreifen kannst, überprüfe, ob du mit einem Konto angemeldet bist, dem Zugriff auf das Front-End gewährt wurde. Achte außerdem darauf, dass du nur in diesem Konto angemeldet bist. Wenn du dich mit einem anderen Konto anmeldest und dann die Funktion „Nutzer wechseln“ verwendest, um dich im genehmigten Google-Konto anzumelden, kannst du trotzdem nicht auf das Sandbox-Front-End zugreifen.

Feeds in die Produktionsumgebung hochladen

Sobald du in der Lage bist, vollständige, fehlerfreie Feeds in die Sandbox-Umgebung hochzuladen, kannst du mit dem Upload in die Produktionsumgebung beginnen. Deine Integration ist dann nicht aktiv.

Bitte laden Sie so bald wie möglich (mindestens eine Woche vor der Einführung) einen vollständigen Händlerfeed hoch, damit Sie Ihre Händler einem Google-Brancheneintrag zuordnen können. Bitte überprüfen Sie, ob die Zuordnung korrekt ist.

Sobald alle Daten Ihres Produktionsfeeds konsistent hochgeladen und mit dem Produktionssystem verbunden sind, können Ihre Feeds überprüft werden.

Google wertet Feeds aus

Sobald du deine Feeds hochgeladen hast, verarbeitet Google sie und bewertet sie auf Qualität und Vollständigkeit. Dabei werden folgende Faktoren berücksichtigt:

  1. Feeds entsprechen der Feedspezifikation.
  2. Feeds enthalten alle Pflichtfelder.
  3. Die Gesamtzahl der Händler in den Feeds stimmt mit der Anzahl überein, die mit Google besprochen wurde.
  4. Für jeden Händler ist mindestens eine Dienstleistung definiert.
  5. Die Gesamtzahl der Dienstleistungen in den Feeds stimmt mit der Anzahl überein, die mit Google besprochen wurde.
  6. Wir prüfen, für wie viele der Dienste in den nächsten 1–30 Tagen verfügbare Slots verfügbar sind.
  7. Wir prüfen, wie viele der angegebenen Händler mit Funktionen auf Google Maps abgeglichen werden können.