Ad Set, Destination Type

This guide describes the type of destination an ad links to; in other words, where someone goes when they click an ad or Call to Action (CTA) in an ad and how it provides a single destination type for all ads in an ad set. Ads in this ad set only contain different types of ad creative and do not provide unique destination types.

Your chosen destination type must be consistent with your objective and optimization goal.

Possible Destination Types

The destination type is optional. We validate this to check if you selected a setting compatible with your chosen objective and optimization goal. See Marketing API, Validation.

Destination TypeRequirements

UNDEFINED

No defined destination type. Returned only in read mode if you create an ad set prior to v2.11 or if you have objectives that do not appear in the table of objectives below.

WEBSITE

All ads in ad set must have ad creative with at least one valid, external URL.

APP

Ads in this ad set must provide an app ID in promoted object. Destination is either the app installed on someone's phone or in the app store if not installed.

MESSENGER

All ads in this ad set must have ad creative with Messenger as a destination.

APPLINKS_AUTOMATIC

Used with dynamic ads. An ad set's promoted object must have a product_set_id. Facebook determines the destination which displays based on the applink specified in the ad's creative.

FACEBOOK

Used with dynamic ads. The catalog being promoted needs to support the Click to Marketplace ads use case in Catalog Manager. All ads in this ad set must have ad creative with Marketplace as a destination. This is currently only available for the Vehicle vertical. Learn more

Objectives

If you are using v2.10 or earlier, these objectives are optional.

ObjectiveAvailable Destination Types

LINK_CLICKS

WEBSITE, APP, MESSENGER, APPLINKS_AUTOMATIC

APP_INSTALLS

APP

CONVERSIONS

WEBSITE, APP, MESSENGER, APPLINKS_AUTOMATIC

PRODUCT_CATALOG_SALES

APPLINKS_AUTOMATIC

All Other Objectives

Defaults to UNDEFINED

Create an Ad Set for Click to Marketplace Ads

Click to Marketplace ads enable advertisers to drive to on-Facebook listings as a destination for their product catalog sales campaigns instead of external websites. These ads can drive awareness of car inventory with multiple placement options. Learn more about Click to Marketplace ads.

To create an ad set that leverages Click to Marketplace ads to go to an On-Facebook Listing, specify destination_type "FACEBOOK" in your ad set data:

-F 'destination_type="FACEBOOK"' \

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.

If you don’t specify destination_type, your ads’ default destination is the website URL specified in your catalog.