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. Berücksichtigen 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 Partnerportal Ihr Konto auf und rufen Sie die Seite „Dropbox-Konfiguration“ auf: Konfiguration > Feeds. Für die Einbindung von Menüdatenfeeds sind zwei Drop-down-Menüs relevant: Generic (Allgemein) und Merchants (Händler). Prüfen Sie, ob für beide Dropbox-Konten der öffentliche SSH-Schlüssel konfiguriert ist. Weitere Informationen zum Konfigurieren von SSH-Schlüsseln finden Sie auf dieser Seite.
Der generische Drop-Box kann verschiedene Feeds mit unterschiedlichen Datenschemata akzeptieren. 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 das Ziel-Dropbox-Konto gesendet werden. Die Verarbeitung von Feeds, die in der Sandbox eingereicht wurden, beginnt voraussichtlich innerhalb einer Stunde nach der Einreichung. Produktionsfeeds werden einmal täglich um 12:00 Uhr (PST) verarbeitet. Dabei wird nur der zuletzt eingereichte Feed berücksichtigt. Weitere Informationen finden Sie in der Spezifikation und den Beispielen für Datenfeeds. 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 Datenqualität 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.