Multi-advertiser Ads

Multi-advertiser ads delivery will become OPT-IN by default beginning August 19, 2024. Partners must implement multi-advertiser ads before then so advertisers can opt out.

Multi-advertiser ads showcase ads from multiple advertisers, helping advertisers drive performance by reaching more people looking to go deeper in their shopping journey. Multi-advertiser ads are available for select placements on Facebook and Instagram. For more information, please visit the Business Help Center.

API support for multi-advertiser ads

Multi-advertiser ads are supported in all versions of the Marketing API, but all ad creation requests that are eligible for multi-advertiser ads must specify if the ad opts in to use it or not. Multi-advertiser ads support all campaign objectives and all ad formats across all available placements. The enroll_status field must be provided with either an OPT_IN or OPT_OUT value.

Ad creation

Request

curl -X POST \
  -F 'name="My creative title"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "link": "https://www.google.com",
         "image_hash": "<IMAGE_HASH>",
         "attachment_style": "link",
      }
     }' \
  -F 'contextual_multi_ads={
       "enroll_status": "OPT_IN"
     },'
  -F "access_token=<ACCESS_TOKEN>" \
   https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

For more details, see Ad Creative.

Parameters

NameDescription

contextual_multi_ads

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

Learn More