Set up your catalogue for dynamic ads for products

30/11/2019

To show your products in a dynamic ad, you need to create a catalogue. A catalogue is a container that stores all of your product information. A catalogue allows Facebook to generate dynamic ads for your products and show personalised recommendations to people who view your ad.

There are three parts that make up your catalogue:

  • A catalogue, which acts as a container for your product information.

  • A data feed, which contains the image URLs, descriptions, prices, availability and other attributes for all of the products that you want to advertise. You can have multiple data feeds within a catalogue.

  • A product set, which is a group of items from your inventory in a catalogue. Product sets allow you to control the items that appear in your ad. When you create a product set, you use filters (such as availability, brand, category, product type or price) to define what goes into the product set.

Note: If you're using Business Manager, you need to be assigned as an employee of your business, or be an employee of an agency assigned to a business, to upload a catalogue. If you plan on creating new catalogues, you need to have the catalogue admin role in Business Manager. Learn more about catalogue roles and their permissions.

Already have a catalogue with a feed management partner? You can upload the catalogue directly to Facebook. Browse feed management partners.

In this article:

Data feed basics

Setting up your data feed correctly is important if you want to have a successful catalogue. If you leave out required information in your data feed, your catalogue may not work properly. If you're creating a data feed file, you can use these supported file formats: CSV, TSV, XML (RSS) and XML (ATOM).

CSV/TSV

This format is typically associated with spreadsheet programs (for example, Microsoft Excel). With this format, you list all of the information about your products in different columns. In the first row, you enter the names of each attribute that makes up your inventory. In the subsequent rows, you enter the information about your products. For example, a product's title would be included under the "title" column. Each of these values make up the inventory that you want to promote through the Facebook family of apps and services.

CSV example (click or tap to expand)
product_idTitleLinkDescriptionproduct_category
13028Rugs for every...www.jaspers.com...Imported from Tu...Area rugs
4820217Keep warmwww.jaspers.com...Thousands of throw...Blankets
84902Untz-Untzwww.jaspers.com...Get the best sound...Stereo system
730202Fashionistas...www.jaspers.com...Made from 100%...Handbags

XML (ATOM / RSS)

This format is typically associated with coding programs (for example, ATOM) or basic text editors. With this format, you use a series of "tags" for each product in your inventory. Each product is enclosed in these tags. With XML, you can use an automated feed provider system or web server. Your data feed file should begin with a valid

XML example (click or tap to expand)

Test store

DB_1

Dog Bowl in Blue

Solid plastic Dog Bowl in marine blue colour

http://www.example.com/bowls/db-1.html

http://images.example.com/DB_1.png

Example

new

in stock

9.99 GBP

UK

Standard

4.95 GBP

Animals > Pet Supplies

Create a data feed

To begin creating your data feed:

  1. Open a supported data feed file format: CSV, TSV or XML.
  2. Add the required fields below to your data feed. Enter them exactly as they appear here for your file to upload correctly.

    Note: While you can use non-English data in each field of the feed, the column names need to be in US English only.
Required fields for products
Need examples? Right-click and save either of the following links to your computer to see how the feed file looks in different formats.
Column nameDescription/GuidelinesExample
idEnter a unique ID for the item, such as an SKU. If there are multiple instances of the same ID, these will be ignored.

Max. characters: 100
FB_product_1234
availabilityThe current availability of the item in your shop. Make sure that you indicate the availability of the item on your shop page and keep it up to date.

Supported: in stock, available for order, pre-order, out of stock, discontinued
in stock
conditionThe current condition of the item in your shop.

Supported: new, refurbished, used
new
descriptionA short description of the item.

Max. characters: 5000
A vibrant crewneck for all shapes and sizes. Made from 100% cotton.
image_linkThe URL for the image used in your ad. For square (1:1) aspect ratios in the carousel ad format, your image should be 600x600. For single image ads, your image should be at least 1200x630.https://www.facebook.com/t_shirt_image_001.jpg
linkThe URL of the website where you can buy the item.https://www.facebook.com/facebook_t_shirt
titleThe title of the item.

Max. characters: 500
Facebook T-shirt (Unisex)
priceThe cost and currency of the item. The price is a number followed by the currency code (ISO 4217 standards).9.99 USD
gtin*The Global Trade Identification Number for the item.

Supported: UPC (North America – 12 digits), EAN (Europe – 13 digits), JAN (Japan – 8 or 13 digits), ISBN (books – 13 digits)

Max. characters: 70
1234567891011
mpn*The Manufacturer Part Number for the item.

Max. characters: 70
100020003
brand*The brand name of the item.

Max. characters: 70
Facebook

*Either gtn, mpn or brand is required for the data feed.

Optional fields for products
Column nameDescription/GuidelinesExample
additional_image_linkYou can include up to 10 additional links to images for the same product. These should be separated by commas in the field.

