Exporting Playable Ads
Upload network-specific playable ad builds from Super HTML to PlayableLabs for distribution
Export Overview
PlayableLabs stores and distributes playable ad builds that are exported from Super HTML. Builds are uploaded as ZIP files containing network-specific folders, each with an index.html and supporting resources. The upload system processes the ZIP, detects the included networks, and stores each build for preview and distribution.
Builds must be generated externally using Super HTML. PlayableLabs handles storage, preview, and distribution — not build generation.
Upload Workflow
Network file upload is located on the Version detail page. Navigate to any version to find the Network Files Upload section.
Prepare Your Build
Export your playable ad from Super HTML as a ZIP file. The ZIP should contain a folder for each target network (e.g., applovin/, facebook/, google-ads/), with each folder containing an index.html file.
Choose Upload Method
You have two options:
- Paste URL — Enter a direct URL to your ZIP file. The system downloads and processes it automatically.
- Upload File — Drag and drop a ZIP file or click to browse. Files under 30MB use direct upload; larger files (up to 500MB) use chunked upload automatically.
Monitor Progress
Upload progress is tracked in real-time via Server-Sent Events (SSE) across 4 phases:
- Download/Upload — File transfer to the server
- Extract — ZIP extraction and validation
- Process — Network detection and file organization
- Store — Uploading processed files to cloud storage
Each phase shows progress percentage, files processed, and detected networks.
Review Results
On completion, you'll see a summary of uploaded networks with badge indicators. The Currently Available Networks section updates to reflect all stored builds.
Supported Networks
PlayableLabs supports 22 ad networks across 4 tiers:
Tier 1 Networks
Premium global ad networks with highest reach.
| Network | Display Name | Max File Size |
|---|---|---|
| AppLovin | AppLovin | 5 MB |
| Facebook (Meta) | 4.8 MB | |
| Google Ads | Google Ads | 5 MB |
| ironSource | ironSource (Unity) | 5 MB |
Major Networks
High-volume networks with strong performance.
| Network | Display Name | Max File Size |
|---|---|---|
| Mintegral | Mintegral | 5 MB |
| Pangle | Pangle (TikTok Ads) | 5 MB |
| Unity Ads | Unity Ads | 5 MB |
| Vungle | Vungle (Liftoff) | 5 MB |
| TikTok | TikTok for Business | 5 MB |
| InMobi | InMobi | 5 MB |
Specialized Networks
Networks with specific audiences or features.
| Network | Display Name | Max File Size |
|---|---|---|
| Liftoff | Liftoff | 5 MB |
| Moloco | Moloco | 5 MB |
| Chartboost | Chartboost | 5 MB |
| Snapchat | Snapchat Ads | 5 MB |
| News Break | News Break | 5 MB |
| AdColony | AdColony | 5 MB |
| Tapjoy | Tapjoy | 5 MB |
Regional Networks
Networks with strong regional presence.
| Network | Display Name | Max File Size |
|---|---|---|
| GDT | GDT (Tencent) | 5 MB |
| Nefta | Nefta | 5 MB |
| Bigo | Bigo Ads | 5 MB |
| Kwai | Kwai for Business | 5 MB |
| Yandex | Yandex Ads | 5 MB |
Understanding Build Formats
Single HTML
A self-contained HTML file with all assets embedded as base64. This is the simplest format — upload the single file directly to the ad network.
game_meta.html (4.8MB)ZIP Bundle
A ZIP archive containing an index.html file and supporting resources. Some networks require this format for larger or more complex playable ads.
game_google.zip (5MB)
├── index.html
├── res.js
└── config.jsonSuper HTML Export Requirements
- The ZIP should contain folders for each network (e.g.,
applovin/,facebook/,google-ads/) - Each folder should contain an
index.htmlfile - Maximum file size: 4.8 MB per HTML file
- Large ZIP files up to 500 MB are supported via chunked upload
- Files over 30 MB automatically use chunked upload mode
Troubleshooting
File Size Exceeds Network Limit
If individual network files exceed the network's size limit:
- Compress images — Use WebP instead of PNG, reduce resolution
- Optimize audio — Use OGG or MP3 at lower bitrates, trim silence
- Remove unused assets — Delete assets not referenced by the game
- Simplify game logic — Reduce the complexity of embedded scripts
Upload Fails
- Verify the ZIP file is not corrupted
- Check that the file is within the 500 MB upload limit
- Ensure stable internet connection (large uploads use chunked transfer)
- Try the alternative upload method (URL vs file upload)
Playable Ad Does Not Load
- Test the exported file in the network's preview tool
- Check browser console for JavaScript errors
- Verify the click-through URL is valid and uses HTTPS
- Ensure the file was not corrupted during download
Tip: Always test exported files in each network's creative preview tool before launching a campaign.
Next Steps
- Learn about variants to create network-specific customizations
- Review the games overview for the full project hierarchy