We are introducing a new, unified, and streamlined process for creating campaigns, replacing the existing separate workflows for Manual, Advantage+ Shopping Campaigns (ASC), and Advantage+ App Campaigns.

As of v25.0, Marketing API developers will no longer be able to use the ASC API with the smart_promotion_type=AUTOMATED_SHOPPING_ADS field to create ASC campaigns. Instead, developers will need to use Advantage+ audience, Advantage+ campaign budget, and Advantage+ placements to create campaigns with an advantage_state that reflects the type of Advantage+ campaign. Refer to the Advantage+ Campaigns documentation to start creating Advantage+ campaigns today and avoid disruption with the releases of v24.0 and v.25.0.

Advantage+ shopping campaigns is a solution that enables ecommerce and retail direct-to-consumer and brand advertisers to potentially achieve better performance, greater personalization and more efficiency. These campaigns provide greater flexibility to control levers such as creative, targeting, placements and budget, and more opportunities to optimize campaigns that drive conversions.

Advantage+ Shopping Campaigns empower advertisers to use automation and AI to:

deliver campaigns at scale with sustained performance

increase efficiency with minimum effort to set up and manage different campaigns

It replaces a portfolio of manual sales campaigns using a combination of targeting, bidding, destination, creative, placement and budget set-ups within a single campaign to test up to 150 different combinations and optimize for the highest performing ads.

Learn more about the context and benefits of ASC in our blog.

Manual Campaign Setup Compared to Advantage+ Shopping Campaigns

Manual BAU Campaign Setup	Advantage+ Shopping Campaign
Multiple BAU campaigns	BAU portfolio replacement
Manual Targeting with 7 Targeting levers	Automated targeting, automation to increase setup efficiency with 1 country input
Strict budget allocations in multiple campaigns	Budget liquidity within 1 campaign
Test up to 50 creative combinations	Allows both dynamic and static ads with up to 150 creative combinations

This document outlines the steps you need to follow to set up your integration for Advantage+ shopping campaigns. You will need to:

Define Existing Customers

Create Campaign

Verify Campaign Creation

Create Ad Set

Provide Creative and Create Ads

Set Minimum Age Constraint and Geo Exclusion (See Ad Account Controls reference doc)

Have a pixel_id to set up Advantage+ Shopping Campaigns

Learn more about Cross-Channel Conversion Optimization for Advantage+ shopping campaigns.

Step 1: Define Your Existing Customers (Optional)

Optionally, Advantage+ shopping campaigns allow you to define your existing customers as a collection of custom audience IDs. Your existing customers are users who are already familiar with your business/product. Once this definition is set up, you can use this to segment your budget for Advantage+ shopping campaigns to limit spend on existing customers via existing_customer_budget_percentage. We will also provide you with metrics reporting the performance of your campaigns among these different segments. This step is not required unless you plan on using existing_customer_budget_percentage.

Parameter	Description
`existing_customers` Array<string>	Array of custom audience IDs that the ad account has access to. Currently the supported sources for the custom audience are website, app activity, customer list, catalog and offline activity. For information on how to create a custom audience, refer to this page.

Example

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>

For more information on tracking new and existing audiences in third-party tracking tools, see Audience Type URL Parameters.

Step 2: Create Campaign

Start by creating your ad campaign. To do this, make a POST request to /act_{ad_account_id}/campaigns.

Set campaign_objective to OUTCOME_SALES

Set smart_promotion_type to AUTOMATED_SHOPPING_ADS to indicate that the campaign you’re creating is an ASC campaign

ASC can be created only with the OUTCOME_SALES campaign objective.

Parameters

