Marketing API Version

Ad Preview Plugin

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, Newsfeed, 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.

API Creative Spec
Ad Account ID
Adgroup ID
Creative ID

Parameters

  • Required: One of creative, creative_id, or adgroup_id
  • Required: ad_format (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", or "MOBILE_FEED_STANDARD".

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.