Automotive Inventory Ads - Catalogs and Feeds

To promote your automotive inventory on Facebook, you need to share this information with Facebook. You do this by creating an automotive catalog and then filling it with automotive details.

If you're a dealer interested in listing your inventory on Marketplace, the Marketplace program is a closed beta program and is only available for dealers selling used vehicles in specific regions.

To leverage your vehicle inventory catalog for Marketplace, contact an existing marketplace inventory partner.

To create a catalog, you should connect a data feed or upload data to Facebook. The data should contain all the required fields for the vehicles that you want advertise, which are listed below.

Step 1: Specify Your Auto Inventory Catalog Feed

Your catalog is a structured data file with a list of cars to showcase. Each line of the file contains all information needed to create a vehicle listing.

To set up a vehicles feed, you need a catalog and a feed of your inventory hosted at a location of your choice.

From your Business Manager/Catalog Manager, create a new vehicles catalog.

Supported fields are available for Vehicle and Dealership and apply to dynamic ads and Marketplace as noted in the Description for each. All enum fields are case-insensitive.

Supported Auto Inventory Catalog Fields - Vehicle

NameDescriptionUse in CreativeUse as a product set filter

fb_page_id

type: int

Required for Marketplace; NA for dynamic ads.

Facebook page ID of the partner or dealership. Your catalog must be whitelisted by your Facebook representative before you can send your page IDs. The page must be whitelisted using the Business Manager before can be ingested. See Managing Permissions.

N

N

vehicle_id

type: string

Required for Marketplace & dynamic ads.

Max characters: 100

Unique ID for item. Can be a variant for a vehicle. If there are multiple instances of the same ID, we ignore all instances. Example: 2017 Volvo XC90

Y

Y

title

type: string

Required for Marketplace & dynamic ads.

Max characters: 500.

Full name of vehicle. This is relevant and specific to each vehicle and it should contain what is set in year, make, model, trim.

Example: SE Ford Certified and 6-Speed Automatic

Y

Y

description

type: string

Required for Marketplace & dynamic ads.

Max characters: 5000

Short text describing the vehicle. Don't include promotional text or any links. Don't enter text in all capital letters. Use line breaks to format your description.

Example: Used 2017 Volvo XC90 in great condition, available now.

Y

N

url

type: url

Required for dynamic ads; Optional for Marketplace.

Link to the external site where you can view the vehicle listing.

Y

N

make

type: string

Required for Marketplace & dynamic ads.

Make or brand of the vehicle.

Example: Ford

Y

Y

model

type: string

Required for Marketplace & dynamic ads.

Model of the vehicle.

Example: Fusion

Y

Y

year

type: int

Required for Marketplace & dynamic ads.

Year the vehicle was launched in yyyy format.

Example: 2015

Y

Y

mileage.value

type: int

Required for Marketplace & dynamic ads.

For used vehicles, current mileage of the vehicle in kilometers (kms) or miles (MI). For new vehicles, use zero (0). For Marketplace, vehicles must have over 500 miles/kms.

Example: '1500'

Y

Y

mileage.unit

type: string

Required for Marketplace & dynamic ads.

Mileage units: MI (miles) or KM (kilometers)

Y

N

image

type: string

Required for Marketplace & dynamic ads.

Nested or multi-value fields, such as image, can be represented using JSON-encoded values or by a set of "flattened" plain-text columns labeled using JSON-path syntax.

Example:

(image[0].url

,

image[0].tag[0]

,

image[0].tag[1])


When using a CSV/TSV file, we support two different formats: * Use an image header that looks like: image[0].url, image[1].url, and so on * Use a JSON flatten string that looks like: "[{url:'https://images.com/1.jpg'},{url:'https://images.com/2.jpg'}]"

See examples for CSV/TSV, Address CSV/TSV, Feed XML.

Learn more about Marketplace Best Practices for images.

Y

N

image[0].url

type: string

Required for Marketplace & dynamic ads.

Max items: 20

URL of the vehicle image. If you have more than one vehicle image, follow this naming convention: image[1].url, image[2].url, and so on. You must provide at least one image. Each image can be up to 4 MB in size. For Marketplace, a 2-image minimum is required.

  • To use carousel ads — Provide a square 1:1 aspect ratio images (600x600px).

  • To show single vehicle ads — Provide images with 1.91:1 aspect ratio image (1200x630px).

