Référence

Ce guide référence les formats de fil et les champs pris en charge si vous voulez créer des publicités pour véhicules automobiles.

L’ensemble des champs de type enum ne sont pas sensibles à la casse.

Publicités pour inventaire automobile - Formats de fil pris en charge

Présentez votre fil de données au bon format : CSV, TSV ou XML. Une fois le fichier du fil créé, vous devez l’héberger sur une URL pour les mises à jour programmées régulièrement.

Format du fil Description/Règles Exemple de fil

Format du fil	Description/Règles	Exemple de fil
CSV	Valeurs séparées par des virgules. La première ligne correspond à l’en-tête de la colonne. Les lignes suivantes fournissent les valeurs correspondantes pour chaque itinéraire. Les champs contenant des espaces ou des virgules doivent être placés entre guillemets doubles ("…"). Une mention introduite par des guillemets doubles située à l’intérieur d’un champ à guillemets doubles doit être échappée à l’aide de deux guillemets doubles consécutifs. Les champs imbriqués ou à valeurs multiples, tels que les champs image, peuvent être représentés à l’aide de valeurs encodées au format JSON ou par un ensemble de colonnes en texte brut « simplifié » désignées au moyen de la syntaxe d’un chemin d’accès JSON. Exemple : `(image[0].url`, `image[0].tag[0]`, `image[0].tag[1])` Les deux conventions peuvent être utilisées de manière interchangeable dans le même fichier. Consultez l’exemple de fil au format CSV/TSV et l’exemple d’adresse au format CSV/TSV.	Télécharger > Clic droit > Enregistrer le lien sous
TSV	Valeurs séparées par des tabulations. Voir les règles relatives au format CSV. Consultez l’exemple de fil au format CSV/TSV et l’exemple d’adresse au format CSV/TSV.	Télécharger > Clic droit > Enregistrer le lien sous
XML	Ce format est normalement généré par les systèmes automatisés de création de fils ou les serveurs web. Un ensemble de nœuds XML d’éléments représente une liste de produits et doit commencer par le tag déclaratif `<?xml`. Voir l’exemple de fil au format XML.	Télécharger > Clic droit > Enregistrer le lien sous

CSV

Valeurs séparées par des virgules.

La première ligne correspond à l’en-tête de la colonne. Les lignes suivantes fournissent les valeurs correspondantes pour chaque itinéraire.
Les champs contenant des espaces ou des virgules doivent être placés entre guillemets doubles ("…"). Une mention introduite par des guillemets doubles située à l’intérieur d’un champ à guillemets doubles doit être échappée à l’aide de deux guillemets doubles consécutifs.
Les champs imbriqués ou à valeurs multiples, tels que les champs image, peuvent être représentés à l’aide de valeurs encodées au format JSON ou par un ensemble de colonnes en texte brut « simplifié » désignées au moyen de la syntaxe d’un chemin d’accès JSON. Exemple : (image[0].url, image[0].tag[0], image[0].tag[1])
Les deux conventions peuvent être utilisées de manière interchangeable dans le même fichier.

Consultez l’exemple de fil au format CSV/TSV et l’exemple d’adresse au format CSV/TSV.

Télécharger > Clic droit > Enregistrer le lien sous

TSV

Valeurs séparées par des tabulations. Voir les règles relatives au format CSV.

Consultez l’exemple de fil au format CSV/TSV et l’exemple d’adresse au format CSV/TSV.

Télécharger > Clic droit > Enregistrer le lien sous

XML

Ce format est normalement généré par les systèmes automatisés de création de fils ou les serveurs web. Un ensemble de nœuds XML d’éléments représente une liste de produits et doit commencer par le tag déclaratif <?xml.

Voir l’exemple de fil au format XML.

Télécharger > Clic droit > Enregistrer le lien sous

Exemple : fichier TSV délimité par des tabulations

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

Exemple : fil avec des images sous forme d’ensemble

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

Cet exemple de fil de données est au format 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>

Exemple : fil au format 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/"

Exemple : adresse au format CSV/TSV

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

Exemple : fil au format 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>

Publicités pour inventaire automobile - Champs pris en charge - Véhicule

Les champs acceptés mentionnés ci-dessous se rapportent aux éléments que vous ajoutez dans votre catalogue produits.

S’il s’agit de catalogues localisés, consultez les champs pris en charge pour les véhicules.