Parameter	Description
`name` string	Required Name for the Advantage+ shopping campaign
`objective` enum	Required Campaign’s objective. Specify `OUTCOME_SALES` for this type of ad
`special_ad_categories` list<Object>	Required Special ad categories associated with the Advantage+ shopping campaign
`adlabels` list<Object>	Optional Ad Labels associated with the Advantage+ shopping campaign
`buying_type` string	Optional Advantage+ shopping campaigns only support the value `AUCTION`
`execution_options` list<enum>	Optional Default value: `set`. Other options are: `validate_only`: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. `include_recommendations`: this option cannot be used by itself. When this option is used, recommendations for ad object’s configuration will be included. A separate section recommendations will be included in the response, but only if recommendations for this specification exist. If the call passes validation or review, the response will be `{"success": true}`. If the call does not pass, an error will be returned with more details.
`smart_promotion_type` enum	Required To specify this is an Advantage+ shopping campaign, the smart promotion type should be set to `AUTOMATED_SHOPPING_ADS`
`status` enum	Optional Valid options are: `PAUSED` and `ACTIVE`. If this status is `PAUSED`, all its active ad sets and ads will be paused and have an effective status `CAMPAIGN_PAUSED`

Campaign Create Example

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/campaigns

Response

{
   "id": "<campaign_id>"
}

Updating

You can update a Campaign by making a POST request to /{campaign_id}.

Parameters

