Build and Upload a TikTok Playable Ad

TikTok accepts a ZIP file. The ZIP root must contain index.html and config.json.

Requirements

• A TikTok for Business account
• A registered app
• Business and billing details
• A video for the feed ad
• An App Promotion campaign in Smart+

Read the TikTok playable ad specification. Then read the TikTok campaign procedure.

1. Add the profile

playableAds: {
    name: "MyGame",
    platforms: [{
        platform: "tiktok",
        maxBytes: 5_000_000,
        reportPath: "artifacts/tiktok-playable-build-report.json",
        orientation: 0,
    }],
}

See Build Playable Ads for the complete Vite configuration.

2. Build the ZIP file

npm run build -- --production

The ZIP has this structure:

playable.zip
├── index.html
└── config.json

TikTok requires the hosted Playable-sdk.js. The ZIP contains all other game files.

3. Upload the ZIP file

1. Open Creative Library → Playable.
2. Select + Add.
3. Upload dist/TikTok/playable.zip.
4. Wait for validation.
5. Open the preview.
6. Complete the game.

4. Add the playable to a campaign

1. Select + Create in Ads Manager.
2. Select App Promotion.
3. Select App Install.
4. Select the app and optimization goal.
5. Select TikTok placement.
6. Select + Add Creative at ad level.
7. Select the playable.
8. Add the required video.
9. Preview the ad.
10. Submit the ad for review.

Test on a device

1. Open the campaign or ad group.
2. Open View data → Creatives → Preview.
3. Select TikTok → QR Code.
4. Scan the code with TikTok.
5. Select Preview Ad.

Read Preview ads with a QR code. A QR code expires after seven days. A preview session expires after 24 hours.

Test with an agent

Upload the ZIP to an authorized Creative Library draft. Record all validator messages.

For a local test, extract the ZIP. Then use the browser test procedure.

Do not publish a campaign or change its spend without permission.

Troubleshooting

Related pages

• Test Playable Ads
• Playable Ad Build Profiles