This guide covers creating ads and ad creatives with opted-in Advantage+ Creative features.
Previously, Advantage+ Creative was only supported through standard enhancements, a bundle of Advantage+ Creative features. Starting with Marketing API v22.0 and applying to all subsequent versions, the opt-in and preview functionality for standard enhancements will be deprecated. Instead, you can opt-in to or preview individual Advantage+ Creative features by following the guidelines outlined in this document.
Note that the support for automatic removal of ineligible features and preview are gradually rolling out to all API versions, and will be available to all developers by February 2025.
Set up your ad campaigns using the following instructions:
You can create an ad through the /ads
endpoint or create a standalone creative through the /adcreatives
endpoint. In either approach, specify the individual features to opt-in within the creative_features_spec
.
To opt-in features image_touchups
, inline_comment
, and image_templates
:
// creative example curl -X POST \ -F 'name=Advantage+ Creative Creative' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "image_touchups": { "enroll_status": "OPT_IN" }, "inline_comment": { "enroll_status": "OPT_IN" }, "image_template": { "enroll_status": "OPT_IN" } } }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v22.0
/act_<AD_ACCOUNT_ID>/adcreatives // ad example curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Advantage+ Creative Adgroup", "object_story_spec": { "link_data": { "image_hash": "<IMAGE_HASH>", "link": "<URL>", "message": "You got this.", }, "page_id": "<PAGE_ID>" }, "degrees_of_freedom_spec": { "creative_features_spec": { "image_touchups": { "enroll_status": "OPT_IN" }, "inline_comment": { "enroll_status": "OPT_IN" }, "image_template": { "enroll_status": "OPT_IN" } } } }' \ https://graph.facebook.com/v22.0
/act_<AD_ACCOUNT_ID>/ads
The Advantage+ Creative features that can be opted-in within the creative_features_spec
parameter.
Name | Description |
---|---|
| Optional. The Note: This feature is labeled Relevant comments in Ads Manager. |
| Optional. The Note: This feature is labeled Add overlays in Ads Manager. |
| Optional. The Note: This feature is labeled Visual-touch ups in Ads Manager. |
| Optional. The Note: This feature is labeled Visual-touch ups in Ads Manager. |
| Optional. The Note: This feature is labeled Adjust brightness and contrast in Ads Manager. |
| Optional. The The { "text_extraction": { "enroll_status": "OPT_IN" } Note: This feature is labeled Enhance CTA in Ads Manager. |
| Optional. The The { "text_extraction": { "enroll_status": "OPT_IN" } Note: This feature is labeled Text improvements in Ads Manager. |
| Optional. The Note: This feature is labeled Generate backgrounds in Ads Manager. |
| Optional. The Note: This feature is labeled Expand image in Ads Manager. |
| Optional. The Note: This feature is labeled Adapt to placement in Ads Manager. |
| Optional. The Note: This feature is labeled Dynamic media in Ads Manager. See Dynamic Media for more information. |
| Optional. The Note: This feature is labeled Add catalog items in Ads Manager. See Product Extensions (Add Catalog Items) Features on Marketing API for more details. |
Features specified as OPT_IN
but ineligible for the given ad setup will be automatically removed from creative_features_spec
. For example, 'image_templates' (or Add Overlays) is not eligible to be applied to video format creatives — if you opt in to this feature on a video ad, it is ineligible and thus will be automatically removed. To confirm the final outcome, you can send a GET
request to retrieve the creative_features_spec
field.
Do not worry if you see standard_enhancements
and some standard enhancements sub-features appended to creative_features_spec
when you retrieve it. As long as these sub-features are not set to OPT_IN
, they will not be applied. We are in the process of deprecating standard enhancements and this behavior will be phased out once the deprecation is complete.
Most Advantage+ Creative features can be opted-in through creative_features_spec
, with the exception of the music
feature, which is opted-in through asset_feed_spec
.
curl -X POST \
-F 'name="Advantage+ Creative Music"' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>"
}' \
-F 'asset_feed_spec={
"audios": [
{
"type": "random"
}
]
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v22.0
/act_<AD_ACCOUNT_ID>/adcreatives
If the features opted-in include features generated with AI, it's necessary to create the ad with a PAUSED
status, then follow Step 2 and Step 3 below to complete the publishing process. When creating an ad through the /ads
endpoint, the status
field on the ad is set to PAUSED
by default. On the other hand, if no AI-generated features are included, Step 2 and Step 3 are optional and you can directly create the ad with an ACTIVE
status.
See the Ad Previews reference for more information on the existing functionality of previews.
To preview an Advantage+ Creative feature, add the creative_feature
parameter to your existing preview request and specify the desired feature name.
Features that support preview include image_templates
, image_touchups
, video_auto_crop
, enhance_cta
, text_optimizations
, image_background_gen
, and image_uncrop
.
curl -X GET -G \
-d 'ad_format="DESKTOP_FEED_STANDARD"' \
-d 'creative_feature=<FEATURE_NAME> \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v22.0
/<AD_ID>/previews
{ "data": [ { "body": "<iframe src='<PREVIEW_URL>'></iframe>", "transformation_spec": { "<FEATURE_NAME>": [ { "body": "<iframe src='<PREVIEW_URL>'></iframe>", "status": "eligible" } ] } } ] }
Click on the link to see the previews.
Note: If a transformation_spec
node is not shown, that means the creative is not eligible for the Advantage+ Creative feature on the given placement, and therefore the feature will not be applied.
Once the previews have been reviewed and appear acceptable to publish, move on to Step 3 to set the ad to ACTIVE
if it is not already. If any of the previews are not acceptable, create a new ad or creative without opt-in to the corresponding features.
ACTIVE
After you have verified the previews, you can set the status of the ad to ACTIVE
.
curl -X POST \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v22.0
/<AD_ID>
Some Advantage+ Creative features have already been covered in other Marketing API docs:
adapt_to_placement
and media_type_automation
: Advantage+ Creative for Catalogproduct_extensions
: Product Extensions (Add Catalog Items) Features on Marketing APIimage_background_gen
and image_uncrop
: Get Started with the Generative AI Features on Marketing APIAdvantage+ Creative was previously available as standard enhancements on Marketing API:
Others