Marketing API

Multi-advertiser Ads

Multi-advertiser ads delivery will become OPT-IN by default beginning August 19, 2024. Partners will need to implement the multi-advertiser request in order to opt out of multi-advertiser ads. Ads created on or after August 19 that do not specify the enroll_status field within the contextual_multi_ads field will be opted into multi-advertiser ads by default.

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. 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. Ads created on or after August 19, 2024 that do not specify the enroll_status field will be opted into multi-advertiser ads by default.

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/v21.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