Przegląd

Partnerzy Google mogą przesyłać do Google uporządkowane dane menu za pomocą kompleksowej integracji rezerwacji, aby wyświetlać je w sekcji Menu w profilu firmy w Google i innych punktach wejścia w usługach Google dla klientów.

Dane menu są przetwarzane za pomocą plików danych ogólnych. Zanim zaczniesz:

  1. Sprawdź, czy masz ukończoną konfigurację konta.
  2. Proces przesyłania ogólnego pliku danych
  3. Dowiedz się, jak skonfigurować konto do przesyłania plików danych ogólnych

Schemat

Pełny schemat menu znajdziesz tutaj.

Tworzenie i przesyłanie plików danych menu

Podczas tworzenia i przesyłania plików danych menu przestrzegaj tych wskazówek i porozumień:
  • Aby podać szczegóły restauracji, postępuj zgodnie ze specyfikacją danych opisaną w sekcji Plik danych sprzedawcy. Przykładowy plik JSON znajdziesz w sekcji przykładowy plik JSON. Nazwy plików danych powinny być niepowtarzalne. Zalecamy dodanie sygnatury czasowej do nazwy pliku, na przykład menu1_1633621547.json
  • W deskryptorze zbioru plików dla pliku danych menu ustaw pole name na google.food_menu. Przykładowy plik z informacjami o deskryptorze znajdziesz w pliku JSON z informacjami o deskryptorze. Nazwy plików opisu powinny być niepowtarzalne wśród przesyłanych plików. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej, np. descriptor_1633621547.filesetdesc.json. Plik opisu musi zostać przesłany do ogólnego folderu Dropbox SFTP w ramach pliku danych menu.
  • Pliki danych muszą być przesyłane do ogólnego dropboxa SFTP codziennie w ramach pełnego odświeżania.
  • Ogranicz pliki danych do 1000 fragmentów (plików), jak opisano w artykule Korzystanie z dropboxa z plikami danych ogólnych.

Stan przetwarzania pliku danych możesz sprawdzić w sekcji Pliki danych > Historia na portalu partnera. Informacje o skrzynce SFTP znajdziesz w sekcji Konfiguracja > Pliki danych na Portalu Partnera.

Wybieranie pól danych

Rysunek 1. Informacje o ogólnej skrzynce referencyjnej SFTP

Stan przetwarzania pliku danych znajdziesz w sekcji Pliki danych > Historia na Portalu Partnera. Informacje o skrzynce Dropbox pliku danych SFTP znajdziesz w sekcji Konfiguracja > Pliki danych na Portalu Partnera.

Praca z opcjami elementów menu

Opcje pozycji menu można określić za pomocą protokołu MenuItemOption. Dokładne działanie zależy od interfejsu Google. Opcje elementów menu są wyświetlane jako lista pozioma pod elementem menu. Zobacz przykład:

Elementy menu cen z opcjami

Ilustracja 2. Produkt „Pieczywo z sosem” ma 2 opcje: Sm i Lg

Opcje pozycji menu są obsługiwane tylko wtedy, gdy wymagane jest wybranie jednej z opcji. Na przykład przy zamawianiu pizzy wymagany jest rozmiar. Opcje elementów menu, które są opcjonalne (np. „opcja dodania awokado”), nie są obsługiwane i nie powinny być uwzględniane w plikach danych.

Opcje pozycji menu są wyświetlane jako jedna płaska lista, dlatego partnerzy, którzy mają wiele zestawów wymaganych opcji dla jednej pozycji menu (np. latte z opcjami rozmiaru i mleka), muszą zdecydować, jak najlepiej wyświetlić te opcje w Google. Google zaleca przestrzeganie tych wskazówek:

  • Jeśli na cenę wpływa tylko jeden wymagany zestaw opcji, uwzględnij go w plikach danych.
  • W pozostałych przypadkach to partner decyduje, jak najlepiej przedstawić opcje elementów menu. Nie zalecamy tworzenia długich list opcji dla wszystkich możliwych kombinacji. Unikaj takich opcji:
    • burrito z kurczakiem
    • Burrito z kurczakiem i serkiem
    • Burrito z kurczakiem i salsa
    • Burrito z kurczakiem, salsą i serkiem
    • Kurczak burrito z guacamole
    • Burrito z kurczakiem, guacamole i salsa