Nom	Description	Utilisation dans le contenu publicitaire	Utilisation comme filtre d’ensemble de produits
`fb_page_id` type : nombre entier	Obligatoire concernant les publicités pour inventaire destinées à Facebook. ID de la page Facebook du partenaire ou du concessionnaire. Votre catalogue doit être ajouté à la liste des éléments autorisés par votre représentant·e Facebook avant que vous ne puissiez envoyer vos ID de page. La page doit être ajoutée à la liste des éléments autorisés à l’aide de Business Manager avant de pouvoir être intégrée. Consultez la section Gestion des autorisations.	N	N
`vehicle_id` type : chaîne	Obligatoire. Nombre maximal de caractères : 100 ID unique de l’article. Il peut s’agir d’une variante de véhicule. S’il existe plusieurs occurrences du même ID, elles sont toutes ignorées. Vous pouvez également utiliser le VIN pour `vehicle_id` et `vin`. Exemple : `1FADP5AU6DL536022`	O	O
`title` type : chaîne	Obligatoire. Nombre maximal de caractères : 500 Nom complet du véhicule. Il est important et spécifique à chaque véhicule et doit contenir ce qui apparaît dans les champs `year`, `make`, `model` et `trim`. Exemple : `$299 per month for the EndoHatch GE`	O	O
`description` type : chaîne	Obligatoire. Nombre maximal de caractères : 5 000 Texte court décrivant le véhicule. N’incluez ni texte promotionnel, ni lien. Ne saisissez pas de texte tout en majuscules. Utilisez des sauts de ligne pour mettre en forme la description. Exemple : `Used 2017 Volvo XC90 in great condition, available now.`	O	N
`url` type : url	Obligatoire. Lien vers le site externe sur lequel vous pouvez voir les annonces de véhicules.	O	N
`make` type : chaîne	Obligatoire. Marque du véhicule. Exemple : `Endomoto`	O	O
`model` type : chaîne	Obligatoire. Modèle du véhicule. Exemple : `EndoHatch`	O	O
`year` type : nombre entier	Obligatoire. Année de lancement du véhicule au format `yyyy`. Exemple : `2015`	O	O
`mileage.value` type : nombre entier	Obligatoire. Pour les véhicules d’occasion, kilométrage actuel du véhicule en kilomètres (`kms`) ou en miles (`MI`). Pour les véhicules neufs, il sera nul (`0`). Les véhicules sur Marketplace doivent avoir plus de 500 miles/800 km au compteur. Exemple : 1 500	O	O
`mileage.unit` type : chaîne	Obligatoire. Unités de kilométrage : `MI` (miles) ou `KM` (kilomètres)	O	N
`image[0].url` type : chaîne	Obligatoire. Nombre d’éléments max. : 20 URL de l’image du véhicule. Si vous présentez plusieurs images de véhicules, suivez cette convention de nommage : `image[1].url`, `image[2].url`, etc. Vous devez fournir au moins une image. La taille maximale autorisée pour chaque image est de 4 Mo. Pour Marketplace, un minimum de 2 images est requis. Pour utiliser des publicités carrousel, fournissez des images carrées au format 1:1 (600 x 600 pixels). Pour des publicités à image unique pour le véhicule, fournissez une image au format 1.91:1 (1 200 x 630 pixels). Apprenez-en davantage sur les recommandations concernant les images sur Marketplace.	N	N
`image[0].tag[0]` type : chaîne	Facultatif. Nombre d’éléments max. : 20 Tag ajouté à l’image qui montre ce qu’il y a dans l’image. Plusieurs tags peuvent être associés à une image. Suivez cette convention de nommage : `image[0].tag[0], image[0].tag[1]` .... `image[1].tag[0], image[1].tag[1]` .... Exemple : `Exterior`, `Interior`, `StockImage`	N	O
`transmission` type : énumération	Facultatif. Type de de boîte de vitesses du véhicule : `Automatic` ou `Manual`.	N	O
`body_style` type : énumération	Obligatoire. Type de carrosserie du véhicule : `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER`, `SMALL_CAR` ou `OTHER`.	O	O
`drivetrain` type : énumération	Facultatif. Transmission du véhicule. Valeurs prises en charge : `4X2`, `4X4`, `AWD`, `FWD`, `RWD`, `Other`.	N	O
`vin` type : chaîne	Obligatoire, certains pays. Nombre maximal de caractères : 17 Numéro ID du véhicule (VIN). Vous pouvez également utiliser le numéro d’identification du véhicule (VIN) pour `vehicle_id` et `vin`. Remarque : Le VIN doit comporter 17 caractères et n’est pas obligatoire pour les véhicules antérieurs à 1983. Le VIN des bateaux comporte moins de chiffres et certains véhicules (dont les remorques) n’ont pas besoin de VIN. Exemple : `1FADP5AU6DL536022`	O	O
`price` type : chaîne	Obligatoire. Prix et devise du véhicule. Le format du prix doit être le suivant : coût suivi du code de devise ISO, séparés par une espace. Exemple : `18000 USD`, `32000 USD`	O	O
`exterior_color` type : chaîne	Obligatoire. Couleur du véhicule. Exemple : `Black`, `White`, `Blue`, `Red`	O	O
`state_of_vehicle` type : énumération	Obligatoire. État actuel du véhicule. Valeurs prises en charge : `New`, `Used` ou `CPO` (véhicule d’occasion certifié).	N	O
`fuel_type` type : énumération	Facultatif. Type de carburant du véhicule. Valeurs prises en charge : `DIESEL`, `ELECTRIC`, `FLEX`, `GASOLINE`, `HYBRID`, `OTHER`.	N	O
`tag` (tag d’image) type : chaîne	Facultatif. Chaîne décrivant l’image. Plusieurs tags peuvent être associés à une image. Exemple : `Exterior`, `Interior`, `StockImage`	O	N
`chrome_id` type : nombre entier	Facultatif. Similaire à `autodata_id`.	N	N
`condition` type : énumération	Facultatif. État du véhicule. Valeurs prises en charge : `EXCELLENT`, `GOOD`, `FAIR`, `POOR` ou `OTHER`.	N	O
`sale_price` type : nombre entier	Facultatif. Prix de vente ou offre spéciale. Le format du prix doit être le suivant : coût suivi du code de devise ISO, séparés par une espace. Exemple : `16000 USD`	O	O
`availability` type : énumération	Facultatif. Disponibilité des véhicules : `available` ou `not available`. Nous ne montrons pas les véhicules qui sont indisponibles dans la publicité.	N	O
`vehicle_type` type : chaîne	Facultatif. Type de véhicule. Valeurs attendues : `car_truck` (par défaut, si aucune information fournie), `boat`, `commercial`, `motorcycle`, `powersport`, `rv_camper`, `trailer` ou `other`.	N	O
`trim` type : chaîne	Facultatif. Nombre maximal de caractères : 50 Coupe du véhicule. Exemple : `5DR HB SE`	O	O
`interior_color` type : chaîne	Facultatif. Nombre maximal de caractères : 50 Couleur intérieure du véhicule.	N	O
`date_first_on_lot` type : chaîne	Facultatif. Date d’arrivée de ce véhicule chez le concessionnaire. Permet d’indiquer la date d’entrée dans l’inventaire. Utilisez le format `yyyy-mm-dd`. Exemple : `2018-09-05`	N	O
`days_on_lot` type : nombre entier	Facultatif. Nombre de jours pendant lesquels le véhicule était à la concession. Doit être incrémenté tous les jours. Exemple : `62`	N	O

