Przegląd

Partnerzy Google mogą udostępniać Google uporządkowane dane menu w ramach kompleksowej integracji rezerwacji do wykorzystania w sekcji Menu wizytówki restauracji w Mapach Google na komórki (Android i iOS).

Dane menu są przetwarzane przy użyciu ogólnych plików danych. Zanim zaczniesz, poświęć kilka minut na wykonanie konfiguracji konta i przeczytaj artykuł Korzystanie ze skrzynki referencyjnej ogólnego pliku danych, w którym znajdziesz omówienie procesu przesyłania ogólnego pliku danych oraz wyjaśnienie, jak skonfigurować konto pod kątem przesyłania ogólnych plików danych.

Tworzenie i przesyłanie plików danych z menu

Podczas tworzenia i przesyłania plików danych z menu pamiętaj o tych kwestiach:

  • Aby wygenerować pliki danych menu, postępuj zgodnie ze specyfikacją danych opisaną w pliku danych menu. Nazwy plików danych menu nie mogą się powtarzać pomiędzy przesyłanymi plikami. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej, np. menu1_1633621547.json.
  • W deskryptorze zbioru plików ustaw pole name na wartość google.food_menu. Przykład zawartości pliku deskryptora znajdziesz w przykładzie pliku deskryptora w formacie JSON. Nazwy plików deskryptorów powinny być niepowtarzalne w poszczególnych operacjach przesyłania. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej, np. descriptor_1633621547.filesetdesc.json. Plik deskryptora należy przesłać do ogólnej skrzynki referencyjnej SFTP jako część pliku danych.
  • Pliki danych menu należy przesyłać do ogólnej skrzynki referencyjnej SFTP codziennie w ramach pełnego odświeżania.
  • Informacje o skrzynce referencyjnej SFTP na kanale SFTP znajdziesz w sekcji Konfiguracja > Pliki danych w portalu dla partnerów.

    • Wybieranie skrzynek referencyjnych

    Rysunek 1. Ogólne informacje o skrzynce referencyjnej SFTP

Praca z opcjami pozycji menu

Opcje pozycji w menu można określić za pomocą protokołu MenuItemOption. Opcje pozycji menu są wyświetlane na płaskiej liście poniżej pozycji menu. Zobacz ten przykład:

Pozycje menu cen z opcjami

Rysunek 2. Paluszki z chleba i sos mają 2 opcje w menu: Sm i Lg

Obsługiwane są tylko wymagane opcje pozycji menu. Wymagana opcja pozycji w menu to opcja, którą klient musi wybrać przy składaniu zamówienia. Na przykład podczas zamawiania pizzy wymagany jest rozmiar. Opcjonalne opcje w menu (np. „opcja dodania awokado”) nie są obsługiwane.

Opcje pozycji w menu są wyświetlane w formie pojedynczej listy, dlatego partnerzy, którzy mają wiele zestawów wymaganych opcji do 1 dania w menu (np. latte z opcjami rozmiaru i opcjami mleka), muszą zdecydować, jak najlepiej wyświetlać je w Google. Google zaleca tę metodę heurystyki:

  • Jeśli na cenę wpływa tylko 1 wymagany zestaw opcji, preferuj uwzględnianie go w plikach danych.
  • W pozostałych przypadkach to partner musi określić, jak najlepiej przedstawić opcje. Nie zalecamy tworzenia długich list opcji dla wszystkich możliwych kombinacji opcji.

Gdy do pozycji menu dodajesz opcje pozycji menu, możesz:

  • Pozycja w menu musi zawierać co najmniej 1 ofertę z ceną (w przypadkach, gdy opcje dania w menu nie wpływają na cenę).
  • Pozycja menu musi zawierać zestaw opcji, z których każda ma taką samą cenę jak łączna cena pozycji z wybraną opcją.

Cenę należy podać tylko dla pozycji menu lub jej opcji, ale nie dla obu tych opcji.

Po wprowadzeniu plików danych z menu restauracji mogą się one pojawić na karcie „Menu” wizytówki restauracji. Jeśli wiele źródeł oferuje menu tej samej restauracji, sprzedawca może wybrać preferowanego dostawcę w edytorze menu Profilu Firmy w Google. Więcej informacji o tym, jak sprzedawca może wybrać preferowanego dostawcę menu, znajdziesz w artykule Zarządzanie menu.

Karta „Menu” wyświetla się w wizytówce w tych usługach Google:

Produkt Urządzenie
wyszukiwarki Google. Internet mobilny
wyszukiwarki Google. Natywna na urządzeniach mobilnych
Mapy Google Natywna na urządzeniach mobilnych
Nowe menu wyświetla się w wyszukiwarce Google na komórki, a dodatkowo udostępnimy je na dodatkowych platformach, m.in. na komputerach i w Mapach Google.

Przykładowe menu z pozycjami menu z opisami

Rysunek 3. Przykład wyświetlania treści z pliku danych w menu.

Jeśli chcesz przeprowadzić testy na komputerze, zasymuluj urządzenie mobilne za pomocą narzędzi dla programistów w przeglądarce.

  1. W widoku zasobów reklamowych wybierz sprzedawcę i kliknij link do wizytówki, aby wyświetlić wizytówkę restauracji.
  2. Otwórz Narzędzia dla deweloperów w Chrome (prawym przyciskiem myszy kliknij Zbadaj lub Wyświetl -> Deweloper -> Narzędzia dla deweloperów), wybierz typ urządzenia mobilnego Typ urządzenia mobilnego i odśwież stronę.

Sprawdzone metody

Poniżej znajdziesz sprawdzone metody tworzenia plików z menu.

  • Powiąż z restauracją tylko jedno menu.
  • Jako pierwszy język w TextField podaj preferowany język. Jeśli wysyłasz wiele obiektów LocalizedText, obecnie użytkownicy widzą tylko pierwszy obiekt na liście tekstowej.
  • Wszystkie pozycje menu należy dodawać do sekcji menu. Nie należy ich dodawać bezpośrednio do obiektu menu.
  • Dostarczone treści powinny być w kodowaniu UTF-8. Znaki spoza zestawu ASCII nie są konieczne.
  • Ogranicz liczbę plików lub fragmentów kanału do 1000,jak wspomnieliśmy w sekcji Używanie skrzynki referencyjnej ogólnego pliku danych.