Advantage+ App Campaigns & Advantage+ Catalog Ads

Advantage+ app campaigns (formaerly known as Automated App Ads (AAA)) use powerful machine learning and automated systems to help your app install ads drive more of the results you value, scale campaigns with sustained performance, and ultimately help you work more efficiently. We are introducing the ability to create Advantage+ catalog ads with the existing Advantage+ app campaigns API. See the Advantage+ app campaigns API documentation for more information on creating your campaigns.

There are no changes to ad campaign and ad set creation, and the dynamic capability is introduced only in the creatives. This document will detail the creation of a Advantage+ catalog ad creative and how to use it in your ads.

Provide a Creative and Create Ads

Once you have an ad set, you can create your ad by sending a POST request to the /act_{ad_account_id}/ads endpoint.

Request

curl -X POST \
-F 'name=Advantage+ app campaigns sample ad' \
-F 'adset_id=ADSET_ID' \
-F 'creative={"name": NAME, "object_story_spec": SPEC, "product_set_id": PRODUCT_SET_ID}' \
-F 'access_token=ACCESS_TOKEN' \
https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/ads

Parameters

Name	Description
`name` string	Required. Name of the ad.
`adset_id` int-64	Required. The ID of the ad set, required on creation.
`creative` AdCreative	Required. The creative spec of the ad creative to be used by this ad. Values: `object_story_spec`, `product_set_id`, `use_page_actor_override` Provide a creative spec: { "creative": { "name": "NAME", "object_story_spec": SPEC, "product_set_id": PRODUCT_SET_ID } } Read more about creatives.
`status` enum	Optional. Only `ACTIVE` and `PAUSED` are valid during creation. During testing, it is recommended setting 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. Values: `set` (default) `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, the image 20% text rule, etc., 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 of 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.

Updating

You can update an ad by making a POST request to the /{ad_id} node.

Request

curl -X POST \
-F 'name=Advantage+ app campaigns sample update ad' \
-F 'creative={"name": NAME, "object_story_spec": SPEC, "product_set_id": PRODUCT_SET_ID}' \
-F 'access_token=ACCESS_TOKEN' \
https://graph.facebook.com/v21.0/AD_ID

Parameters

Name	Description
`name` string	New name of the ad.
`adlabels` list<Object>	Ad labels associated with this ad.
`execution_options` list<enum>	Optional. Values: `set` (default) `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, the image 20% text rule, etc., 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 of 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	Values: `ACTIVE`, `PAUSED`, `DELETED`, `ARCHIVED` During testing, it is recommended setting 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. Values: `object_story_spec`, `product_set_id`, `use_page_actor_override` Provide a creative spec: { "creative": { "name": "<NAME>", "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } } Read more about creatives.