Learn more about Marketplace Best Practices for images.

N

N

transmission

type: enum

Optional for Marketplace & dynamic ads.

Transmission type of the vehicle: Automatic or Manual.

N

Y

body_style

type: enum

Required for Marketplace & dynamic ads.

Body style of the vehicle: CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER, SMALL_CAR, or OTHER.

Y

Y

drivetrain

type: enum

Optional for Marketplace & and dynamic ads.

Vehicle drivetrain. Supported values: 4X2, 4X4, AWD, FWD, RWD, Other.

N

Y

vin

type: string

Required for dynamic ads & Marketplace, some countries.

Max characters: 17

Vehicle ID number of the vehicle. Note: VIN must be exactly 17 characters and it isn't required for pre-1983 vehicles. Boats have less digits and some vehicles (such as trailers) don't need VINs.

Example: 1FADP5AU6DL536022

Y

Y

price

type: string

Required for Marketplace & dynamic ads.

Cost and currency of the vehicle. Format the price as the cost, followed by the ISO currency code, with a space between cost and currency. For Marketplace - new vehicles only, see Additional Fields for Specific Countries

Example: 18000 USD, 32000 USD

Y

Y

exterior_color

type: string

Required for Marketplace & dynamic ads.

Vehicle color.

Example: Black, White, Blue, Red

Y

Y

state_of_vehicle

type: enum

Required for Marketplace & dynamic ads.

Current state of the vehicle. Supported values: New, Used, or CPO (certified pre-owned).

N

Y

fuel_type

type: enum

Optional for Marketplace & and dynamic ads.

Vehicle fuel type. Supported values: DIESEL, ELECTRIC, FLEX, GASOLINE, HYBRID, OTHER.

N

Y

image[0].tag[0]

type: string

Optional for Marketplace & dynamic ads.

Max items: 20

Tag appended to the image that shows what's in the image. There can be multiple tags associated with an image. Follow this naming convention: image[0].tag[0], image[0].tag[1] .... image[1].tag[0], image[1].tag[1] ....

Example: Exterior, Interior, StockImage

N

Y

tag (image tag)

type: string

Optional for Marketplace & and dynamic ads.

String that describes the image. There can be multiple tags associated with an image.

Example: Exterior, Interior, StockImage

Y

N

chrome_id

type: int

Optional for Marketplace; NA for dynamic ads.

Similar to autodata_id.

N

N

car_history_link

type: string

Optional for Marketplace; NA for dynamic ads.

Link to a carfax report or other car history report.

N

N

condition

type: enum

Optional for Marketplace & and dynamic ads.

Condition of the vehicle. Supported values: EXCELLENT, GOOD, FAIR, POOR, or OTHER.

N

Y

sale_price

type: integer

Optional for Marketplace & dynamic ads.

Sale price or special price. Format the price as the cost, followed by the ISO currency code, with a space between cost and currency.

Example: 16000 USD

Y

Y

availability

type: enum

Optional for Marketplace & dynamic ads.

Vehicle availability: available or not available. We don't show vehicles that are unavailable in the ad.

N

Y

vehicle_type

type: string

Optional for dynamic ads amp; for Marketplace.

Type of vehicle. Expected values: car_truck (default if not supplied), boat, commercial, motorcycle, powersport, rv_camper, trailer, or other.

N

Y

trim

type: string

Optional for dynamic ads and Marketplace.

Max characters: 50

Trim of the vehicle.

Example: 5DR HB SE

Y

Y

interior_color

type: string

Optional for dynamic ads and Marketplace.

Max characters: 50

Vehicle interior color.

N

Y

date_first_on_lot

type: string

Optional for dynamic ads and Marketplace.

Date when this vehicle first arrived at the dealer lot. Used to indicate inventory age. Use yyyy-mm-dd format.

Example: 2018-09-05

N

Y

Auto Inventory Catalog Fields - Dealership (Vehicle Location)

NameDescriptionUse in CreativeUse as a product set filter

address, addr1, address 1

type: string

Required for Marketplace & dynamic ads.

Complete dealership physical address, formatted as:

{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY].

The postal code is optional.

Example: {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}

N

N

address.city

type: string

Required for Marketplace.

