In diesem Artikel wird beschrieben, wie Sie die Menu API für Ihr Konto aktivieren und in dieses integrieren. Im Folgenden finden Sie eine detaillierte Übersicht über den Onboardingprozess und die Voraussetzungen für die Einführung. Bitte berücksichtigen Sie diese Seite beim Planen der Integration.
- Einrichtung – Kontokonfiguration und Planung des Entwicklungsprozesses
- Entwicklung – Datenfeed-Entwicklung und -Tests
- Einführung – Datenauswertung vor der Einführung.
Einrichtung
In dieser Phase müssen Sie überprüfen, ob Ihr Konto im Partner-Portal vollständig konfiguriert ist und Datenfeeds akzeptiert, die für statische Menüdaten relevant sind. Wenn Sie eine aktive OwG Redirect- oder RwG-Integration haben, der Sie die Menümetadaten hinzufügen, wird Ihr vorhandenes Konto für diese Integration wiederverwendet. Wird OwG Direct auf dieser Plattform integriert oder gar keine Integration, wird ein neues Konto erstellt und die Zugriffsdetails werden per E-Mail gesendet.
Greife im Partner-Portal auf dein Konto zu und rufe die Dropbox-Konfigurationsseite Konfiguration > Feeds auf. Es gibt zwei Dropboxes, die für die Integration von Speisekartendatenfeeds relevant sind: Allgemein und Händler. Für beide Dropboxes muss der öffentliche SSH-Schlüssel konfiguriert sein. Weitere Informationen zum Konfigurieren von SSH-Schlüsseln finden Sie auf dieser Seite.
Die allgemeine Dropbox kann verschiedene Feeds annehmen, die unterschiedlichen Datenschemas folgen können. Der Feedtyp, der strukturierte Speisekartendaten akzeptiert, heißt google.food_menu. Er wird normalerweise zu Beginn des Onboardings standardmäßig für Ihr Konto aktiviert. Falls beim Versuch, einen Feed zu senden, 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." angezeigt wird, wenden Sie sich an Ihren Ansprechpartner bei Google, um diesen Feedtyp zu aktivieren.
Rufen Sie schließlich die Seite Konfiguration > Kontaktdaten auf und vergewissern Sie sich, dass alle Ihre Kontaktdaten aktuell sind.
Entwicklung
Die Entwicklungsphase umfasst den Hauptteil der Implementierung: das Generieren und Testen der Datenfeeds. Datenfeeds müssen täglich erstellt und an die Ziel-Dropbox gesendet werden. In der Sandbox eingereichte Feeds werden voraussichtlich innerhalb einer Stunde nach dem Einreichen verarbeitet. Produktionsfeeds werden einmal täglich um 12:00 Uhr (PST) verarbeitet. Nur der zuletzt eingereichte Feed wird zur Verarbeitung herangezogen. Sehen Sie sich die Datenfeedspezifikation und die Beispiele an, wenn Sie Ihre Feeds generieren. Obwohl die Spezifikation im protobuf-Format dargestellt wird, empfehlen wir, Feeddateien im JSON-Format hochzuladen, da die Fehlerbehebung so einfacher ist. Daher stehen auch die Feedbeispiele im JSON-Format zur Verfügung.
Eine Datenfeeddatei kann schnell mit dem Onlinetool Feed Validator getestet werden, das überprüft, ob diese Datei der Spezifikation entspricht. Das Tool zeigt an, ob die Datei mit dem Datenschema übereinstimmt. Falls nicht, wird eine Fehlerliste ausgegeben. Wenn Sie einen gesamten Datenfeed testen möchten, der aus mehreren Dateien besteht, laden Sie ihn in die Sandbox-Umgebung hoch. Nachdem die Aufnahme abgeschlossen ist, sehen Sie sich die Ergebnisse im Partner-Portal an. Während der Feedaufnahme werden zusätzliche Validierungsregeln angewendet, um eine gewisse Geschäftslogik und die Qualität der Daten zu testen.
Launch
Die Einführungsphase kann eingeleitet werden, nachdem alle Integrationsschritte abgeschlossen sind und der Produktionsfeed das gesamte Inventar der Speisekarten korrekt widerspiegelt.
Voraussetzungen für den Start
Die folgenden Bedingungen müssen erfüllt sein, damit die Integration gestartet werden kann:
- Datenfeeds werden in der Produktionsumgebung ohne Fehler verarbeitet.
- Der Produktionsdatenfeed enthält zu Beginn der Integration das gesamte Inventar für diese Integration.
- 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 fehlerfrei aufgenommen wurden, gibt es möglicherweise einen internen Prozess zur Bewertung der Qualität der Speisekartendaten. Ziel dieses Prozesses ist es, Unstimmigkeiten in der Datenqualität zu finden, z. B. Inhalte, die sich nicht auf Lebensmittel beziehen, in Beschreibungen von Gerichten, nicht übereinstimmende Namen oder Preise von Gerichten. In solchen Fällen wird das Feedback an das Entwicklungsteam weitergegeben.