Set up your catalogue for dynamic ads for automotive

30/11/2019
If you are a developer, visit Facebook for Developers for catalogue and feed setup documentation.

To complete dynamic ads for automotive, you will need to create a catalogue and data feeds.

A catalogue is a file that contains your inventory data, i.e. a list of vehicles, new or used, that you have for sale. A data feed is the actual data file containing the details about your vehicle inventory that is used to populate the catalogue, i.e. each individual vehicle that is displayed on your website or app. Data feeds are dynamic uploads of your data to keep your catalogue up to date.

There are two steps to completing a catalogue:

Step 1: Create your catalogue

The following instructions will guide you through how to create a catalogue in Business Manager. Bear in mind that you can also create your catalogue from Ads Manager.

    To upload a catalogue to Facebook Business Manager:
  1. In your Business Manager, click Business settings in the top-right.
  2. Under the People and assets tab on the right-hand side, select Catalogues and then click + Add.
  3. Note: Admin access will be required for anyone planning to add/update a catalogue.
  4. Select Create a new catalogue, or Request access to a catalogue if you're requesting access to an existing catalogue, and follow the on-screen instructions.
  5. If you select Create a new catalogue, start by assigning a name to it, then select Type > Vehicles. Click Create Catalogue when you're ready.
  6. Decide whether you want to give people access to your catalogue and/or pixel, or skip this and click OK.

    Now that your catalogue has been created, you can upload your data feed.
Step 2: Create/upload your data feed
The inventory items in your data feed are the different vehicles that you're advertising. You can list all of your vehicles in the same feed or submit separate feeds for certain vehicle groups, e.g. all SUVs under the same brand.
Create your data feed

Add required fields to your data feed by creating a file with the column names below. They'll need to be written exactly as they appear in the Required fields chart below for your file to upload correctly. It's important to note that all column names (file headers) must be in US English.

See the Supported data feed formats and sample files section below this table for information on how to input these fields correctly based on the file format you're using. Facebook supports the following file types: CSV, TSV, RSS XML or ATOM XML.

Required fields for automotive

To use a catalogue, please make certain that your feed includes the required fields listed below.

Field_typeNameTypeDescriptionCan it be used in creative?Can it be used as product set filter?
Genericvehicle_idString (max. 100)Unique ID for item. Can be a variant for a product. If there are multiple instances of the same ID, we ignore all instances.Y
Vehicle-specific detailsvinStringVIN number of the vehicle.Y
makeStringMake or brand of the vehicle. E.g. FordYY
modelStringModel of the vehicle. E.g. FocusYY
body_styleenum

Body style of the vehicle.

Convertible

Coupe

Hatchback

Minivan

Truck

SUV

Saloon

Van

Pick-up

Crossover

Other
YY
imageobjectImage data for this vehicle. You can provide up to 20 images for the vehicle. Each image contains two fields: URL and tag. You can associate multiple tags with an image. You must provide at least one image. Each image can be up to 4 MB in size.
image:url (subset of image object above)StringThe URL of the vehicle image. Please note that if you want to use carousel ads, provide square 1:1 aspect ratio images which are 600 x 600 pixels. To show single vehicle ads, provide images with 1.91:1 aspect ratio image at 1,200 x 630 pixels.
mileage.valueintMileage of the vehicle in kilometres or miles (for used vehicle). This will be zero for new vehicles.YY
mileage.unitStringMileage units "MI" or "KM".YY
urlurlLink to the external site where you can view destination page.
titleStringTitle of vehicle (e.g. 2017 Ford Focus 5DR HD SE).Y
priceStringCost of vehicle and currency. Currency should follow ISO 4217 currency codes, such as 13,999 GBP.YY
state_of_vehicleenumEssential to know whether the vehicle is new or used. Values supported are: New, Used or CPO (certified pre-owned).Y
exterior_colorStringVehicle exterior colour. E.g.: black, white, blueY
Dealership-specific detailsaddressobjectA complete address for the dealership that must be resolvable to its location.Y
Dealership-specific details(address object) addr 1StringStreet address of dealership, e.g. 123 Birch Way.
(address object) cityStringCity dealership is in, e.g. Manchester.Y
(address object) regionStringState, county, region or province for dealership, e.g. Greater Manchester.Y
(address object) countryStringCountry, e.g. United Kingdom.
latitudefloatThe latitude of the dealership, e.g. 51.443737.Y
longitudefloatThe longitude of the dealership, e.g. 1.029968.Y
Optional fields for automotive
Field_typeNameTypeDescriptionCan it be used in creative?Can it be used as product set filter?
Vehicle-specific detailstrimStringTrim of the vehicle, e.g. 5DR HB SE.Y
transmissionenumTransmission type of the vehicle. Expected values are: Automatic or ManualY
drivetrainenum

Drivetrain of the vehicle. Expected values are: 4X2,

4X4, AWD, FWD, RWD, Other
Y
fuel_typeenumFuel type of the vehicle. Values accepted: Diesel, Electric, Flex, Gasoline, Hybrid or Other
tag (image tag)StringA string that represents what's in the image. There can be multiple tags associated with an image, such as Exterior, Interior, StockImage.Y
interior_colorStringVehicle interior colour.
conditionenumCondition of the vehicle. Values expected are: excellent, good, fair, poor, other.
sale_priceintSale price/special price.
availabilityenumAvailability of the vehicle. AVAILABLE, NOT_AVAILABLE. Note: We will not show vehicles that are not available in the ad.
custom_label_0 (max size: 100)StringOptional, additional information about vehicle if needed.
date_first_on_lotStringDate vehicle was first available for sale on the forecourt.Y
Dealership-specific detailsdealer_idStringAlphanumeric identifier of the dealer.
dealer_nameStringName of dealer.Y
(address object) postal_codeStringPostal code/ZIP code of dealer.
dealer_phoneStringPhone number of dealer.
Supported data feed formats and sample files

