Marketing API

Placement Asset Customization

Use this solution to customize the creative assets displayed in different ad placements. Examples of assets are images and videos.

You can maintain control over the creative, while using several different placements.

Placement Asset Customization is one of our three APIs that use asset customization rules. Learn more about Asset Customization Rules.

Recommended Steps

  1. Create an ad campaign and ad set
  2. Provide the creative and customize assets - see below
  3. Create your ad
  4. Get insights and analyze results

Placement Asset Customization with existing posts is no longer supported via the API. You can only use this option in Ads Manager.

Provide Creative

Use asset_feed_spec to provide your creative. You can specify multiple creative assets for each asset type, including images, videos, headlines, and link descriptions.

To apply customization:

  1. Set asset_customization_rules inside your asset_feed_spec.
  2. For each rule, add customization_spec and asset labels.

For Placement Asset Customization, every asset_feed_spec needs to have more than one customization rule attached to it.

See Asset Customization Rules.

Supported Properties


Property Name Description

customization_spec

type: Supported Fields

Required.

Placements where you want to display the assets.

image_label

format: {"name": "{LABEL_NAME}"}

Required for SINGLE_IMAGE format.

Label of the image you want to display. It is attached to the image assets in asset_feed_spec.

video_label

format: {"name": "{LABEL_NAME}"}

Required for SINGLE_VIDEO format.

Label of the video you want to display. It is attached to the video assets in asset_feed_spec.

Supported Fields in customization_spec


Property Name Description

publisher_platforms

Required.

Possible placements for your ad. Options are: facebook, instagram, and audience_network.

facebook_positions

Optional, but required if Facebook is selected in publisher_platforms.

Facebook specific placement. Options are: feed, right_hand_column, instant_article, marketplace, video_feeds, and story.

instagram_positions

Optional, but required if Instagram is selected in publisher_platforms.

Instagram specific placements. Options are: stream, story, and explore.

audience_network_positions

Optional, but required if Audience Networks is selected in publisher_platforms.

Audience Network specific placement. Options are: classic, instream_video, and rewarded_video.

Learn more about our available placement options.

Example — Feed Setup

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' 
  -F 'asset_feed_spec={
    "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb",
          }
        ],
        "video_id": "10154618295707554"
      },
      {
        "adlabels": [
          {
            "name": "labelig",
          }
        ],
        "video_id": "10154618298562554"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": ""
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb",
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig",
        }
      }
    ]
  }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

See all available options for Asset Feed Spec.