Le Visionneuse d'inventaire vous permet de:
- Rechercher des entités en fonction de l'ID du fournisseur (ID que vous fournissez dans les flux)
- Consultez les détails spécifiques à l'entité, y compris :
- Nom de l'entité
- Adresse du restaurant
- JSON d'entité brut
- Zones desservies
- Heures
- État de diffusion sur les surfaces grand public
- Liens vers le parcours de commande des consommateurs
- et plus
- Passer d'une entité à une autre (par exemple, passer d'un menu à son service et restaurant parent, ou inversement)
- Afficher la version d'une entité que Google possède
Pour accéder au Visionneuse d'inventaire, ouvrez le Centre d'actions, puis accédez à Inventaire > Entités de commande de repas ou cliquez sur ce lien.
Tous les utilisateurs disposant d'un accès Lecteur ou supérieur à votre compte Actions Center ont automatiquement accès au Visionneuse d'inventaire.
Le Visionneuse d'inventaire n'est compatible qu'avec les environnements de production et de bac à sable. Les tests rapides ne sont pas pris en charge.
Utiliser l'outil d'affichage de l'inventaire
Commencez par accéder à Inventaire > Entités de commande de repas ou cliquez sur ce lien.
Le lecteur d'inventaire comporte deux vues: la vue Liste et la vue détaillée.
Liste
Il s'agit de la vue que les utilisateurs voient lorsqu'ils accèdent à l'outil pour la première fois. Il contient un tableau avec un onglet pour chaque type d'entité. Chaque onglet contient un tableau paginé de toutes les entités de ce type. Les colonnes varient selon le type d'entité, mais incluent toujours les éléments suivants:
| Nom de la colonne | Description |
|---|---|
| ID d'entité | ID d'entité fourni par le partenaire (à partir des flux par lot et des RTU) |
| Dernière modification | Il s'agit de l'horodatage de la dernière ingestion de modification de cette entité dans des flux ou des RTU (dans votre fuseau horaire). |
Voici d'autres colonnes spécifiques aux entités:
| Nom de la colonne | Description |
|---|---|
| Nom | Nom de l'entité dans les flux. |
| État | État de diffusion de l'entité. Disponible uniquement pour les restaurants et les services |
| État supprimé | État de suppression de l'entité. Les valeurs sont "Deleted" (Supprimé) ou "Not deleted" (Non supprimé). Disponible pour tous les types d'entités, à l'exception de "Service" et "Restaurant" |
| Type | Delivery (Livraison) ou Takeout (Retrait) pour "Services", optionType pour "MenuItemOptions" |
Cliquez sur une ligne pour accéder à la vue détaillée de l'entité correspondante.
Filtres de la vue Liste
Chaque tableau de la vue Liste est compatible avec un ensemble de filtres spécifiques à ce type d'entité. Toutes les entités acceptent le filtrage par ID d'entité (l'ID que vous fournissez à Google dans les flux et les RTU).
Certains types d'entités sont compatibles avec des filtres plus avancés. Vous trouverez ci-dessous un tableau qui liste quelques-uns de ces filtres.
| Clé | Opérateurs | Types d'entités compatibles | Description |
|---|---|---|---|
| Nom | =,contient | Restaurant, Menu, MenuSection, MenuItem | le nom de l'entité fourni dans les flux ; |
| SKU | = | MenuItemOffer | |
| Adresse | =,contient | Restaurant | L'adresse fournie dans les flux |
| État de la diffusion | multi-sélection | Restaurant, service | État de la diffusion dans l'UI du client |
| État supprimé | multi-sélection | Toutes les entités, sauf les restaurants et les services | État de suppression de l'entité (supprimée ou non) |
Vue Détails
La vue détaillée est celle que les utilisateurs voient lorsqu'ils cliquent sur une entité dans la vue Liste. La vue détaillée contient des informations supplémentaires sur cette entité, comme:
- Motif de désactivation (pour les types d'entités "Restaurant" et "Service")
- Vues de liste des entités associées
- Heure d'indexation de l'entité (heure de la dernière synchronisation avec la base de données de service)
- Le JSON brut provenant de flux ou de RTU
- Vues combinées d'entités associées (par exemple, "OperationHours", "ServiceAreas", "price")
- Liens vers les flux de commande en production et en test (restaurants et services uniquement)
États et correction des erreurs
Le tableau suivant décrit les états de diffusion des entités tels qu'ils apparaissent dans l'Aperçu de l'inventaire. Seuls les restaurants et les services ont un état de service.
| État | Description |
|---|---|
| Activé | L'entité peut être diffusée sur les plates-formes Google. |
| Désactivé | L'entité n'est pas diffusée sur Google. Cliquez sur la ligne pour ouvrir la vue détaillée et voir pourquoi elle n'est pas diffusée. |
| En attente | L'entité a été ajoutée dans le flux le plus récent, mais n'est pas encore diffusée. |
| Supprimé | L'entité a été supprimée dans un flux ou une réponse à une requête. Les entités supprimées sont conservées pendant 30 jours. |
La version que vous voyez dans l'Aperçu de l'inventaire peut ne pas être celle qui est diffusée en raison des délais de traitement des entités. Pour en savoir plus, consultez les questions fréquentes.
Si une entité est désactivée, ouvrez la vue détaillée pour afficher le motif de désactivation.
| Motif de la désactivation | Description | Solution |
|---|---|---|
| Menu manquant ou contenant une erreur | L'entité de menu est manquante ou une erreur s'est produite lors de l'ingestion. | Assurez-vous qu'une entité de menu est définie pour le restaurant dans les flux de données. Assurez-vous que les références @id sont correctes. Rechercher les erreurs dans le menu à l'aide de l'outil Inventory Viewer |
| Restaurant manquant ou erreur | L'entité du restaurant est manquante dans les flux ou une erreur s'est produite lors de l'ingestion. | Assurez-vous que l'entité restaurant est définie dans les flux de données. Assurez-vous que les références @id à l'entité restaurant sont correctes. |
| Impossible de trouver un restaurant valide dans la base de données de Google | Cela se produit lorsqu'une entité de restaurant de votre flux de données ne peut pas être mise en correspondance avec un restaurant valide dans la base de données de Google. | Vérifiez si le restaurant existe dans la recherche Google et sur Maps. Si le restaurant n'existe pas, suivez les instructions pour ajouter ou revendiquer votre fiche d'établissement sur Google. Assurez-vous que le nom et l'adresse indiqués dans le fichier de flux de données correspondent exactement à ceux de la fiche de l'établissement. |
| Service manquant ou présentant une erreur | L'entité de service est manquante ou une erreur s'est produite lors de l'ingestion. | Assurez-vous que l'entité de service est définie pour le restaurant dans les flux de données. Assurez-vous que les références @id sont correctes. Utilisez l'outil d'inventaire pour rechercher et corriger les erreurs liées aux entités de service. |
| Désactivé temporairement dans les flux | Le restaurant figure dans les flux de données, mais son service a été désactivé. | Envoyez une mise à jour incrémentielle ou une ingestion par lot pour définir la propriété isDisabled de l'entité de service sur "false". |
| Restaurant désactivé | Le marchand n'est pas activé dans le programme Commande de bout en bout, car il a précédemment choisi de désactiver le bouton "Commander en ligne" en suivant les instructions de la section Configurer, activer ou désactiver le bouton "Commander en ligne". | Contactez votre restaurant et demandez-lui d'activer le bouton "Commander en ligne" en suivant ces instructions : Configurer, activer ou désactiver le bouton "Commander en ligne". |
| Le restaurant a désactivé le fournisseur | Le marchand a désactivé la commande en ligne en suivant les instructions de la section Configurer, activer ou désactiver le bouton "Commander en ligne" dans le menu "Commande de bout en bout", car il a indiqué qu'il n'avait pas de relation commerciale avec vous. | Contactez votre marchand et demandez-lui d'activer le bouton "Commander en ligne" pour le fournisseur à l'aide du formulaire de contact. |
| Établissement marqué comme fermé sur Google (fermé définitivement) | L'établissement apparaît comme fermé définitivement dans la fiche info Google. | Les marchands peuvent suivre les instructions de Définir des horaires d'ouverture ou indiquer une fermeture pour indiquer que l'établissement a rouvert dans sa fiche d'établissement. |
| Établissement marqué comme fermé sur Google – Fermé temporairement | L'établissement apparaît comme définitivement ou temporairement fermé dans le Knowledge Panel de Google. | Les marchands peuvent suivre les instructions de Définir des horaires d'ouverture ou indiquer une fermeture pour indiquer que l'établissement a rouvert dans sa fiche d'établissement. |
| Restaurants en double | Cela signifie que plusieurs entités de restaurant de vos flux de données sont associées au même restaurant dans la base de données de Google. | Supprimez les entités de restaurant en double de vos flux de données. Si un même restaurant possède plusieurs établissements dans un même complexe (centre commercial, aéroport ou centre commercial), ou à proximité les uns des autres, assurez-vous que chacun dispose d'une adresse distincte dans la fiche d'établissement Google (instructions) et qu'il correspond à une seule entité dans les flux de données. |
| Services en double | Cela signifie que plusieurs services du même type (livraison ou à emporter) de vos flux de données sont associés au même restaurant dans la base de données de Google. Exemple: Deux entités de service de livraison sont configurées pour le même restaurant dans vos flux de données. | Mettez à jour vos flux de données pour vous assurer qu'il n'y a pas de service de livraison ou de vente à emporter en double pour chaque restaurant. |
Entités supprimées
Pour les entités Restaurant et Service qui ont été supprimées, la colonne "État" indique "État supprimé". Pour tous les autres types d'entités, la vue Liste contient une colonne "État de suppression" dont la valeur est "Supprimé" ou "Non supprimé". Les entités supprimées sont conservées pendant 30 jours après les événements de suppression. Le Visionneuse d'inventaire ne dispose pas d'informations complètes sur les entités supprimées, et des champs tels que "Nom" s'affichent comme "Inconnu".
Questions fréquentes
Le rapport "Aperçu de l'inventaire" remplace-t-il le rapport "État du restaurant" ?
Non. Le rapport sur l'état des restaurants continuera d'exister et fournira une vue agrégée des états de service.
Quelle est la latence des données qui s'affichent dans l'outil Inventory Viewer ?
La latence des données dans l'Aperçu de l'inventaire suit le temps d'ingestion et de traitement. Pour les données fournies dans des flux par lot, la latence peut aller jusqu'à deux heures à partir du moment où l'ingestion est réussie. Pour les RTU, il est inférieur à cinq minutes. Une ingestion réussie signifie que:
- Le flux contenant l'entité affiche l'état "Success" (Succès) sur l'écran Ingestion History (Historique d'ingestion).
- La RTU qui contenait l'entité ne comporte aucune erreur de validation au niveau de la requête ou de l'entité, comme indiqué dans les rapports RTU.
Le Lecteur d'inventaire est-il compatible avec Quicktesting ?
Non. Inventory Viewer n'est compatible qu'avec les environnements de production et de bac à sable.
J'ai corrigé le problème qui empêchait la diffusion d'un restaurant, mais il est toujours indiqué comme "Désactivé" dans l'Aperçu de l'inventaire.
L'intégration des données via des flux par lot peut prendre jusqu'à deux heures à partir du moment où elle a réussi, ou cinq minutes pour que les RTU soient reflétées dans le parcours de commande des consommateurs. Pour en savoir plus sur la latence, consultez les questions fréquentes. L'état de diffusion est à jour dans l'Aperçu de l'inventaire. Par conséquent, lorsqu'une entité modifie l'état de diffusion dans l'UI grand public, il est reflété presque instantanément dans l'Aperçu de l'inventaire.
Date et heure de la dernière modification et de l'indexation
L'Aperçu de l'inventaire affiche toujours la dernière version ingérée d'une entité. Toutefois, une fois l'ingestion terminée, mais avant que l'UI du consommateur n'ait été mise à jour avec la dernière version, la version de la diffusion de l'entité ne correspondra pas à la version qui vient d'être ingérée et qui s'affiche dans l'Aperçu de l'inventaire. Cela est dû au temps de traitement dans le pipeline de diffusion. L'heure d'indexation correspond au moment où les données reçues via des flux et des RTU ont été synchronisées avec la base de données de diffusion pour être diffusées sur les surfaces grand public. Toute entité dont la date et l'heure de la dernière modification sont antérieures à l'heure d'indexation sera diffusée sur les surfaces grand public.
Par exemple, supposons que vous ajoutiez un service dans des flux qui se terminent à 00:30:00, est indexé à 01:30:00 et commence donc à diffuser à ce moment-là. À 04h00, vous importez un autre flux avec une nouvelle version de ce service avec isDisabled=true. L'ingestion de ce flux se termine à 04h30. Une fois la deuxième ingestion terminée, le Visionneuse d'inventaire affichera le 1er janvier 04:30:00 GMT comme code temporel Dernière modification. Toutefois, jusqu'à ce qu'une opération d'indexation ait lieu, le flux de commande du consommateur continuera de diffuser la version dont l'ingestion s'est terminée à 00:30:00. Imaginons qu'une autre opération d'indexation ait lieu à 04:45:00. À ce stade, l'état de désactivation du service sera mis à jour dans l'interface utilisateur du client et cette entité cessera de s'afficher. Toutefois, pendant toute la période allant de 01:30:00 (première opération d'indexation) à 04:45:00 (deuxième opération d'indexation), l'état de l'entité sera "Activé", car une version précédente de l'entité était diffusée dans l'interface utilisateur du client.