Destination Ads - Catalog & Feed

To promote destinations on Facebook, you have to share information about them with Facebook. You do this by creating a destinations catalog and then filling it with destinations.

Upload CSV or XML files for 'destination feeds' with the destinations you want to promote

You can create and manage your destinations catalog in your Commerce Manager.

To use the API to manage your catalog:

1. Create a destination catalog
2. Upload your feed to Facebook
3. Create product sets out of your destination catalog
4. Associate the catalog to your event sources

Destination Feed - Upload Your Destinations to Facebook

A destination feed is a file with the destinations you want to promote. Every line or item in the file represents a single destination. You can use one or more destination feeds, as long as all feeds together contain all destinations you want to promote.

Supported Destination Feed Formats

CSV - Sample & Description

CSV sample | TSV sample (flattened) | TSV sample (JSON-style)

• 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 destination.
• Fields containing whitespace or commas should be enclosed in "double quotes".
• Nested or multi-value fields, such as address, neighborhood or image can be represented using JSON-encoded values or by a set of "flattened" plain-text columns labeled using JSON-path syntax, such as address.city, neighborhood[0], image[0].url, image[0].tag[0], image[0].tag[1]. Both conventions can be used interchangeably in the same file.

XML - Sample & Description

XML sample

• A root <listings> XML node encloses a set of <listing> nodes, each of which represents a destination.
• The file must begin with a valid <?xml declaration tag.

Supported Fields - Destinations

The following supported fields are designed for items you add to your product catalog.

For localized catalogs, see supported fields for destinations.

Product Deep Links

Provide deep links in feed following the App Links specification. Deep link information in 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 don't 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 Advantage+ Catalog Ads, Ad Template.

Image Object Parameters

Address Object Parameters

The following sections are only relevant to manage your catalogs using this API.

Create a Destination Catalog using the API

A destination catalog is a container for the destinations you want to promote. To use the catalog API, make sure you have the appropriate Marketing API Access Level and that you have accepted the Terms of Service by creating your first catalog through Business Manager.

To create a destination catalog for destination ads, set vertical to destinations:

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

Upload Your Destination Feeds via the API

Once you have created the catalog, you must upload your destination feed(s) to Facebook. Use the API to create a feed object for every feed you want to upload. We support scheduled and direct uploads.

Filter Destination Catalog to Destination Sets

A destination set is a subset of your catalog. To setup destination ads, you need a destination set. Therefore, you have to create at least one.

Destination sets are defined by filters that are applied to the destination catalog. For example, you can create a destination set with all destinations that had a large price drop. Do note you can also create a destination set without any filters. In that case, the destination set will contain all destinations in your catalog.

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

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

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

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