Marketing API

Add Site Links Feature

The Add site links feature in Ads Manager is an Advantage+ Creative optimization that showcases additional URLs below your static or dynamic single media (only on Facebook feed) when it's likely to improve performance. This guide covers using the Add site links feature using the Marketing API.

Eligibility Criteria

To be eligible to use this feature, your ad campaign must have:

  • Either Traffic, Engagement, Leads or Sales as your ad objective.
  • Website as your conversion location.
  • Single image or video ad format.

Before You Begin

Set up your ad campaigns using the following instructions:

  1. Create an ad campaign
  2. Create an ad set

Create an Ad Creative and Ad

Standalone Creative Creation

Before

curl -X POST \
  -F 'name=Creative With Site Links' \
  -F 'object_story_spec={
      "link_data": {
         "link": "<URL>",
      },
      "page_id": "<PAGE_ID>",
      "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

After

New fields are highlighted in bold.

curl -X POST \
  -F 'name=Creative With Site Links' \
  -F 'object_story_spec={
    "link_data": {
      "link": "<URL>",
    },
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
    }' \
  -F 'creative_sourcing_spec={
    "site_links_spec": [{
      "site_link_title": "<SITE_LINK_TITLE>",
      "site_link_url" : "<SITE_LINK_URL>",
    },
    {
      "site_link_title": "<SITE_LINK_TITLE>",
      "site_link_url" : "<SITE_LINK_URL>",
    },
    {
      "site_link_title": "<SITE_LINK_TITLE>",
      "site_link_url" : "<SITE_LINK_URL>",
    },
    {
      "site_link_title": "<SITE_LINK_TITLE>",
      "site_link_url" : "<SITE_LINK_URL>",
    }],
  }' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "site_extensions": {
        "enroll_status": "OPT_IN",
      },
    },
  }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Ad Creation

Before

  -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/v25.0/act_<AD_ACCOUNT_ID>/ads

After

New fields are highlighted in bold.

curl -X POST \
  -F 'creative={
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "link_data": {
        "link": "<WEBSITE_URL>",
      }
    },
    "creative_sourcing_spec": {
      "site_links_spec": [{
        "site_link_title": "<SITE_LINK_TITLE>",
        "site_link_url" : "<SITE_LINK_URL>",
      },
      {
        "site_link_title": "<SITE_LINK_TITLE>",
        "site_link_url" : "<SITE_LINK_URL>",
      },
      {
        "site_link_title": "<SITE_LINK_TITLE>",
        "site_link_url" : "<SITE_LINK_URL>",
      },
      {
        "site_link_title": "<SITE_LINK_TITLE>",
        "site_link_url" : "<SITE_LINK_URL>",
      }],
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "site_extensions": {
          "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/v25.0/act_<AD_ACCOUNT_ID>/ads

Parameters

NameDescription

site_link_title

Specifies the display label of the site link.

It can be added in site_links_spec, see Ad Creative Site Links Spec, Reference.

site_link_url

Specifies the url of the site link.

It can be added in site_links_spec, see Ad Creative Site Links Spec, Reference.

site_link_image_hash

Specifies the image of the site link. Use either site_link_image_hash or site_link_image_url. When both exist, site_link_image_url will be prioritized.

It can be added in site_links_spec, see Ad Creative Site Links Spec, Reference.

site_link_image_url

Specifies the image of the site link. Use either site_link_image_hash or site_link_image_url. When both exist, site_link_image_url will be prioritized.

It can be added in site_links_spec, see Ad Creative Site Links Spec, Reference.

site_extensions

“Add site links”, an Advantage+ Creative optimization that showcases additional URLs below your static single media or dynamic single media when it's likely to improve performance. Set the enroll_status field with OPT_IN to enable it.

It can be added in creative_features_spec. For more details, see Ad Creative Features Details, Reference.

Learn More

Business Help Center

Marketing API Reference