Riferimento

Questa guida è un riferimento per i formati di elenco e i campi supportati per la creazione di inserzioni per il settore automotive.

Tutti i campi enum non fanno distinzione tra maiuscole e minuscole.

Inserzioni per il settore automotive - Formati di elenco supportati

Fornisci l'elenco nel formato corretto: CSV, TSV o XML. Dopo aver creato il file dell'elenco, devi ospitarlo su un URL per regolari aggiornamenti programmati.

Formato elenco Descrizione e linee guida Elenco di esempio

Formato elenco	Descrizione e linee guida	Elenco di esempio
CSV	Valori separati da virgole. La prima riga indica l'intestazione della colonna. Le righe successive forniscono i valori corrispondenti per ciascuna voce del catalogo. I campi contenenti spazi vuoti o virgole devono essere inclusi fra "virgolette doppie". Le virgolette doppie in un campo con virgolette doppie devono avere come carattere di escape due virgolette doppie consecutive. I campi nidificati o con più valori, ad esempio image, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice "appiattite", etichettate usando una sintassi con percorso JSON. Ad esempio: `(image[0].url`, `image[0].tag[0]`, `image[0].tag[1])` Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file. Consulta Esempio di elenco CSV/TSV, Esempio di indirizzo CSV/TSV.	Scarica > Clic con il tasto destro del mouse > Salva link con nome
TSV	Valori separati da carattere di tabulazione. Consulta le linee guida per il formato CSV. Consulta Esempio di elenco CSV/TSV, Esempio di indirizzo CSV/TSV.	Scarica > Clic con il tasto destro del mouse > Salva link con nome
XML	Formato solitamente generato da sistemi di provider di elenchi automatizzati o server web. Un insieme di nodi XML rappresenta una lista di prodotti e deve iniziare con il tag di dichiarazione `<?xml`. Consulta Esempio di elenco XML.	Scarica > Clic con il tasto destro del mouse > Salva link con nome

CSV

Valori separati da virgole.

La prima riga indica l'intestazione della colonna. Le righe successive forniscono i valori corrispondenti per ciascuna voce del catalogo.
I campi contenenti spazi vuoti o virgole devono essere inclusi fra "virgolette doppie". Le virgolette doppie in un campo con virgolette doppie devono avere come carattere di escape due virgolette doppie consecutive.
I campi nidificati o con più valori, ad esempio image, possono essere rappresentati usando valori con codifica JSON o tramite una serie di colonne a testo semplice "appiattite", etichettate usando una sintassi con percorso JSON. Ad esempio: (image[0].url, image[0].tag[0], image[0].tag[1])
Entrambe le convenzioni possono essere usate in modo intercambiabile all'interno dello stesso file.

Consulta Esempio di elenco CSV/TSV, Esempio di indirizzo CSV/TSV.

Scarica > Clic con il tasto destro del mouse > Salva link con nome

TSV

Valori separati da carattere di tabulazione. Consulta le linee guida per il formato CSV.

Consulta Esempio di elenco CSV/TSV, Esempio di indirizzo CSV/TSV.

Scarica > Clic con il tasto destro del mouse > Salva link con nome

XML

Formato solitamente generato da sistemi di provider di elenchi automatizzati o server web. Un insieme di nodi XML rappresenta una lista di prodotti e deve iniziare con il tag di dichiarazione <?xml.

Consulta Esempio di elenco XML.

Scarica > Clic con il tasto destro del mouse > Salva link con nome

Esempio: file TSV con carattere di tabulazione come delimitatore

vehicle_id title description url make model year mileage.value mileage.unit image[0].url image[0].tag[0] transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude i2 EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test g GE http://www.facebook.com/teapic.jpg Gym AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-02-21  NEW 52.35 42.10

Esempio: elenco con immagini in forma di array

auto_listing_id title description url make model year mileage.value mileage.unit image transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude
"i2" $299 per month for the EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test Endomoto "[{""url"":""https://images.trvl-media.com/hotels/3000000/2260000/2250400/2250336/2250336_1_y.jpg""}]" AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-09-15 NEW 52.35 42.10

Questo elenco di esempio è nel formato XML:

