Marketing API

Standard Enhancements for Advantage+ Creative

Starting with Marketing API v22.0, opting in or out of standard enhancements will no longer be available. Instead, you can opt in or out of individual Advantage+ Creative features by following the instructions in Get Started with Advantage+ Creative. Opting in or out of sub-features within the standard enhancements bundle will have the same effect as previously opting in or out of standard enhancements.

The sub-features within the standard enhancement bundle for single image ads include image_template, image_touchups, text_optimizations, and inline_comment. For single video ads, the sub-features are video_auto_crop, text_optimizations, and inline_comment.

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

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