# Playable Upload Specifications for Networks

## <mark style="color:blue;">Supported Ad Networks & Test Apps</mark> <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

Currently, Playturbo supports the following channels for apply or download:

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FMcae94BSfLodn2Li4Q5O%2F%E6%B8%A0%E9%81%93en.png?alt=media&#x26;token=84a0c42e-6aa2-48f4-b2fa-12e386109d20" alt=""><figcaption></figcaption></figure></div>

💡<mark style="color:orange;">Please note that for some channels, the package will be downloaded with an additional ZIP layer. In such cases, you will need to extract the downloaded ZIP file first, and then upload the innermost ZIP file (the smallest ZIP package) to the ad platform.</mark>

If you encounter a prompt like "The main HTML file must be named 'index' and located in the first-level directory" when uploading the file to the channel, it indicates an issue with the Zip file. You can check if the Zip file has been unzipped before.

<table data-full-width="false"><thead><tr><th width="134">Network</th><th width="140">File Size</th><th width="241">File Format</th><th width="146">Test Site</th><th>Test App</th></tr></thead><tbody><tr><td>AdColony</td><td>2 MB</td><td>Single HTML file</td><td>-</td><td><a href="https://install.appcenter.ms/orgs/iosdeveloper-dbmy/apps/ios-playable-preview/distribution_groups/all-users-of-ios-playable-preview">IOS</a><br><a href="https://install.appcenter.ms/orgs/iosdeveloper-dbmy/apps/android-playable-preview/distribution_groups/all-users-of-android-playable-preview">Android</a></td></tr><tr><td>Applovin</td><td>5MB</td><td>Single HTML file</td><td><a href="https://p.applov.in/playablePreview?create=1&#x26;qr=1">Playable Preview</a></td><td><a href="https://install.appcenter.ms/orgs/iosdeveloper-dbmy/apps/ios-playable-preview/distribution_groups/all-users-of-ios-playable-preview">IOS</a><br><a href="https://install.appcenter.ms/orgs/iosdeveloper-dbmy/apps/android-playable-preview/distribution_groups/all-users-of-android-playable-preview">Android</a></td></tr><tr><td>Facebook</td><td>2 MB HTML / 5 MB Zip</td><td>Single HTML or Zip with resources</td><td><a href="https://developers.facebook.com/tools/playable-preview/">Playable Preview (Beta)</a></td><td>-</td></tr><tr><td>Google Ads</td><td>5 MB</td><td><p>Zipped HTML file</p><p><em>（Tips: unzip the downloaded compressed file once and upload the compressed file inside it.）</em></p></td><td><a href="https://h5validator.appspot.com/adwords/asset">Google Playable Testing</a></td><td>-</td></tr><tr><td>ironSource</td><td>5 MB</td><td>Single HTML file</td><td><a href="https://developers.is.com/ironsource-mobile/general/html-upload/">Submit an HTML asset for review</a></td><td>-</td></tr><tr><td>Liftoff</td><td>5MB</td><td>Zip file with resources</td><td>-</td><td>-</td></tr><tr><td>Mintegral</td><td>5MB</td><td>Single HTML or Zip with resources</td><td><a href="https://www.mindworks-creative.com/review/doc">Mindworks Playable Testing</a></td><td></td></tr><tr><td>Moloco</td><td>2MB HTML / 5MB Zip</td><td>Single HTML or Zip with resources</td><td>-</td><td>-</td></tr><tr><td>TikTok</td><td>5MB</td><td><p>Zip file with resources</p><p><em>（Tips: unzip the downloaded compressed file once and upload the compressed file inside it.）</em></p></td><td>-</td><td>-</td></tr><tr><td>Unity Ads</td><td>5MB</td><td>Single HTML file</td><td>-</td><td><a href="https://apps.apple.com/us/app/ad-testing/id1463016906">IOS</a><br><a href="https://play.google.com/store/apps/details?id=com.unity3d.auicreativetestapp">Android</a></td></tr><tr><td>Vungle</td><td>5MB</td><td>Single HTML or Zip with resources(Name your main html file "ad.html")</td><td>-</td><td><a href="https://vungle.com/creative-verifier/">iOS and Android</a></td></tr><tr><td>Inmobi</td><td>5MB</td><td>Pls Note: After downloading the InMobi playable material, you need to deploy the offline script content to the CDN and manually modify the paths in the HTML file for the material to function properly.</td><td>-</td><td>-</td></tr><tr><td>Tapjoy</td><td>1.9MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Pangle</td><td>5MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>myTarget</td><td>2MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Kwai</td><td>5MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>i-mobile</td><td>6MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Snapchat</td><td>5MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Smadex</td><td>5MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Chartboost</td><td>3MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Bigo</td><td>5MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>巨量引擎</td><td>3MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>快手</td><td>3MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Tencent AMS</td><td>3MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td>Tencent Ads</td><td>3MB</td><td>Zip file with resources</td><td>-</td><td>-</td></tr><tr><td>WeChat MiniGame</td><td>15MB</td><td>Zip with resources</td><td>Refer to the official WeChat documentation</td><td>-</td></tr></tbody></table>

