Creare feed
I feed devono essere forniti regolarmente a Google 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 commercianti | Una volta ogni 24 ore |
| Disponibilità | Slot disponibili per i servizi forniti dai commercianti. È necessario fornire una copertura di almeno 30 giorni. | Una volta ogni 24 ore |
In ogni feed, includi metadati che indichino a Google come interpretarli.
Il formato dei feed viene descritto con la sintassi del buffer di protocollo 3, ma puoi caricare i tuoi feed come formato JSON corrispondente. Fai riferimento agli esempi di feed per vedere il formato JSON. Ti consigliamo di caricare i feed in formato JSON.
Dimensioni del file del feed, partizionamento orizzontale e compressione
Guarda i seguenti tutorial relativi alla compressione e agli shard:Per determinare le dimensioni dei feed, attieniti alle seguenti linee guida (un feed può essere costituito da più file denominati "shard"):
- Partizionamento orizzontale del feed suggerito:
- Feed dei commercianti: 1 shard
- Feed dei servizi: 1 shard
- Feed di disponibilità : meno di 20 shard
- Dimensioni dei file del feed e partizionamento orizzontale:
- Mantieni le dimensioni del file shard al di sotto di 200 MB (dopo la compressione). Se necessario, utilizza più shard.
- I singoli record inviati in uno shard non devono essere inviati nello stesso shard nei feed futuri.
- Per ottenere prestazioni migliori, suddividi i dati in modo uniforme tra gli shard in modo da rendere tutti i file shard simili di dimensioni.
- Se necessario, utilizza gzip per comprimere feed JSON in testo normale. Tuttavia, ripeti l'operazione per ogni singolo shard del feed.
Carica i feed sulla tua casella personale SFTP
Carica i tuoi feed nell'ambiente sandbox. Per farlo, fai riferimento ai nomi utente nella pagina di configurazione del feed del Portale partner. Il server SFTP di Google è disponibile all'indirizzo sftp://partnerupload.google.com sulla porta 19321.
Ti consigliamo di assegnare nomi univoci ai file da caricare. Ad esempio, può essere utile aggiungere un timestamp a ogni nome file. Ciò consente di risolvere i problemi ed eseguire query sullo stato dei feed.
Verifica che i dati siano corretti
Accedi al Portale partner. Passa all'ambiente Sandbox per trovare le pagine seguenti nella sezione Dashboard.
- Feed
- Mostra le statistiche di riepilogo dei 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 del feed. Dopodiché controlla la pagina Riepilogo dell'inventario per verificare la presenza di eventuali problemi relativi ai dati. I problemi comuni includono il caricamento di commercianti senza alcun servizio o il caricamento di servizi senza slot di disponibilità in futuro.
Il frontend della sandbox, che emula l'esperienza dell'interfaccia utente dal vivo, mostra l'aspetto dei dati dal punto di vista dell'utente. Per accedervi, assicurati che il selettore di ambiente in alto sia impostato su Sandbox e vai a Inventario > Inventario , trova un commerciante "Pronto" o "Attivo (in Sandbox)", quindi fai clic sul link nella colonna più a destra (se disponibile) oppure fai clic sulla riga e poi sul link "RwG - E2E". Se non è presente alcun commerciante con lo stato "Pronto" o "Attivo (in sandbox)", apri un commerciante disattivato e assicurati di risolvere tutti i problemi elencati a destra (ad esempio assicurandoti 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 questo sia l'unico account a cui hai eseguito l'accesso. Se accedi con un account diverso e utilizzi la funzionalità Cambia utente per accedere all'Account Google approvato, il frontend della sandbox rimarrà bloccato.
Carica i feed in produzione
Dopo aver caricato regolarmente feed completi e senza errori nell'ambiente sandbox, puoi iniziare a caricarli nell'ambiente di produzione. A questo punto, l'integrazione non sarà attiva.
Carica un feed commerciante completo appena possibile (almeno una settimana prima del lancio) in modo da poter iniziare ad associare i tuoi commercianti a una scheda di attività commerciale su Google. Verifica che la corrispondenza sia corretta.
Quando tutti i dati del feed di produzione vengono caricati in modo coerente e collegati al tuo sistema di produzione, i tuoi feed sono pronti per la revisione.
Google valuta i feed
Una volta caricati i feed, Google li elabora e li valuta per verificarne la qualità e la completezza. Esaminiamo i seguenti fattori:
- I feed devono corrispondere 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.
- Verifichiamo quanti dei servizi hanno slot di disponibilità aperti per i prossimi 1-30 giorni.
- Verifichiamo quanti dei commercianti forniti possono essere abbinati a funzionalità su Google Maps.