City where the dealership is located.

Example: Palo Alto

Y

Y

address.region

type: string

Required for Marketplace.

State, county, region, or province where the dealership is located.

Example: California

Y

Y

addr.country

type: string

Required for Marketplace.

Country where the dealership is located.

Example: United States

N

Y

latitude

type: float

Required for dynamic ads & Marketplace.

Latitude of the hotel.

Example: 37.484100

N

N

longitude

type: float

Required for dynamic ads amp; Marketplace.

Longitude of the hotel.

Example: -122.148252

N

N

addr.postal_code

type: string

Optional for Marketplace.

Postal code for vehicle (outside the U.S. or zip code within the U.S.).

Example: 75008 (Paris, France) or 94025 (Menlo Park)

N

N

dealer_id

type: string

Optional for dynamic ads. Required for Marketplace.

Max characters: 100

Alphanumeric ID of the dealership.

Y

Y

dealer_name

type: string

Optional for dynamic ads. Required for Marketplace.

Max characters: 100

Name of dealership.

Y

Y

dealer_phone

type: string

Optional for dynamic ads. Required for Marketplace.

Phone number of dealership. Must be a valid phone number format and must include the country code. Required to display the Call button on a Marketplace-based listing.

Example: +1 3603453333, 001 (360)345-3333

N

N

dealer_communication_channel

type: enum

Optional for dynamic ads. Required for Marketplace.

Method with which the dealer will be contacted by the user. Available values: CHAT or LEAD_FORM. LEAD_FORM is subject to regional availability. When unavailable, every listing is forced to CHAT, regardless of the value provided.

N

N

dealer_privacy_policy_url

type: url

Optional for dynamic ads. Required for Marketplace.

Link to the privacy URL of the dealer listing the vehicle. This should match the dealer of the Facebook page ID (fb_page_id).

N

N

stock_number

type: string

Optional for dynamic ads & Marketplace.

Dealership's own designation of the car on their lot. The stock number is a way for the dealer to inventory specific vehicles.

Example: N8990

Y

Y

custom_label_0

type: string

Optional for Marketplace & dynamic ads.

Max character limit: 100

Additional information about the vehicle you want to include.

Y

Y

custom_label_1

type: string

Optional for Marketplace & dynamic ads.

Max character limit: 100

Additional information about the vehicle you want to include.

Y

Y

custom_label_2

type: string

Optional for Marketplace & dynamic ads.

Max character limit: 100

Additional information about the vehicle you want to include.

Y

Y

Auto Inventory Catalog Fields — Specific Countries — Marketplace ONLY

Some fields are specifically required by country laws or only available in specific countries. The vin is required in all countries where Marketplace is available.

CountryNameDescription

United Kingdom

France

Brazil

vehicle_registration_plate

type: string

Required for Marketplace; NA for dynamic ads.

Vehicle's registration plate. A metal or plastic plate attached to a motor vehicle or trailer for official identification purposes. All countries require registration plates for road vehicles, such as cars, trucks, and motorcycles. Whether they are required for other vehicles, such as bicycles, boats, or tractors, may vary by jurisdiction. The registration identifier is a numeric or alphanumeric ID that uniquely identifies the vehicle or vehicle owner within the issuing region's vehicle register. In some countries, the identifier is unique within the entire country, while in others it is unique within a state or province. Whether the identifier is associated with a vehicle or a person also varies by issuing agency.

Use vehicle_registration_plate instead of vin.

Germany — A CO2 emissions statement is required.

legal_disclosure_impressum_url

type: string

Required for Marketplace; NA for dynamic ads.

URL with statement of ownership and authorship (impressum).

Germany

vehicle_specifications

type: array

Required for Marketplace; NA for dynamic ads.

Specifications or features of the vehicle.

Germany

type (in vehicle_specifications)

type: string

Required for Marketplace; NA for dynamic ads.

Type of specification. Supported values are case-sensitive: CO2_emissions, gas_mileage_city, gas_mileage_highway, gas_mileage_combined

Germany

units (in vehicle_specifications)

type: string

Required for Marketplace; NA for dynamic ads.

Unit used to express the value of this specification.

Example: g/km, l/100km

Germany

value (in vehicle_specifications)

type: string

Required for Marketplace; NA for dynamic ads.

Value for this vehicle specification.

