In diesem Artikel erfahren Sie, wie Sie die Menü-API für Ihr Konto aktivieren und sie einbinden. Unten finden Sie eine detaillierte Übersicht über den Einrichtungsprozess und die Voraussetzungen für die Markteinführung. Bitte beachten Sie diese Seite bei der Planung der Integration.
- Einrichtung: Kontokonfiguration und Planung des Entwicklungsvorgangs.
- Entwicklung: Entwicklung und Tests von Datenfeeds.
- Einführung – Datenanalyse vor der Einführung.
Einrichtung
In dieser Phase ist es wichtig, zu prüfen, ob Ihr Konto im Partnerportal vollständig konfiguriert ist und Datenfeeds für statische Menüdaten akzeptiert. Wenn Sie bereits eine aktive OwG-Weiterleitung oder RwG-Verknüpfung haben, der Sie die Metadaten für die Menüs hinzufügen, wird Ihr vorhandenes Konto für diese Verknüpfung wiederverwendet. Wenn auf dieser Plattform eine OwG Direct-Integration vorhanden ist oder keine Integration vorhanden ist, wird ein neues Konto erstellt und die Zugriffsdetails werden per E-Mail gesendet.
Rufen Sie im Partner-Portal Ihr Konto auf und rufen Sie die Seite für die Feedkonfiguration auf: Konfiguration > Feeds. Für die Einbindung von Menüdatenfeeds sind zwei SFTP-Server relevant: Generic und Merchants. Prüfen Sie, ob auf beiden SFTP-Servern der öffentliche SSH-Schlüssel konfiguriert ist. Weitere Informationen zum Konfigurieren von SSH-Schlüsseln finden Sie auf dieser Seite.
Der generische SFTP-Server kann verschiedene Feeds akzeptieren, die verschiedenen Datenschemata folgen können. Der Feedtyp, der strukturierte Menüdaten akzeptiert, heißt google.food_menu und ist in der Regel zu Beginn des Onboardings standardmäßig für Ihr Konto aktiviert. Wenn Sie versuchen, einen Feed einzureichen, und die folgende Fehlermeldung angezeigt wird:
„Feedverarbeitung fehlgeschlagen. Beim Parsen Ihres Feeds ist ein internes Problem aufgetreten. „google.food_menu“ ist nicht aktiviert. Bitte beheben Sie das Problem und versuchen Sie es noch einmal.“, wenden Sie sich an Ihren Google-Ansprechpartner, um diesen Feedtyp zu aktivieren.
Rufen Sie abschließend die Seite Konfiguration > Kontaktdaten auf und prüfen Sie, ob alle Ihre Kontaktdaten auf dem neuesten Stand sind.
Entwicklung
Die Entwicklungsphase umfasst den Hauptteil der Implementierung – das Erstellen und Testen der Datenfeeds. Datenfeeds müssen täglich erstellt und an den Ziel-SFTP-Server gesendet werden. Die Verarbeitung der eingereichten Feeds beginnt voraussichtlich innerhalb einer Stunde nach der Einreichung. Lesen Sie die Spezifikation und die Beispiele für Datenfeeds, wenn Sie Ihre Feeds generieren. Die Spezifikation ist zwar im Protobuf-Format, wir empfehlen jedoch, Feeddateien im JSON-Format hochzuladen, da sich so Fehler leichter beheben lassen. Aus diesem Grund werden auch die Feedbeispiele im JSON-Format bereitgestellt.
Eine Datenfeeddatei kann mit dem Onlinetool Feed Validator schnell getestet werden, um zu prüfen, ob sie der Spezifikation entspricht. Das Tool zeigt an, ob die Datei dem Datenschema entspricht. Andernfalls wird eine Liste der Fehler ausgegeben. Wenn Sie einen vollständigen Datenfeed testen möchten, der aus mehreren Dateien besteht, laden Sie ihn in die Sandbox-Umgebung hoch. Nach Abschluss der Datenaufnahme können Sie die Ergebnisse im Partner-Portal einsehen. Bei der Feedaufnahme werden zusätzliche Validierungsregeln angewendet, um die Geschäftslogik und die Qualität der Daten zu testen.
Starten
Die Einführungsphase kann gestartet werden, nachdem alle Integrationsarbeiten abgeschlossen sind und der Produktionsfeed das gesamte Inventar der Restaurantmenüs korrekt widerspiegelt.
Voraussetzungen für die Einführung
Damit die Integration gestartet werden kann, müssen die folgenden Bedingungen erfüllt sein:
- Datenfeeds werden in der Produktionsumgebung ohne Fehler verarbeitet.
- Der Produktionsdatenfeed enthält das gesamte Inventar, das zu Beginn dieser Integration für diese Integration festgelegt wurde.
- Der Großteil deiner Händlerdaten muss mit Google Maps-Standorten übereinstimmen.
- Die Produktionsfeeds haben die Datenqualitätsprüfung bestanden.
- Die Integration erfüllt alle Richtlinien und Anforderungen für Speisekarten.
Datenauswertung
Nachdem die Produktionsdatenfeeds ohne Fehler aufgenommen wurden, kann es einen internen Prozess zur Bewertung der Qualität der Menüdaten geben. Ziel dieses Prozesses ist es, Inkonsistenzen in der Datenqualität zu finden, z. B. nicht ernährungsbezogene Inhalte in Gerichtbeschreibungen, Abweichungen bei Gerichtenamen, Preisen usw. Bei solchen Ergebnissen wird das Feedback an das Entwicklungsteam weitergegeben.