Parameter	Description
`name` string	Name for the Advantage+ shopping campaign
`special_ad_categories` list<Object>	Special ad categories associated with the Advantage+ shopping campaign
`adlabels` list<Object>	Ad Labels associated with the Advantage+ shopping campaign
`execution_options` list<enum>	Default value: `set`. Other options are: `validate_only`: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. `include_recommendations`: this option cannot be used by itself. When this option is used, recommendations for ad object’s configuration will be included. A separate section recommendations will be included in the response, but only if recommendations for this specification exist. If the call passes validation or review, the response will be `{"success": true}`. If the call does not pass, an error will be returned with more details.
`topline_id` numeric string or integer	Topline ID
`status` enum	You can use the following status for an update API call: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` If an ad campaign is set to `PAUSED`, its active child objects will be paused and have an effective status `CAMPAIGN_PAUSED`.

Campaign Update Example

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<CAMPAIGN_ID>

Step 3: Verify Campaign Creation

To verify that you have successfully created an Advantage+ shopping campaign, you can make a GET request to /<AD_CAMPAIGN_ID> with the field smart_promotion_type.

A valid Advantage+ shopping campaign will return the field value AUTOMATED_SHOPPING_ADS.

Example

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_CAMPAIGN_ID>

Response

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

Step 4: Create Ad Set

Once you have completed the campaign creation, you can create an ASC ad set. Make a POST request to /act_{ad_account_id}/adsets.

Only one Ad Set can be associated with each ASC campaign.

For ad sets targeting Taiwan, the regional_regulated_categories and regional_regulation_identities fields must be set to identify the name of the individual or organization paying for and/or benefitting from the ad. Please see the Ad Set documentation for more details.

For a lightweight Ad Set creation:

Set performance goal to maximize the number of conversions (optimization_goal=OFFSITE_CONVERSIONS)

Use auto-bidding (bid_strategy=LOWEST_COST_WITHOUT_CAP)

Target by ISO country code using geo_locations field

Choose either a daily_budget or a lifetime_budget. If you choose to specify a lifetime_budget, you must also set the end_time

Set the conversion location to website under the promoted_object by specifying the pixel_id for your website and setting custom_event_type=PURCHASE

Set billing_event=IMPRESSIONS. This is the only supported billing event for ASC.

Parameters

Parameter	Description
`campaign_id` numeric string or integer	Required A valid Advantage+ shopping campaign you wish to add this ad set to.
`name` string	Required Name for the Advantage+ shopping campaign
`promoted_object` Object	Required The object this ad set is promoting across all its ads. For Advantage+ shopping campaigns, provide: `pixel_id` `custom_event_type`: Advantage+ shopping ad set supports the following events: `PURCHASE`, `ADD_TO_CART`, `INITIATED_CHECKOUT`, `ADD_PAYMENT_INFO`, `ADD_TO_WISHLIST`, `CONTENT_VIEW`, `COMPLETE_REGISTRATION`, `DONATE`, `START_TRIAL`, `SUBSCRIBE`, `SEARCH`, `DONATE` (Website-only conversion location), `OTHER` (Website-only conversion location for custom events), and custom conversions. Restrictions `optimization_goal=VALUE` only supports `PURCHASE` as the conversion event All conversion events are supported for `optimization_goal=OFFSITE_CONVERSIONS` Website and Shop conversion location only supports `PURCHASE` as a conversion event. If an advertiser selects anything else, the campaign will convert to the Website conversion location There are 2 types of cross-channel conversion configurations in `promoted_object`. Cross-channel conversion is optional. For a Website-only conversion location, specify the `pixel_id` for your website and set `custom_event_type=PURCHASE`. Website and App: Use this if you can track the same web and app events, such as with an active Meta Pixel or Facebook SDK. You will need to specify the app information under `promoted_object` using `omnichannel_object`. Website and Shop: Use this if your business has an onsite Shop. This is for businesses with both an app and an eligible Shop. Specify Shop information by setting `destination_type=SHOP_AUTOMATIC` and using `omnichannel_object` under `promoted_object` to specify `commerce_merchant_settings_id`. Learn more about and view configuration examples for cross-channel conversion optimization for Advantage+ shopping campaigns.
`targeting` Targeting object	Required An Advantage+ shopping ad set’s targeting structure. Only `geo_locations` are allowed to be specified.
`geo_locations` array	Required Used to limit the audience of the ad set by `countries` — Country targeting. Requires an array of 2-digit ISO 3166 format codes⁠. Example: `{ "geo_locations": { "countries": [“US”] }, }` `regions` — State, province, or region. See Targeting Search, Regions for available values. Limit: 200. Example: `{ "geo_locations": { "regions": [{"key":"3847"}] }, }`
`daily_budget` int64	Optional The daily budget defined in your account currency, allowed only for ad sets with a duration (difference between `end_time` and `start_time`) longer than 24 hours. Either `daily_budget` or `lifetime_budget` must be greater than 0.
`lifetime_budget` int64	Optional Lifetime budget, defined in your account currency. If specified, you must also specify an `end_time`. Either `daily_budget` or `lifetime_budget` must be greater than 0.
`end_time` datetime	Required when `lifetime_budget` is specified. When creating an ad set with a `daily_budget`, specify `end_time=0` to set the ad set as ongoing with no end date. UTC UNIX timestamp Example: `2015-03-12 23:59:59-07:00` or `2015-03-12 23:59:59 PDT`.
`optimization_goal` enum	Optional Select `OFFSITE_CONVERSIONS` to target delivery to individuals more likely to take a specific action on your website. Select `VALUE` as the optimization goal if you want to target delivery to individuals who are more likely to make high-value purchases. In Ads Manager, we display Highest Value as your bid strategy. `VALUE` optimization goal is only available for Website conversion location and requires `promoted_object` to have a specified `pixel_id` for your website and the `custom_event_type=PURCHASE`.
`bid_strategy` enum	Optional `LOWEST_COST_WITHOUT_CAP`: Facebook automatically bids on your behalf and gets you the lowest cost results. Automatically increase your effective bid as needed to get the results you want based on your given `optimization_goal`. This is the default `bid_strategy` when optimization_goal is `OFFSITE_CONVERSION` or `VALUE`. `LOWEST_COST_WITH_MIN_ROAS`: Specific bidding option for value optimization. You must specify a `roas_average_floor`, which is the minimum return wanted from ads spend. Allows advertisers to keep return on ad spend around an average amount over the course of their campaign. You must specify `roas_average_floor`, which is the minimum return wanted from ads spend, within the `bid_constraints` object. This strategy is available for Website-only conversion location. It is compatible with VALUE as the `optimization_goal`. See Minimum Return on Advertiser Spend Bidding. `COST_CAP`: Get the most results possible while we strive to meet the cost per action you set. You must provide a cap number in the `bid_amount` field. Allows advertisers to scale conversions while keeping costs around their desired average CPA. You must provide a cap number in `bid_amount` to use this strategy. It is available for Website and Website and App conversion locations, and is compatible with `OFFSITE_CONVERSIONS` as the `optimization_goal`. Adherence to cost cap limits is not guaranteed. See Cost Cap.
`bid_amount`	Required if bid_strategy is `COST_CAP`.
`bid_constraints` JSON object	Optional `optimization_goal` must be `VALUE`. `bid_strategy` must be `LOWEST_COST_WITH_MIN_ROAS`. Min ROAS bidding uses `bid_constraints` to pass the “ROAS floor”, but you cannot use with `bid_constraints`, use `roas_average_floor` instead. See Minimum Return on Advertiser Spend Bidding. The valid range of `roas_average_floor` is `[100, 10000000]`, inclusive. This means that the valid range of “minimum ROAS” is `[0.01, 1000.0]` or `[1%, 100000.0%]`, inclusive.
`billing_event` enum	Required A billing event for the ad set. Only `IMPRESSIONS` is supported for Advantage+ shopping campaigns.
`existing_customer_budget_percentage` number	Optional Specifies the maximum percentage of the budget that can be spent on the existing customers associated with this ad account. Lower values may lead to higher costs per conversion. Valid values are between 0-100.
`adlabels` list<Object>	Optional Specifies a list of labels to be associated with this object.
`start_time` datetime	Optional. The start time of the set. UTC UNIX timestamp Example: `2015-03-12 23:59:59-07:00` or `2015-03-12 23:59:59 PDT`.
`time_start` datetime	Optional Time start
`time_stop` datetime	Optional Time stop
`attribution_spec` list<JSON Object>	Optional Conversion attribution spec used for attributing conversions for optimization.

Ad Set Create Example

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adsets

Example Response

"id": "<adset_id>"

Ad Set Create Example where `bid_strategy=COST_CAP`:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS \
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=COST_CAP'
  -F 'bid_amount=200' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations":{"countries":["US"]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/adsets

Ad Set Create Example where `bid_strategy=LOWEST_COST_WITH_MIN_ROAS`:

  curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS \
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITH_MIN_ROAS
  -F 'bid_constraints={"roas_average_floor": 1000} \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations":{"countries":["US"]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/adsets

Updating

You can update an Ad Set by making a POST request to /{ad_set_id}.

Parameters

Parameter	Description
`adlabels` list<Object>	Specifies a list of labels to be associated with this object. This field is optional.
`daily_budget` int64	The daily budget defined in your account currency, allowed only for ad sets with a duration (difference between `end_time` and `start_time`) longer than 24 hours. Either `daily_budget` or `lifetime_budget` must be greater than 0.
`existing_customer_budget_percentage` number	Specifies the maximum percentage of the budget that can be spent on the existing customers associated with this ad account. Lower values may lead to higher costs per conversion. Valid values are between 0-100.
`end_time` datetime	End time, required when `lifetime_budget` is specified. Example: `2015-03-12 23:59:59-07:00` or `2015-03-12 23:59:59 PDT` When creating an ad set with a daily budget, specify `end_time=0` to set the ad set as ongoing with no end date. UTC UNIX timestamp.
`execution_options` list<enum>	Default value: `set`. Other options are: `validate_only`: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. `include_recommendations`: this option cannot be used by itself. When this option is used, recommendations for ad object’s configuration will be included. A separate section recommendations will be included in the response, but only if recommendations for this specification exist. If the call passes validation or review, the response will be `{"success": true}`. If the call does not pass, an error will be returned with more details.
`start_time` datetime	The start time of the set. Must be provided in UTC UNIX timestamp. Example: `2015-03-12 23:59:59-07:00` or `2015-03-12 23:59:59 PDT`.
`status` enum	Available options for updates: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` If it is set to `PAUSED`, all its active ads will be paused and have an effective status `ADSET_PAUSED`.
`lifetime_budget` int64	Lifetime budget, defined in your account currency. If specified, you must also specify an `end_time`. Either `daily_budget` or `lifetime_budget` must be greater than 0.
`time_start` datetime	Time start
`time_stop` datetime	Time stop
`targeting` Targeting object	Targeting structure for your ad set. Valid values for targeting are `geo_locations`.
`geo_locations` array	Required Used to limit the audience of the ad set by `countries` — Country targeting. Requires an array of 2-digit ISO 3166 format codes⁠. Example: `{ "geo_locations": { "countries": [“US”] }, }` `regions` — State, province, or region. See Targeting Search, Regions for available values. Limit: 200. Example: `{ "geo_locations": { "regions": [{"key":"3847"}] }, }`
`attribution_spec` list<JSON Object>	Optional Conversion attribution spec used for attributing conversions for optimization.

