Visão geral

Os parceiros do Google podem fornecer dados estruturados de cardápio ao Google pela integração de listas de espera de reservas para uso na seção Menu do Perfil da Empresa no Google de um restaurante e outros pontos de entrada em plataformas do Google para consumidores.

Os dados do cardápio são ingeridos usando os feeds genéricos. Antes de começar:

  1. Verifique se você concluiu a configuração da conta.
  2. Entenda o processo de upload de feeds genéricos
  3. Entenda como configurar sua conta para uploads de feeds genéricos

Esquema

Confira o esquema completo do menu aqui.

Como criar e fazer o upload de feeds de cardápio

Ao criar e fazer upload de feeds de cardápio, siga estas diretrizes e convenções:
  • Para fornecer detalhes do restaurante, siga a especificação de dados descrita em Feed do comerciante. Para conferir um exemplo de arquivo JSON, consulte o exemplo de JSON. Os nomes dos arquivos de dados precisam ser exclusivos entre os uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, menu1_1633621547.json
  • No descritor de conjunto de arquivos do feed de menu, defina o campo name como google.food_menu. Para conferir um exemplo do conteúdo do arquivo de descritor, consulte o exemplo de JSON do arquivo de descritor. Os nomes dos arquivos de descrições precisam ser exclusivos entre os uploads. É recomendável incluir um carimbo de data/hora no nome do arquivo, por exemplo, descriptor_1633621547.filesetdesc.json. O arquivo descritor precisa ser enviado para a caixa de depósito genérica do SFTP como parte do feed de menu.
  • Os feeds precisam ser enviados para a caixa de depósito genérica de SFTP diariamente como atualizações completas.
  • Limite os feeds a 1.000 fragmentos (arquivos), conforme mencionado em Como usar a caixa de depósito genérica de feeds.

O status de transferência de feeds pode ser encontrado na seção Feeds > History do portal de parceiros. As informações da caixa de depósito SFTP do feed podem ser encontradas na seção Configuração > Feeds do portal do parceiro.

Como selecionar caixas de depósito de feeds

Figura 1: Informações genéricas da caixa de depósito SFTP

O status de transferência de feeds pode ser encontrado na seção Feeds > History do portal do parceiro. As informações da caixa de depósito SFTP do feed podem ser encontradas na seção Configuração > Feeds do portal do parceiro.

Como trabalhar com opções de itens de menu

As opções de itens de menu podem ser especificadas usando o proto MenuItemOption. A experiência do usuário vai depender da plataforma do Google. As opções de item de menu são mostradas como uma lista simples abaixo do item de menu. Confira o exemplo:

Definir preços de itens de menu com opções

Figura 2. Bread Sticks & Sauce tem duas opções de itens do menu: Sm e Lg

As opções de itens do cardápio só são aceitas se o prato exigir que uma das opções seja selecionada. Por exemplo, ao pedir uma pizza, o tamanho é uma opção obrigatória. Opções de itens de menu opcionais (por exemplo, "opção de adicionar abacate") não são aceitas e não devem ser incluídas nos feeds.

Como as opções de itens de menu são exibidas como uma única lista simples, os parceiros com vários conjuntos de opções necessárias para um único item de menu (por exemplo, um latte com opções de tamanho e de leite) precisam decidir a melhor forma de mostrar essas opções no Google. O Google recomenda as seguintes diretrizes:

  • Se apenas um conjunto de opções obrigatório afetar o preço, inclua esse conjunto nos feeds.
  • Em todos os outros casos, cabe ao parceiro determinar a melhor forma de representar as opções do item de menu. Não é recomendável criar listas longas de opções para todas as combinações possíveis. Evite estruturar suas opções assim:
    • Burrito de frango
    • Burrito de frango com queijo
    • Burrito de frango com molho
    • Burrito de frango com molho e queijo
    • Burrito de frango com guacamole
    • Burrito de frango com guacamole e molho

Ao incluir opções de item de menu em um item de menu, faça o seguinte:

  • O item de menu precisa ter pelo menos uma oferta com preço (para casos em que as opções do item de menu não afetam o preço).
  • O item de menu precisa ter um conjunto de opções com o preço de cada opção definido como o preço total do item com essa opção selecionada.

O preço precisa ser fornecido apenas para o item do menu ou para as opções dele, mas não para os dois.

Restaurantes com vários cardápios

Um único restaurante (entidade) só pode ter um menu. Para um restaurante com vários cardápios (por exemplo, cardápios de almoço e jantar separados), você pode combinar todos em um único cardápio com MenuSections (um cardápio com uma seção para almoço e outra para jantar). O menu resultante teria a seguinte estrutura:

  • Menu
    • Seção de almoço
      • Sopas
        • Sopa 1
        • Sopa 2
      • Sanduíches
        • Sanduíche 1
        • Sanduíche 2
    • Seção "Jantar"
      • Entradas
        • Starter 1
        • Starter 2
      • Entradas
        • Prato principal 1
        • Prato principal 2

Compartilhamento de cardápios entre restaurantes

Um único menu pode ser compartilhado entre vários restaurantes ao incluir todos os restaurantes na lista merchant_ids do menu. Essa lista aceita IDs de entidade para parceiros que usam o feed de entidade.

Práticas recomendadas

Confira a seguir as práticas recomendadas para seguir ao desenvolver feeds de cardápio.

  • Associe apenas um menu a um restaurante.
  • Informe o idioma preferido como o primeiro no TextField. Se você estiver enviando vários objetos LocalizedText, o primeiro objeto na lista de texto será mostrado aos usuários.
  • Todos os itens do cardápio precisam ser adicionados às seções do cardápio. Não adicione itens de menu diretamente ao objeto de menu.
  • Forneça conteúdo usando a codificação UTF-8. Não é necessário escapar de caracteres não ASCII.
  • Se você estiver lançando em várias regiões, verifique se está usando os códigos de moeda e as denominações corretas no campo de unidades e nanos. Tenha cuidado com o campo de nanos, que é 10^-9 de uma unidade. Use o visualizador de cardápios no Inventory Viewer para confirmar se você definiu os preços corretamente.
  • Oferecer menus visualmente ricos, abrangentes e novos é fundamental para oferecer uma experiência útil e envolvente. Preços, descrições, fotos e informações sobre a dieta são elementos-chave para a tomada de decisões. Recomendamos que os parceiros forneçam o máximo possível desses dados para oferecer uma experiência ideal para usuários e comerciantes.

Depois que os feeds de cardápio forem lançados, os dados do feed de cardápio vão estar qualificados para aparecer nas experiências de descoberta e poderão ser mostrados na guia "Cardápio" da ficha do restaurante. A guia de menu é compatível com a Pesquisa Google (dispositivos móveis e computadores) e a experiência será expandida para outras plataformas, incluindo o Google Maps. A experiência renderizada pode variar dependendo da superfície.

Exemplo de menu mostrando itens de menu com descrições

Figura 3:exemplo de como o conteúdo do feed de cardápio aparece no Perfil da Empresa em dispositivos móveis

Para garantir que o menu esteja estruturado corretamente, use o Visualizador de menus no Inventory Viewer para visualizar seus menus.

Os cardápios dos restaurantes podem vir de várias fontes, incluindo os próprios restaurantes pelo Perfil da Empresa no Google, parceiros de pedidos de comida e reservas, fotos de cardápios dos usuários e muito mais. Se várias fontes estiverem fornecendo cardápios para o mesmo restaurante, o comerciante poderá escolher um fornecedor preferencial no editor de cardápio do Perfil da Empresa no Google.