Panoramica

Nota: compila questo modulo se ti interessa attivare i menu per l'integrazione end-to-end esistente delle prenotazioni.

I partner di Google possono fornire a Google dati strutturati per il menu tramite l'integrazione end-to-end per le prenotazioni, da utilizzare nella sezione Menu della scheda del ristorante su Google Maps Mobile (Android e iOS).

I dati del menu vengono importati utilizzando i feed generici. Prima di iniziare, dedica qualche minuto per assicurarti di aver completato i passaggi per la creazione dell'account e leggi l'articolo Utilizzo della casella personale del feed generico per una panoramica della procedura di caricamento dei feed generici e una spiegazione su come configurare il tuo account per i caricamenti di feed generici.

Creare e caricare feed menu

Quando crei e carichi feed menu, tieni presente quanto segue:

• Segui la specifica dei dati descritta nel feed dei menu per generare i file di dati del menu. I nomi dei file dei dati del menu devono essere univoci tra un caricamento e l'altro. Ti consigliamo di includere un timestamp nel nome file, ad esempio menu1_1633621547.json.
• Nel descrittore del set di file, imposta il campo name su google.food_menu. Per un esempio dei contenuti del file descrittore, consulta l'esempio di file JSON descrittore. I nomi dei file descrittori devono essere univoci tra un caricamento e l'altro. Ti consigliamo di includere un timestamp nel nome del file, ad esempio descriptor_1633621547.filesetdesc.json. Il file descrittore deve essere caricato nella casella personale SFTP generica all'interno del feed del menu.
• I feed di menu devono essere caricati nella casella personale SFTP generica ogni giorno per gli aggiornamenti completi.
• Puoi trovare le informazioni relative alla casella personale SFTP nella sezione Configurazione > Feed del Portale partner.



Figura 1: Informazioni generiche sulla casella personale SFTP

Utilizzare le opzioni delle voci di menu

Le opzioni delle voci di menu possono essere specificate utilizzando il protocollo MenuItemOption. Le opzioni delle voci di menu vengono visualizzate sotto forma di elenco semplice sotto la voce di menu. Vedi l'esempio di seguito.

Figura 2: Bastoncini di pane e salsa hanno due opzioni di menu: Sm e Lg

Sono supportate solo le opzioni di voce di menu obbligatorie. Un'opzione obbligatoria della voce di menu è un'opzione che il cliente deve scegliere al momento dell'ordine. Ad esempio, quando si ordina una pizza, è obbligatorio specificare le dimensioni. Le opzioni facoltative delle voci di menu (ad es. "l'opzione per aggiungere l'avocado") non sono supportate.

Poiché le opzioni delle voci di menu vengono visualizzate come un unico elenco semplice, i partner con più insiemi di opzioni obbligatorie per una singola voce di menu (ad esempio un latte macchiato con opzioni di dimensioni e opzioni per il latte) devono decidere come visualizzare meglio queste opzioni su Google. Google consiglia le seguenti euristiche:

• Se solo un insieme di opzioni obbligatorie influisce sul prezzo, è preferibile includerlo nei feed.
• In tutti gli altri casi, spetta al partner determinare il modo migliore per rappresentare le opzioni della voce di menu. Non è consigliabile creare lunghi elenchi di opzioni per tutte le possibili combinazioni di opzioni.

Quando includi opzioni delle voci di menu in una voce di menu:

• La voce di menu deve avere almeno un'offerta con un prezzo (per i casi in cui le opzioni della voce di menu non influiscono sul prezzo).
• La voce di menu deve avere una serie di opzioni, ciascuna con prezzo uguale al prezzo totale dell'articolo con questa opzione selezionata.

Il prezzo deve essere indicato solo per la voce del menu o per le sue opzioni, ma non per entrambe.

Come visualizzare il menù

Nota: il menu del tuo feed potrebbe non essere visualizzato per un ristorante se esistono più fornitori di menu per quel ristorante.

Una volta lanciati i feed del menu, i relativi dati potrebbero essere visibili nella scheda "Menu" del ristorante. Se più fonti forniscono i menu per lo stesso ristorante, il commerciante può scegliere un fornitore preferito nell'editor del menu di Profilo dell'attività su Google. Per saperne di più su come un commerciante può selezionare un fornitore di menu preferito, consulta la pagina Gestire il menu.

Le seguenti piattaforme Google mostrano la scheda "Menu" nella scheda:

Prodotto	Dispositivo
Ricerca Google	Web mobile
Ricerca Google	Nativo per dispositivi mobili
Google Maps	Nativo per dispositivi mobili

I nostri nuovi menu visivi sono visualizzabili nella Ricerca Google per dispositivi mobili e l'esperienza verrà estesa ad altre piattaforme, inclusi computer e Google Maps.

Figura 3: Un esempio di come vengono visualizzati i contenuti del feed del menu.

Per eseguire il test su computer, utilizza gli strumenti per sviluppatori del browser per simulare un dispositivo mobile.

1. Nella Visualizzazione inventario, seleziona il commerciante e fai clic sul link della scheda per visualizzare la scheda del ristorante.
2. Apri Strumenti per sviluppatori di Chrome (fai clic con il pulsante destro del mouse su Ispeziona o Visualizza -> Sviluppatore -> Strumenti per sviluppatori), seleziona il tipo di dispositivo mobile e aggiorna la pagina.

Best practice

Di seguito sono riportate le best practice da seguire per sviluppare i feed del menù.

• Associare un solo menu a un ristorante.
• Specifica la lingua preferita come prima lingua nel campo TextField. Se invii più oggetti LocalizedText, al momento viene mostrato agli utenti solo il primo oggetto dell'elenco di testo.
• Tutte le voci di menu devono essere aggiunte alle sezioni di menu, non aggiungere voci di menu direttamente all'oggetto del menu.
• Fornisci i contenuti utilizzando la codifica utf-8. Non è necessario utilizzare l'escape dei caratteri non ASCII.
• Limita i file di feed o gli shard a 1000,come indicato in Utilizzare la casella personale del feed generico.