<?xml version="1.0" encoding="UTF-8"?>
<listings>
    <title>Vehicles Feed</title>
    <link rel="self" href="http://www.example.com"/>
    <listing>
      <vehicle_id>SED1234</vehicle_id>
      <title>$299 per month for the EndoHatch GE</title>
      <description>EndoHatch GE. Turbocharged! Gasoline!</description>
      <url>http://www.example.com/test</url>
      <make>Endomoto</make>
      <image>
        <url>http://example.com/some.image_1.jpg</url>
        <tag>Exterior</tag>
      </image>
      <model>EndoHatch</model>
      <year>2017</year>
      <mileage>
        <value>10</value>
        <unit>MI</unit>
      </mileage>
      <drivetrain>FWD</drivetrain>
      <vin>1FADP5AU6DL536022</vin>
      <body_style>SEDAN</body_style>
      <fuel_type>GASOLINE</fuel_type>
      <transmission>AUTOMATIC</transmission>
      <condition>EXCELLENT</condition>
      <price>18000 USD</price>
      <address format="simple">
          <component name="addr1">550 Auto Center Dr</component>
          <component name="city">Watsonville</component>
          <component name="region">CA</component>
          <component name="postal_code">95076</component>
          <component name="country">US</component>
      </address>
      <latitude>52.35</latitude>
      <longitude>42.10</longitude>
      <exterior_color>white</exterior_color>
      <sale_price>16000 USD</sale_price>
      <availability>AVAILABLE</availability>
      <date_first_on_lot>2018-02-21</date_first_on_lot>
      <state_of_vehicle>NEW</state_of_vehicle>
      <dealer_id>ABC1234</dealer_id>
    </listing>
</listings>

Esempio: elenco CSV/TSV

"vehicle_id","vehicle_registration_plate","vin","make","model","year","transmission","body_style","fuel_type","drivetrain","description","image[0].url", "image[1].url","image[2].url","mileage.value","mileage.unit","url","title","price","state_of_vehicle","exterior_color","address","latitude","longitude","trim","interior_colour","dealer_id","dealer_name","postal_code","dealer_phone","fb_page_id","dealer_communication_channel","dealer_privacy_policy_url"
"56345636","AB12CDE","YV1DZ8256F2693747","Volvo","XC60","2014","AUTOMATIC","OTHER","DIESEL","OTHER","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","http://website.com/images/stock/car1.jpg","http://website.com/images/stock/car2.jpg","http://website.com/images/stock/car3.jpg","12950","MI","http://www.dealership.co.uk","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","22495.00 GBP","Used","White","{""addr1"":""Sample Road"",""city"":""London"",""region"":""Greater London"",""postal_code"":""SW31 3EW"",""country"":""United Kingdom""}","52.7445867","-2.7337375","2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","Black","436456435347346","Dealer Group","SSW31 3EW","","3562564376375","CHAT","https://www.dealership.co.uk/site/privacy-and-legal/"

Esempio: indirizzo CSV/TSV

"{addr1: '1 Hacker Way', city: 'Menlo Park', region: 'CA', postal_code: '94025', country: 'US'}"

Esempio: elenco XML

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <title>Sample Vehicles Feed</title>
  <link rel="self" href="https://www.example.com/dealers/cars/1234/?r=vddn" />
  <listing>
    <vehicle_id>3456553</vehicle_id>
    <title>$299 per month for the EndoHatch GE</title>
    <description>Adjustable Steering Column, Adjustable Steering Wheel, Air Bags, Air Conditioning, Alloy Wheels, Anti Lock Brakes, Bluetooth Preparation (Phone), CD Player, CD Radio, Driver Airbag, Electric & Heated Door Mirrors, Electric Windows, Electronic Stability Programme (ESP), Front Electric Windows, Front Fog Lights, Height Adjustable Drivers Seat, Passenger Airbag, Power Assisted Steering (PAS), Power Fold &amp; Heated DoorMirrors, Rear Parking Sensor, Remote Boot Release, Remote Central Locking, Solid Paint,LOW MILEAGE WITH A FULL FORD HISTORY, SUPPLIED FROM US,</description>
    <url>https://www.example.com/car-1234>
    <make>Endomoto</make>
    <image>
      <url>https://www.example.com/1234/image_1.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_2.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_3.jpg</url>
    </image>
    <model>B-MAX</model>
    <year>2015</year>
    <mileage>
      <value>15617</value>
      <unit>MI</unit>
    </mileage>
    <drivetrain>Other</drivetrain>
    <vin>1A2BCDEF3GH456789</vin>
    <body_style>OTHER</body_style>
    <fuel_type>Gasoline</fuel_type>
    <transmission>Manual</transmission>
    <price>9490 GBP</price>
    <address format="simple">
      <component name="addr1">Sample Road</component>
      <component name="city">Carland</component>
      <component name="region">North Test</component>
      <component name="country">United States of America</component>
      <component name="postal_code">12345</component>
    </address>
    <latitude>37.484419</latitude>
    <longitude>-122.148406</longitude>
    <exterior_color>White</exterior_color>
    <state_of_vehicle>Used</state_of_vehicle>
    <dealer_id>453356</dealer_id>
    <vehicle_registration_plate>AB12CD</vehicle_registration_plate>
    <fb_page_id>5636367576574</fb_page_id>
    <dealer_communication_channel>LEAD_FORM</dealer_communication_channel>
    <dealer_privacy_policy_url>https://www.example.com/privacy/</dealer_privacy_policy_url>
  </listing>
