Advantage+ Creative Preview API

The Advantage+ Creative Preview API supports generating previews for ads both before and after publishing the ad.

• Provide the creative ID or ad ID to see previews of published ads
• Provide the creative spec to see previews of unpublished ads

Existing Functionality

See the Ad Preview documentation for more information on the existing functionality.

1. Provide the creative or ad ID and placement

   curl -X GET \
     -d 'ad_format="DESKTOP_FEED_STANDARD"' \
     -d 'access_token=<ACCESS_TOKEN>' \
     https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews
   

2. Receive the iframe response.

   {
     "data": [
       {
         "body": "<PREVIEW_LINK>",
       }
     ]
   }
   

3. Click on the link to see the previews.

Updated Functionality

1. Provide the creative or ad ID and placement with new parameters.

   curl -X GET \
     -d 'ad_format="DESKTOP_FEED_STANDARD"' \
     -d 'access_token=<ACCESS_TOKEN>' \
     -d 'creative_feature=standard_enhancements' \
     https://graph.facebook.com/v21.0/<CREATIVE_ID>/previews
   
   

2. Receive the iframe response.

   {
     "data": [
       {
         "body": "<preview link>",
         "transformation_spec": {
           "standard_enhancements": [
             {
               "body": "<preview link>",
               "optimization_type_description": "Vary image aspect ratio",
               "status": "eligible"
             },
             {
               "body": "<preview link>",
               "optimization_type_description": "Image templates for Feed",
               "status": "eligible"
             }
           ]
         }
       }
     ]
   }
   
   
   

3. Click on the link to see the previews.

Parameters

See the Ad Preview documentation for existing parameters. New parameters are listed below.

Limitations

• Advantage+ Creative previews are currently only supported on the MOBILE_FEED_STANDARD, INSTAGRAM_STANDARD, INSTAGRAM_REELS and INSTAGRAM_STORY placements.

• Image ad previews on MOBILE_FEED_STANDARD may appear cropped, even without manual crops, because the placement supports a limited range of aspect ratios. See Aspect ratios supported by placements in Meta Ads Manager for more information about aspect ratio support for each placement.

• The following transformations in Standard Enhancements do not have preview support:

  • Inline Comment
  • Text Liquidity