Build and Upload a Unity Ads Playable

Unity Ads accepts one inline index.html file. The file must be smaller than 5 MB.

Requirements

• A Unity Cloud organization
• A User Acquisition project
• An advertised app
• Permission to manage creatives

Read the current Unity Ads playable specifications.

1. Add the profile

playableAds: {
    name: "MyGame",
    appStoreUrls: {
        ios: "https://apps.apple.com/app/id0000000000",
        android: "https://play.google.com/store/apps/details?id=com.example.game",
    },
    platforms: [{
        platform: "unity",
        maxBytes: 5_000_000,
        reportPath: "artifacts/unity-playable-build-report.json",
    }],
}

Add at least one store URL. See Build Playable Ads for the complete Vite configuration.

2. Build the file

npm run build -- --production

Test these functions before upload:

• Portrait and landscape layout
• Audio start after the first interaction
• Pause when the ad is not visible
• Store open from an explicit CTA

3. Upload the file

1. Open the Unity User Acquisition Creatives library.
2. Select Upload creatives.
3. Select the advertised app.
4. Upload dist/UnityAds/index.html.
5. Select a moderation language.
6. Wait for validation.
7. Add the creative to a creative pack.

Read the Unity Ads upload guide for the current dashboard procedure.

4. Test on a device

Use the Unity Ads creative pack preview.

1. Install Ad Testing for Unity Ads on iOS or Android.
2. Select Show QR code for the creative pack.
3. Scan the code in the app.
4. Test orientation, touch, audio, pause, resume, and the CTA.

Test with an agent

Upload the HTML to an authorized draft. Record the complete validation report. Keep the campaign inactive.

Use the Unity preview to test MRAID and the store action.

Troubleshooting

Related pages

• Test Playable Ads
• Playable Ad Build Profiles