Facebook Automotive Inventory Ads Feed

Facebook automotive feed ads

Learn how to create and submit an automotive feed for Facebook. Let’s get started… 

You’ll need to share information with Facebook in order to promote your automotive inventory on the platform. This can be achieved by creating an automotive catalog and then filling it with automotive details.

To build 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 to advertise, which are listed below.

 

1. Determine Your Auto Catalog Feed

Mandatory Fields for Auto Catalog Feed – Vehicle-Specific Details

All enum fields are case-insensitive.

NameTypeDescriptionCan use in Creative?Can use as a product set filter?

vehicle_id

String, max 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.

 

Y

vin

String

VIN number of the vehicle. Note: VIN must be exactly 17 characters.

Y

Y

make

String

Make or brand of the vehicle, such as Ford.

Y

Y

model

String

Model of the vehicle, such as Focus.

Y

Y

year

int

Year the vehicle was launched in yyyyformat, such as 2015.

Y

Y

transmission

enum

Values accepted: Automatic or Manual.

 

Y

body_style

enum

Body style of the vehicle: CONVERTIBLECOUPEHATCHBACKMINIVANTRUCKSUVSEDANVANWAGONCROSSOVER, or OTHER.

Y

Y

description

String (max 5000 characters)

Short text describing the vehicle.

Y

 

exterior_color

String

Vehicle color. Ex: blackwhiteblue

Y

Y

image[0].tag[0]

String

Tag for first vehicle image. You can have 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]….

 

Y

image[0].url

String

The URL of the vehicle image. 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). If you have more than one vehicle image, follow this naming convention: image[1].urlimage[2].url, and so on. You can provide up to 20 images for the vehicle. You must provide at least one image. Each image can be up to 4 MB in size.

  

mileage.value

int

Mileage of the vehicle in kms or miles, for used vehicles. Zero (0) for new vehicles.

Y

Y

mileage.unit

String

Mileage units: MI or KM

Y

 

url

url

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

  

title

String

Title of vehicle, such as “2017 Ford Focus 5DR HD SE”; 500 characters (max).

Y

Y

price

String

Cost of vehicle and currency. Currency should follow ISO 4217 currency codes such as USD 13,999.

Y

Y

state_of_vehicle

enum

Whether the vehicle is new or used. Values supported are: NewUsed, or CPO (certified pre-owned).

 

Y

 

Mandatory Fields for Vehicle Catalog Feed – Dealership (Vehicle Location)-Specific Details

 

NameTypeDescriptionCan use in Creative?Can be used as product set filter?

address

object

Complete address for the dealership (vehicle location) that must be resolvable to its location.

  

addr1 (address object)

String

Street address of dealership, such as 675 El Camino Real.

  

city (address object)

String

City dealership is in, such as Palo Alto.

Y

Y

region (address object)

String

State, county, region, or province for dealership, such as California.

Y

Y

country (address object)

String

Country, such as United States.

 

Y

longitude

float

Dealership’s longitude, such as –122.148252.

  

latitude

float

Dealership’s latitude.

  

Optional fields include:

NameTypeDescriptionCan use in Creative?Can be used as product set filter?

drivetrain

enum

Vehicle drivetrain. Expected values: 4X24X4AWDFWDRWDOther.

 

Y

fuel_type

enum

Vehicle fuel type. Accepted values: DieselElectricFlexGasolineHybridOther.

 

Y

trim

String

Trim of the vehicle, such as 5DR HB SE; 50 characters (max).

Y

Y

tag (image tag)

String

String of image description. There can be multiple tags associated with an image, such as ExteriorInteriorStockImage.

  

interior_color

String

Vehicle interior color.

 

Y

condition

enum

Condition of the vehicle. Expected values: excellentgoodfairpoor, or other.

 

Y

sale_price

int

Sale price or special price.

Y

Y

date_first_on_lot

String

Date this vehicle first arrived at the dealer lot. Used to indicate inventory age. Should be in date format yyyy-mm-dd; for example, 2018-09-05

 

Y

availability

enum

Vehicle availability: available or not available. Note: We do not show vehicles that are unavailable in the ad.

  

dealer_id

String

Alphanumeric identifier of the dealer; 100 characters (max).

 

Y

dealer_name

String

Name of dealer; 100 characters (max).

Y

Y

dealer_phone

string

Phone number of dealer.

  

postal_code, in address object

String

Postal code or zip code of dealer.

  

custom_label_0 (max size: 100)

String

Optional. Additional information about item.

Y

Y

vehicle_type

enum

Type of vehicle. Expected values: car_truck (default if not supplied), boatcommercialmotorcyclepowersportrv_campertrailer, or other.

  

 

Optional Fields, Product Deep Links

 

Provide deep links in Product Feed following the App Links specification. Deep link information in Product 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.

 

NameDescriptionExample

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

Step 2: Create Data Feed

There are two options, 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.

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 frequently scheduled updates.

You have these available feed options:

  • A single vehicle feed to represent all vehicles in your catalog
  • Multiple vehicle feeds where each feed represents a single dealership or region’s vehicles

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>

You have these available feed options:

  • A single vehicle feed to represent all vehicles in your catalog
  • Multiple vehicle feeds where each feed represents a single dealership or region’s vehicles
 

Step 3: Schedule Uploads

Rather than uploading refreshed files manually, you should schedule feed uploads to automatically push the latest vehicle inventory data to Facebook.

For more info on how to schedule feed uploads, see Product 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 as shown below:

 

Step 4: Debug your Automotive Feed

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.

You’ll find that this is helpful in the early stages, to discover whether the current feeds you may already have are supported by Facebook.

 

Step 5: Create Vehicle Sets

Once 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 instance, you can create a vehicle set with all vehicles with a year later than 2015. Note: You can also create a vehicle set without any filters, where the vehicle set contains all vehicles in your catalog.

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

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

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.

Our full-service team of experts will ensure your Automotive ads are optimized and delivering the desired results. Take a look at some of our other Automotive solutions below:

Auto Parts Feed (Online product visibility)

Dynamic Text Ads (Best option for Car Dealers)

Remarketing on Google & Facebook (Bring your visitors back to increase chance of closing sale)

The Feedonomics Experience

See how we can help your business today!

Find out why over 30% of the top 1,000 Internet Retailers choose Feedonomics.