Creare feed
I feed devono essere forniti a Google regolarmente affinché i dati vengano mostrati direttamente su Google. Sono necessari i seguenti feed.
| Feed | Descrizione | Frequenza |
|---|---|---|
| Commercianti | Descrive i tuoi commercianti. | Una volta ogni 24 ore |
| Servizi | Descrive i servizi forniti dai tuoi commercianti | Una volta ogni 24 ore |
| Disponibilità | Spazi disponibili per i servizi offerti dai commercianti. È necessario fornire una copertura minima di 30 giorni. | Una volta ogni 24 ore |
In ogni feed, includi metadati che indicano a Google come interpretarlo.
Il formato dei feed è descritto con la sintassi di Protocol Buffer 3, ma puoi caricare i feed nel formato JSON corrispondente. Consulta i Sample di feed per visualizzare il formato JSON. Ti consigliamo di caricare i feed in formato JSON.
Dimensioni, suddivisione e compressione dei file del feed
Guarda i seguenti tutorial sulla compressione e sui frammenti:Per determinare le dimensioni dei feed, segui le linee guida riportate di seguito (un feed può essere costituito da più file chiamati "shard"):
- Sharding del feed suggerito:
- Feed dei commercianti: 1 shard
- Feed di servizi: 1 shard
- Feed di disponibilità : meno di 20 shard
- Dimensioni dei file del feed e suddivisione in parti:
- Mantieni le dimensioni del file del frammento inferiori a 200 MB (dopo la compressione). Utilizza più shard, se necessario.
- I singoli record inviati in uno shard non devono essere inviati nello stesso shard nei feed futuri.
- Per migliorare le prestazioni, suddividi i dati in modo uniforme tra gli shard in modo che tutti i file degli shard abbiano dimensioni simili.
- Se necessario, utilizza gzip per comprimere i feed JSON in testo normale. Tuttavia, fai così per ogni singolo shard del feed.
Carica i feed nella tua casella personale SFTP
Carica i feed nell'ambiente sandbox. Per farlo, consulta i nomi utente nella pagina Configurazione del feed del Partner Portal. Il server SFTP di Google è disponibile all'indirizzo sftp://partnerupload.google.com sulla porta 19321.
Ti consigliamo di assegnare nomi univoci ai file che carichi. Ad esempio, può essere utile aggiungere a ciascun nome file un timestamp. In questo modo puoi risolvere i problemi e eseguire query sullo stato del feed.
Verifica che i dati siano corretti
Accedi al Partner Portal. Passa all'ambiente Sandbox per trovare le seguenti pagine nella sezione Dashboard.
- Feed
- Mostra le statistiche di riepilogo del feed e segnala gli errori durante il caricamento del feed.
Per verificare che i dati siano corretti dopo il caricamento iniziale nell'ambiente sandbox, controlla la pagina Feed per verificare la presenza di eventuali errori. Quindi, controlla la pagina Riepilogo inventario per verificare la presenza di eventuali problemi con i dati. I problemi comuni includono il caricamento di commercianti senza servizi o il caricamento di servizi senza slot di disponibilità futuri.
Il frontend della sandbox, che emula l'esperienza utente in tempo reale, mostra l'aspetto dei dati dal punto di vista dell'utente. Per accedervi, assicurati che il pulsante di commutazione dell'ambiente in alto sia impostato su Sandbox e vai a Inventario > Inventario , trova un commerciante con stato "Pronto" o "Pubblicato (in sandbox)", quindi fai clic sul link corrispondente nella colonna più a destra (se disponibile) o sulla riga e poi sul link "RwG - E2E". Se non è presente alcun commerciante con stato "Pronto" o "Pubblicato (in sandbox)", apri un commerciante disattivato e assicurati di risolvere tutti i problemi elencati a destra (ad esempio, assicurati che la disponibilità futura sia stata caricata).
Se non riesci ad accedere al frontend della sandbox, verifica di aver eseguito l'accesso con un account a cui è stato concesso l'accesso al frontend. Assicurati inoltre che sia l'unico account a cui hai eseguito l'accesso. Se accedi con un account diverso e poi utilizzi la funzionalità Cambia utente per accedere all'Account Google approvato, l'accesso all'interfaccia frontend della sandbox rimane bloccato.
Caricare i feed in produzione
Quando sarai in grado di caricare in modo coerente feed completi e privi di errori nell'ambiente sandbox, potrai iniziare a caricarli nell'ambiente di produzione. A questo punto, l'integrazione non sarà attiva.
Carica un feed dei commercianti completo il prima possibile (almeno 1 settimana prima del lancio), in modo da poter iniziare ad associare i tuoi commercianti a una scheda della tua attività su Google. Verifica la correttezza della corrispondenza.
Una volta che tutti i dati dei feed di produzione vengono caricati in modo coerente e collegati al sistema di produzione, i feed sono pronti per la revisione.
Google valuta i feed
Una volta caricati, Google li elabora e valuta per verificarne la qualità e la completezza. Prendiamo in considerazione i seguenti fattori:
- I feed corrispondono alla specifica del feed.
- I feed includono tutti i campi obbligatori.
- Il numero totale di commercianti nei feed corrisponde al numero discusso con Google.
- Per ogni commerciante è definito almeno un servizio.
- Il numero totale di servizi nei feed corrisponde al numero discusso con Google.
- Controlliamo quanti servizi hanno disponibilità per i prossimi 1-30 giorni. .
- Controlliamo quanti commercianti forniti possono essere abbinati alle funzionalità su Google Maps.