Max. characters: 2,000
https://www.facebook.com/t_shirt_image_001.jpg, https://www.facebook.com/t_shirt_image_002.jpg
age_groupThe recommended age group for the product.

Supported values: newborn, infant, toddler, kids, adult
adult
colorThe colour of the product.

Max. characters: 100
Blue
expiration_dateThe product's expiry date. When the product expires, Facebook excludes it from all product sets and does not display it in ads.2018-05-31
genderThe product's gender.

Supported values: male, female, unisex
unisex
item_group_idIf you have multiple versions of the same product (for example, a red polo shirt in a product group containing polo shirts), assign an item group ID to all variants. Facebook then maps the item group ID to your overall product group ID. When you run an ad, Facebook picks one item out of the group based on relevance or popularity.FB_tshirt_variant_001
google_product_categoryPredefined values from Google's product taxonomy. For example, Apparel & Accessories > Clothing > Dresses or 2271. When you use a Google product category, you can use it for categories in dynamic ads.

Max. characters: 250
Apparel & Accessories > Clothing > Shirts & Tops
materialThe product's material.

Max. characters: 200
cotton
patternThe product's pattern or graphic print.

Max. characters: 100
plaid
product_typeThe product's category, based on your specifications. For example, Apparel & Accessories > Clothing > Shirts & Tops. When you use a product type, you can use it in categories for dynamic ads.

Max. characters: 750
Apparel & Accessories > Clothing > Shirts & Tops
sale_priceThe sale price of the product. The price is a number followed by the currency code (ISO 4217 standards).4.99 GBP
sale_price_effective_dateThe start and end date and time for the sale, separated by a slash. Start and end dates should be written as YYYY-MM-DD. Add a "T" after each date and then include the time. The time should follow the 24-hour format (0:00 to 23:59). For example, 2018-11-01T12:00-03:00/2018-12-01T00:00-03:00.2018-11-01T12:00-03:00/2018-12-01T00:00-03:00
shippingThe price for delivery of the product. For free delivery, the price should be 0.0. For every region where you deliver your products, separate them with a comma. For example, US:CA:Ground:0.0,US:NY:Air:0.0.US:NY:Air:15.99 USD
shipping_weightThe delivery weight of the product. We only accept these units of weight: lb, oz, g, kg. Example: 3 lbs

Supported values: lb, oz, g, kg
5.5 oz
sizeThe size of the product.XS
custom_label_0Optional, additional information about product. For additional labels, add any subsequent numbers. For example, custom_label_1, custom_label_2, etc.Additional features
Deep links for apps

You can also add deep links to your app in your data feed. Deep links allow you to send people to your mobile app instead of your website.

Column nameDescription/GuidelinesExample
ios_urlA custom URL for an iOS app.example-ios://electronic
ios_app_store_idThe app ID on the App Store.1234
ios_app_nameThe name of the app.iOS App
iphone_urlA custom URL for an iPhone app.example-iphone://electronic
iphone_app_store_idThe app ID on the App Store.5678
iphone_app_nameThe name of the app.iPhone App
ipad_urlA custom URL for an iPad app.example-ipad://electronic
ipad_app_store_idThe app ID on the App Store.9010
ipad_app_nameThe name of the app.iPad App
android_urlA custom URL for an Android app.example-android://electronic
android_packageFully qualified package name for intent generationcom.electronic
android_app_nameThe name of the app.Android App

When you've finished creating your feed, use the feed debug tool to check your feed for errors and warnings. To use the feed debug tool, paste your feed into the box and then click Validate.Try the feed debug tool.

Are you a developer? Visit our developer site for detailed documentation about data feeds.

Create a catalogue

There are two tools you can use to create a catalogue: Catalogue Manager and Business Manager. Catalogue Manager allows you to build your catalogue of inventory – products, flights, hotels, properties and more – and use them in a variety of Facebook ad types. Business Manager allows you to do the same, while also allowing you to control access to your catalogue if you have multiple people in your Business Manager.

Use Catalogue Manager (recommended)
  1. Go to Catalogue Manager.
  2. Click Create catalogue.
  3. Select E-commerce as your catalogue type and click Next.
  4. Select the ad account for the catalogue and enter a name for your catalogue.
Use Business Manager
  1. Go to Business Manager.
  2. Click Data sources.
  3. Click Catalogues.
  4. Click + Add.
  5. Select Create a New Catalogue. To request access to a catalogue owned by another business, select Request Access to a Catalogue instead and follow the on-screen instructions.
  6. Enter a name for your catalogue.
  7. Open the drop-down menu and select Products.
  8. Click Create catalogue.
  9. Decide whether you want to give people access to your catalogue and/or pixel, or skip this and click OK.

Now that you've created your catalogue, you can upload your data feed.

Upload a data feed

