Marketing API

Standard Enhancements for Advantage+ Creative

Standard enhancements is for ads using a single image, video, or carousel. It automatically creates multiple variations of your ad and shows a personalized variation to each Account Center account based on what they're most likely to respond to. You can create ads with standard enhancements using the TRAFFIC or CONVERSIONS objectives to help drive performance and deliver more tailored ads to each Account Center account. For more information, please see About Advantage+ creative.

API Support for Standard Enhancements

Advantage+ creative creation is supported in all versions of the Marketing API, but beginning with v17.0, all ad creation requests that are eligible for standard enhancements must specify if the ad opts in to use it or not. With the v17.0 update, this includes campaigns using traffic, engagement, leads, sales, app promotion objectives and single image or video, or carousel ad formats. The enroll_status field must be provided with either an OPT_IN or OPT_OUT value.

Limitations

  • Standard Enhancements is not available for
    • Advantage+ catalog ads
    • Carousel ads

Standalone Creative Creation

Before:

curl -X POST \
  -F 'name="My creative title"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
             "link": "www.google.com",
      }
     }' \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

After (new fields are in bold):

curl -X POST \
  -F 'name="My creative title"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
             "link": "www.google.com",
      }
     }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_IN"
        }
      }
    }' \ 
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Ad Creation

Before:

curl -X POST \
  -F 'creative={
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "link_data": {
        "link": "<WEBSITE_URL>",
      }
    },
  }' \
  -F "adset_id=<ADSET_ID>" \
  -F "name=New Ad" \
  -F "status=PAUSED" \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

After (new fields are in bold):

curl -X POST \
  -F 'creative={
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "link_data": {
        "link": "<WEBSITE_URL>",
      }
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
  -F "adset_id=<ADSET_ID>" \
  -F "name=New Ad" \
  -F "status=PAUSED" \
  -F "access_token=<ACCESS_TOKEN>" \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

For more details, see Ad Creative.

Parameters

NameDescription

degrees_of_freedom_spec

Specifies the types of transformations that are enabled for the given creative. For more information, see Ad Creative Degrees Of Freedom Spec, Reference.

The following features can be opted in the creative_features_spec:

NameDescription

standard_enhancements

Basic set of enhancements to optimize your ad creative and improve performance. This can include:

  • Automatically adjusting the aspect ratio of your image or video
  • Applying a template to your image to help it better fit certain ad placements
  • Displaying relevant Meta comments below your ad.

The enroll_status field can be set to OPT_IN or OPT_OUT. For more details, see Ad Creative Features Details, Reference.

Learn More

Business Help Center

Marketing API Reference