Ad Creative Link Data

String that represents the ad context provided by advertiser

The index (zero based) of the image from the additional images array to use as the ad image for a dynamic product ad

Native deeplinks attached to the post

The style of the attachment

Combined with “product_set_id” to promote a specific Product Set while including other products from the Product Catalog in ads. Use the All Products Product Set ID in the “product_set_id” field and the specific Product Set ID in the “boosted_product_set_id” field. This will ensure products from the set are shown more often compared to other products from the Product Catalog.

The branded content shared to sponsor option

The branded content sponsor page id

The branded content sponsor relationship option

An optional call to action button. If not specified, on Instagram, a default CTA would be used, {"type":"LEARN_MORE","value": {"link":<LINK VALUE OF LINK_DATA>,}}. Note that LIKE_PAGE is not supported

Link caption. Overwrites the caption under the title in the link. The caption must be an actual URL and should accurately reflect the URL and associated advertiser or business someone visits when they click the link. See Post, Reference for more info. You do not use this setting in Instagram ads.

A 2-5 element array of link objects required for carousel ads. If multi_share_optimized is set to true, this array could have up to 10 objects. Facebook will automatically optimize the order in which the carousel cards are shown and display the top 5. We strongly recommend that you use at least 3 attachments for achieving optimal performance; allowing minimum of 2 attachments is for enabling lightweight integrations and using 2 objects might result in sub-optimal campaign results.
If this ad creative is used for an Instagram Carousel ad, you will need to have at least 3 attachments for MOBILE_APP_INSTALLS ads and 2 for the other objectives. If more than 5 are given, only the first 5 will be shown on Instagram, even if multi_share_optimized is true.

List of Canvas media component IDs and their square cropping information provided by the advertiser for Collection style feed rendering

Customization rules for a dynamic ad

Link description. Overwrites the description in the link when your ad displays. See Post, Reference for more information. You do not use this setting for Instagram ads.

The id of a Facebook event. This is only to be used if this creative is for a Website Clicks campaign, the Call To Action is Buy Tickets, and the link points to the ticketing website of this Facebook event

Whether to force the post to render in a single link format

Options on how to render your ad. If not specified, default is carousel_images_multi_items. See Dynamic Ads, Ads Management

How to the image should be cropped. You can use the crop spec with 100x100 key for Facebook Feed and Instagram.

Hash of an image in your ad account's image library. Provide a value for this field or `picture` but not both

How to render image overlays on a dynamic item in Dynamic Ads

How to render image overlays on a dynamic item in Dynamic Ads

Link url. This url is required to be the same as the CTA link url. See post for more info. This field is required for a carousel ad

The main body of the post. See post for more info. This field is required for a carousel ad

If set to false, removes the end card which displays the page icon. Default is true. Used by carousel ads

If set to true, automatically select and order images and links. Default is true. Used by carousel ads

Name of the link. Overwrite the title of the link when you preview the ad. Facebook ignores this value when call-to-action type is LIKE_PAGE. See Post, Reference for more information

The id of a Facebook native offer

The customized greeting message that is presented to the user when they are redirected from a click to Messenger or click to Whatsapp ad to the messaging app.

For click to Whatsapp ads, this string is a JSON object passed as a string. It can be an autofill message, an icebreaker or an automated greeting message with an optional call to action.

URL of a picture to use in the post. Specify this field or image_hash but not both. See post for more info. The image specified at the URL will be saved into the ad accounts image library

Customized contents provided by the advertiser for the ad post-click experience

Select which image to display by its tag, if you have added tags to your images. Tags are specified in order of priority to try

Selects which video to use, if you have added tags to your video.
For any item, we choose the video as follows: we get the first tag in preferred_video_tags that has at least one video for the item, then render the most performant video for that tag and placement. If no tags correspond to a video, we serve the first video. If there are no videos, we fall back to image rendering.
Note: preferred_video_tags will only be applied if your ad is opted into Dynamic Media.

List of product IDs provided by the advertiser for Collections

Use with force_single_link = true in order to show a single dynamic item but in carousel format using multiple images from the catalog. See dynamic product ad

Details of the sponsor for the event ad

Give a fallback creative for dynamic ads

Default value is true. This field only applies if you do not provide a cropping spec. We ignore it if you provide one.

If true, when the aspect ratio, or width:height ratio, is between 1.91:1 and 1:1, render the entire image. If the image is taller than the aspect ratio 1:1, automatically crop it to 1:1 and render the cropped image. If the image is wider than aspect ratio 1.91:1, automatically crop it to 1.91:1 and render the cropped image.

If set to false, when the aspect ratio, or width:height ratio, is 1.91:1, render the entire image. If the image aspect ratio is not 1.91:1, automatically crop it to 1.91:1 aspect ratio and render the cropped image.

Use this field only for single image ads, not carousel ads.

This field is not supported for Donation ads, Offer ads, Dynamic Ads, ads with image overlays, and ads using stock images.