Il feed è l'origine dati principale che Google utilizza per accedere ai tuoi veicoli e visualizzarli. Al momento supportiamo i feed nel formato file CSV, che puoi eventualmente comprimere 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 in 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. In un secondo momento, potrai eseguire lo scaling per includere tutto il tuo inventario su Google.
Assicurati di includere i seguenti dettagli nel feed per consentirci di associare con precisione i veicoli ai concessionari di auto su Google:
- Obbligatorio: codice negozio
- Per maggiori dettagli, vedi Corrispondenza con i concessionari.
- Obbligatorio: nome e indirizzo postale del concessionario
- Consigliato: ID luogo di Google o URL di Maps
- Questi identificano in modo univoco il profilo dell'attività del concessionario su Google erimuovono 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 virgole (CSV) o valori delimitati da tabulazioni (TSV). Assicurati che il file soddisfi i seguenti requisiti:
- Il formato CSV deve essere conforme alla specifica RFC 4180:
- Non includere virgolette doppie in nessun punto del file, a meno che non siano inserite con un carattere di escape.
- Per eseguire l'interpretazione letterale di una virgola doppia, utilizza due virgolette doppie e inoltre chiude l'intero campo CSV tra virgolette doppie. Per maggiori dettagli, consulta le sezioni 2.5-2.7 della RFC 4180.
- Un esempio di utilizzo valido delle virgolette doppie è
"Wheels 17"" Alloy", che viene visualizzato comeWheels 17" Alloy.
- Non includere virgolette doppie in nessun punto del file, a meno che non siano inserite con un carattere di escape.
- Se vuoi, puoi comprimere il file con i formati ZIP o GZ.
- Il feed deve contenere un solo file. Non supportiamo l'utilizzo di più frammenti di file, chiamato anche sharding.
- Ogni versione del feed deve contenere l'intero inventario di tutti i concessionari che vuoi mostrare su Google. Poiché ogni file del feed contiene l'inventario di tutti i tuoi concessionari, non devi creare account separati per ogni concessionario. Una volta elaborato il feed, i veicoli verranno raggruppati per concessionario nella pagina di diagnostica del portale partner.
- Non supportiamo gli aggiornamenti dell'inventario parziali (incrementali).
Feed di esempio
Il seguente feed CSV di esempio 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"
Carica il feed nella tua casella personale SFTP
Quando registri il tuo account per le schede di veicoli, viene creata automaticamente una casella personale SFTP. Utilizza le informazioni SFTP fornite nella pagina Feed del portale partner per caricare i file CSV.
Esistono diversi metodi per caricare un file con SFTP. I modi più comuni sono l'utilizzo della riga di comando (Terminale) o di un programma SFTP. Il metodo migliore per te dipende da come gestisci l'inventario. Pertanto, non forniamo istruzioni specifiche su come esportare e caricare i veicoli sul server SFTP di Google.
Per ridurre al minimo i ritardi dovuti al modo in cui Google elabora il tuo feed, ti consigliamo di procedere come segue:
- Assicurati 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.
- Carica l'intero inventario per ogni concessionario 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 del portale partner mostra lo stato di ogni caricamento del feed. Verranno controllati solo i problemi di base relativi a file e dati, ad esempio campi obbligatori mancanti o formattazione errata. I risultati completi dell'elaborazione diventano disponibili nella pagina Diagnostica dopo alcune ore.
Gestire il feed
Ti consigliamo di caricare la versione più recente del feed ogni quattro ore. Esistono due motivi principali per cui ti consigliamo di aggiornare il feed così spesso:
- Caricamenti dei feed più frequenti aumentano l'aggiornamento complessivo dei dati. In questo modo si riduce il tempo che intercorre tra l'aggiornamento dell'inventario e l'invio dei dati a Google.
- Aggiornamenti frequenti consentono di rilevare e recuperare più rapidamente gli arresti anomali che potrebbero causare l'elaborazione non riuscita di un feed.
Ogni volta che carichi il feed, assicurati che contenga l'intero inventario di tutti i concessionari. I veicoli e i concessionari che non sono presenti in un feed vengono rimossi da Google entro poche ore.
Dopo aver caricato un feed su Google, il tempo necessario per aggiornare i dati dipende dal tipo di aggiornamento. I numeri riportati nella tabella seguente sono stime e non sono garantiti.
| Modifica del feed | Tempo di aggiornamento previsto su Google |
|---|---|
| Aggiungere un nuovo concessionario | 1 giorno |
| Rimuovere un concessionario | 6 ore |
| Modificare il profilo dell'attività di una concessionaria | 12 ore |
| Aggiungere, rimuovere o aggiornare un'auto | 6 ore |
Iscriverti agli avvisi relativi ai feed
Puoi ricevere una notifica via email quando Google non ha ricevuto un feed o quando il feed non è stato elaborato correttamente per più di 24 ore. Vai alla pagina Account del portale partner e aggiungi un nuovo indirizzo email di contatto su cui vuoi ricevere questi avvisi relativi ai feed.