Ad Set Update Example

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_SET_ID>

Step 5: Provide Creative and Create Ads

Once you have an ad set, you can create your ad by posting to the /act_{ad_account_id}/ads endpoint. Creating Ads in Advantage+ Shopping Campaigns follows the same process as in manual sales campaigns. Please refer to the links below to create Ads under Advantage+ Shopping Campaigns:

Manual Ads (non-Catalog Ads)

Advantage+ Catalog Ads (formerly known as Dynamic Ads)

Shops Ads

Localized Catalogs (or Advantage+ Catalog Ads for Multiple Languages or Countries)

Parameters

Parameter	Description
`name` string	Required Name of the ad
`adset_id` int64	Required The ID of the ad set, required on creation.
`creative` AdCreative	Required The creative spec or the ID of the ad creative to be used by this ad. Valid fields are: `object_story_spec` `product_set_id` `use_page_actor_override` `creative_id` You can read more about creatives here Provide the creative in the following format: `{"creative_id": <CREATIVE_ID>}` Or provide a creative spec: `{ "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }`
`status` enum	Optional Only `ACTIVE` and `PAUSED` are valid during creation. During testing, it is recommended to set ads to a `PAUSED` status so as to not incur accidental spend.
`adlabels` list<Object>	Optional Ad Labels associated with this ad
`execution_options` list<enum>	Optional Default value: `set`. `validate_only`: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. `synchronous_ad_review`: this option should not be used by itself. It should always be specified with `validate_only`. When these options are specified, the API call will perform Ads Integrity validations, which include message language checking, image 20% text rule, and so on, as well as the validation logics. `include_recommendations`: this option cannot be used by itself. When this option is used, recommendations for ad object’s configuration will be included. A separate section recommendations will be included in the response, but only if recommendations for this specification exist. If the call passes validation or review, the response will be `{"success": true}`. If the call does not pass, an error will be returned with more details.

