> For the complete documentation index, see [llms.txt](https://doc.playturbo.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.playturbo.cn/su-cai-dao-chu-tou-fang-xiang-guan-wen-dang/ke-wan-guang-gao-qu-dao-shang-chuan-gui-fan.md).

# 可玩广告渠道上传规范

\#订阅 #定制

## <mark style="color:blue;">一、目前支持的广告渠道&测试地址</mark> <a href="#currently-supported-a-d-networks--test-apps" id="currently-supported-a-d-networks--test-apps"></a>

当前，Playturbo支持推送或下载的渠道如下：

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FQVpV9xUSI8DfMQV7Svy1%2F%E6%B8%A0%E9%81%93.png?alt=media&amp;token=13267571-857f-46d5-8baf-27cc7ee56b9e" alt=""><figcaption></figcaption></figure></div>

💡<mark style="color:orange;">请注意，部分渠道包下载到本地后，会额外套一层ZIP；所以通常，您需要将下载后的ZIP文件先解压一次，上传里面最小单位的ZIP文件到投放平台。</mark>（如果上传文件到渠道时有类似这种提示"The main HTML file must be named "index" and located in the first-level directory."，即是ZIP文件有误的问题，可自行检查是否已解压过一次）

<table data-full-width="false"><thead><tr><th width="137">渠道</th><th width="129">文件大小</th><th width="202">文件格式</th><th width="162">测试地址</th><th>测试APP</th></tr></thead><tbody><tr><td>AdColony</td><td>2 MB</td><td>单个 HTML 文件</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>单个 HTML 文件</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>单个 HTML 或 包含资源的Zip</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>压缩的 HTML 文件（Tips：将下载到本地的压缩包，解压一次，上传里面的那个压缩包哦）</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>单个 HTML 文件</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 文件</td><td>-</td><td>-</td></tr><tr><td>Mintegral</td><td>5MB</td><td>包含资源的单个 HTML 或 Zip</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>包含资源的单个 HTML 或 Zip</td><td>-</td><td>-</td></tr><tr><td><p>Tik Tok</p><p>(含头条)</p></td><td>5MB</td><td><p>包含资源的 Zip 文件</p><p>（Tips：将下载到本地的压缩包，解压一次，上传里面的那个压缩包哦）</p></td><td>-</td><td>-</td></tr><tr><td>Unity Ads</td><td>5MB</td><td>单个 HTML 文件</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>包含资源的单个 HTML 或 Zip(将主 html 文件命名为“ad.html”)</td><td>-</td><td><a href="https://vungle.com/creative-verifier/">iOS and Android</a></td></tr><tr><td>Tapjoy</td><td>1.9MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td><p>Pangle</p><p>(含头条)</p></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>Inmobi</td><td>5MB</td><td>温馨提示:Inmobi渠道包下载后，需要将离线脚本内容部署到CDN上，再手动修改html中的路径，素材才能正常使用。</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>腾讯AMS</td><td>3MB</td><td>-</td><td>-</td><td>-</td></tr><tr><td><p>腾讯广告</p><p>(广点通)</p></td><td>3MB</td><td>包含资源的 Zip 文件</td><td>-</td><td>-</td></tr><tr><td>微信小游戏</td><td>15MB</td><td>包含资源的 Zip 文件</td><td>见微信官方文档</td><td></td></tr></tbody></table>

注意：需要包含所需广告的特定尺寸、格式和 APIS，请确保在实现场景时已涵盖所有这些内容。

## <mark style="color:blue;">二、特别说明: 微信小游戏</mark>

### 1.使用说明

当您的项目制作完成后，进入下载流程：

#### **Step1：绑定【项目信息】**

点击右上角【项目信息】>>>关联推广产品>>>新增推广产品>>>微信小游戏>>>依次输入小游戏名称、小游戏APP ID、小游戏图标>>>确认绑定

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F3nE6riUoSa5VXdT1RVbf%2Fimage.png?alt=media&amp;token=6a2fc505-2bf9-44e3-9b36-fef033c64dfe" alt="" width="345"><figcaption></figcaption></figure></div>

#### **Step2：选择试玩步数，确认下载**

点击右上角【下载】按钮>>>根据试玩流程，选择对应的试玩步数>>>下载

👉相关阅读: [自由编辑器 - 下载&推送](/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/zi-you-bian-ji-qi-xia-zai-tui-song.md#khhpw-1)

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2Fu1lJK3dRJlG4GToKyMnp%2Fimage.png?alt=media&amp;token=cde07212-2466-4af7-9251-26eb838e121d" alt="" width="368"><figcaption></figcaption></figure></div>

#### **Step3：勾选渠道，完成下载**

点击【下载】>>>勾选【微信小游戏】渠道>>>确认包体大小>>>完成下载

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FxcdqA6OIb9Hs5QFU5F2Y%2Fimage.png?alt=media&amp;token=33398afc-094a-463b-9e41-982974616630" alt="" width="563"><figcaption></figcaption></figure></div>

👉相关阅读: [换肤编辑器 -下载&推送](/ke-wan-gong-ju-huan-fu-bian-ji-qi/huan-fu-bian-ji-qi-shi-yong-zhi-nan/huan-fu-bian-ji-qi-xia-zai-tui-song.md)   [自由编辑器 - 下载&推送](/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/zi-you-bian-ji-qi-xia-zai-tui-song.md)

### 2.注意事项

#### <mark style="color:red;">2.1 渠道限制</mark>

⚠️所有项目，不支持使用"视频"类型的资源，否则无法勾选此渠道

⚠️除定制类型的项目，其他项目均不支持使用"刚体"功能，否则无法勾选此渠道

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FC7mWtaWQsN1nQ98P6P6O%2Fimage.png?alt=media&amp;token=4fddab40-41da-4245-9ca7-fbd7366b765e" alt="" width="563"><figcaption></figcaption></figure></div>

⚠️**微信小游戏渠道没有"跳转应用商店"的概念（试玩结束时会自动跳转结束页），因此无需添加相关CTA按钮或跳转环节**

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FY8193Hv2nUZp6wFhLkby%2Fimage.png?alt=media&amp;token=00ffd648-9ed3-4089-bd35-41384782c993" alt=""><figcaption></figcaption></figure></div>

#### <mark style="color:red;">2.2 部分可玩模板支持微信小游戏渠道</mark>

当前，并非所有可玩模板都支持下载微信小游戏渠道，具体可查看模板右下方的角标 是否带有微信标识，有则支持

<figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2F364kM5gLkp8sHNnspEHA%2Fimage.png?alt=media&amp;token=f42f3fe8-6b43-4221-a53f-45e88809d95c" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">三、部分渠道的可玩广告测试</mark>

以下内容提供了如何测试部分特定渠道可玩广告的指南

### 1.Applovin

*如果您希望在 Applovin 构建中使用外部请求（例如分析），则需要在上传请求许可之前联系 Applovin。否则播放将被拒绝*

为了测试您的 Applovin 版本，请按照以下步骤操作：

1）从您的 Creative Suite 帐户下载 Applovin 版本

2）导航至[Applovin 可玩预览工具](https://p.applov.in/playablePreview?create=1)

3）拖入您的index.html 文件或手动查找它

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FbbZIcoQlDuyaYGdXhpId%2Fimage.png?alt=media&amp;token=d9b958ae-4930-46e0-be96-ac51cba383f0" alt="" width="563"><figcaption></figcaption></figure></div>

4）如果可播放的格式不正确或超过文件大小限制，您将出现如下错误：

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FB2l2u9UQVKOkBP7ClFNz%2Fimage.png?alt=media&amp;token=95a58d1a-c5a1-42d0-b89b-239fbb2f44ac" alt="" width="563"><figcaption></figcaption></figure></div>

5）您现在可以在预览中测试可玩性，并更改方向

6）当成功点击应用程序商店时，预览工具将显示一条消息 - 请确保这种情况发生在所有预期位置

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FUPYhMUgHWWxrTs9jAcrp%2Fimage.png?alt=media&amp;token=f31963d9-7c7f-442b-aeff-21a3380f9505" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.Facebook

为了测试您的 Facebook 版本，请按照以下步骤操作：

1）从您的 Creative Suite 帐户下载 Facebook 版本

2）导航至[Facebook 可玩预览工具](https://developers.facebook.com/tools/playable-preview/)

3）拖入您的文件或手动查找它

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FLqS5uQQ8IAfJJXEK8Eoy%2Fimage.png?alt=media&amp;token=1a7fdb08-3ebe-42a7-945e-00d3dee09a09" alt="" width="563"><figcaption></figcaption></figure></div>

4）如果可播放的格式不正确或超过文件大小限制，您将出现如下错误：

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FBsdvGIV9O1W9zqj9HCGG%2Fimage.png?alt=media&amp;token=b95a9e9d-0da8-4efc-bcf8-c2a50b1ff5a8" alt="" width="563"><figcaption></figcaption></figure></div>

5）您现在可以在预览中测试可玩性，并更改分辨率

6）当成功点击应用程序商店时，预览工具将显示一条消息 - 请确保这种情况发生在所有预期位置

7）一旦右侧的所有规格项目都变成绿色，就可以将可播放的内容上传到广告管理器

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FNBnqn1uDZddIYhzYfD9L%2Fimage.png?alt=media&amp;token=4d848f5e-c320-4962-8d9d-07f13c2ed7ea" alt="" width="563"><figcaption></figcaption></figure></div>

### 3.ironSource

ironSource 测试工具已于 2023 年 3 月弃用。

如果您计划将ironSource 用于可玩广告，则必须确保您的构建与该平台兼容。为此，您需要在ironSource 仪表板中提交您的构建以供审核。

提交构建版本以供审核是一个简单的过程，但必须遵循正确的步骤以确保提交成功。为了帮助您完成此过程，ironSource 提供了[详细的指南](https://developers.is.com/ironsource-mobile/general/html-upload/) ，解释了如何逐步提交构建以供审核。

通过遵循ironSource指南中提供的说明，您可以确保您的构建得到高效且有效的审核，并且您的可播放广告有质量保证。

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FPU3UphTILrMLD5VR9Jdr%2Fimage.png?alt=media&amp;token=1fe21436-1359-4673-a760-ddcf1d9564dc" alt="" width="563"><figcaption></figcaption></figure></div>

### 4.Mintegral

为了测试您的 Mintegral 版本，请按照以下步骤操作：

1）从您的 Creative Suite 帐户下载 Mintegral 版本

2）导航至[Mintegral 可玩预览工具](https://www.mindworks-creative.com/review/)

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FHSbQyThWXII7gaWwoKnx%2Fimage.png?alt=media&amp;token=1c20b77d-1bed-48c1-a4be-d3c1622c2f89" alt="" width="563"><figcaption></figcaption></figure></div>

3）拖入您的 zip 存档文件或手动查找它

4）在预览工具中播放可玩内容。如果可玩内容存在任何错误，例如大小错误、格式错误或任何缺少 API，则会以红色突出显示

5）然后，您可以预览可玩内容并更改方向

6）当成功点击应用程序商店时，预览工具将显示一条消息 - 请确保这种情况发生在所有预期位置

7）一旦你满意了，并且测试用例都是绿色的，你就可以将你的 Playable 发送到 Mintegral 了

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FND36tPkl6R2WXBHpqr03%2Fimage.png?alt=media&amp;token=112f78f1-1a14-4d28-854b-b4a4692e10c9" alt="" width="563"><figcaption></figcaption></figure></div>

### 5.TikTok

目前，TikTok 上的可玩游戏还没有可用的测试工具。

**其他补充：**

显示方向和语言必须存储在位于一级目录的 config.json 文件中

* 方向必须以 0、1、2（响应式、纵向、横向）值存储
* 语言代码必须存储在`playable_languages`数组中

举例：

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

en：英语  ja：日语  Ko：韩语  Zh-Hant：繁体中文

### 6.Unity Ads

为了测试您的 Unity Ads 版本，请按照以下步骤操作：

1）从 Creative Suite 帐户的下载菜单中复制 Unity Ads 链接

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FeSY9t8Ckt64xcJJAbbzd%2Fimage.png?alt=media&amp;token=0e74bf56-3aee-4fb6-9b1b-7ae58061901d" alt="" width="563"><figcaption></figcaption></figure></div>

2）从 Unity下载[Android](https://play.google.com/store/apps/details?id=com.unity3d.auicreativetestapp)或[iOS测试应用程序](https://apps.apple.com/us/app/ad-testing/id1463016906)

3）打开应用程序并输入可播放广告的网址

4）&#x6309;**“初始化”**

5）广告加载后，&#x6309;**“显示”**

6）如果广告加载失败，或者要检查广告的状态，请返回主屏幕并&#x6309;**“分析”**。任何问题都会在创意报告中显示

举例：

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FuVZeOSbXHpcwBk5QNuoo%2Fimage.png?alt=media&amp;token=e9ddea31-dca0-4d7c-ab10-df10834c82e7" alt="" width="375"><figcaption></figcaption></figure></div>

<mark style="color:red;">注意：</mark>您的可玩广告必须包含 App Store 和 Google Play 应用商店网址才能通过 QA。在执行以下步骤之前，请确保您已在可玩 UI 中设置这些链接：

**可玩设置> iOS/Android 安装游戏链接**。[更多详细信息请参见此处](https://docs.lunalabs.io/docs/playable/playable-setup/settings/ad-network-settings#global-settings)

请确保对于 iOS 应用商店链接，您使用的是`apps.apple.com/`域名，而**不是**域名`itunes.apple/com/`

### 7.Vungle

为了测试您的 Vungle 版本，请按照 Vungle[此处](https://support.vungle.com/hc/en-us/articles/4908908675355-Test-Your-Playable-Asset-With-Our-Creative-Verifier)提供的这些步骤进行操作。

### 8.Google&#x20;

1）请先勾选【Select for App Campaigns】，然后点击【UPLOAD】上传正确的压缩包

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FDSYWDdoDDZVt2jv25evQ%2Fimage.png?alt=media&amp;token=bd88ebd6-d18c-44bd-a687-59f0c11d5353" alt=""><figcaption></figcaption></figure></div>

2）第一个错误提示：是zip文件名长度，可以随便修改，不用管

3）第二个错误提示：技术人员已排查过，文件没有问题，疑似是检测工具自身的问题，可以忽略

<div align="left"><figure><img src="https://1964780147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwzFOJWic5gvuaiaPmJmc%2Fuploads%2FquyyU6OeYM8T1zf9WOjQ%2F89d165033779fffe24b9e9e54c0b7291.png?alt=media&amp;token=d9dd2b29-0fc0-4758-a6b9-dc365ee5ba4f" alt=""><figcaption></figcaption></figure></div>
