Dynamic Ads with an On-Facebook Destination

Dynamic Ads with an On-Facebook Destination drive in-market shoppers to an existing Marketplace listing or to a Product Detail Page formatted as a Marketplace listing, increasing opportunities for leads to be cultivated into sales.

On-Facebook Destination Ads are currently available to use only with auto catalogs. Learn more About Dynamic Ads with an On-Facebook Destination.

You do not need to be an existing Marketplace Partner to use On-Facebook Destination Ads nor is listing on Marketplace required.

Before You Start

Before you start, you need to have a valid auto catalog, and build the audience you want to target your ads to. Visit our Get Started page to learn how to set up a catalog, then see the following requirements specific to auto. See the Resources section for information about audience creation.

Valid Auto Catalog

Dynamic Ads with an On-Facebook Destination for Auto can use catalogs that meet requirements for either Marketplace Vehicle or Automotive Ads. You must have at least one item in your catalog for it to be eligible.

Businesses can choose to capture leads via either of two contact methods, Messenger or a lead form.

To use the lead form contact method, the field dealer_communication_channel should be set to LEAD FORM and a privacy term url is required for field dealer_privacy_policy_url. To use Facebook Messenger, leave dealer_communication_channel blank or select CHAT.

Marketplace Vehicles

See list of required fields for Marketplace Vehicles. If you are not a Marketplace partner, fb_page_id is also required.

Automotive Ads

See list of required fields for Automotive Inventory Ads. Optional fields can be found here.

Get Started

Once you have your catalog and audience, you can create your ads via Ads Manager or via API. To use Ads Manager, see the Business Help Center article. To use the API, follow these steps:

Step 1: Create ad campaign

See instructions for ad campaign creation. While creating your campaign, set PRODUCT_CATALOG_SALES as the objective and specify your catalog in promoted_object.

Step 2: Create Ad Set and set destination

Once you have the campaign and the campaign_id, create the ad set. The ad set defines the bidding and targeting options for your ads.

To create an ad set that leverages Dynamic Ads with an On-Facebook Destination to go to an on-Facebook Listing, specify destination_type FACEBOOK in your ad set data. If customizing placements, destination_type FACEBOOK supports:

  • publisher_platforms: facebook and instagram.
  • facebook_positions: feed, marketplace, instant_article, search, story, and right_hand_column.
  • instagram_positions: stream, explore, and story.

Step 3: Provide Ad Creative

See instructions to provide creative using template tags. To leverage Dynamic Ads with an On-Facebook Destination, specify app_destination as MARKETPLACE in your call_to_action. This way, your ads will take the user to an On-Facebook Listing.

app_destination MARKETPLACE is only supported for carousel creatives.

For more information, see Template Tags for Vehicles.

Step 4: Create the Ad

Use the ad_set_id and the creative_id to create the ad:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \

Your ad is now visible in Ads Manager and is in a paused state.