# 可玩广告渠道上传规范

## <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="/files/Sa1R4GxdGkQxL2lutskD" 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="/files/N4NOJ920hjxsAYRE81TB" 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="/files/dLvN0msMwd9GTeYMnKyt" alt="" width="368"><figcaption></figcaption></figure></div>

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

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

<div align="left"><figure><img src="/files/YjGHcZd28WlRbRYvYS2Z" 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="/files/HdumtTlX8pY9oE6FZ02t" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/BirpE0g0AZSQEjVexXPv" alt=""><figcaption></figcaption></figure></div>

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

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

<figure><img src="/files/52G0tBFnBzzj8uhTj5eB" 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="/files/lP4BGUh7yfQIEhRkcwp6" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/zz6kVL6y3A0ig2jMEBGD" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

<div align="left"><figure><img src="/files/PbOTs4mKwovsZscbF0kX" 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="/files/7bW5vnKT4kzvwQJj0Jp7" alt="" width="563"><figcaption></figcaption></figure></div>

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

<div align="left"><figure><img src="/files/OoUZLaNO4ZlZ0N1lf7y6" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

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

<div align="left"><figure><img src="/files/OxCB0rQ8D6unxg4kIoQF" 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="/files/Bhb6p0l0TLDP5x0Rm9XP" 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="/files/eYHu909vpUBc8vCeCqTI" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

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

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

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

<div align="left"><figure><img src="/files/GRD9dlmWbJk5AA6drWCt" 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="/files/n2oCULSQjpsMW42bQdWp" 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="/files/Ukz8E0b9eeK0dkkAMKpp" 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="/files/ImPfmGpivEz6UqNb8db4" alt=""><figcaption></figcaption></figure></div>

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

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

<div align="left"><figure><img src="/files/o2m6IfpljrNH02or7R3n" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET 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?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
