Devi prima creare i feed, poi Google li valuta.
Creare feed
-
Genera i feed. Trasmetti la maggior parte dei dati di inventario a Google tramite feed. Per iniziare, crea due tipi di feed:
- Feed dei commercianti: il feed dei commercianti descrive i tuoi commercianti e i link alle azioni a livello di commerciante.
- Feed di servizi
(facoltativo): il feed di servizi descrive i servizi e i
action_link
livelli di servizio offerti dai tuoi commercianti alla tua piattaforma.
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 Numero di telefono del commerciante Sì Commerciante category Tipo di luogo del commerciante Consigliabili Commerciante action_link Informazioni sui link diretti specifici del commerciante Facoltativo se vengono forniti feed di servizi, obbligatorio in caso contrario Commerciante brand_id Stringa che identifica il brand rivolto ai consumatori da utilizzare Facoltativo Servizi service_id Identificatore univoco del servizio fornito dal commerciante Sì (solo se viene fornito il feed del servizio) Servizi merchant_id Link al commerciante che fornisce questo servizio Sì (solo se viene fornito il feed del servizio) Servizi localized_service_name Nome del servizio fornito Sì (solo se viene fornito il feed del servizio) Servizi localized_description Descrizione del servizio visibile all'utente Facoltativo Servizi action_link Fornisce informazioni sui link diretti relativi al servizio Sì (solo se viene fornito il feed del servizio) Servizi tipo Tipo di link diretto (ad es. SERVICE_TYPE_DINING_RESERVATION) Sì (solo se viene fornito il feed del servizio) Per iniziare, dai un'occhiata ai feed di esempio
- Feed di prenotazione per ristoranti
- Feed di consegna per ordini di cibo
- Feed di ritiro per ordini di cibo
- Feed di ordinazione di cibo con metadati
- Feed ordini per la vendita al dettaglio
- Feed ordini di vendita al dettaglio con metadati
- Feed di appuntamenti di persona
- Feed di appuntamenti online/virtuali
Per i commercianti che offrono più servizi, ma li pubblicano utilizzando un singolo link di azione, devi fornire un singolo link di azione per tutti i servizi associati a un commerciante nel feed dei commercianti.
Scopri di più su come specificare i link di azioni nei feed di integrazione iniziale legacy qui.
Includi metadati del feed in ogni 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 }
-
Esporta i tuoi feed. Il formato dei feed è descritto con la sintassi di Protocol Buffer 3, ma puoi fare riferimento agli esempi sopra indicati per visualizzare 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 Nozioni di base sui buffer di protocollo: Java.
-
Carica i feed nella tua casella personale SFTP. Per caricare i feed, utilizza le informazioni del dropbox SFTP che ti sono state fornite da Google e la chiave privata che hai creato in Configurazione. Il server SFTP di Google è disponibile all'indirizzo
sftp://partnerupload.google.com
sulla porta19321
.Carica i file con nomi univoci, ad esempio un nome che includa un timestamp. I nomi univoci sono utili per la risoluzione dei problemi e consentono di eseguire query sullo stato del feed.
Per determinare le dimensioni dei feed e la frequenza di invio, segui le seguenti linee guida:
- Dimensioni dei file e dei frammenti del feed:
- Mantieni le dimensioni del file del feed inferiori a 200 MB (dopo la compressione). Comprimili utilizzando
gzip
- Se il file potrebbe raggiungere più di 200 MB (dopo la compressione), suddividilo in più shard seguendo il tutorial sullo sharding dei file del feed . Tuttavia, è improbabile che l'integrazione del comando iniziale precedente da sola raggiunga il limite di 200 MB.
- Mantieni le dimensioni del file del feed inferiori a 200 MB (dopo la compressione). Comprimili utilizzando
- Frequenza degli aggiornamenti completi:
- Viene fornito un feed completo del commerciante una volta al giorno.
- (Se implementato) Un feed del servizio completo viene fornito una volta al giorno.
- Dimensioni dei file e dei frammenti del feed:
Google valuta i feed
Una volta caricati, Google li elabora e valuta per verificarne la qualità e la 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 almenoaction_link
definito. - La maggior parte dei dati del commerciante corrisponde alle sedi su Google Maps.