Example: 5.60

U.S. & Canada

carfax_dealership_id

type: string

Optional for Marketplace; NA for dynamic ads.

Dealership ID agreed between Carfax and a partner, enabling the dealer to show Carfax reports.

U.S. & Canada

msrp

type: string

Optional for Marketplace; NA for dynamic ads.

New vehicles only: Manufacturer's suggested retail price of vehicle and currency. Cost and currency of the vehicle. Format the price as the cost, followed by the ISO currency code, with a space between cost and currency.

Example: 32000 USD


Product Deep Links

Provide deep links in data feed following the App Links specification. Deep link information in data feed takes precedence over any information Facebook collects with App Links metadata with our web crawler.

If you already have deep link information from App Links, you do not need to specify this data. Facebook uses information from App Links to display the correct deep link. To display deep links in your ads see Dynamic Ads, Ad Template.

Note: All parameters are optional.

Name Description Example

ios_url

Custom scheme for iOS app as URL

example-ios://electronic

ios_app_store_id

App ID for App Store

1234

ios_app_name

Name of app to display

Electronic Example iOS

iphone_url

Custom scheme for iPhone app as URL

example-iphone://electronic

iphone_app_store_id

App ID for App Store

5678

iphone_app_name

Name of app to display

Electronic Example iPhone

ipad_url

Custom scheme for iPhone app

example-ipad://electronic

ipad_app_store_id

App ID for App Store

9010

ipad_app_name

Name of app to display

Electronic Example iPad

android_url

Custom scheme for Android app as URL

example-android://electronic

android_package

Fully-qualified package name for intent generation

com.electronic

android_app_name

Name of app for display

Electronic Example Android

windows_phone_url

Custom scheme for Windows Phone app as URL

example-windows://electronic

windows_phone_app_id

App ID, as a GUID, for app store

ee728e01-7727-4168-9c8f-85c7eef40112

windows_phone_app_name

Name of app for display

Electronic Example Windows

For iOS, only provide iPhone or iPad app information if they are different from the general iOS app.

Example

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

Learn more about Dynamic Ads, Product Catalog.

Step 2: Create Data Feed

You can either have a single auto feed to represent all vehicles in your catalog or multiple auto feeds where each feed represents a single dealership or a specific region's vehicles.

Supported Feed Formats

Provide your feed in the correct format: CSV, TSV, or XML. Once you create the feed file, you should host it at a URL for regular scheduled updates.

Feed Format Description & Guidelines Sample Feed

CSV

Comma-separated value.

  • The first row specifies the column header. Subsequent rows supply the corresponding values for each route.

  • Fields containing whitespace or commas should be enclosed in "double quotes". A double quote inside a double-quoted field must be escaped with two consecutive double quotes.

  • Nested or multi-value fields, such as image, can be represented using JSON-encoded values or by a set of "flattened" plain-text columns labeled using JSON-path syntax. Example: (image[0].url, image[0].tag[0], image[0].tag[1])

  • Both conventions can be used interchangeably in the same file.

See Feed CSV/TSV example, Address CSV/TSV example.

Download > Right-click > Save Link As

TSV

Tab-separated value. See guidelines for CSV.

See Feed CSV/TSV example, Address CSV/TSV example.

Download > Right-click > Save Link As

XML

Format typically generated by automated feed provider systems or web servers. A set of item XML nodes represents a product list and must begin with the <?xml declaration tag.

See Feed XML example.

Download > Right-click > Save Link As

Example - TSV file with tab delimiters

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 2017 Ford Fusion SE Ford Certified and 6-Speed Automatic. Turbocharged! Gasoline! http://www.example.com/test Ford Fusion 2017 1500 KM 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

