Placement Asset Customization

This solution allows you to customize the creative assets displayed in different ad placements. You can maintain control over the creative, while using several different placements. Examples of assets are images and videos.

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

Recommended Steps

Create an ad campaign and ad set
Provide the creative and customize assets
Create your ad
Get insights and analyze results

Provide Creative

Provide your creative through the asset_feed_spec. You can specify multiple creative assets for each asset type, including images, videos, headlines and link descriptions.

To apply customization, set asset_customization_rules inside your asset_feed_spec. For each rule, add customization_spec and asset labels.

Property Name Description

Property Name	Description
`customization_spec` type: see table below	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`.

customization_spec

type: see table below

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.

Fields allowed in customization_spec:

Property Name	Description
`publisher_platforms`	Required. Possible placements for your ad. Options are: `facebook`, `instagram`, `audience_network`, `messenger`.
`facebook_positions`	Optional. Facebook specific placement. Option is: `feed`.
`instagram_positions`	Optional. Instagram specific placements. Options are: `stream` and `story`.
`audience_network_positions`	Optional. Audience Network specific placement. Option is: `classic`.
`device_platforms`	Optional. Platform specific placements. Options are: `mobile` and `desktop`.

Example feed setup code:

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. For next steps, see Asset Customization Rules.