Questo articolo illustra la procedura per attivare l'API menu per il tuo account e integrarla. Di seguito è riportata una panoramica dettagliata della procedura di onboarding e dei prerequisiti per il lancio. Fai riferimento a questa pagina quando pianifichi l'impegno di integrazione.
- Configurazione: configurazione dell'account e pianificazione del processo di sviluppo.
- Sviluppo: sviluppo e test dei feed di dati.
- Lancio: valutazione dei dati prima del lancio.
Configurazione
In questa fase è importante verificare che il tuo account nel Partner Portal sia completamente configurato e pronto ad accettare i feed di dati pertinenti per i dati del menu statico. Se hai già un'integrazione di reindirizzamento OwG o RwG attiva a cui aggiungi i metadati dei menu, il tuo account esistente verrà riutilizzato per questa integrazione. In caso di integrazione di OwG Direct su questa piattaforma o di nessuna integrazione, viene creato un nuovo account e i dettagli di accesso vengono condivisi via email.
Accedi al tuo account nel Partner Portal e vai alla pagina di configurazione del dropbox Configurazione > Feed. Esistono due caselle di immissione pertinenti per l'integrazione del feed di dati del menu: Generico e Commercianti. Verifica che in entrambe le caselle personali sia configurata la chiave pubblica SSH. Per ulteriori informazioni su come configurare le chiavi SSH, consulta questa pagina.
La casella generica può accettare vari feed che possono seguire schemi di dati diversi. Il tipo di feed
che accetta i dati dei menu strutturati si chiama google.food_menu e solitamente è attivato per il tuo account per impostazione predefinita all'inizio dell'onboarding. Se provi a inviare un feed e visualizzi questo messaggio di errore:
"Elaborazione del feed non riuscita. Abbiamo riscontrato un problema interno durante l'analisi del tuo feed. "google.food_menu" non è attivato. Correggi e riprova". Contatta il tuo punto di contatto Google per attivare questo tipo di feed.
Infine, vai alla pagina Configurazione > Dati di contatto e assicurati che tutti i tuoi dati di contatto siano aggiornati.
Sviluppo
La fase di sviluppo contiene la parte principale dell'impegno di implementazione: generazione e test dei feed di dati. I feed di dati devono essere creati e inviati ogni giorno alla cassetta degli attrezzi di destinazione. L'elaborazione dei feed inviati nella sandbox dovrebbe iniziare entro un'ora dall'invio. I feed di produzione vengono elaborati una volta al giorno alle 12:00 (fuso orario PST). Viene preso in considerazione solo il feed inviato più di recente. Consulta la specifica e i campioni dei feed di dati quando generi i feed. Sebbene la specifica sia presentata in formato protobuf, consigliamo di caricare i file del feed in formato JSON, perché è più facile risolvere i problemi. Per questo motivo, i samples del feed vengono forniti anche in formato JSON.
Un file del feed di dati può essere testato rapidamente utilizzando lo strumento online di convalida del feed che verifica se il file corrisponde alle specifiche. Lo strumento mostra se il file corrisponde allo schema di dati e, in caso contrario, genera l'elenco degli errori. Per testare un intero feed di dati costituito da più file, caricalo nell'ambiente sandbox e, al termine dell'importazione, controlla i risultati nel Partner Portal. Durante l'importazione del feed vengono applicate regole di convalida aggiuntive per testare alcune logiche aziendali e la qualità dei dati.
Lancio
La fase di lancio può essere avviata al termine di tutte le operazioni di integrazione e quando il feed di produzione riflette correttamente l'intero inventario dei menu dei ristoranti.
Prerequisiti per il lancio
Per il lancio dell'integrazione devono essere soddisfatte le seguenti condizioni:
- I feed di dati vengono elaborati nell'ambiente di produzione senza errori.
- Il feed di dati di produzione contiene l'inventario completo ambito per questa integrazione all'inizio di questa integrazione.
- La maggior parte dei dati del commerciante corrisponde alle sedi su Google Maps.
- I feed di produzione hanno superato la valutazione della qualità dei dati.
- L'integrazione soddisfa tutti i requisiti e le norme dei menu dei ristoranti.
Valutazione dei dati
Dopo l'importazione dei feed di dati di produzione senza errori, potrebbe esserci un processo interno per valutare la qualità dei dati del menu. Lo scopo di questa procedura è trovare incoerenze nella qualità dei dati, ad esempio contenuti non correlati al cibo nelle descrizioni dei piatti, mancata corrispondenza dei nomi dei piatti, dei prezzi e così via. In caso di risultati simili, il feedback verrà condiviso con il team di sviluppo.