Feed

Innanzitutto, devi creare i tuoi feed, dopodiché Google li valuterà.

Creare feed

1. Genera i feed. Trasmetti la maggior parte dei dati di inventario a Google tramite feed. Per iniziare, crea il tuo feed di Merchant Center (e il feed dei servizi, se applicabile):

   • Feed dei commercianti: il feed Merchants descrive i tuoi commercianti e i link alle azioni a livello di commerciante.
   • Feed dei servizi (facoltativo / sconsigliato): sconsigliamo di implementare i feed dei servizi per le nuove integrazioni di base. Se stai cercando di mantenere l'integrazione esistente, segui questa documentazione precedente.

   Campi obbligatori e consigliati

   Feed	Nome campo	Descrizione	Obbligatoria?
   Merchant Center	merchant_id	Identificatore univoco del commerciante	Sì
   Merchant Center	name	Nome del commerciante	Sì
   Merchant Center	geo	Indirizzo e coordinate geografiche del commerciante	Sì
   Merchant Center	telefono	Telefono del commerciante	Sì
   Merchant Center	category	Tipo di luogo del commerciante	Ottimo
   Merchant Center	link_azione	Informazioni sui link diretti specifici del commerciante	Sì
   Merchant Center	action_link_type [tipo_di_azione]	Tipo di azione di collegamento. I partner di prenotazione di pasti devono utilizzare ACTION_LINK_TYPE_MAKE_DINING_RESERVATION. I partner che ordinano cibo devono consultare la guida all'ordinazione di cibo da asporto o alla consegna a domicilio.	Sì
   Merchant Center	metadati_ordine_cibo	Specifica Tariffe e tempi di evasione per l'ordinazione di cibo.	Consigliati
   Merchant Center	brand_id [id_brand]	Stringa che identifica il brand rivolto al consumatore da utilizzare	Facoltativo

   Nota: tutti i campi aggiuntivi descritti nella sezione di riferimento devono essere ignorati.
   Punto chiave: devi caricare solo il feed del commerciante.

   Per iniziare, dai un'occhiata ai feed di esempio

   • Feed di prenotazione per pasti
   • Feed di consegna degli ordini di cibo
   • Feed di cibo da asporto che ordina
   • Feed degli ordini di cibo con metadati

   Puoi scoprire di più su come specificare i link di azione nei feed di integrazione di Starter qui.

   Includi i metadati dei feed in ciascuno dei feed che indicano a Google come interpretare il feed.

   Di seguito è riportato uno snippet di metadati del feed:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }
   

   Nota: tutti i feed devono essere caricati con Processing_instruction PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL è deprecato e non può essere utilizzato.
   Nota: l'integrazione iniziale può anche essere implementata insieme all'integrazione end-to-end di Prenota con Google o come componente aggiuntivo. A supporto di ciò, dovrai anche implementare i feed di disponibilità e i campi obbligatori di integrazione end-to-end come indicato in questa guida.

2. Esporta i feed. Il formato dei feed è descritto con la sintassi del buffer di protocollo 3, tuttavia puoi fare riferimento agli esempi sopra per vedere il formato JSON. Ti consigliamo di caricare i feed in formato JSON.

   Se vuoi procedere con il formato pb3, per informazioni generali su come utilizzare i buffer di protocollo per generare un file pb3, consulta la pagina Basic Buffer Basics: Java.

3. Carica i feed nella tua casella personale SFTP. Per caricare i feed, utilizza le informazioni sulla casella personale SFTP che Google ha fornito a te e la chiave privata che hai creato in Configurazione. Il server SFTP di Google è disponibile all'indirizzo sftp://partnerupload.google.com sulla porta 19321.

   Carica i file con nomi univoci, ad esempio un nome che includa un timestamp. I nomi univoci contribuiscono alla risoluzione dei problemi e consentono query per lo stato del feed.

   Per determinare la dimensione dei feed e la frequenza di pubblicazione, utilizza le seguenti linee guida:

   • Dimensioni dei file e degli shard del feed:
     • Mantieni le dimensioni del file del feed al di sotto di 200 MB (dopo la compressione). Comprimile utilizzando gzip
     • Se il file può raggiungere più di 200 MB (dopo la compressione), dividilo in più shard seguendo il tutorial Suddivisione dei file di feed . Tuttavia, è improbabile che l'integrazione iniziale raggiunga il limite di 200 MB.
   • Frequenza degli aggiornamenti completi:
     • Viene fornito un feed commerciante completo una volta al giorno.
     • (Se implementato) Un feed di servizio completo viene fornito una volta al giorno.
   Nota: Google elabora i file del feed non appena vengono caricati nella casella personale SFTP. Se il feed è suddiviso in più file, il processo inizia dopo aver caricato l'ultimo file. Se il feed contiene errori, riceverai un'email con i codici di errore del feed.

Google valuta i feed

Una volta caricati i feed, Google li valuta e ne valuta la qualità e la completezza. Consideriamo diversi fattori:

• I feed soddisfano le specifiche.
• I feed includono tutti i campi obbligatori.
• Ogni commerciante ha almeno un action_link o un servizio con almeno action_link definiti.
• La maggior parte dei tuoi dati relativi al commerciante corrisponde alle sedi di Google Maps.

Nota: per garantire un'integrazione senza problemi, esegui una pre-valutazione dei fattori precedenti, ad eccezione dell'ultima, prima di inviare i feed.