Passaggio 2: feed

Per prima cosa devi creare i feed, poi Google li valuta.

Creare feed

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

   • Feed dei commercianti:il feed dei commercianti descrive i tuoi commercianti e i link di azione a livello di commerciante.
   • Feed dei servizi (facoltativo / non consigliato): Non è consigliabile implementare i feed dei servizi per le nuove integrazioni di link dell'attività di prenotazioni. Se vuoi mantenere l'integrazione esistente, segui questa documentazione legacy.

   Campi obbligatori e consigliati

   Feed	Nome campo	Descrizione	Obbligatorio?
   Commerciante	merchant_id	Identificatore univoco del commerciante	Sì
   Commerciante	nome	Nome del commerciante	Sì
   Commerciante	geo	Indirizzo e coordinate geografiche del commerciante	Sì
   Commerciante	telefono	Telefono del commerciante	Sì
   Commerciante	category	Tipo di luogo del commerciante	Consigliabili
   Commerciante	action_link	Informazioni sui link diretti specifici del commerciante	Sì
   Commerciante	action_link_type	Tipo di azione del link. I partner di Link dell'attività per prenotazioni devono utilizzare ACTION_LINK_TYPE_MAKE_DINING_RESERVATION.
   Commerciante	brand_id	Stringa che identifica il brand rivolto ai consumatori 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 prenotazioni per ristoranti

   Puoi scoprire di più su come specificare i link di azione nei feed di integrazione di Business Link per le prenotazioni qui.

   Includi i metadati del feed in ciascun feed per indicare a Google come interpretarlo.

   Di seguito è riportato uno snippet dei metadati del feed:

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

   Nota:tutti i feed devono essere caricati con l'istruzione di elaborazione PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL è ritirato e non può essere utilizzato.
   Nota:questa integrazione può essere implementata anche in combinazione con l'integrazione end-to-end di Actions Center o come componente aggiuntivo dell'integrazione end-to-end. Per supportare questa funzionalità, dovrai anche implementare i feed di disponibilità e i campi obbligatori dell'integrazione end-to-end come indicato in questa guida.

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

   Se vuoi davvero procedere con il formato pb3, per informazioni generali su come utilizzare i buffer di protocollo per generare un file pb3, consulta Nozioni di base sui buffer di protocollo: Java.

3. Carica i feed sul server SFTP. Per caricare i feed, utilizza le informazioni sul server SFTP che Google ti ha fornito e la chiave privata che hai creato nella 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 aiutano a risolvere i problemi e consentono di eseguire query sullo stato del feed.

   Per determinare le dimensioni 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). Comprimili utilizzando gzip
     • Se il file potrebbe raggiungere più di 200 MB (dopo la compressione), dividilo in più shard seguendo il tutorial Suddividere i file del feed in shard . Tuttavia, questa integrazione da sola difficilmente raggiungerà il limite di 200 MB.
   • Frequenza degli aggiornamenti completi:
     • Un feed commerciante completo viene fornito una volta al giorno.
     • (Se implementato) Un feed di servizi completo viene fornito una volta al giorno.
   Nota:Google elabora i file di feed non appena vengono caricati sul server SFTP. Se il feed è suddiviso in più file, l'elaborazione inizia dopo il caricamento dell'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 elabora e li valuta in termini di qualità e completezza. Prendiamo in considerazione 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 definito.
• La maggior parte dei dati del commerciante corrisponde alle località di Google Maps.

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