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(),
);
No JavaScript redirects: the store opens only through the SDK call.

How to test a TikTok playable

  1. 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.

  2. Play it on a phone

    Use TikTok’s QR code generator to open the playable on a mobile device.

  3. 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

$600

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
Fix My PrototypeHow it works

Most Popular · Flagship

Pilot Sprint

$950

~$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)
Start Pilot SprintHow it works

iGaming & Acquisition

Gamified Pre-Lander

$1,100

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)
Launch Pre-LanderHow it works

No prepayment. You pay after the sprint is delivered.

Need High-Craft 3D or High-Volume Scaling?

Request Custom Scope
  • High-Craft 3D Sprint

    7–10 days

    From$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.

  • Zero Validation Rejects

    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 networks

How 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