Feed di base (legacy)

Per prima cosa devi creare i feed, poi Google li valuta.

Creare feed

  1. Genera i feed. Devi trasmettere la maggior parte dei dati di inventario a Google tramite i feed. Per iniziare, crea due tipi di feed:

    • Feed dei commercianti: il feed dei commercianti descrive i link alle azioni a livello di commerciante e di commerciante.
    • Feed dei servizi (facoltativo): il feed dei servizi descrive i servizi e i livelli di servizio action_link che i commercianti forniscono alla tua piattaforma.

    Campi obbligatori e consigliati

    Feed Nome campo Descrizione Campo 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 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 servizio, altrimenti obbligatorio
    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 di servizio)
    Servizi merchant_id Link al commerciante che fornisce questo servizio Sì (solo se viene fornito il feed di servizio)
    Servizi localized_service_name Nome del servizio fornito Sì (solo se viene fornito il feed di servizio)
    Servizi localized_description Descrizione del servizio visibile all'utente Facoltativo
    Servizi action_link Fornisce informazioni sui link diretti correlati al servizio Sì (solo se viene fornito il feed di servizio)
    Servizi digita Tipo di link diretto (ad es. SERVICE_TYPE_DINING_RESERVATION) Sì (solo se viene fornito il feed di servizio)

    Per iniziare, consulta i feed di esempio

    Per i commercianti che hanno più servizi, ma li pubblicano utilizzando un singolo link di azione, dovresti fornire un link di un'unica azione per tutti i servizi associati a un commerciante nel feed dei commercianti.

    Scopri di più su come specificare i link di azione nei feed di integrazione iniziale legacy qui.

    Includi in ogni feed i metadati del feed per indicare a Google come interpretare il feed.

    Di seguito è riportato uno snippet dei metadati del feed:

    "metadata": {
 "generation_timestamp": "1467993600",
 "processing_instruction": "PROCESS_AS_COMPLETE",
 "total_shards": 1
}

  2. Esporta i feed. Il formato dei feed è descritto con la sintassi del buffer di protocollo 3, tuttavia puoi fare riferimento agli esempi sopra menzionati per vedere 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 Informazioni di base sul buffer di protocollo: Java.

  3. Carica i feed nella tua casella personale SFTP. Per caricare i tuoi feed, utilizza le informazioni della casella personale SFTP che Google ti ha fornito e la chiave privata che hai creato nella 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 include un timestamp. I nomi univoci sono utili per la risoluzione dei problemi e consentono l'esecuzione di query sullo stato dei feed.

    Per determinare le dimensioni dei feed e la frequenza di consegna, segui le seguenti linee guida:

    • Dimensioni dei file e degli shard del feed:
      • Mantieni le dimensioni del file del feed al di sotto di 200 MB (dopo la compressione). Comprimili utilizzando gzip
      • Se dopo la compressione il file può raggiungere più di 200 MB (dopo la compressione), suddividilo in più shard seguendo il tutorial sullo suddivisione dei file del feed . Tuttavia, è improbabile che l'integrazione iniziale con la versione precedente raggiunga il limite di 200 MB.
    • Frequenza degli aggiornamenti completi:
      • Un feed commerciante completo viene fornito una volta al giorno.
      • (Se implementato) Viene fornito un feed di servizio completo una volta al giorno.

Google valuta i feed

Una volta caricati i feed, Google li elabora e li valuta per verificarne la qualità e la completezza. Esaminiamo diversi fattori:

  • I feed sono conformi alle specifiche.
  • I feed includono tutti i campi obbligatori.
  • Ogni commerciante ha almeno un action_link o un servizio con almeno action_link definiti.
  • La maggior parte dei tuoi dati del commerciante corrisponde alle località di Google Maps.