Publicités pour inventaire automobile - Champs pris en charge - Concessionnaires

Il existe deux formats d’adresse et vous devez utiliser l’un ou l’autre, mais pas les deux à la fois. Vous pouvez utiliser le format address ou indiquer chaque champ d’adresse individuellement. Notez que l’utilisation des deux formats générera une erreur.

Nom	Description	Utilisation dans le contenu publicitaire	Utilisation comme filtre de l’ensemble de produits
`address` type : chaîne	Obligatoire. Renseignez l’adresse physique du concessionnaire, au format suivant : `{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY]`. Le code postal est facultatif. Exemple : `{addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}`	N	N
`address.city` type : chaîne	Obligatoire. Ville dans laquelle se trouve le concessionnaire. Exemple : `Palo Alto`	O	O
`address.region` type : chaîne	Obligatoire. État, département, région ou province où se trouve le concessionnaire. Exemple : `California`	O	O
`address.country` type : chaîne	Obligatoire. Pays dans lequel se trouve le concessionnaire. Exemple : `United States`	N	O
`latitude` type : virgule flottante	Obligatoire. Latitude du concessionnaire. Exemple : `37.484100`	N	N
`longitude` type : virgule flottante	Obligatoire. Longitude du concessionnaire. Exemple : `-122.148252`	N	N
`address.postal_code` type : chaîne	Facultatif. Code postal du concessionnaire (autres pays ou États-Unis). Exemple : `75008` (Paris, France) ou `94025` (Menlo Park)	N	N
`dealer_id` type : chaîne	Facultatif. Nombre maximal de caractères : 100 ID alphanumérique du concessionnaire.	O	O
`dealer_name` type : chaîne	Facultatif. Nombre maximal de caractères : 100 Nom du concessionnaire.	O	O
`dealer_phone` type : chaîne	Facultatif. Numéro de téléphone du concessionnaire. Numéro de téléphone de la concession. Conditions requises : Doit afficher le bouton Appeler sur une annonce Marketplace. Doit utiliser un format de numéro de téléphone valide. Doit inclure l’indicatif pays. Exemple : `+1 3603453333`, `001 (360)345-3333`	N	N
`dealer_communication_channel` type : énumération	Facultatif. Moyen de communication servant à contacter le concessionnaire. Valeurs disponibles : `CHAT` ou `LEAD_FORM`. Remarque : si vous sélectionnez LEAD_FORM, vous devez également inclure une politique de confidentialité. Pour en savoir plus, consultez `dealer_privacy_policy_url`.	N	N
`dealer_privacy_policy_url` type : url	Obligatoire si un formulaire de prospect est utilisé comme mode de contact. Facultatif pour le mode de contact par Messenger (Discussion). Lien vers l’URL de confidentialité du concessionnaire annonçant le véhicule. Il doit correspondre à l’ID de la Page Facebook du concessionnaire (`fb_page_id`).	N	N
`stock_number` type : chaîne	Facultatif. Désignation du véhicule, telle que spécifiée dans le propre inventaire du concessionnaire. Pour le concessionnaire, le numéro de stock est un moyen d’inventorier des véhicules spécifiques. Exemple : `N8990`	O	O
`custom_label_0` type : chaîne	Facultatif. Nombre maximal de caractères : 100 Informations complémentaires sur le véhicule, que vous souhaitez inclure.	O	O
`custom_label_1` type : chaîne	Facultatif. Nombre maximal de caractères : 100 Informations complémentaires sur le véhicule, que vous souhaitez inclure.	O	O
`custom_label_2` type : chaîne	Facultatif. Nombre maximal de caractères : 100 Informations complémentaires sur le véhicule, que vous souhaitez inclure.	O	O

