Get Started with Advantage+ Creative

This guide covers creating ads and ad creatives with opted-in Advantage+ creative features.

Before You Begin

Set up your ad campaigns using the following instructions:

1. Create an ad campaign
2. Create an ad set

Step 1: Create an d or ad creative opted into Advantage+ creative features

Create an ad using the /ads endpoint or create a standalone ad creative using the /adcreatives endpoint. With either approach, specify the individual opt-in features in the creative_features_spec parameter.

Example request

To implement the image_touchups, inline_comment, and image_templates opt-in features:

// 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/v25.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/v25.0/act_<AD_ACCOUNT_ID>/ads

Features

These are the Advantage+ creative opt-in features that can be implemented in the creative_features_spec parameter.

{
    "text_extraction": {
        "enroll_status": "OPT_IN"
}

{
    "text_extraction": {
        "enroll_status": "OPT_IN"
}

Features specified as OPT_IN but ineligible for the given ad setup will be automatically removed from the creative_features_spec parameter. 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 will be automatically removed as ineligible.

To confirm the final configuration, use a GET request to retrieve the creative_features_spec parameter.

Most Advantage+ creative features can be opted into using the creative_features_spec parameter with the exception of the music feature which is implemented with the asset_feed_spec parameter. To opt out of the music feature, pass the assest_feed_spec.audios parameter in as empty.

Example request

To opt into the music feature using the asset_feed_spec parameter:

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/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

If the opted-in features include features generated with AI, you must create the ad with a PAUSED status, then follow Step 2 and Step 3 below to complete the publishing process. If no AI-generated features are included, Step 2 and Step 3 are optional, and you can create the ad with an ACTIVE status.

Note: When creating an ad through the /ads endpoint, the status field on the ad is set to PAUSED by default.

Step 2: Preview for Advantage+ creative

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 with the desired feature name specified.

Features that support preview include: image_templates, image_touchups, video_auto_crop, enhance_cta, text_optimizations, image_background_gen, image_uncrop, and description_automation.

Example request

curl -X GET -G \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'creative_feature=<FEATURE_NAME> \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v25.0/<AD_ID>/previews

Example response

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "<FEATURE_NAME>": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible"
          }
        ]
      }
    }
  ]
}

Click on the returned URL to see the previews.

Note: If a transformation_spec object is not returned, the creative is not eligible for the Advantage+ creative feature on the chosen placement, and the feature will not be applied.

Once you have reviewed the previews and deemed them acceptable to publish, set the ad to ACTIVE, if it is not already. If any of the previews are not acceptable, create a new ad or ad creative without the corresponding features opted-in.

Step 3: Set the ad status to ACTIVE

When your ad is ready, set its status to ACTIVE.

Example request

curl -X POST \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/<AD_ID>

Learn More

Other Advantage+ creative features:

• Advantage+ Creative for Catalog: adapt_to_placement and media_type_automation
• Product Extensions (Add Catalog Items) Features on Marketing API: product_extensions
• Get Started with the Generative AI Features on Marketing API: text_generation, image_background_gen and image_uncrop

Other adcreative resources:

• Ad Creative Degrees Of Freedom Spec
• Ad Creative Features Spec
• Ad Creative Feature Details
• Ad Creative Object Story Spec
• Ad Creative Asset Feed Spec

Advantage+ creative was previously available as standard enhancements:

• Standard Enhancements for Advantage+ Creative
• Advantage+ Creative Preview API