Il feed è l'origine dati principale che Google utilizza per accedere ai tuoi veicoli e visualizzarli. Al momento supportiamo i feed in formato di file CSV, che puoi comprimere facoltativamente con i formati ZIP o GZ.
Creare un feed
Per formattare le informazioni per il servizio di schede di veicoli, utilizza il formato descritto in Formato del feed, gli attributi forniti nella specifica del feed e il nostro feed di esempio. Ti consigliamo di iniziare con alcuni veicoli di prova e di inviare un file CSV di esempio allo strumento di convalida per convalidare il formato del feed. Potrai scalare in un secondo momento per includere tutto il tuo inventario su Google.
Assicurati di includere i seguenti dettagli nel feed per consentirci di associare con precisione i veicoli alle concessionarie di automobili su Google:
- Obbligatorio: codice negozio
- Per maggiori dettagli, consulta la sezione Corrispondenza Dealership.
- Obbligatorio: nome e indirizzo postale della concessionaria
- Consigliato: ID luogo Google o URL di Maps
- Questi codici identificano in modo univoco il profilo dell'attività della concessionaria su Google e rimuovono qualsiasi ambiguità rispetto alle corrispondenze che utilizzano il nome e l'indirizzo postale.
Formato del feed
Carica il feed come file con valori separati da virgola (CSV) o con valori separati da tabulazioni (TSV). Assicurati che il file soddisfi i seguenti requisiti:
- Il formato CSV deve essere conforme a RFC 4180:
- Non inserire virgolette doppie in nessun punto del file, a meno che non siano precedute da una sequenza di escape.
- Per utilizzare l'escape di una virgoletta doppia, utilizza due virgolette doppie e racchiudi l'intero campo CSV tra virgolette. Per maggiori dettagli, consulta le sezioni 2.5-2.7 in RFC 4180.
- Un esempio di utilizzo valido delle virgolette doppie è
"Wheels 17"" Alloy", visualizzato comeWheels 17" Alloy.
- Non inserire virgolette doppie in nessun punto del file, a meno che non siano precedute da una sequenza di escape.
- Se vuoi, puoi comprimere il file con i formati file ZIP o GZ.
- Il feed deve contenere un solo file. Non supportiamo l'uso di più frammenti di file, chiamati anche sharding.
- Ogni versione del feed deve contenere l'intero inventario per tutte le concessionarie che vuoi mostrare su Google. Poiché ogni file del feed contiene l'inventario di tutte le tue concessionarie, non devi creare account separati per ogni concessionaria. Una volta elaborato correttamente il feed, i veicoli saranno raggruppati per concessionario nella pagina Diagnostica del portale partner.
- Non supportiamo gli aggiornamenti parziali (incrementali) dell'inventario.
Feed di esempio
Il seguente esempio di feed CSV può essere utilizzato come modello per i tuoi feed:
store_code,id,VIN,year,make,model,trim,exterior_color,interior_color,mileage,condition,price,dealership_name,dealership_address,link,image_link,additional_image_link,vehicle_option,vehicle_fulfillment,legal_disclaimer
123,123,JA4AR3AW8GZ057772,2016,Mitsubishi,Outlander Sport,SE,Silver,Black,90377,Used,13998 USD,Dealer 123,123 Street,http://www.example.com/JA4AR3AW8GZ057772,http://www.image.com/image1,"http://www.image.com/image2, http://www.image.com/image3","Bluetooth,Rear View Camera,Front Seat Heaters,Navigation System",IN_STORE,"Price does not include taxes, fees"
Caricare il feed nella casella personale SFTP
Quando ti registri per creare un account per le schede di veicoli, viene creata automaticamente una casella personale SFTP. Utilizza le informazioni SFTP fornite nella pagina Feed del portale dei partner per caricare i file CSV.
Esistono diversi metodi per caricare un file con SFTP. I modi più comuni sono utilizzare la riga di comando (Terminale) o un programma SFTP. Il metodo più adatto alle tue esigenze dipende da come gestisci il tuo inventario. Pertanto, non forniamo istruzioni specifiche su come esportare e caricare i veicoli sul server SFTP di Google.
Per ridurre al minimo i ritardi nell'elaborazione dei feed da parte di Google, ti consigliamo di procedere nel seguente modo:
- Verifica che il tuo feed superi il nostro strumento di convalida.
- Verifica che i dati del veicolo siano conformi alla specifica del feed e alle nostre norme e limitazioni.
- Invia il feed almeno una volta al giorno.
- Caricare l'intero inventario per ogni concessionaria che vuoi mostrare su Google.
Esaminare i risultati di elaborazione del feed
Dopo aver inviato il feed, puoi esaminare i risultati dell'elaborazione. La pagina Feed sul portale dei partner mostra lo stato di ogni caricamento del feed. Questo controllo controlla solo la presenza di problemi di base relativi ai file e ai dati, come la mancanza di campi obbligatori o una formattazione non corretta. I risultati completi dell'elaborazione sono disponibili nella pagina Diagnostica dopo alcune ore.
Gestisci il tuo feed
Ti consigliamo di caricare la versione più recente del feed ogni quattro ore. Esistono due motivi principali per cui consigliamo di aggiornare il feed spesso:
- Caricamenti più frequenti dei feed aumentano l'aggiornamento complessivo dei dati. Questo riduce il tempo che intercorre tra l'aggiornamento dell'inventario e la pubblicazione dei dati in Google.
- Gli aggiornamenti frequenti consentono un rilevamento e un ripristino più rapidi in caso di interruzioni che potrebbero causare la mancata elaborazione di un feed.
Ogni volta che carichi il feed, assicurati che contenga l'intero inventario per tutte le concessionarie. I veicoli e le concessionarie che non sono presenti in un feed vengono rimossi da Google entro alcune ore.
Dopo aver caricato un feed su Google, il tempo necessario per l'aggiornamento dei dati dipende dal tipo di aggiornamento. I valori nella seguente tabella sono stime e non garantiti.
| Modifica del feed | Orario di aggiornamento previsto su Google |
|---|---|
| Aggiungi una nuova concessionaria | 1 giorno |
| Rimuovere una concessionaria | 6 ore |
| Modificare il profilo dell'attività di una concessionaria | 12 ore |
| Aggiungere, rimuovere o aggiornare un'auto | 6 ore |
Iscriviti agli avvisi del feed
Puoi ricevere una notifica via email quando Google non ha ricevuto un feed o il feed non è stato elaborato correttamente per più di 24 ore. Vai alla pagina Account sul portale dei partner e aggiungi un nuovo indirizzo email di contatto a cui vuoi ricevere questi avvisi sui feed.