Passaggio 2: feed

Devi prima creare i feed, poi Google li valuta.

Creare feed

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

    • Feed dei commercianti:il feed dei commercianti descrive i tuoi commercianti e i link alle azioni a livello di commerciante.
    • Feed dei servizi (facoltativo / non consigliato): non è consigliabile implementare i feed dei servizi per le nuove integrazioni di Business Link per gli ordini di vendita al dettaglio. Se vuoi mantenere l'integrazione esistente, segui questa documentazione precedente.

    Campi obbligatori e consigliati

    Feed Nome campo Descrizione Obbligatorio?
    Commerciante merchant_id Identificatore univoco del commerciante
    Commerciante nome Nome del commerciante
    Commerciante geo Indirizzo e coordinate geografiche del commerciante
    Commerciante telefono Numero di telefono del commerciante
    Commerciante category Tipo di luogo del commerciante Consigliabili
    Commerciante action_link Informazioni sui link diretti specifici del commerciante
    Commerciante action_link_type
    Commerciante brand_id Stringa che identifica il brand rivolto ai consumatori da utilizzare Facoltativo

    Per iniziare, dai un'occhiata ai feed di esempio

    Puoi scoprire di più su come specificare i link di azioni nei feed di integrazione di Business Link per gli ordini di vendita al dettaglio 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
    }
  2. 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.

  3. 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 porta 19321.

    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 questa integrazione da sola raggiunga il limite di 200 MB.
    • 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.

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 almeno action_link definito.
  • La maggior parte dei dati del commerciante corrisponde alle sedi su Google Maps.