Example — Feed with images as an 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" 2017 Ford Fusion SE Ford Certified and 6-Speed Automatic. Turbocharged! Gasoline! http://www.example.com/test Ford Fusion 2017 1500 KM "[{""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

This sample feed is as 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>2017 Ford Fusion SE</title>
      <description>Ford Certified and 6-Speed Automatic. Turbocharged! Gasoline!</description>
      <url>http://www.example.com/test</url>
      <make>Ford</make>
      <image>
        <url>http://example.com/some.image_1.jpg</url>
        <tag>Exterior</tag>
      </image>
      <model>Fusion</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>

Example - Feed 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/"

Example - Address CSV/TSV

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

Example - Feed 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>Ford B-MAX ZETEC</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>Ford</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>

Step 3: Schedule Uploads

For Marketplace, you need approval from the Facebook Support team. Contact your Facebook Partner Manager or at commerce-partnerships@fb.com with the catalog's ID. You should schedule feed uploads to automatically push the latest vehicle inventory data to Facebook instead of uploading refreshed files manually.

For details on how to schedule feed uploads, see Catalog - Schedule Product Feed Fetches.

You can download a sample feed (CSV, TSV, XML format) if you try to create an auto catalog via Catalog Manager.

See also Direct Upload Feed Reference and Catalog Feed Debugger.

Debug Your Automotive Feed (Optional)

Using the Product Feed Debug Tool, you can paste in a product feed, and validate the feed for errors and warnings.

To debug your automotive feed, in the catalog selection drop-down menu, select Vehicles.

This is helpful in the early stages of integrating automotive inventory ads to discover whether the current feeds you may already have are supported by Facebook.

Step 4: Create Vehicle Sets

Reference Docs

After the catalog upload is set up and working properly, you can create vehicle sets.

A vehicle set is a subset of your catalog. Vehicle sets are defined by filters that are applied to the Vehicle catalog. For example, you can create a vehicle set with all vehicles with a year later than 2015. Note: A vehicle set with all vehicles in your catalog is pre-created for you.

Example - Create a vehicle set containing all the vehicles that manufactured in 2016

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$vehicle_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$vehicle_set->setData(array(
  ProductSetFields::NAME => 'Test Vehicle Set',
  ProductSetFields::FILTER => array(
    'year' => array(
      'eq' => 2016,
    ),
  ),
));

$ vehicle_set->create();

The filter parameter is made up of the following operators and data:

OperatorsThe type of filter

i_contains

Contains substring. Operator is case insensitive.

i_not_contains

Does not contain substring. Operator is case insensitive.

contains

Contains substring. Operator is case insensitive.

not_contains

Does not contain substring. Operator is case insensitive.

eq

Equal to. Operator is case insensitive.

neq

Not equal to. Operator is case insensitive.

lt

Less than. For numeric fields only.

lte

Less than or equal to. For numeric fields only.

gt

Greater than. For numeric fields only.

gte

Greater than or equal to. For numeric fields only.

Marketplace Best Practices

Currently, Marketplace only supports used and certified pre-owned Vehicles. All vehicle mileage must be over 500 miles. Listings with less than 500 miles (or equivalent in km) will be rejected, unless they have a registration plate.

Images

  • Provide as many high quality photos as possible. Posts with at least 15–20 photos tend to perform the best.
  • Photos should be at 960x720 resolution or better.
  • Provide the following images:
    • 1 - Front 3/4 angle
    • 2 - Cockpit,
    • 3 - Side, back
    • 4 - Interior
    • 5 - Dents, dings & excessive wear
    • 6 - Engine
    • 7 - Wheels
  • Clearly show any damage or excessive wear.
  • Only include images of the vehicle itself. Don't add any brand or dealership overlays or graphics.
  • Listings with less than 2 images will be rejected.

Learn more about Marketplace Vehicles best practices.

Upload Your Listings

  1. Select one listing partner. Listing inventory through multiple partners will yield suboptimal results. Selecting one provider enables you to attribute Marketplace to the correct provider and measure performance accordingly.
  2. Upload your full inventory of pre-owned vehicles. To maximize your dealership’s presence on Marketplace, send 100% of your available used vehicle inventory across all price points.
  3. Provide a complete vehicle description. Provide as much information as you have available about each vehicle, including notation of any damages.
  4. Provide proper contact information. Always include a dealership phone number.

Scheduled Vehicles Feed Fetches

Facebook fetches vehicles feeds from your system on a schedule you define. There are two types of schedule you can define:

  • Update Schedule — The uploads would either create new items or update existing ones with the information provided in the feed file.
  • Replace Schedule — The uploads would result in a complete refresh operation on your feed - we delete vehicles not present in the file, update existing ones, and create new ones.

Full Error Reporting / Catalog Debugging

This functionality is in beta.

For more details, see "How can I see the full error list of my catalog?" in the Marketplace FAQ list.