To add a data feed to your catalogue:

  1. Go to Catalogue Manager.
  2. Choose the catalogue you want to update. If you haven't created a catalogue yet, create one first before you add the feed.
  3. Click Data sources.
  4. Click Add Data Source.
  5. Click Use data feeds and click Next.
  6. Choose how you want to upload the feed:
Upload once

Choose this option if your inventory changes rarely. If you make changes to your feed, you'll need to upload the feed to Facebook again for the changes to take effect.

  1. Drag and drop the file from your computer. Alternatively, click Upload file and search for the file on your computer.
  2. Enter a name for your feed.
  3. Choose the currency type for your feed. The currency type is used for your feed if you don't specify it in your feed file.
  4. Click Next.
  5. Review your file for any errors. If you're missing any required columns in your file, or there are columns that Facebook doesn't recognise, you can map them to the appropriate columns here. Any columns mapped here are saved for future feed uploads.
  6. Click Next. Your items are uploaded to Facebook.
Set a schedule

Choose this option if your feed changes often. If you make changes to your feed, your feed is automatically updated at the next scheduled upload. If you choose this option, you should make sure your feed file is already hosted on a website (for example, Dropbox or an FTP client).

  1. Choose how frequently you want Facebook to check your feed for updates. You can choose Daily, Hourly and Weekly.
  2. Choose when you want Facebook to check your feed for updates. You can choose the time and time zone. If you choose Hourly or Weekly as your frequency, you can also specify when your scheduled upload is repeated.
  3. Enter the URL where your feed is located. Make sure your URL starts with "http://" or "https://".
  4. Enter the username and password for the feed provider. This is different to the username and password you use to access your Facebook ad account.
  5. Click Next.
  6. Review your file for any errors. If you're missing any required columns in your file, or there are columns that Facebook doesn't recognise, you can map them to the appropriate columns here. Any columns mapped here are saved for future feed uploads.
  7. Click Next. Your items are uploaded to Facebook.

Create a product set

A product set is a group of items from your inventory in a catalogue. Product sets allow you to control the items that appear in your ad. When you create a product set, you use filters (such as availability, brand, category, product type or price) to define what goes into the product set. To create a product set, you need to be an admin in the catalogue you represent. Learn more about setting up roles for the catalogue.

  1. Go to Catalogue Manager.
  2. Choose the catalogue that will contain your new product set.
  3. Click Product sets.
  4. Click Create New Product Set. A window appears where you can add filters for your catalogue.
  5. Enter a name for your product set.
  6. Use the drop-down menus to apply filters to your product set. For example, if you want to create a product set for all clothing greater than £50 in your catalogue, select the drop-down menus Price and Category, and then enter the appropriate values into the text field. The filters then match the column names and products from your product catalogue.

  7. Click Create.

Learn more about creating a product set.

Best practices

Setting up your catalogue

  • If you're using multiple data feeds in one catalogue, make sure that the same item belongs to the same feed every time. If the item is assigned randomly to different feeds, this may impact delivery and result in lower-quality recommendations.

Updating your catalogue

  • Schedule updates to your catalogue so that you can keep it up to date and prevent your ads from showing out-of-stock products. You can schedule updates to your catalogue on a daily, hourly or weekly basis. If you need more frequent updates, you can either connect to the API directly or work with a Facebook Marketing Partner to enable more frequent updates. Learn more about scheduling updates to your catalogue.

Uploading your catalogue

  • Depending on the size of your file, your catalogue may take several minutes or hours to upload. When the upload finishes, the catalogue appears in Catalogue Manager.
  • 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, go to Catalogue Manager and open the catalogue, then select the Data sources tab. Select the data feed that you want to update, then click Settings.

Associating 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. Learn more about associating a pixel or app to your catalogue.

Setting up product IDs or product groups

You have the option of using product IDs or product groups when referencing a catalogue. Product IDs represent individual items. Product groups are used to distinguish products that are identical but have minor variations such as colour, material, size or pattern.

Your product IDs should go directly through your pixel or app. Passing product IDs through your pixel allow Facebook to match events from your website or app to specific products in your catalogue. For example, if you sell shoes, Facebook can see the specific sizes that someone might be interested in and then recommended products that are in stock in their size.

Consider using product groups when you want:

  1. People to find additional colours, styles or patterns of a particular product. Product groups are the way in which you group all product variants.
  2. To avoid retargeting a person with a similar item if it's unlikely that they are going to purchase a similar item. For example, a customer viewed multiple colours of the same shoe, but chose only to buy a black pair of shoes and is unlikely to buy the brown version in the next month.

If you have a separate product for each variant (for example, different colours or patterns), give each product a unique ID. Each variant needs to have the same item_group_id defined, and you should supply a unique image for items that differ by colour, material or pattern. The link attribute should also lead to a landing page where that particular variant is preselected.

Complete your dynamic ad for products

Step 2: Add the Facebook pixel and/or Facebook SDK for dynamic ads for products

Step 3: Create an ad template for dynamic ads for products

* Nguồn: Facebook