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.
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:
asset_customization_rules
inside your asset_feed_spec
. customization_spec
and asset labels.See Asset Customization Rules.
Property Name | Description |
---|---|
type: Supported Fields | Required. Placements where you want to display the assets. |
format: | Required for Label of the image you want to display. It is attached to the image assets in |
format: | Required for Label of the video you want to display. It is attached to the video assets in |
customization_spec
Property Name | Description |
---|---|
| Required. Possible placements for your ad. Options are: |
| Optional, but required if Facebook is selected in Facebook specific placement. Options are: |
| Optional, but required if Instagram is selected in Instagram specific placements. Options are: |
| Optional, but required if Audience Networks is selected in Audience Network specific placement. Options are: |
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