NOTE：Remember! that specific size, formats and APIS need to be included for desired ads, make sure you have covered all them all when implementing your scene.

## <mark style="color:blue;">Special Note: WeChat MiniGame</mark> <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

### 1.**Usage Intro** <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

After completing your project editing, proceed with the download process:

#### **Step 1: Bind "Project Info"**

Click the top-right corner \[Project Info] >>> Associate with promoted product >>> Add Promoted Product >>> WeChat MiniGame >>> Enter the MiniGame name, MiniGame APP ID, and icon >>> Confirm binding.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FzxOY1uIM8ro539lnCPW9%2Fimage.png?alt=media&#x26;token=c9d0a1fd-6486-43bf-943f-9031a50d53c6" alt="" width="339"><figcaption></figcaption></figure></div>

#### **Step 2: Select "Playable ad steps" and confirm download**

Click the top-right \[Download] button >>> Choose the corresponding playable ad steps based on the process >>> Download.  [#id-2.playable-a-d-steps](https://doc.playturbo.com/playable-tools-content-editor/content-editor-user-guide/content-editor-download-and-apply#id-2.playable-a-d-steps "mention")

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FVgONDrOx3X6xpzVuOywR%2Fimage.png?alt=media&#x26;token=669ee153-ffe7-4096-9dba-5f8c8d9f4e60" alt="" width="373"><figcaption></figcaption></figure></div>

#### **Step 3: Select channel and complete download**

Click \[Download] >>> Check the \[WeChat MiniGame] channel >>> Confirm package size >>> Complete download.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FiVP6kj3Rb0jUKmpyC0cR%2Fimage.png?alt=media&#x26;token=ae71389f-0026-45ea-875b-d0c5a2b9e8e1" alt="" width="563"><figcaption></figcaption></figure></div>

**👉Related content：** [feature-changer-download-and-apply](https://doc.playturbo.com/playable-tools-feature-changer/feature-changer-user-guide/feature-changer-download-and-apply "mention")   [content-editor-download-and-apply](https://doc.playturbo.com/playable-tools-content-editor/content-editor-user-guide/content-editor-download-and-apply "mention")

### 2.Precautions <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

#### <mark style="color:red;">2.1</mark> <mark style="color:red;"></mark><mark style="color:red;">**Channel Restrictions**</mark> <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

⚠️ Except for customized projects, other projects do not support using the "Rigid Body" feature, and the channel cannot be selected if this feature is used.

⚠️ All projects do not support using "Video" type assets, and the channel cannot be selected if this type is used.

⚠️ WeChat MiniGame channel does not support the concept of "redirecting to app store" (it will automatically go to the End Card after the trial ends), so there is no need to add any CTA buttons or redirect steps.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FJiEEAZ2RgbSUnnkROXFH%2Fimage.png?alt=media&#x26;token=54d3e201-2d95-402e-8eee-0d6bbfed46dd" alt="" width="563"><figcaption></figcaption></figure></div>

#### <mark style="color:red;">2.2</mark> <mark style="color:red;"></mark> <mark style="color:red;"></mark><mark style="color:red;">**Some playable templates support the WeChat MiniGame channel**</mark>

Currently, not all playable templates support exporting to the WeChat MiniGame channel.&#x20;

You can check whether the template has the WeChat logo in the lower right corner to determine if it is supported.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FzGLMOKG0hv4GGVywgYSt%2Fimage.png?alt=media&#x26;token=18f2efcf-4889-40c3-860a-a1c464ae2416" alt=""><figcaption></figcaption></figure></div>

## <mark style="color:blue;">Test playable ads for specific networks</mark>

The following content provide some guidelines on how to test your playable ads for specific networks.

### 1. Applovin

*If you wish to use external requests like analytics with your Applovin build, you will need to contact Applovin prior to uploading requesting permission to do so. Otherwise the playable will be rejected.*

In order to test your build for Applovin, please follow these steps:

1）Download an Applovin build from you Creative Suite account.

2）Navigate to the [Applovin playable preview tool](https://p.applov.in/playablePreview?create=1).

3）Drag in your index.html file or find it manually.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FyYU7r7gnE1fNXOofoYcO%2Fimage.png?alt=media&#x26;token=42284063-d922-44f4-8c3e-e8ac7a8b1cb7" alt="" width="563"><figcaption></figcaption></figure></div>

4）If the playable is incorrectly formatted or over the file size limit, you will an error such as the following:

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FgXsL73oI93qb4jvI2wec%2Fimage.png?alt=media&#x26;token=e703904a-158e-4afe-837d-9cf0ee0a8744" alt="" width="563"><figcaption></figcaption></figure></div>

5）You may now test the playable in the preview, and change the orientation.

6）The preview tool will show a message when a successful app store click has taken place - please ensure this happens at all expected locations.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FezwFhdw8O5tqxILGYwTD%2Fimage.png?alt=media&#x26;token=b0a792ad-9b94-4eef-a7ce-c424a83fc1ec" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.Facebook

In order to test your build for Facebook, please follow these steps:

1）Download a Facebook build from your Creative Suite account.

2）Navigate to the [Facebook playable preview tool](https://developers.facebook.com/tools/playable-preview/).

3）Drag in your file or find it manually.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FTSDuof3GTciVqWSobDFa%2Fimage.png?alt=media&#x26;token=7752a11d-f9c4-49b3-90a8-829b853d27d1" alt="" width="563"><figcaption></figcaption></figure></div>

4）If the playable is incorrectly formatted or over the file size limit, you will an error such as the following:

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F0u5BKoLYUcbBHjf8y8br%2Fimage.png?alt=media&#x26;token=545f4634-bff5-4676-9128-ba2219555812" alt="" width="563"><figcaption></figcaption></figure></div>

5）You may now test the playable in the preview, and change the resolution.

6）The preview tool will show a message when a successful app store click has taken place - please ensure this happens at all expected locations.

7）Once all the specification items on the right-hand-side are green, the playable can be uploaded to Ads Manager.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FsxKRHnzV1cXugC3jOBeQ%2Fimage.png?alt=media&#x26;token=c3bc0bee-6bda-46ec-811e-707f38085e30" alt="" width="563"><figcaption></figcaption></figure></div>

### 3.ironSource

The ironSource test tool has been deprecated in March 2023.

If you're planning to use ironSource for your playable ads, it's essential to make sure that your build is compatible with the platform. In order to do that, you'll need to submit your build for review in the ironSource dashboard.

Submitting your build for review is a straightforward process, but it's essential to follow the correct steps to ensure that your submission is successful. To help you through this process, ironSource provides a [detailed guide](https://developers.is.com/ironsource-mobile/general/html-upload/) that explains how to submit your build for review step-by-step.

By following the instructions provided in the ironSource guide, you can ensure that your build is reviewed efficiently and effectively and that your playable ads are quality assured.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2Fj9FO7dvkD1OhKNUdHoIG%2Fimage.png?alt=media&#x26;token=c166fbdf-f126-4d5d-8e8e-9e59d4635aa6" alt="" width="563"><figcaption></figcaption></figure></div>

### 4.Mintegral

In order to test your build for Mintegral, please follow these steps:

1）Download a Mintegral build from your Creative Suite account.

2）Navigate to the [Mintegral playable preview tool](https://www.mindworks-creative.com/review/).

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F8oEaOXw30irBNi8CcXgH%2Fimage.png?alt=media&#x26;token=901db1ef-bf2f-4bfd-aac6-6de3ea1f1e87" alt="" width="563"><figcaption></figcaption></figure></div>

3）Drag in your zip archive file or find it manually.

4）Play the playable in the preview tool. If the playable has any errors such as wrong size, wrong formatting or any missing APIs, it will be highlighted in red.

5）You can then preview the playable and change the orientation.

6）The preview tool will show a message when a successful app store click has taken place - please ensure this happens at all expected locations.

7）Once you are happy, and the test cases are all green, you can send your Playable to Mintegral.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2F4fQwVdJAeMMEoLTnumLn%2Fimage.png?alt=media&#x26;token=2438f8f0-6324-4f6f-bbc0-cfc3d42ebddf" alt="" width="563"><figcaption></figcaption></figure></div>

### 5.TikTok

Currently, there is no testing tool available for playables on TikTok.

**Additional Details**

The display orientations and languages must be stored in a config.json file, located in the first-level directory.

* The orientation must be stored with values of 0,1,2 (responsive, portrait, landscape).
* The language code must be stored in the `playable_languages` array.

Example:

```
"playable_orientation": 0,
"playable_languages":["ja","ko"]
```

en: English ja: Japanese Ko: Korean Zh-Hant: Traditional Chinese

### 6.Unity Ads

In order to test your build for Unity Ads, please follow these steps:

1）Copy Unity Ads link from the download menu in your Creative Suite account

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FxOLJ8IyR7edUBkxmqb7s%2Fimage.png?alt=media&#x26;token=5345ed5b-2b6a-42b1-913b-d855aa56daa5" alt="" width="563"><figcaption></figcaption></figure></div>

2）Download the [Android](https://play.google.com/store/apps/details?id=com.unity3d.auicreativetestapp) or [iOS](https://apps.apple.com/us/app/ad-testing/id1463016906) test app from Unity

3）Open the app and past in the URL of your playable ad

4）Press **"Initialize"**

5）Once the ad is loads, press **"Show"**

6）If the ad fails to load, or to check the status of the ad, go back to the main screen and press **"Analyse"**. Any issues will be surfaced in the Creative report

Example:

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FirUI4rcr8JAiGot72rhp%2Fimage.png?alt=media&#x26;token=520df714-71ee-467f-b970-8c014d4f017c" alt="" width="375"><figcaption></figcaption></figure></div>

<mark style="color:red;">NOTE：</mark>Your playable ad must include the App Store and Google Play app store URLs in order to pass QA. Before carrying out the following steps, please ensure you have set these links in the Playable UI under:

**Playable settings > iOS/Android install game link**. [More details here.](https://docs.lunalabs.io/docs/playable/playable-setup/settings/ad-network-settings#global-settings)

Please make sure that for iOS app store links, you use the `apps.apple.com/` domain, and **NOT** the `itunes.apple/com/` domain.

### 7.Vungle

In order to test your build for Vungle, please follow these steps provided by Vungle [here](https://support.vungle.com/hc/en-us/articles/4908908675355-Test-Your-Playable-Asset-With-Our-Creative-Verifier).

### 8.Google

1）Please check "Select for App Campaigns" first, and then click "UPLOAD" to upload the correct compressed package.&#x20;

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FP5yOwjuL6BRizKcJD06X%2Fimage.png?alt=media&#x26;token=00e826aa-227d-419a-b6f9-213f309883bd" alt=""><figcaption></figcaption></figure></div>

2）The first error message is about the length of the zip file name. You can modify it freely, no need to worry.

3）The second error message has been investigated by our technical team, and there doesn't seem to be any issue with the file. It may be a problem with the detection tool itself and this error can be ignored.

<div align="left"><figure><img src="https://695199083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4PyzU9CRLR4XKbxmIEid%2Fuploads%2FlI2Yroi4jR9ulM1z9U9L%2Fimage.png?alt=media&#x26;token=0ace95f8-fa29-405c-857d-857efd88e7f5" alt=""><figcaption></figcaption></figure></div>