Below you'll find a chart that provides information on the types of vehicle feed formats available, as well as sample files.

File formatDescriptionSample file
CSV, TSVA simple, compact tabular format that can be edited and exported by most spreadsheet applications. The first row must list the chosen field names in the order the values will be given. Subsequent rows then supply the corresponding values for each vehicle. According to convention, fields containing whitespace or commas should be enclosed in "double quotes". Nested or multi-value fields such as address, neighbourhood or image can be represented using JSON-encoded values or by a set of "flattened" plain-text columns labelled using JSON-path syntax (e.g. address.city, neighbourhood[0], image[0].url, image[0].tag[0], image[0].tag[1]). Both conventions can be used interchangeably in the same file.

TSV "flattened" style - sample file

CSV "flattened" style - sample file

XMLThis format would typically be generated by automated feed provider systems. A root XML node encloses a set of nodes, each of which represents a vehicle. The file must begin with a valid

XML - sample file

Common issues
  • Make sure that the image URLs in your catalogue link to high-quality images that are appropriate for Facebook News Feed. For example, if you plan to advertise using the Carousel format, we recommend image sizes of at least 600 x 600. Alternative image sizes will be accepted, but may be cropped. See the complete image guide.
  • The product catalogue also supports deep-linking into apps. For more information, visit our developer site.
Upload your data feed to a catalogue in Business Manager
To upload your data feed:
  1. Select the catalogue that you want to upload a data feed for and click Add Vehicle Feed.

  2. Choose your feed name and set your currency, then choose your upload type:
    • Scheduled recurring uploads: When you choose this option, you can upload your feed at scheduled intervals from a website where your feed is hosted.
    • Single upload: When you choose this option, you can upload your feed manually for a one-off upload. If you choose this option, you'll need to upload your feed manually whenever you change the file.
    Click Next.
  3. Complete the final steps, including providing a feed URL, and click Create Feed.

Note: Data feeds can be separated by tab or comma.

For more details on data feeds, visit our developer site.

Once your catalogue is uploaded, click below to learn best practices, how to view your catalogue, how to debug your feed and more.

Recommendations
  • If you have a catalogue, and you're breaking it into multiple feeds, make sure that the same item (product, hotel, vehicle etc.) belongs to the same feed every time. Do not randomly assign the same item to different feeds each day.
  • We recommend that you enter a feed URL and schedule either hourly, daily or weekly upload frequencies in order to automatically keep your catalogue up to date. This helps you avoid showing ads for out-of-stock inventory and automatically add new inventory as your catalogue changes.
  • To represent your inventory accurately, you should update your data feeds as often as your product inventory changes. Most advertisers have found an hourly update to be sufficient. If you need more frequent updates, you can connect to the API directly to enable more frequent updates.
  • In some cases, you may have to make changes to the encoding and delimiter settings. For example, for catalogues that use quotes (") in their description column, you may need to tick the quoted fields checkbox. Work with your feed management provider to understand the settings that are necessary for your catalogue.
Viewing your catalogue
  • Depending on the size of your file, your catalogue may take several minutes to one hour to upload. When it successfully uploads, it will appear in your Business Manager on the product catalogues page.
  • On the catalogues page, you can see when the feed was last updated, how many products were added, removed or updated, and how many errors occurred.
  • You may receive several warnings or errors the first time you upload your catalogue. Warnings are recommendations for things to fix to improve the quality of your ads. Errors indicate that a feed was not processed and that you need to fix your feed before proceeding.
  • If you already have a catalogue and need to make an update, find your existing catalogue in Business Manager in the Data feeds section. Click the name of the data feed and select Upload Now.
Associate your pixel or app

You may be asked to associate your Facebook pixel or app to your catalogue. This is necessary in cases where your business has more than one catalogue, Facebook pixel or app. Associating your pixel or app tells Facebook which pixel or app will match which catalogue.

To associate your pixel:
  1. In the assets menu, click on Catalogues.
  2. Select your catalogue.
  3. Click on Catalogue settings in the top menu.
  4. At event sources, click on Edit.
  5. Assign pixels and apps to your catalogue.

Note: If you are a developer, visit Facebook for Developers for more information on associating your pixel with your catalogue via Business Manager or the API.

Add vehicle sets

A vehicle set is a list of inventory in a catalogue that you can use to advertise. Each catalogue can have more than one vehicle set. For example, you can create a vehicle set of all the saloons in your catalogue and a separate vehicle set for all the SUVs in your catalogue. Vehicle sets are defined by certain filters in a catalogue and are created when you set up your ad campaign. Please refer to the catalogue above to find the specific fields that you can create a vehicle set with.

Note: Only catalogue admins can create vehicle sets.

To create a vehicle set:

    1. Go to Catalogue Manager.
    2. Choose the catalogue that will contain your new vehicle set.
    3. In the top navigation bar, click Vehicle sets.
    4. Click Create Vehicle Set. A window appears where you can add filters for your catalogue.
    5. Enter a name for your vehicle set.
    6. Use the drop-down menus to apply filters to your vehicle set.
    7. Click Create.

Validate your feed with the Product Feed Debug Tool

The Product Feed Debug Tool allows you to paste in a product feed and validate the feed for errors and warnings without creating an upload session or adding products to your product catalogue. This is helpful in the early stages of integration when you don't have a product catalogue and haven't fully flushed out a feed yet. You can just paste in your test feed, detect the errors and warnings and ensure that the feed format is correct before actually setting it up for all your products.

Try the Product Feed Debug Tool.

Complete your dynamic ad for automotive:

Implement a pixel and/or mobile SDK

Create an ad template

* Nguồn: Facebook