Creare feed
I feed devono essere forniti a Google su base regolare affinché i dati vengano mostrati direttamente su Google. Sono necessari i feed seguenti.
| 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 tuoi commercianti. Deve essere fornita una copertura minima di 30 giorni. | Una volta ogni 24 ore |
In ogni feed, includi i metadati che indicano a Google come interpretarli.
Il formato dei feed è descritto con la sintassi del buffer di protocollo 3, ma puoi caricare i 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 per quanto riguarda la compressione e gli shard:Per determinare le dimensioni dei feed, utilizza le seguenti linee guida (un feed può essere costituito da più file denominati "shards"):
- Partizionamento orizzontale del feed consigliato:
- Feed Merchant: 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 di 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 che le dimensioni di tutti i file di shard siano simili.
- Se necessario, utilizza gzip per comprimere i feed JSON in testo normale. Tuttavia, puoi farlo 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 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 i file che carichi con nomi univoci. Ad esempio, può essere utile aggiungere ogni nome file con un timestamp. In questo modo, puoi risolvere i problemi e inviare query per lo stato del feed.
Verifica che i tuoi dati siano corretti
Accedi al Portale partner. Passa all'ambiente Sandbox per trovare le seguenti pagine nella sezione Dashboard.
- Feed
- Mostra le statistiche di riepilogo dei feed e segnala gli errori durante il caricamento del feed.
Per verificare che i tuoi dati siano corretti dopo il caricamento iniziale nell'ambiente sandbox, verifica la presenza di eventuali errori nel feed nella pagina Feed. Controlla poi la pagina Riepilogo dell'inventario per verificare la presenza di eventuali problemi di dati. I problemi più comuni includono il caricamento dei commercianti senza alcun servizio o il caricamento dei servizi senza slot di disponibilità in futuro.
Il frontend della sandbox, che emula l'esperienza dell'UI in tempo reale, mostra l'aspetto dei dati dal punto di vista dell'utente. Per accedervi, assicurati che il selettore dell'ambiente in alto sia impostato su Sandbox e vai a Inventario > Inventario , trova un commerciante che sia "Pronto" o "Pubblicato (in Sandbox)", poi fai clic sul link nella colonna più a destra (se disponibile) oppure fai clic sulla riga "RwG - E2E". Se non c'è alcun commerciante con lo stato "Pronto" o "Pubblicato (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 autorizzato ad accedere al frontend. Assicurati inoltre che questo sia l'unico account a cui hai eseguito l'accesso. Se accedi con un altro account e poi utilizzi la funzionalità Cambia utente per accedere all'Account Google approvato, il tuo accesso al frontend sandbox verrà comunque bloccato.
Caricare i feed in produzione
Una volta che hai caricato in modo coerente feed completi e privi di errori nell'ambiente di sandbox, puoi iniziare a caricarli nell'ambiente di produzione. A questo punto, la tua integrazione non sarà attiva.
Carica un feed commerciante completo non appena possibile (minimo 1 settimana prima del lancio), in modo da poter iniziare ad associare i tuoi commercianti a una scheda dell'attività su Google. Verifica che la corrispondenza sia corretta.
Una volta che tutti i dati del 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 i feed, Google elabora e li valuta la qualità e la completezza. Esaminiamo 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 slot di disponibilità aperti per i prossimi 1-30 giorni .
- Controlliamo quanti commercianti forniti possono essere abbinati a funzionalità su Google Maps.