</listings>

Inserzioni per il settore automotive: campi supportati - Veicolo

I seguenti campi supportati sono progettati per gli elementi che aggiungi al tuo catalogo prodotti.

Per i cataloghi localizzati, consulta i campi supportati per i veicoli.

Nome	Descrizione	Uso nelle creatività	Uso come filtro dell'insieme di prodotti
`fb_page_id` tipo: int	Obbligatorio per le inserzioni con destinazione su Facebook. ID della Pagina Facebook del partner o della concessionaria. Il catalogo deve essere aggiunto alla lista di elementi consentiti dal tuo rappresentante di Facebook prima di poter inviare gli ID della pagina. La pagina deve essere aggiunta alla lista di elementi consentiti tramite il Business Manager prima che possa essere acquisita. Consulta Gestione delle autorizzazioni.	N	N
`vehicle_id` tipo: stringa	Obbligatorio. Caratteri massimi: 100 ID unico dell'articolo. Può essere una variante di un veicolo. In caso di più istanze dello stesso ID, ignoreremo tutte le istanze. Puoi anche usare il VIN sia per `vehicle_id` sia per `vin`. Esempio: `1FADP5AU6DL536022`	S	S
`title` tipo: stringa	Obbligatorio. Caratteri massimi: 500. Nome completo del veicolo. Questo campo è pertinente e specifico per ogni veicolo e deve contenere ciò che è impostato in `year`, `make`, `model` e `trim`. Esempio: `$299 per month for the EndoHatch GE`	S	S
`description` tipo: stringa	Obbligatorio. Caratteri massimi: 5000 Breve testo per descrivere il veicolo. Non includere testo promozionale o link. Non inserire testo tutto in lettere maiuscole. Usa interruzioni di riga per formattare la descrizione. Esempio: `Used 2017 Volvo XC90 in great condition, available now.`	S	N
`url` tipo: url	Obbligatorio. Link al sito esterno in cui è possibile visualizzare l'annuncio del veicolo.	S	N
`make` tipo: stringa	Obbligatorio. Produttore o brand del veicolo. Esempio: `Endomoto`	S	S
`model` tipo: stringa	Obbligatorio. Modello del veicolo. Esempio: `EndoHatch`	S	S
`year` tipo: int	Obbligatorio. Anno di lancio del veicolo in formato `yyyy`. Esempio: `2015`	S	S
`mileage.value` tipo: int	Obbligatorio. Per i veicoli usati, l'attuale chilometraggio di un veicolo in chilometri (`kms`) o miglia (`MI`). Per i veicoli nuovi, indica zero (`0`). I veicoli su Marketplace devono avere più di 500 miglia/km. Esempio: "1500"	S	S
`mileage.unit` tipo: stringa	Obbligatorio. Unità chilometraggio: `MI` (miglia) o `KM` (chilometri)	S	N
`image[0].url` tipo: stringa	Obbligatorio. N. max. di articoli: 20 URL dell'immagine del veicolo. Se hai più di un'immagine del veicolo, segui questa convenzione di denominazione: `image[1].url`, `image[2].url` e così via. Devi fornire almeno un'immagine. Ogni immagine può avere una dimensione massima di 4 MB. Per Marketplace, è richiesto un minimo di 2 immagini. Per usare le inserzioni carosello, fornisci immagini con rapporto larghezza/altezza 1:1 quadrate (600 x 600 pixel). Per mostrare singole inserzioni di veicoli, fornisci immagini con rapporto larghezza/altezza 1,91:1 (1200 x 630 pixel). Scopri di più sulle best practice di Marketplace per le immagini.	N	N
`image[0].tag[0]` tipo: stringa	Facoltativo. N. max. di articoli: 20 Tag allegato all'immagine a indicare il contenuto dell'immagine. Possono essere presenti più tag associati a un'immagine. Segui questa convenzione di denominazione: `image[0].tag[0], image[0].tag[1]` .... `image[1].tag[0], image[1].tag[1]` .... Esempio: `Exterior`, `Interior`, `StockImage`	N	S
`transmission` Tipo: enum	Facoltativo. Tipo di cambio del veicolo: `Automatic` o `Manual`.	N	S
`body_style` Tipo: enum	Obbligatorio. Tipo di carrozzeria del veicolo: `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER`, `SMALL_CAR` o `OTHER`.	S	S
`drivetrain` Tipo: enum	Facoltativo. Trazione del veicolo. Valori supportati: `4X2`, `4X4`, `AWD`, `FWD`, `RWD`, `Other`.	N	S
`vin` Tipo: stringa	Obbligatorio, alcuni Paesi. Caratteri massimi: 17 Numero ID veicolo (VIN) del veicolo. Puoi anche usare il VIN sia per `vehicle_id` sia per `vin`. Nota: il VIN deve avere esattamente 17 caratteri e non è necessario per i veicoli precedenti al 1983. Le barche hanno meno cifre e alcuni veicoli (come i rimorchi) non hanno bisogno di VIN. Esempio: `1FADP5AU6DL536022`	S	S
`price` Tipo: stringa	Obbligatorio. Costo e relativa valuta del veicolo. Il prezzo deve avere lo stesso formato del costo, seguito dal codice valuta ISO, con uno spazio tra costo e valuta. Esempio: `18000 USD`, `32000 USD`	S	S
`exterior_color` tipo: stringa	Obbligatorio. Colore del veicolo. Esempio: `Black`, `White`, `Blue`, `Red`	S	S
`state_of_vehicle` tipo: enum	Obbligatorio. Stato attuale del veicolo. Valori supportati: `New`, `Used` o `CPO` (usato garantito).	N	S
`fuel_type` tipo: enum	Facoltativo. Tipo di alimentazione del veicolo. Valori supportati: `DIESEL`, `ELECTRIC`, `FLEX`, `GASOLINE`, `HYBRID`, `OTHER`.	N	S
`tag` (tag dell'immagine) tipo: stringa	Facoltativo. Stringa che descrive l'immagine. Possono essere presenti più tag associati a un'immagine. Esempio: `Exterior`, `Interior`, `StockImage`	S	N
`chrome_id` tipo: int	Facoltativo. Simile ad `autodata_id`.	N	N
`condition` tipo: enum	Facoltativo. Condizioni del veicolo. Valori supportati: `EXCELLENT`, `GOOD`, `FAIR`, `POOR`, `OTHER`.	N	S
`sale_price` tipo: intero	Facoltativo. Prezzo di vendita o prezzo speciale. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: `16000 USD`	S	S
`availability` tipo: enum	Facoltativo. Disponibilità del veicolo: `available` o `not available`. Nell'inserzione non mostriamo i veicoli non disponibili.	N	S
`vehicle_type` tipo: stringa	Facoltativo. Tipo di veicolo. Valori attesi: `car_truck` (predefinito se non indicato), `boat`, `commercial`, `motorcycle`, `powersport`, `rv_camper`, `trailer` o `other`.	N	S
`trim` tipo: stringa	Facoltativo. Caratteri massimi: 50 Allestimento del veicolo. Esempio: `5DR HB SE`	S	S
`interior_color` tipo: stringa	Facoltativo. Caratteri massimi: 50 Colore degli interni del veicolo.	N	S
`date_first_on_lot` tipo: stringa	Facoltativo. Data in cui il veicolo è arrivato presso la concessionaria. Utilizzato per indicare da quanto esiste l'inventario. Usa il formato `yyyy-mm-dd`. Esempio: `2018-09-05`	N	S
`days_on_lot` tipo: int	Facoltativo. Da quanti giorni il veicolo si trova presso la concessionaria. Deve essere incrementato su base giornaliera. Esempio: `62`	N	S

Inserzioni con offerte per il settore automotive: campi supportati - Concessionaria

Esistono due formati per fornire gli indirizzi; devi usarne uno dei due, ma non entrambi. Puoi usare il formato address o puoi fornire ciascun campo di indirizzo separatamente. L'utilizzo di entrambi i formati determinerà un errore.

Nome	Descrizione	Uso nelle creatività	Uso come filtro dell'insieme di prodotti
`address` tipo: stringa	Obbligatorio. Indirizzo fisico completo della concessionaria, formattato come: `{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY]`. Il codice postale è facoltativo. Esempio: `{addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}`	N	N
`address.city` tipo: stringa	Obbligatorio. Città in cui ha sede la concessionaria. Esempio: `Palo Alto`	S	S
`address.region` tipo: stringa	Obbligatorio. Stato, contea, regione o provincia in cui ha sede la concessionaria. Esempio: `California`	S	S
`address.country` tipo: stringa	Obbligatorio. Paese in cui ha sede la concessionaria. Esempio: `United States`	N	S
`latitude` tipo: float	Obbligatorio. Latitudine della sede della concessionaria. Esempio: `37.484100`	N	N
`longitude` tipo: float	Obbligatorio. Longitudine della sede della concessionaria. Esempio: `-122.148252`	N	N
`address.postal_code` tipo: stringa	Facoltativo. Codice postale dell'ubicazione della concessionaria (al di fuori degli Stati Uniti o CAP all'interno degli Stati Uniti). Ad esempio: `75008` (Parigi, Francia) o `94025` (Menlo Park)	N	N
`dealer_id` tipo: stringa	Facoltativo. Caratteri massimi: 100 ID alfanumerico della concessionaria.	S	S
`dealer_name` tipo: stringa	Facoltativo. Caratteri massimi: 100 Nome della concessionaria.	S	S
`dealer_phone` tipo: stringa	Facoltativo. Numero di telefono della concessionaria. Numero di telefono della concessionaria. Requisiti: Deve visualizzare il pulsante Chiama in un annuncio su Marketplace. Deve essere un formato di numero di telefono valido. Deve includere il prefisso internazionale. Esempio: `+1 3603453333`, `001 (360)345-3333`	N	N
`dealer_communication_channel` tipo: enum	Facoltativo. Metodo con cui la concessionaria verrà contattata dall'utente. Valori disponibili: `CHAT` o `LEAD_FORM`. Nota: se selezioni LEAD_FORM, devi includere anche un'informativa sulla privacy. Per maggiori informazioni, consulta `dealer_privacy_policy_url`.	N	N
`dealer_privacy_policy_url` tipo: url	Obbligatorio per il metodo di contatto tramite modulo di contatto. Opzionale per il metodo di contatto tramite Messenger (chat). Il link all'URL della privacy della concessionaria che pubblica l'annuncio del veicolo. Deve corrispondere alla concessionaria dell'ID della Pagina Facebook (`fb_page_id`).	N	N
`stock_number` tipo: stringa	Facoltativo. La designazione dell'auto nella concessionaria assegnata dal rivenditore. Il numero di magazzino è un modo per il rivenditore di inventariare veicoli specifici. Esempio: `N8990`	S	S
`custom_label_0` tipo: stringa	Facoltativo. Limite massimo di caratteri: 100 Informazioni aggiuntive sul veicolo che desideri includere.	S	S
`custom_label_1` tipo: stringa	Facoltativo. Limite massimo di caratteri: 100 Informazioni aggiuntive sul veicolo che desideri includere.	S	S
`custom_label_2` tipo: stringa	Facoltativo. Limite massimo di caratteri: 100 Informazioni aggiuntive sul veicolo che desideri includere.	S	S

