Обзор

Партнеры Google могут предоставлять Google структурированные данные меню посредством сквозной интеграции Reservations для использования в разделе «Меню » бизнес-профиля ресторана в Google и других точках входа на потребительских страницах Google.

Данные меню принимаются с использованием общих каналов. Прежде чем начать:

  1. Убедитесь, что вы завершили настройку учетной записи
  2. Понимание процесса загрузки общего фида
  3. Узнайте, как настроить свою учетную запись для загрузки общего канала.

Схема

Полную схему меню можно найти здесь .

Создание и загрузка фидов меню

При создании и загрузке фидов меню следуйте следующим рекомендациям и соглашениям:
  • Чтобы предоставить подробную информацию о ресторане, следуйте спецификации данных, описанной в ленте продавцов . Например, файл JSON относится к образцу JSON . Имена файлов данных должны быть уникальными между загрузками. Рекомендуется включать в имя файла метку времени, например, menu1_1633621547.json
  • В дескрипторе набора файлов для ленты меню установите для поля name google.food_menu . Чтобы увидеть пример содержимого файла дескриптора, обратитесь к образцу JSON файла дескриптора . Имена файлов дескрипторов должны быть уникальными между загрузками. Рекомендуется включать в имя файла метку времени, например, descriptor_1633621547.filesetdesc.json . Файл дескриптора необходимо загрузить в общий ящик SFTP как часть канала меню.
  • Фиды необходимо загружать в общий ящик SFTP ежедневно с полным обновлением.
  • Ограничьте каналы до 1000 фрагментов (файлов), как указано в раскрывающемся списке «Использование общего канала».

Статус приема каналов можно найти в разделе «Фиды» > «История» партнерского портала. Информацию о раскрывающемся ящике SFTP для каналов можно найти в разделе «Конфигурация» > «Фиды» партнерского портала.

Выбор ящиков для каналов

Рисунок 1. Общая информация о почтовом ящике SFTP.

Статус приема каналов можно найти в разделе «Фиды» > «История» партнерского портала. Информацию о раскрывающемся ящике SFTP для каналов можно найти в разделе «Конфигурация» > «Фиды» партнерского портала.

Работа с опциями пунктов меню

Параметры пункта меню можно указать с помощью прототипа MenuItemOption . Конкретный опыт пользователя будет зависеть от поверхности Google. Опции пунктов меню отображаются в виде плоского списка под элементом меню. См. пример:

Пункты ценового меню с опциями

Рисунок 2. В меню «Хлебные палочки и соус» есть два пункта меню: Sm и Lg.

Опции пунктов меню поддерживаются только в том случае, если блюдо требует выбора одного из вариантов. Например, при заказе пиццы обязательным параметром является размер. Опции пунктов меню, которые являются необязательными (например, «возможность добавить авокадо»), не поддерживаются и не должны включаться в каналы.

Поскольку параметры пунктов меню отображаются в виде единого плоского списка, партнеры, у которых есть несколько наборов обязательных параметров для одного пункта меню (например, латте с вариантами размера и вариантами молока), должны решить, как лучше всего отображать эти параметры в Google. Google рекомендует следующие рекомендации:

  • Если на цену влияет только один обязательный набор опций, лучше включить этот набор в фиды.
  • Во всех остальных случаях партнер должен определить, как лучше всего представить параметры пунктов меню. Не рекомендуется создавать длинные списки опций для всех возможных комбинаций опций. Избегайте структурирования своих вариантов следующим образом:
    • Куриное буррито
    • Куриное буррито с сыром
    • Куриное буррито с сальсой
    • Куриное буррито с сальсой и сыром
    • Куриное буррито с гуакамоле
    • Куриное буррито с гуакамоле и сальсой

При включении опций пункта меню в элемент меню либо:

  • В пункте меню должно быть хотя бы одно предложение с ценой (для случаев, когда опции пункта меню не влияют на цену).
  • Пункт меню должен иметь набор опций, при этом цена каждого варианта должна быть равна общей цене пункта с выбранной опцией.

Цена должна быть указана только за пункт меню или за его опции, но не за то и другое.

Рестораны с несколькими меню

В одном ресторане (Entity) может быть только одно меню. Для ресторана, имеющего несколько меню (т. е. отдельные меню обеда и ужина), вы можете объединить все меню в одно меню с помощью MenuSections (т. е. одно меню с разделом для обеда и разделом для ужина). В результате меню будет иметь следующую структуру:

  • Меню
    • Обеденный раздел
      • Супы
        • Суп 1
        • Суп 2
      • Сэндвичи
        • Сэндвич 1
        • Сэндвич 2
    • Ужин
      • Закуски
        • Стартер 1
        • Стартер 2
      • Сеть
        • Основное блюдо 1
        • Основное блюдо 2

Совместное использование меню в ресторанах

Одно меню можно использовать в нескольких ресторанах, включив все рестораны в список merchant_ids меню. Обратите внимание, что в этом списке принимаются идентификаторы объектов для партнеров, использующих фид объектов .

Лучшие практики

Ниже приведены рекомендации, которым следует следовать при разработке каналов меню.

  • Свяжите с рестораном только одно меню .
  • Укажите предпочтительный язык в качестве первого языка в TextField . Если вы отправляете несколько объектов LocalizedText , пользователям отображается первый объект в текстовом списке.
  • Все пункты меню должны быть добавлены в разделы меню . Не добавляйте пункты меню непосредственно в объект меню.
  • Предоставляйте контент, используя кодировку utf-8. Нет необходимости экранировать символы, отличные от ascii.
  • Если вы запускаете игру в нескольких регионах, убедитесь, что вы используете правильные коды валют и номиналы в полях единиц и нано. Обратите особое внимание на поле нано, которое составляет 10^-9 единиц. Используйте визуализатор меню в средстве просмотра инвентаря, чтобы убедиться, что вы правильно установили цены.
  • Предоставление пользователям визуально богатых, всеобъемлющих и свежих меню является ключом к обеспечению полезного и привлекательного пользовательского опыта. Цены, описания, фотографии и информация о диете — все это ключевые элементы при принятии решений, и партнерам рекомендуется предоставлять как можно больше этих данных, чтобы обеспечить оптимальное взаимодействие с пользователем и продавцом.

После запуска фидов меню данные вашего фида меню смогут появляться в разделе Discovery и могут отображаться на вкладке "Меню" в таблице ресторанов. Вкладка меню поддерживается в Поиске Google (на мобильных устройствах и компьютерах), и ее возможности будут расширены на дополнительные поверхности, включая Карты Google. Визуализация может отличаться в зависимости от поверхности.

Пример меню, показывающий пункты меню с описаниями

Рис. 3. Пример отображения содержимого ленты меню в профиле компании на мобильных устройствах.

Чтобы убедиться, что ваше меню структурировано правильно, используйте визуализатор меню в Inventory Viewer для предварительного просмотра меню.

Меню ресторана могут поступать из многих источников, в том числе из самих ресторанов через их бизнес-профиль в Google, партнеров по заказу и резервированию еды, фотографий меню и т. д. Если несколько источников предоставляют меню для одного и того же ресторана, продавец может выбрать предпочтительного поставщика в редакторе меню профиля компании в Google.