Aperçu

Les partenaires Google peuvent fournir à Google des données de menu structurées via l'intégration de Réservations de bout en bout pour les utiliser dans la section Menu de la fiche d'établissement Google d'un restaurant et d'autres points d'entrée sur les surfaces Google destinées aux consommateurs.

Les données de menu sont ingérées à l'aide des flux génériques. Avant de commencer :

1. Assurez-vous d'avoir terminé la configuration de votre compte.
2. Comprendre le processus d'importation d'un flux générique
3. Découvrez comment configurer votre compte pour importer des flux génériques.

Schéma

Pour consulter le schéma complet du menu, cliquez ici.

Créer et importer des flux de menus

Lorsque vous créez et importez des flux de menus, suivez ces consignes et conventions :

• Pour fournir des informations sur le restaurant, suivez les spécifications des données décrites dans Flux des marchands. Pour obtenir un exemple de fichier JSON, consultez l'exemple de fichier JSON. Les noms des fichiers de données doivent être uniques entre les importations. Il est recommandé d'inclure un code temporel dans le nom de fichier, par exemple menu1_1633621547.json.
• Dans le descripteur de fichier de l'ensemble de fichiers du flux de menu, définissez le champ name sur google.food_menu. Pour voir un exemple du contenu du fichier de descripteur, consultez l'exemple de fichier de descripteur JSON. Les noms des fichiers de descripteur doivent être uniques entre les importations. Il est recommandé d'inclure un code temporel dans le nom de fichier, par exemple descriptor_1633621547.filesetdesc.json. Le fichier descripteur doit être importé dans la boîte de dépôt SFTP générique dans le cadre du flux de menu.
• Les flux doivent être importés dans la boîte de dépôt SFTP générique à une fréquence quotidienne pour des actualisations complètes.
• Limitez les flux à 1 000 fragments (fichiers), comme indiqué dans Utiliser la boîte de dépôt du flux générique.

L'état de l'ingestion des flux est indiqué dans la section Flux > Historique du portail des partenaires. Vous trouverez les informations sur la boîte de dépôt SFTP du flux dans la section Configuration > Flux du Partner Portal.

L'état de l'ingestion des flux est indiqué dans la section Flux > Historique du Partner Portal. Vous trouverez les informations sur la boîte de dépôt SFTP du flux dans la section Configuration > Flux du Partner Portal.

Utiliser les options des éléments de menu

Les options d'élément de menu peuvent être spécifiées à l'aide du proto MenuItemOption. L'expérience utilisateur exacte dépend de la surface Google. Les options des éléments de menu sont affichées sous forme de liste plate. Voici un exemple:

Les options d'un élément de menu ne sont acceptées que si le plat nécessite l'une d'elles. Par exemple, lorsque vous commandez une pizza, la taille est une option obligatoire. Les options d'éléments de menu facultatives (par exemple, "Option d'ajouter de l'avocat") ne sont pas acceptées et ne doivent pas être incluses dans les flux.

Étant donné que les options d'un élément de menu sont affichées sous forme de liste unique, les partenaires disposant de plusieurs ensembles d'options obligatoires pour un même élément de menu (par exemple, un café latte avec des options de taille et de lait) doivent choisir la meilleure façon d'afficher ces options dans Google. Google recommande les consignes suivantes:

• Si seul un ensemble d'options obligatoire affecte le prix, privilégiez son inclusion dans les flux.
• Dans tous les autres cas, il appartient au partenaire de déterminer la meilleure façon de représenter les options de l'élément de menu. Il est déconseillé de créer de longues listes d'options pour toutes les combinaisons possibles. Évitez de structurer vos options comme suit :
  • Burrito au poulet
  • Burrito au poulet et au fromage
  • Burrito au poulet avec salsa
  • Burrito au poulet avec salsa et fromage
  • Burrito au poulet avec guacamole
  • Burrito au poulet avec guacamole et salsa

Lorsque vous incluez des options d'élément de menu sous un élément de menu, vous avez le choix entre:

• L'élément de menu doit comporter au moins une offre avec un prix (dans les cas où les options de l'élément de menu n'ont pas d'incidence sur le prix).
• L'élément de menu doit comporter un ensemble d'options dont le prix de chacune est défini sur le prix total de l'élément avec l'option sélectionnée.

Le prix ne doit être indiqué que pour l'élément de menu ou pour ses options, mais pas pour les deux.

Restaurants proposant plusieurs menus

Un restaurant (entité) ne peut avoir qu'un seul menu. Pour un restaurant qui propose plusieurs menus (par exemple, un menu du déjeuner et un menu du dîner), vous pouvez combiner tous les menus en un seul avec MenuSections (un menu avec une section pour le déjeuner et une section pour le dîner, par exemple). Le menu obtenu présente la structure suivante:

• Menu
• Section "Déjeuner"
• Soupes
• Soupe 1
• Soupe 2
• Sandwichs
• Sandwich 1
• Sandwich 2
• Section "Dîner"
• Entrées
• Déclencheur 1
• Déclencheur 2
• Mains
• Plat principal 1
• Plat principal 2

Partager des menus entre les restaurants

Un même menu peut être partagé entre plusieurs restaurants en incluant tous les restaurants dans la liste merchant_ids du menu. Notez que cette liste accepte les ID d'entité pour les partenaires qui utilisent le flux Entity (Entité).

Bonnes pratiques

Voici les bonnes pratiques à suivre lors du développement de flux de menus.

• N'associez qu'un seul menu à un restaurant.
• Indiquez la langue préférée en tant que première langue dans le TextField. Si vous envoyez plusieurs objets LocalizedText, le premier objet de la liste de texte s'affiche auprès des utilisateurs.
• Tous les éléments de menu doivent être ajoutés à des sections de menu. N'ajoutez pas d'éléments de menu directement à l'objet de menu.
• Fournissez du contenu encodé en UTF-8. Il n'est pas nécessaire d'échapper les caractères non ASCII.
• Si vous lancez votre application dans plusieurs régions, assurez-vous d'utiliser les codes et les dénominations de devise appropriés dans le champ "Unités et nanos". Faites particulièrement attention au champ "Nanos", qui correspond à 10^-9 d'une unité. Utilisez le visualiseur de menu dans l'Aperçu de l'inventaire pour vérifier que vous avez correctement défini les prix.
• Proposer aux utilisateurs des menus visuellement riches, complets et actualisés est essentiel pour leur offrir une expérience utilisateur utile et attrayante. Les prix, les descriptions, les photos et les informations nutritionnelles sont tous des éléments clés qui guident les décisions. Les partenaires sont donc encouragés à fournir autant de données que possible pour offrir une expérience optimale aux utilisateurs et aux marchands.

Outils de développement et de test

Une fois les flux de menus lancés, les données de votre flux de menus pourront apparaître dans les expériences de découverte et être visibles dans l'onglet "Menu" de la fiche d'établissement du restaurant. L'onglet de menu est compatible avec la recherche Google (mobile et ordinateur). L'expérience sera étendue à d'autres surfaces, y compris Google Maps. L'expérience de rendu peut varier en fonction de la surface.

Pour vous assurer que votre menu est correctement structuré, utilisez le visualiseur de menu dans l'Aperçu de l'inventaire pour prévisualiser vos menus.

Les menus de restaurant peuvent provenir de nombreuses sources, y compris des restaurants eux-mêmes via leur fiche d'établissement Google, des partenaires de commande et de réservation de repas, des photos de menus prises par les utilisateurs, etc. Si plusieurs sources fournissent des menus pour le même restaurant, le marchand peut choisir un fournisseur préféré dans l'éditeur de menu de la fiche d'établissement Google.