Publicités pour une offre automobile - Formats pris en charge

Le fil peut être au format CSV, TSV ou XML.

Exemple : un fichier TSV délimité par des tabulations.

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

Publicités pour des offres automobiles — Champs pris en charge

Ces fils peuvent être importés via l’UI ou l’API. Si vous choisissez l’UI, veuillez indiquer votre identifiant utilisateur et votre ID de compte afin que nous puissions vous ajouter à la liste des accès autorisés.

Nom	Description	Filtre de l’ensemble de produits	Utilisation dans le contenu publicitaire ?
`vehicle_offer_id` type : chaîne	Obligatoire. ID unique du véhicule qui permet aux annonceurs et annonceuses d’identifier une offre. Il s’agit également de la valeur transmise sous le paramètre `content_id` dans le pixel. Exemple : `offer1`	O	O
`make` type : chaîne	Obligatoire. Marque du véhicule. Exemple : `Endomoto`	O	O
`model` type : chaîne	Obligatoire. Modèle du véhicule. Exemple : `EndoHatch`	O	O
`year` type : nombre entier	Obligatoire. Année de commercialisation du véhicule, au format aaaa. Exemple : `2015`	O	O
`offer_type` type : énumération	Obligatoire. Type de l’offre. Valeurs valides : `lease`, `finance`, `cash`	O	N
`title` type : chaîne	Obligatoire. Titre de la publicité/de l’offre. Exemple : `"$299 per month for the EndoHatch GE!"`	N	O
`offer_description` type : chaîne	Obligatoire. Description de l’offre. Exemple : `This offer is valid only during the month of September.`	N	O
`url` type : url	Obligatoire. Lien vers le site externe sur lequel vous pouvez voir l’offre.	N	O
`offer_disclaimer` type : chaîne	Obligatoire. Limitation de responsabilité associée à l’offre.	N	N
`image[0].url` type : chaîne	Obligatoire. URL de l’image du véhicule utilisée dans le contenu publicitaire. Remarque : pour utiliser des publicités carrousel, fournissez des images au format carré (1:1) de 600 x 600 pixels. Si vous souhaitez diffuser des publicités à image unique pour le véhicule, fournissez des images au format 1.91:1 de 1 200 x 630 pixels. Pour plus d’informations sur le format des images, consultez les recommandations relatives aux proportions.	N	N
`image[0].tag[0]` type : chaîne	Facultatif. Chaîne représentant ce que contient l’image. Plusieurs tags peuvent être associés à une image, tels que Lease Offer, Financing, etc.
`image[0].tag[m]` type : chaîne	Facultatif. Chaîne représentant ce que contient l’image. Vous pouvez indiquer plusieurs tags. Pour en ajouter d’autres, incrémentez la valeur `m`.	N	N
`image[n].url` type : chaîne	Facultatif. Chaîne représentant ce que contient l’image. Vous pouvez importer plusieurs images en incrémentant le chiffre n de 1 à 20. La valeur `n` doit se présenter selon un ordre séquentiel. Par exemple, si vous avez 0,1,2, le chiffre 3 doit suivre, car vous ne pouvez pas passer directement à 4.	N	N
`image[n].tag[0]` type : chaîne	Facultatif. Chaîne représentant ce que contient l’image. Vous pouvez indiquer plusieurs tags. Pour en ajouter d’autres, incrémentez la valeur `m`.	N	N
`image[n].tag[m]` type : chaîne	Facultatif. Chaîne représentant ce que contient l’image. Plusieurs tags peuvent être associés à une image, tels que Lease Offer, Financing, etc.	N	N
`amount_price` type : chaîne	Recommandé. Montant de l’offre Lease ou Cash. Le format du prix doit être le suivant : coût suivi du code de devise ISO, avec un espace entre les deux. Exemple : pour une location de 329 $/mois ou un cashback de 2 000 $, les valeurs sont les suivantes : `329 USD` ou `2000 USD`.	N	O
`amount_percentage` type : chaîne	Recommandé. Valeur en pourcentage, le cas échéant. Il peut arriver que la valeur soit un pourcentage (exemple : `3.9% APR`) au lieu d’un montant.	N	N
`amount_qualifier` type : chaîne	Recommandé. Qualificatif du montant en dollars ou du pourcentage. Valeurs valides : `per month` ou `APR`. Exemple : `/mo` dans 100 $/mois pour les offres de location. `APR` dans 1,1 % APR pour les offres financières.	N	O
`term_length` type : nombre entier	Recommandé. Durée d’application de l’offre. S’il s’agit d’une offre de location de 329 $/mois pendant 3 ans, la valeur sera `3` et la valeur correspondante pour `term_qualifier` sera `years`. Exemple : `/mo` dans 100 $/mois pour les offres de location. `APR` dans 1,1 % APR pour les offres financières.	N	O
`term_qualifier` type : énumération	Recommandé. Unités associées à la durée de l’offre. Valeurs valides : mois ou années. Exemple : `months` pour une offre de 329 $/mois pendant 36 mois, et `year` pour une offre de 329 $/mois pendant 3 ans.	N	O
`downpayment` type : chaîne	Recommandé. Valeur de l’acompte au moment de l’achat ou de la location. Le format du prix doit être le suivant : coût suivi du code de devise ISO, avec un espace entre les deux. Exemple : utilisez la valeur `1500 USD` si les conditions d’acompte sont `$1500 due at signing + 1 month payment`.	N	O
`downpayment_qualifier` type : chaîne	Recommandé. Qualificatif de la valeur `downpayment`. Exemple : utilisez la valeur `due at signing + 1 month payment` si les conditions d’acompte sont `$1500 due at signing + 1 month payment`.		O
`trim` type : chaîne	Recommandé. Version du véhicule. Exemple : `GE`.	N	O
`price` type : chaîne	Recommandé MSRP du véhicule avec la devise. Le format du prix doit être le suivant : coût suivi du code de devise ISO, avec un espace entre les deux. Exemple : `13,999 USD`	N	N
`body_style` type : énumération	Recommandé. Type de carrosserie du véhicule. Valeurs valides : `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER` ou `OTHER`	N	N
`start_date` type : chaîne	Facultatif. Date de début de validité d’une offre. Elle doit être indiquée au format suivant : aaaa-mm-jj. Exemple : `2018-09-05`	N	N
`end_date` type : chaîne	Facultatif. Date de fin de validité d’une offre. Elle doit être indiquée au format suivant : aaaa-mm-jj. Exemple : `2018-09-05`	N	N
`market_name` type : chaîne	Facultatif. Nom du marché/de la zone DMA (Designated Marketing Area).	O	N
`dma_codes` type : tableau de chaînes	Obligatoire pour les offres régionales. Facultatif pour les offres nationales. Liste des codes DMA du marché fournis au format ['502', '201'] ['516'...]. Remarque : il s’agit du format CSV. Voir ci-dessous pour des exemples de fils au format XML. Voir la norme relative aux codes DMA. Laisser vide pour les offres nationales.	O	N

Exemple : pour créer un catalogue pour des publicités de catalogue Advantage+, voir Catalogue, Référence.

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