Aperçu

Les partenaires Google peuvent fournir des données structurées sur les menus à Google via l'intégration des listes d'attente et des réservations. Ces données sont utilisées dans la section Menu de la fiche d'établissement Google d'un restaurant et dans 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 la procédure d'importation de flux génériques
  3. Découvrez comment configurer votre compte pour importer des flux génériques.

Schéma

Le schéma complet du menu est disponible 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 les restaurants, suivez les spécifications de données décrites dans Flux des marchands. Pour obtenir un exemple de fichier JSON, consultez l'exemple de fichier JSON. Les noms de fichiers de données doivent être uniques entre les importations. Il est recommandé d'inclure un code temporel dans le nom du fichier, par exemple menu1_1633621547.json.
  • Dans le descripteur du fichier pour le flux de menu, définissez le champ name sur google.food_menu. Pour voir un exemple du contenu du fichier descripteur, consultez l'exemple JSON de fichier descripteur. Les noms des fichiers descripteurs doivent être uniques entre les importations. Nous vous recommandons d'inclure un code temporel dans le nom de fichier, par exemple descriptor_1633621547.filesetdesc.json. Le fichier descripteur doit être importé sur le serveur SFTP générique en tant qu'élément du flux de menu.
  • Les flux doivent être importés sur le serveur SFTP générique tous les jours pour être actualisés complètement.
  • Limitez les flux à 1 000 fragments (fichiers), comme indiqué dans Utiliser le SFTP de flux générique.

L'état de l'ingestion des flux est indiqué dans la section Flux > Historique du portail des partenaires. Les informations sur le serveur SFTP des flux sont disponibles dans la section Configuration > Flux du portail des partenaires.

Sélectionner le serveur SFTP du flux

Figure 1 : Informations génériques sur le serveur SFTP

L'état de l'ingestion des flux est indiqué dans la section Flux > Historique du portail des partenaires. Les informations sur le serveur SFTP des flux sont disponibles dans la section Configuration > Flux du portail des partenaires.

Utiliser les options des éléments de menu

Les options des éléments de menu peuvent être spécifiées à l'aide du proto MenuItemOption.

Les partenaires qui proposent plusieurs ensembles d'options obligatoires pour un même élément de menu (par exemple, un latte avec des options de taille et de lait) doivent choisir la meilleure façon d'afficher ces options sur Google. Google recommande les pratiques suivantes :

  • Le flux de menu doit correspondre au site de commande du partenaire (ou au menu du restaurant si vous n'avez pas de site de commande pour l'établissement). Si l'article est affiché avec un prix individuel sur le site de commande, vous devez utiliser MenuItem. Si l'article est affiché avec un prix de base et plusieurs options, vous devez utiliser MenuItemOption.
  • Évitez d'inclure une longue liste d'options, par exemple :
    • 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
  • Les options de menu ne sont acceptées que si le plat nécessite la sélection d'une des options. Par exemple, lorsque vous commandez une pizza, la taille est une option obligatoire. Les options d'éléments de menu qui concernent les suppléments (par exemple, "option pour ajouter de l'avocat") ne sont pas acceptées et ne doivent pas être incluses dans les flux.

Le prix de l'option d'un élément de menu doit correspondre au prix total de l'élément avec cette option sélectionnée. Le prix doit être défini pour l'élément de menu ou pour ses options, mais pas pour les deux.

Restaurants avec plusieurs menus

Un même restaurant (entité) ne peut avoir qu'un seul menu. Pour un restaurant qui propose plusieurs menus (par exemple, un menu du midi et un menu du soir distincts), vous pouvez combiner tous les menus en un seul à l'aide de MenuSections (par exemple, un menu avec une section pour le midi et une section pour le soir). Le menu obtenu aurait la structure suivante :

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

Partager des menus entre plusieurs 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 utilisant le flux Entity.

Bonnes pratiques

Voici les bonnes pratiques à suivre lorsque vous développez des flux de menus.

  • N'associez qu'un seul menu à un restaurant.
  • Indiquez la langue de votre choix comme première langue dans le TextField. Si vous envoyez plusieurs objets LocalizedText, le premier objet de la liste de texte est affiché aux utilisateurs.
  • Tous les éléments de menu doivent être ajoutés aux sections de menu. N'ajoutez pas d'éléments de menu directement à l'objet de menu.
  • Fournissez du contenu en utilisant l'encodage 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 de devise et les dénominations appropriés dans les champs "unités" et "nanos". Soyez particulièrement vigilant avec le champ "nanos", qui correspond à 10^-9 unité. Utilisez le visualiseur de menu dans l'outil de visualisation de l'inventaire pour vérifier que vous avez correctement défini les prix.
  • Pour offrir aux utilisateurs une expérience utile et attrayante, il est essentiel de leur proposer des menus complets, récents et visuellement riches. Les prix, les descriptions, les photos et les informations sur les régimes alimentaires sont des éléments clés pour influencer les décisions. Nous encourageons les partenaires à fournir autant de données que possible pour offrir une expérience optimale aux utilisateurs et aux marchands.

Une fois les flux de menus lancés, les données de votre flux de menus pourront s'afficher dans les expériences de découverte et dans l'onglet "Menu" de la fiche de votre restaurant. L'onglet "Menu" est disponible dans la recherche Google (sur mobile et ordinateur). Il sera bientôt disponible sur d'autres plates-formes, y compris Google Maps. L'expérience de rendu peut varier en fonction de la surface.

Exemple de menu affichant des éléments avec des descriptions

Illustration 3 : Exemple de contenu de flux de menu affiché dans une fiche d'établissement sur mobile

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

Les menus de restaurants peuvent provenir de nombreuses sources, y compris des restaurants eux-mêmes via leur fiche d'établissement Google, des partenaires de commande de repas et de réservation, 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 menus de la fiche d'établissement Google.