Set up your catalogue for dynamic ads for automotive
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:
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:
- In your Business Manager, click Business settings in the top-right.
- Under the People and assets tab on the right-hand side, select Catalogues and then click + Add. Note: Admin access will be required for anyone planning to add/update a catalogue.
- 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.
- 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.
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.
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.
To use a catalogue, please make certain that your feed includes the required fields listed below.
Field_type | Name | Type | Description | Can it be used in creative? | Can it be used as product set filter? |
---|---|---|---|---|---|
Generic | vehicle_id | String (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 details | vin | String | VIN number of the vehicle. | Y | |
make | String | Make or brand of the vehicle. E.g. Ford | Y | Y | |
model | String | Model of the vehicle. E.g. Focus | Y | Y | |
body_style | enum | Body style of the vehicle. Convertible Coupe Hatchback Minivan Truck SUV Saloon Van Pick-up Crossover Other | Y | Y | |
image | object | Image 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) | String | The 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.value | int | Mileage of the vehicle in kilometres or miles (for used vehicle). This will be zero for new vehicles. | Y | Y | |
mileage.unit | String | Mileage units "MI" or "KM". | Y | Y | |
url | url | Link to the external site where you can view destination page. | |||
title | String | Title of vehicle (e.g. 2017 Ford Focus 5DR HD SE). | Y | ||
price | String | Cost of vehicle and currency. Currency should follow ISO 4217 currency codes, such as 13,999 GBP. | Y | Y | |
state_of_vehicle | enum | Essential to know whether the vehicle is new or used. Values supported are: New, Used or CPO (certified pre-owned). | Y | ||
exterior_color | String | Vehicle exterior colour. E.g.: black, white, blue | Y | ||
Dealership-specific details | address | object | A complete address for the dealership that must be resolvable to its location. | Y | |
Dealership-specific details | (address object) addr 1 | String | Street address of dealership, e.g. 123 Birch Way. | ||
(address object) city | String | City dealership is in, e.g. Manchester. | Y | ||
(address object) region | String | State, county, region or province for dealership, e.g. Greater Manchester. | Y | ||
(address object) country | String | Country, e.g. United Kingdom. | |||
latitude | float | The latitude of the dealership, e.g. 51.443737. | Y | ||
longitude | float | The longitude of the dealership, e.g. 1.029968. | Y |
Field_type | Name | Type | Description | Can it be used in creative? | Can it be used as product set filter? |
---|---|---|---|---|---|
Vehicle-specific details | trim | String | Trim of the vehicle, e.g. 5DR HB SE. | Y | |
transmission | enum | Transmission type of the vehicle. Expected values are: Automatic or Manual | Y | ||
drivetrain | enum | Drivetrain of the vehicle. Expected values are: 4X2, 4X4, AWD, FWD, RWD, Other | Y | ||
fuel_type | enum | Fuel type of the vehicle. Values accepted: Diesel, Electric, Flex, Gasoline, Hybrid or Other | |||
tag (image tag) | String | A string that represents what's in the image. There can be multiple tags associated with an image, such as Exterior, Interior, StockImage. | Y | ||
interior_color | String | Vehicle interior colour. | |||
condition | enum | Condition of the vehicle. Values expected are: excellent, good, fair, poor, other. | |||
sale_price | int | Sale price/special price. | |||
availability | enum | Availability 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) | String | Optional, additional information about vehicle if needed. | |||
date_first_on_lot | String | Date vehicle was first available for sale on the forecourt. | Y | ||
Dealership-specific details | dealer_id | String | Alphanumeric identifier of the dealer. | ||
dealer_name | String | Name of dealer. | Y | ||
(address object) postal_code | String | Postal code/ZIP code of dealer. | |||
dealer_phone | String | Phone number of dealer. |
Below you'll find a chart that provides information on the types of vehicle feed formats available, as well as sample files.
File format | Description | Sample file |
---|---|---|
CSV, TSV | A 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 |
XML | This 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 |
- 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.
- Select the catalogue that you want to upload a data feed for and click Add Vehicle Feed.
- 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.
- 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.
- 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.
- 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.
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:- In the assets menu, click on Catalogues.
- Select your catalogue.
- Click on Catalogue settings in the top menu.
- At event sources, click on Edit.
- 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.
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:
- Go to Catalogue Manager.
- Choose the catalogue that will contain your new vehicle set.
- In the top navigation bar, click Vehicle sets.
- Click Create Vehicle Set. A window appears where you can add filters for your catalogue.
- Enter a name for your vehicle set.
- Use the drop-down menus to apply filters to your vehicle set.
- Click Create.
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.
* Nguồn: Facebook