Jeśli chcesz dodać opcje pozycji menu, wykonaj jedną z tych czynności:

  • Pozycja menu musi mieć co najmniej 1 ofertę z ceną (w przypadku, gdy opcje pozycji menu nie wpływają na cenę).
  • Element menu musi mieć zestaw opcji, a cena każdej z nich musi być ustawiona na łączną cenę elementu z wybraną opcją.

Cena powinna być podana tylko dla pozycji menu lub jej opcji, ale nie dla obu.

restauracje z kilkoma menu;

Jedna restauracja (podmiot) może mieć tylko jedno menu. W przypadku restauracji, która ma kilka menu (np. oddzielne menu na lunch i kolację), możesz połączyć wszystkie menu w jedno menu za pomocą MenuSections (np. jedno menu z sekcją na lunch i kolację). Wygenerowane menu będzie miało taką strukturę:

  • Menu
    • Sekcja obiadowa
      • Zupy
        • Zupa 1
        • Soup 2
      • Kanapki
        • Kanapka 1
        • Sandwich 2
    • Sekcja kolacji
      • Polecenia inicjujące
        • Starter 1
        • Starter 2
      • Główne
        • Danie główne 1
        • Danie główne 2

Udostępnianie menu w różnych restauracjach

Jedno menu może być udostępniane w wielu restauracjach, jeśli wszystkie restauracje są uwzględnione na merchant_ids liście menu. Pamiętaj, że ta lista akceptuje identyfikatory jednostek dla partnerów korzystających z pliku danych Jednostka.

Sprawdzone metody

Oto sprawdzone metody tworzenia plików danych menu.

  • Powiązać z restauracją tylko jedno menu.
  • W pierwszym TextField podaj preferowany język. Jeśli wysyłasz wiele obiektów LocalizedText, użytkownikom wyświetlany jest pierwszy obiekt na liście tekstów.
  • Wszystkie pozycje menu muszą zostać dodane do sekcji menu. Nie dodawaj pozycji menu bezpośrednio do obiektu menu.
  • Prześlij treści w formacie UTF-8. Nie trzeba stosować znaków zmiany znaczenia w przypadku znaków spoza zestawu ASCII.
  • Jeśli wprowadzasz produkt w kilku regionach, upewnij się, że w polu jednostek i nanos używasz prawidłowych kodów walut oraz denominacji. Szczególnie uważaj na pole nanos, które jest równe 10^-9 jednostki. Użyj wizualizacji menu w widoku danych o asortymencie, aby sprawdzić, czy ceny zostały prawidłowo ustawione.
  • Udostępnianie użytkownikom bogatych wizualnie, obszernych i świeżych menu jest kluczem do zapewnienia im przydatnych i ciekawych wrażeń. Ceny, opisy, zdjęcia i informacje dotyczące diety to kluczowe elementy, które pomagają w podejmowaniu decyzji. Zachęcamy partnerów do podawania jak największej liczby tych danych, aby zapewnić optymalne wrażenia użytkowników i sprzedawców.

Gdy pliki danych menu zostaną wdrożone, dane z pliku danych menu będą mogły być wyświetlane w ramach funkcji odkrywania i mogą być widoczne na karcie „Menu” w profilu restauracji. Karta menu jest obsługiwana w wyszukiwarce Google (na urządzeniach mobilnych i komputerach), a ta funkcja będzie dostępna na kolejnych platformach, m.in. w Mapach Google. Renderowanie może się różnić w zależności od powierzchni.

Przykład menu z pozycjami menu i ich opisami

Rysunek 3. Jak treści w menu wyświetlają się w Profilu Firmy na urządzeniu mobilnym

Aby upewnić się, że menu jest prawidłowo sformatowane, wyświetl podgląd menu za pomocą wizualizacji menu w widoku danych o asortymencie.

Menu restauracji mogą pochodzić z różnych źródeł, m.in. od samych restauracji za pośrednictwem ich profilu firmy w Google, od partnerów ds. zamawiania jedzenia i rezerwacji czy od użytkowników, którzy przesyłają zdjęcia menu. Jeśli menu tej samej restauracji pochodzą z różnych źródeł, sprzedawca może wybrać preferowanego dostawcę w edytorze menu w profilu firmy w Google.