TikTok playable ads: requirements and testing
A TikTok playable ad is a ZIP under 5 MB after compression, with index.html and a config.json at its top level. It loads TikTok’s Playable SDK instead of MRAID, makes no HTTP requests, and opens the store with window.openAppStore(). In TikTok Ads Manager, playables are available only in the upgraded Smart+ experience.
Below are TikTok’s rules, the store call and how to test a playable in Ads Manager and on a phone.
By Arc Studio · Updated
TikTok playable ad requirements
The four things a build has to get right before it can run
Package
- TikTok
- ZIP with index.html and config.json at the top level
Max size
- TikTok
- Under 5 MB (compressed)
MRAID / API
- TikTok
- TikTok Playable SDK (not MRAID)
Store click
- TikTok
- window.openAppStore();
TikTok’s rules for playables
From the network’s own documentation
- Include Playable-sdk.js at the bottom of the body, before your own scripts.
- config.json sets the orientation: 0 either, 1 portrait only, 2 landscape only. The TikTok and TikTok Ad Network pages spell the key and SDK path with different letter case, so test the upload.
- No HTTP requests, no dynamic loading from external networks and no JavaScript redirects.
- In TikTok Ads Manager, playable ads are available only in the upgraded Smart+ experience.
- Each ad needs at least one video, image or carousel asset next to the playable. TikTok Ad Network (formerly Pangle) runs playables as rewarded and interstitial at 1280×720 or 720×1280.
The TikTok store call
The Playable SDK goes at the bottom of the body, before your own scripts; the install button calls the SDK
// After TikTok's Playable SDK loads
installButton.addEventListener(
"click",
() => window.openAppStore(),
);How to test a TikTok playable
Upload it in TikTok Ads Manager
Ads Manager validates the technical requirements of a playable, but it does not test safe zones or general playability.
Play it on a phone
Use TikTok’s QR code generator to open the playable on a mobile device.
Check the safe zones
Use TikTok’s allowlisted safe zone overlays to make sure key elements of the playable do not sit under the TikTok interface.
Split-Test Sprints & Pricing
Stop buying single HTML5 files. Every sprint ships as a complete testing kit with built-in funnel analytics, no-code balance configs, and multi-network builds.
AI Prototype Fix
Vibe-to-Prod Rescue
flat fee
- Turnaround
- 48–72 hours
- Best for
- Teams generating raw prototypes in Cursor or Claude that suffer from lag, heavy file sizes (>5 MB), or ad network validation errors.
What you get
- Clean refactor on Cocos Creator or PixiJS
- Game feel polish (tweens, particles, tactile feedback)
- Strict compression (<2 MB for Meta, <5 MB for others)
- Packaged & validated for up to 8 ad networks
Most Popular · Flagship
Pilot Sprint
~$45 per localized build
- Turnaround
- 5 days
- Best for
- Mobile games & non-gaming apps (fintech, utilities, dating) looking to find a winning UA creative fast without burning budget.
What you get
- 1 custom concept + 2 opening hooks
- 4 endcard variations × 5 languages (20+ builds)
- No-Code Tweaker (adjust speed, difficulty & CTAs yourself)
- In-playable drop-off funnel analytics
- Bonus: 3 vertical video hooks recorded in-engine
- Packaged for up to 8 ad networks (Meta, AppLovin, Mintegral, Unity, Google, ironSource, Moloco)
iGaming & Acquisition
Gamified Pre-Lander
flat fee
- Turnaround
- 5 days
- Best for
- Licensed iGaming operators, betting & high-converting web funnels running Meta, TikTok, Push, or Native traffic.
What you get
- Custom mini-game (<1.5 MB, <1s load on 3G/4G)
- Programmable win-logic & bonus funnel (4 win modals)
- Full SubID / UTM / click_id pass-through
- Server/pixel event firing (Meta, TikTok, Keitaro, Binom)
- 5 languages + No-Code config (swap logos, bonuses & links)
No prepayment. You pay after the sprint is delivered.
Need High-Craft 3D or High-Volume Scaling?
Request Custom ScopeHigh-Craft 3D Sprint
7–10 daysFrom$1,600
Custom 3D scenes, physics, and shaders in Cocos 3D or Three.js (like Bottle Jump 3D or Train of Hope), including the full Pilot Sprint testing kit.
Scale Pack
10–12 days$2,400
For UA teams spending $30k+/mo. 3 original concepts × 3 variations, creative hypothesis matrix, 1 post-test iteration round, and 9 in-engine video hooks.
What's included
Standard engineering & analytics stack included in every sprint
Ex-Playrix Game Design
Mechanics engineered around 3-second hooks and IPM lift, not generic templates.
No-Code Balance Tweaker
Change game speed, win thresholds, and CTA copy in seconds without touching code.
In-Playable Funnel Tracking
See exact user drop-off points: load, first tap, 5s, win/fail, store click.
Guaranteed compliance with MRAID and network file-size limits out of the box.
TikTok playable ads FAQ
Quick answers for teams running playables on TikTok
What are the TikTok playable ad requirements?
A ZIP smaller than 5 MB after compression, with index.html and a config.json at the top level. config.json sets the orientation: 0 for either, 1 for portrait only, 2 for landscape only. The Playable SDK loads at the bottom of the body before your own scripts, the store opens with window.openAppStore(), and there are no HTTP requests, external loading or JavaScript redirects.
How do I test a TikTok playable ad?
Test it directly in TikTok Ads Manager, which validates the technical requirements, or use the QR code generator to play it on a phone. Ads Manager does not test safe zones or playability, so check those with TikTok’s safe zone overlays.
Do TikTok playable ads use MRAID?
No. TikTok playables use TikTok’s own Playable SDK, and the store opens through window.openAppStore().
Where do TikTok playable ads run?
On TikTok, as part of the upgraded Smart+ experience in Ads Manager. TikTok Ad Network (formerly Pangle) runs playables as rewarded and interstitial ads at 1280×720 or 720×1280.
Can one playable build run on TikTok and other networks?
Not as is. Networks differ in the package (single HTML or ZIP), the store-click call and the required hooks, so each network needs its own build. Arc Studio delivers a ready-to-ship archive for every ad network you need.
Playable ad specs for 8 networksHow much does a playable ad for TikTok cost?
Arc Studio sells playables as split-test sprints, not single files. A Pilot Sprint is $950 for 20+ playable builds (1 concept, 2 hooks, 4 endcards × 5 languages, about $45 per localized build) in 5 days; a Vibe-to-Prod Rescue of an AI-generated prototype is $600 in 48–72 hours; a Gamified Pre-Lander for iGaming and web funnels is $1,100 in 5 days; a High-Craft 3D Sprint starts at $1,600 (7–10 days) and a Scale Pack is $2,400 (10–12 days). No prepayment. You pay after the sprint is delivered. Every sprint ships builds for TikTok and up to 8 ad networks in all, and includes Ex-Playrix game design around 3-second hooks and IPM lift, a no-code balance tweaker, in-playable drop-off funnel tracking (load, first tap, 5 seconds, win or fail, store click) and builds that meet MRAID and network file-size limits.
Playable ad cost, explained