Inserzioni con offerte per il settore automotive: formati supportati

Un elenco può essere nei formati CSV, TSV e XML.

Esempio: file TSV, con carattere di tabulazione come delimitatore

vehicle_offer_id    market_name     make     model    trim   year    offer_disclaimer                               offer_type    amount    amount_percentage    amount_qualifier    term_length    term_qualifier    downpayment    downpayment_qualifier    offer_description    url    image[0].url      start_date      end_date

offer34220          market1234    MakeA    ModelA    E3    2017    *Available on approved credit to very well qualified customers    lease    USD 419        a month    36    months    USD 0    due at signing.    Expires 09/05/2017. Excludes official fees, taxes and dealer charges. No security deposit required. 10,000 mile/year limit.    https://test123.com/offers1    http://www.test123.com/cm-img/facebook/offer1.jpg    2018-09-05    2018-12-31       
offer34221          market1234    MakeB    ModelB    E4    2017    *Available on approved credit to very well qualified customers    cash    USD 1500        cash                    Expires 09/05/2017.    https://test123.com/offers2    http://www.test123.com/cm-img/facebook/offer2.jpg    2018-09-05    2018-12-31

offer34222          market2345    MakeC    ModelC    E5    2017    *Available on approved credit to very well qualified customers    finance        4.9    APR    60    months            Expires 09/05/2017. Excludes official fees, taxes and dealer charges.    https://test123.com/offers3    http://www.test123.com/cm-img/facebook/offer3.jpg    2018-09-05    2018-12-31

