Ads and Commerce
Ads and Commerce
Resources

Ad Preview Plugin

Updated: Jun 6, 2024
The Ad Preview plugin is the easiest way for advertisers to preview ads on their own websites.
The plugin enables you to generate Right Hand Column, Feed, or Mobile previews of an ad by specifying a Creative Spec, Adgroup ID or Creative ID. Previews can either be generated using a Social Plugin or through the Graph API.

Parameters

  • Required: One of creative, creative_id, or adgroup_id
  • Required: ad_format, which replaces page_type parameter
  • Optional: ad_account_id, targeting, post
The preview plugin requires you to be logged in with Facebook Login. If creative_id, adgroup_id, or ad_account_id is used, you must also have the permissions to access the Creative, Ad Group, or Ad Account respectively.
Setting HTML5 Attribute Description
ad_account_id
data-ad-account-id
Required when specifying a creative that uses image_hash
adgroup_id
data-adgroup-id
Adgroup ID returned from a Graph API call.
creative
data-creative
JSON-encoded creative spec.
creative_id
data-creative-id
Creative ID returned from a Graph API call.
ad_format
data-ad-format
One of: RIGHT_COLUMN_STANDARD, DESKTOP_FEED_STANDARD, MOBILE_FEED_STANDARD, or FACEBOOK_STORY_MOBILE.
page_type
data-page-type
One of: rightcolumn, desktopfeed, or mobile.
targeting
data-targeting
JSON-encoded targeting spec.
post
data-post
JSON-encoded post specification according to the Pages API documentation.

Graph API

Previews can also be generated using the Graph API. To generate a plugin-style preview, simply specify the additional parameter, ad_format, as described in the table above.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon