Feeds

Feeds erstellen

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

Feed Beschreibung Häufigkeit
Händler Beschreibt Ihre Händler. Einmal alle 24 Stunden
Dienste Beschreibt die Dienstleistungen, die Ihre Händler anbieten Einmal alle 24 Stunden
Verfügbarkeit Verfügbare Slots für die Dienstleistungen, die Ihre Händler anbieten. Es muss eine Mindestdeckung von 30 Tagen geboten werden. Einmal alle 24 Stunden

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

Das Feedformat wird mithilfe der Protobuf-3-Syntax beschrieben. Sie können Ihre Feeds jedoch im entsprechenden JSON-Format hochladen. Das JSON-Format finden Sie in den Feedbeispielen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.

Feeddateigröße, Sharding und Komprimierung

Sehen Sie sich die folgenden Anleitungen zur Komprimierung und zu Shards an:

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

  • Vorgeschlagene Feed-Aufteilung:
    • Händlerfeed: 1 Shard
    • Dienstleistungsfeed: 1 Shard
    • Verfügbarkeitsfeed: weniger als 20 Shards
  • Größe von Feeddateien und Sharding:
    • Komprimierte Shard-Dateien dürfen maximal 200 MB groß sein. Verwende 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, sodass alle Shard-Dateien eine ähnliche Größe haben.
    • Bei Bedarf kannst du gzip verwenden, um JSON-Feeds im Nur-Text-Format zu komprimieren. Das muss für jeden Feed-Shard einzeln erledigt werden.

Feeds auf den SFTP-Server hochladen

Lade deine Feeds in die Sandbox-Umgebung hoch. Verwende dazu die Nutzernamen auf der Seite für die 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, einen Zeitstempel an jeden Dateinamen anzufügen. So kannst du leichter Probleme beheben und den Feedstatus abfragen.

Daten prüfen

Melde dich im Partner-Portal an. Wechsle zur Sandbox-Umgebung und rufe die folgenden Seiten im Bereich Dashboards auf.

Feeds
Hier findest du zusammenfassende Statistiken zu Feeds und Informationen zu Fehlern, die beim Feedupload aufgetreten sind.

Auf der Seite Feeds kannst du nach dem ersten Upload in die Sandbox-Umgebung nachsehen, ob es Feedfehler gibt. Danach solltest du die Seite Inventory Summary (Inventarzusammenfassung) aufrufen, um zu prüfen, ob Datenprobleme aufgetreten sind. Oft werden Händler ohne Dienstleistungen oder Dienstleistungen ohne verfügbare Slots in der Zukunft hochgeladen.

Im Sandbox-Front-End wird die Live-UI emuliert. Dort kannst du nachvollziehen, wie die Daten für den Nutzer aussehen. Rufen Sie die Sandbox auf, indem Sie oben die Umgebungsauswahl auf „Sandbox“ setzen. Klicken Sie dann auf Inventar > Inventar . Suchen Sie nach einem 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 auf die Zeile und dann auf den Link „RwG – E2E“. Wenn kein Händler mit dem Status „Bereit“ oder „Aktiv (in der Sandbox)“ vorhanden ist, öffnen Sie einen deaktivierten Händler und beheben Sie alle rechts aufgeführten Probleme (z. B. durch Hochladen der zukünftigen Verfügbarkeit).

Wenn Sie nicht auf das Sandbox-Front-End zugreifen können, prüfen Sie, ob Sie mit einem Konto angemeldet sind, dem Zugriff auf das Front-End gewährt wurde. Außerdem darfst du nicht gleichzeitig in einem anderen Konto angemeldet sein. Wenn du dich mit einem anderen Konto anmeldest und dann die Funktion „Nutzer wechseln“ verwendest, um dich in dem freigegebenen Google-Konto anzumelden, kannst du trotzdem nicht auf das Sandbox-Front-End zugreifen.

Feeds in die Produktionsumgebung hochladen

Sobald deine Feeds durchweg vollständig und fehlerfrei in der Sandbox hochgeladen werden, kannst du mit dem Upload in die Produktionsumgebung beginnen. Deine Integration ist dann noch nicht online.

Laden Sie so bald wie möglich einen vollständigen Händlerfeed hoch (mindestens eine Woche vor der Einführung), damit Sie Ihre Händler mit einem Google-Unternehmenseintrag abgleichen können. Bitte prüfen Sie, ob die Übereinstimmung korrekt ist.

Sobald alle Daten Ihres Produktionsfeeds regelmäßig hochgeladen und mit Ihrem Produktionssystem verbunden sind, können Ihre Feeds überprüft werden.

Google wertet Feeds aus

Sobald Sie Ihre Feeds hochgeladen haben, verarbeitet Google sie und wertet ihre Qualität und Vollständigkeit aus. Dabei werden folgende Faktoren berücksichtigt:

  1. Feeds müssen der Feedspezifikation entsprechen.
  2. Feeds müssen alle erforderlichen Felder enthalten.
  3. Die Gesamtzahl der Händler in den Feeds entspricht der Zahl, die mit Google vereinbart wurde.
  4. Für jeden Händler ist mindestens eine Dienstleistung definiert.
  5. Die Gesamtzahl der Dienstleistungen in den Feeds stimmt mit der Zahl überein, die mit Google besprochen wurde.
  6. Wir prüfen, für wie viele der Dienstleistungen es innerhalb der nächsten 30 Tage verfügbare Slots gibt.
  7. Wir prüfen, wie viele der angegebenen Händler Elementen auf Google Maps zugewiesen werden können.