Inserzioni con offerte per il settore automotive: campi supportati

Questi elenchi possono essere caricati tramite l'interfaccia utente o l'API. Se preferisci l'interfaccia utente, fornisci l'ID utente e l'ID dell'account, così possiamo aggiungerti alla lista di utenti consentiti per l'accesso.

Nome	Descrizione	Filtro dell'insieme di prodotti	Si può usare nelle creatività?
`vehicle_offer_id` tipo: stringa	Obbligatorio. ID univoco del veicolo che verrà utilizzato dagli inserzionisti per identificare un'offerta. È anche lo stesso valore passato nel parametro `content_id` nel pixel. Esempio: `offer1`	S	S
`make` tipo: stringa	Obbligatorio. Produttore o brand del veicolo. Esempio: `Endomoto`	S	S
`model` tipo: stringa	Obbligatorio. Modello del veicolo. Esempio: `EndoHatch`	S	S
`year` tipo: numero intero	Obbligatorio. Anno di lancio del veicolo in formato aaaa. Esempio: `2015`	S	S
`offer_type` tipo: enum	Obbligatorio. Tipo di offerta. Valori validi: `lease`, `finance`, `cash`	S	N
`title` tipo: stringa	Obbligatorio. Titolo dell'inserzione/offerta. Esempio: `"$299 per month for the EndoHatch GE!"`	N	S
`offer_description` tipo: stringa	Obbligatorio. Descrizione dell'offerta. Esempio: `This offer is valid only during the month of September.`	N	S
`url` tipo: url	Obbligatorio. Link al sito esterno in cui è possibile visualizzare l'offerta.	N	S
`offer_disclaimer` tipo: stringa	Obbligatorio. Disclaimer associato all'offerta.	N	N
`image[0].url` tipo: stringa	Obbligatorio. URL dell'immagine del veicolo utilizzata nella creatività dell'inserzione. Nota: per usare le inserzioni carosello, fornisci immagini con rapporto larghezza/altezza 1:1 quadrate di 600 x 600 pixel. Per mostrare singole inserzioni di veicoli, fornisci immagini con rapporto larghezza/altezza 1,91:1 di 1200 x 630 pixel. Per maggiori informazioni sulle proporzioni, consulta le Best practice per i rapporti larghezza/altezza.	N	N
`image[0].tag[0]` tipo: stringa	Facoltativo. Stringa che rappresenta il contenuto dell'immagine. Ci possono essere più tag associati a un'immagine, come Lease Offer, Financing e così via.
`image[0].tag[m]` tipo: stringa	Facoltativo. Stringa che rappresenta il contenuto dell'immagine. Supportiamo più tag. Aumenta il valore `m` per aggiungere più tag.	N	N
`image[n].url` tipo: stringa	Facoltativo. Stringa che rappresenta il contenuto dell'immagine. Puoi caricare più di 1 immagine aumentando la cifra n da 1 a 20. Il valore di `n` deve essere in ordine sequenziale. Ad esempio, se hai 0,1,2, devi avere 3 e non direttamente 4.	N	N
`image[n].tag[0]` tipo: stringa	Facoltativo. Stringa che rappresenta il contenuto dell'immagine. Supportiamo più tag. Aumenta il valore `m` per aggiungere più tag.	N	N
`image[n].tag[m]` tipo: stringa	Facoltativo. Stringa che rappresenta il contenuto dell'immagine. Ci possono essere più tag associati a un'immagine, come Lease Offer, Financing e così via.	N	N
`amount_price` tipo: stringa	Consigliato. Importo del tipo di offerta lease o cash. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: per un leasing di 329 USD/mese o un cashback di 2000 USD, i valori devono essere `329 USD` o `2000 USD`.	N	S
`amount_percentage` tipo: stringa	Consigliato. Valore in percentuale, se presente nell'offerta. A volte, il valore corrisponde a una percentuale (esempio: `3.9% APR`) e non a un importo.	N	N
`amount_qualifier` tipo: stringa	Consigliato. Qualificatore per il valore dell'importo in dollari o la percentuale dell'importo. I valori validi possono essere `per month` o `APR`. Esempio: `/mo` in 100 USD/mese per il tipo di offerta lease. `APR` in 1,1% APR per il tipo di offerta finance.	N	S
`term_length` tipo: numero intero	Consigliato. Durata per la quale si applica l'offerta. Se l'offerta è un leasing di 329 USD/mese per 3 anni, il valore è `3` e il valore corrispondente in `term_qualifier` è `years`. Esempio: `/mo` in 100 USD/mese per il tipo di offerta lease. `APR` in 1,1% APR per il tipo di offerta finance.	N	S
`term_qualifier` tipo: enum	Consigliato. Unità della condizione dell'offerta. I valori validi sono "months" o "years". Esempio: `months` per un'offerta di 329 USD/mese per 36 mesi e `year` per un'offerta di 329 USD/mese per 3 anni.	N	S
`downpayment` tipo: stringa	Consigliato. Valore dell'acconto al momento dell'acquisto o del leasing. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: utilizza `1500 USD` come valore se le condizioni dell'acconto sono `$1500 due at signing + 1 month payment`.	N	S
`downpayment_qualifier` tipo: stringa	Consigliato. Qualificatore per il valore `downpayment`. Esempio: utilizza il valore `due at signing + 1 month payment` se le condizioni dell'acconto sono `$1500 due at signing + 1 month payment`.		S
`trim` tipo: stringa	Consigliato. Allestimento del veicolo. Esempio: `GE`.	N	S
`price` tipo: stringa	Consigliato Prezzo di vendita consigliato dal produttore del veicolo con valuta. Il prezzo deve avere lo stesso formato del costo, seguito dal codice di valuta ISO, con uno spazio tra costo e valuta. Esempio: `13,999 USD`	N	N
`body_style` tipo: enum	Consigliato. Tipo di carrozzeria dei veicoli. Valori validi: `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER` o `OTHER`	N	N
`start_date` tipo: stringa	Facoltativo. Data di inizio validità di un'offerta. La data deve essere nel formato aaaa-mm-gg. Esempio: `2018-09-05`	N	N
`end_date` tipo: stringa	Facoltativo. Data di fine validità di un'offerta. La data deve essere nel formato aaaa-mm-gg. Esempio: `2018-09-05`	N	N
`market_name` tipo: stringa	Facoltativo. Nome del mercato/della Designated Marketing Area (DMA).	S	N
`dma_codes` tipo: array di stringhe	Obbligatorio per offerte regionali e facoltativo per offerte nazionali. Lista dei codici DMA (Designated Marketing Area) per il mercato specifico fornito nel seguente formato ['502', '201'] ['516'...]. Nota: questo è per il formato CSV, consulta di seguito gli esempi di elenchi per il formato XML. Consulta lo standard per i codici DMA. Lascia il campo vuoto per le offerte nazionali.	S	N

Esempio: per la creazione di un catalogo per le inserzioni del catalogo Advantage+, consulta Catalogo, Riferimento.

curl \
  -F 'name=catalog name' \
  -F 'access_token=<ACCESS TOKEN>' \
  -F 'vertical=vehicle_offers' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS ID>/product_catalogs