Ad Create Example

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Individual Ad Scheduling

Individual Ad Scheduling allows advertisers to have more granular control to run their Ads during a specific time period by scheduling the start and end time. This feature is available for all campaign types.

Example

{
  "ad_schedule_end_time": "2024-07-30T09:00:00+0100",
  "ad_schedule_start_time": "2024-07-26T12:00:32+0100"
}

These are the parameters.

Creative Fields

For a full list of Ad Creative fields, see here.

Field	Description
`object_story_spec` AdCreativeObjectStorySpec	Required Use if you want to create a new unpublished page post and turn the post into an ad. The Page ID and the content to create a new unpublished page post.
`use_page_actor_override` AdCreative	Required If `true`, we display the Facebook page associated with the Advantage shopping ads.

Create Creative Example

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Updating

You can update an Ad by making a POST request to /{ad_id}.

Parameters

Parameter	Description
`name` string	New name of the ad
`adlabels` list<Object>	Ad labels associated with this ad.
`execution_options` list<enum>	Default value: `set`. Other options are: `validate_only`: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. `synchronous_ad_review`: this option should not be used by itself. It should always be specified with `validate_only`. When these options are specified, the API call will perform Ads Integrity validations, which include message language checking, image 20% text rule, and so on, as well as the validation logics. `include_recommendations`: this option cannot be used by itself. When this option is used, recommendations for ad object’s configuration will be included. A separate section recommendations will be included in the response, but only if recommendations for this specification exist. If the call passes validation or review, the response will be `{"success": true}`. If the call does not pass, an error will be returned with more details.
`status` enum	Options are: `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` During testing, it is recommended to set ads to a `PAUSED` status so as to not incur accidental spend.
`creative` AdCreative	The creative spec of the ad creative to be used by this ad. Valid fields are `object_story_spec`, `asset_feed_spec`, and `use_page_actor_override` and can be viewed here. You can read more about creatives here Provide the creative in the following format: `{ "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }`

