Expand Navigation HeaderCollapse Navigation Header
Create Ads from a Facebook Page
Beginner's GuideFeaturesBoost PostsPage LikesCall-to-ActionWebsite VisitorsWebsite PurchasesWebsite Purchases With Your CatalogAutomated Ads
Create Ads from Ads Manager
Create Campaigns, Ad Sets, AdsEdit CampaignsEvent AdsOffer AdsLead AdsDynamic CreativeCreative TipsMobile App AdsFacebook Ads Manager for ExcelBid StrategiesBudgetsDelivery
Create Ads from Instagram
Beginner's GuideAdvertising from InstagramInstagram Shopping
Create Ads from the Ads Manager App
Ads Manager App
Brand AwarenessReachLead GenerationBrand ConsiderationMessagesDynamic AdsAutomotiveTravelCollaborative AdsConversions
AudiencesCustom AudiencesLookalike Audiences
ImageCarouselCollectionInstant ExperienceVideo & SlideshowStoriesBranded Content
Placement OptimizationInstagramMessengerAudience NetworkMarketplaceFacebook In-Stream Video
Track Ongoing Campaigns
Track Ads in Ads ManagerAutomated Rules in Ads Manager
Ads Reporting
MetricsFacebook Ads Manager for ExcelAudience InsightsView Results & Run ReportsAnalyze Results
Facebook Attribution
Offline ConversionsApp EventsFacebook PixelConversions API
Experiment ConceptsA/B TestingExperiments ToolFacebook-Managed Tests
Payments Settings
Monthly Invoicing
How Billing WorksPayment MethodsSpending LimitsTaxesAbout Manual paymentsBudgets
Management Tools
Business ManagerUsers in Business ManagerAccounts in Business ManagerData Sources in Business ManagerSecurity and Safety in Business ManagerLeads CenterCatalogsCreative HubConnect Your WebsiteBrand SafetyAd Account PermissionsBusiness Suite
Ads About Social Issues, Elections or PoliticsPersonal HealthCryptocurrencyAdvertising Policy on Real Money Gaming and Gambling (RMG)Drug and Alcohol Addiction Treatment

Business Help Center

Business Help Center

Specifications for Playable Ads Assets

Get help, tips, and more...
Last updated: Jul 27, 2020

Specifications for Playable Ads Assets

The playable ad specifications are the requirements for creating a playable asset. Click below for specifications for:

For Playable HTML5 Assets

  • Playable game should be HTML5 (the extension should be 'html' or 'htm').
  • The file size should be less than 2MB.
  • Playable should not require mraid.js.
  • Playable should not make any HTTP request. For example, "XMLHttpRequest" is not allowed.
  • Playable should be in portrait mode.
  • Playable should have a responsive design because it needs to support multiple types of devices which have different resolutions.
  • A single file for a playable ad that contains all assets as part of that single HTML file and assets should be data uri compressed (JavaScript, CSS, images, sounds).
  • The playable code should use the JavaScript function FbPlayableAd.onCTAClick() when a person interacts with the call-to-action in the ad. Facebook uses the code to navigate to the correct app store page for the app.
  • Playable HTML5 assets should not contain any JavaScript redirect.
  • No dynamic asset loading through external network is permitted.
  • To combine into one file: encode image into base64 string, integrate js into index.html.

For Zip Files

  • A playable ad in a zip file format is currently supported on all placements on iOS and Android.
  • Zip archive should contain an index.html file located at the root, for example:

    Note: Resources may be placed anywhere in the directory structure, as long as they are referenced relative to index.html. For example, the following file:

    must be references as:

    <image src="assets/splash.png"/>

  • Any html files and JavaScript files in the zip archive should have the same constraints, although FbPlayableAd.onCTAClick() only needs to be called in one place.
  • The total size of uploaded files may not exceed 5MB.
  • The number of files inside the bundle may not exceed 100.
  • The size of index.html file should not exceed 2MB.

For Lead-In Video

  • All aspect ratios are supported, including Landscape, Square and Vertical. Learn more about Facebook's standard video requirements.
  • Note: Lead in videos are required when running playable ads, however the lead in video will only deliver as part of the playable experience on Newsfeed. On Audience Network placements, no lead in video is delivered.

Learn More

Was this information helpful?

More in this section: CREATE ADS FROM ADS MANAGER


App Ads