Ad Update Example

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_ID>

Step 6: Ad Account Controls (Optional)

If your business has constraints, such as unable to show ads to people under a certain age, or is restricted to some countries, you can use Ad Account controls to choose how your ads are delivered. These constraints will apply across all new and existing campaigns (manual sales and ASC) across the account.

You can set the following optional features at the Ad Account Control level:

Minimum Age Constraint: You can set the minimum age from 18 to 25. You cannot set the maximum age.

Exclude Geo Locations: You can exclude certain locations from ad delivery based on country, state/province, city, DMA or zip code. See targeting search for available values.

Geo Inclusions: You can include locations at the country level.

Placement Exclusions: You can exclude certain placements to prevent ads appearing on specific surfaces. Available placements for exclusions are Audience Network, Facebook Marketplace, and Facebook’s Right Column. See available values on the Marketing API.

Define Constraints

Make a POST request to /act_{ad_account_id}/account_controls:

Set age_min to a value between 18 - 25

Exclude locations you do not want your Ads to deliver in using exclude_geo_locations

Exclude ad placements where you do not want your Ads to appear using placement_exclusions

Include a specific country

Example Request

curl -X POST \
-F 'audience_controls={
"age_min": 20,
"excluded_geo_locations": {"countries": ["US"]}' \
"geo_locations":{"countries": ["GB"]} \
-F 'placement_controls = {"placement_exclusions": ["facebook_marketplace"]} \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/account_controls

Example Response

{
  "id": "<ad_account_business_constraints_id>",
  "success": true
}

Learn More

How to Create a Custom Audience

Ad Creative Object Story Spec

Cross-channel conversion optimization for Advantage+ shopping campaigns

Did you find this page helpful?

Advantage+ Shopping Campaigns

Manual Campaign Setup Compared to Advantage+ Shopping Campaigns

Step 1: Define Your Existing Customers (Optional)

Example

Step 2: Create Campaign

Parameters

Campaign Create Example

Response

Updating

Parameters

Campaign Update Example

Step 3: Verify Campaign Creation

Example

Response

Step 4: Create Ad Set

Parameters

Ad Set Create Example

Ad Set Create Example where bid_strategy=COST_CAP:

Ad Set Create Example where bid_strategy=LOWEST_COST_WITH_MIN_ROAS:

Updating

Parameters

Ad Set Update Example

Step 5: Provide Creative and Create Ads

Parameters

Ad Create Example

Individual Ad Scheduling

Example

Creative Fields

Create Creative Example

Updating

Parameters

Ad Update Example

Step 6: Ad Account Controls (Optional)

Define Constraints

Example Request

Example Response

Learn More

Ad Set Create Example where `bid_strategy=COST_CAP`:

Ad Set Create Example where `bid_strategy=LOWEST_COST_WITH_MIN_ROAS`: