本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过中介加载和展示来自 Moloco Ads SDK 的广告(内容涵盖出价集成)、如何将 Moloco Ads SDK 添加到广告单元的中介配置,以及如何将 Moloco Ads SDK SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
Moloco Ads SDK 的 Ad Manager 中介适配器具有以下功能:
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 激励广告 | |
| 插页式激励广告 | |
前提条件
在继续之前,请验证以下各项:
- 最新版Google Mobile Ads Unity Plugin。
- Unity 编辑器 5.6 版或更高版本。
- Moloco Unity 插件 1.2.0 版或更高版本。
- 如需在 Android 上部署,则要求:
- Android API 级别 23 或更高级别。
- 如需在 iOS 上部署,则要求:
- iOS 部署目标版本为 13.0 或更高版本。
- 一个正常运行的 Unity 项目,其中配置了 Google Mobile Ads Unity Plugin。如需了解详情,请参阅 设置 Google Mobile Ads Unity Plugin。
- 如何设置中介
第 1 步:在 Moloco Ads SDK 界面中设置配置
登录 Moloco 发布商门户。
依次前往 Overview (概览)> Apps (应用)标签页,然后点击 Add App (添加应用)按钮以创建新应用。
为您的应用选择 OS (操作系统)和 Privacy Settings (隐私设置),填写表单的其余部分,然后点击 Create (创建)。
Android
iOS
创建应用后,从 Apps (应用)标签页中选择该应用,以便查看详细信息并记下 App Key (应用密钥)。
Android
iOS
依次前往 Overview (概览)> Ad Units (广告单元)标签页,从下拉菜单中选择应用,然后点击 New Ad Unit (新建广告单元)。
为 Auction method (竞价方式)选择 In-app bidding (应用内出价),并填写表单的其余部分。然后,点击 Create (创建)。
前往 Ad Units (广告单元)标签页,找到新创建的广告单元,以便查看其详细信息。记下 Ad Unit ID (广告单元 ID)。
第 2 步:在 Ad Manager 界面中设置 Moloco Ads SDK 需求
为广告单元配置中介设置
将 Moloco Ads 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照 欧洲法规设置 和 美国州级法规设置 中的步骤,将 Moloco Ads 添加到 Ad Manager 界面内的 欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步:导入 Moloco Ads SDK SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI ,则可以通过从项目的根目录运行以下命令,将 Google 移动广告 Moloco Ads SDK 中介插件 for Unity 安装到您的项目中:
openupm add com.google.ads.mobile.mediation.molocoOpenUPM
在 Unity 项目编辑器中,依次选择 Edit (修改)> Project Settings (项目设置)> Package Manager (软件包管理器),打开 Unity 软件包管理器设置。
在 Scoped Registries (限定范围的注册表)标签页下,将 OpenUPM 添加为限定范围的注册表,并提供以下详细信息:
- 名称:
OpenUPM - 网址:
https://package.openupm.com - 范围:
com.google
然后,依次前往 Window (窗口)> Package Manager (软件包管理器),打开 Unity 软件包管理器,并从下拉菜单中选择 My Registries (我的注册表)。
选择 Google Mobile Ads Moloco Mediation (Google 移动广告 Moloco 中介)软件包,然后点击 Install (安装)。
Unity 软件包
从变更日志中的下载链接下载最新版 Google 移动广告 Moloco Ads SDK 中介插件,然后从 ZIP 文件中提取GoogleMobileAdsMolocoMediation.unitypackage。
在 Unity 项目编辑器中,依次选择 Assets (资源)> Import Package (导入软件包)> Custom
Package (自定义软件包),然后找到您下载的 GoogleMobileAdsMolocoMediation.unitypackage
文件。确保选择所有文件,然后点击 Import (导入)。
然后,依次选择 Assets (资源)> External Dependency Manager (外部依赖项管理器)> Android
Resolver (Android 解析器)> Force Resolve (强制解析)。外部依赖项管理器库将从头开始执行依赖项解析,并将声明的依赖项复制到
Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步:添加必需的代码
Moloco Ads SDK 集成不需要额外的代码。
第 5 步:测试您的实现
启用测试广告
确保针对 Ad Manager 注册测试设备。
验证测试广告
若要验证您是否能收到来自 Moloco Ads SDK 的测试广告,请在广告检查器中启用 single ad source testing(单个广告来源测试),并选择 Moloco (Bidding)(Moloco [出价])作为广告来源。
错误代码
如果适配器未能收到来自 Moloco 的广告,发布商可以检查
广告响应中归属于以下类的底层错误:
ResponseInfo
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
以下是当广告加载失败时,Moloco 适配器会抛出的代码和随附的消息:
Android
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco 应用密钥缺失或无效。 |
| 102 | com.google.ads.mediation.moloco | Moloco 广告单元 ID 缺失或无效。 |
| 103 | com.google.ads.mediation.moloco | 返回的 Moloco 广告对象为 null。 |
| -1 到 5000 | com.moloco.sdk | Moloco SDK 返回了错误。如需了解详情,请参阅 Moloco 的文档。 |
iOS
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Moloco SDK 不支持在 iOS 12 及更低版本上投放广告。 |
| 102 | com.google.ads.mediation.moloco | Moloco 应用密钥缺失或无效。 |
| 103 | com.google.ads.mediation.moloco | Moloco 广告单元 ID 缺失或无效。 |
| 104 | com.google.ads.mediation.moloco | 广告尚无法展示。 |
| 105 | com.google.ads.mediation.moloco | 广告未能展示。 |
| 106 | com.google.ads.mediation.moloco | 呈现数据不可用,无法呈现广告。 |
| -1 到 5000 | 由 Moloco SDK 发送 | Moloco SDK 返回了错误。如需了解详情,请参阅 Moloco 的文档。 |
激励广告服务器端验证
如果您
验证服务器端验证 (SSV) 回调,
则 Moloco 的广告来源标识符为 8267622065755668722。
Moloco Unity 中介插件变更日志
3.9.0 版(正在开发中)
3.8.1 版
- 支持 Moloco Android 适配器 4.10.1.0 版。
- 支持 Moloco iOS 适配器 4.8.1.0 版。
- 使用 Google 移动广告 Unity 插件 11.1.0 版构建和测试。
3.8.0 版
- 支持 Moloco Android 适配器 4.10.0.0 版。
- 支持 Moloco iOS 适配器 4.8.0.0 版。
- 使用 Google 移动广告 Unity 插件 11.1.0 版构建和测试。
3.7.0 版
- 支持 Moloco Android 适配器 4.9.0.0 版。
- 支持 Moloco iOS 适配器 4.6.1.1.1 版。
- 使用 Google 移动广告 Unity 插件 11.1.0 版构建和测试。
3.6.1 版
- 支持 Moloco Android 适配器 4.8.1.0 版。
- 支持 Moloco iOS 适配器 4.6.1.1 版。
- 使用 Google 移动广告 Unity 插件 11.1.0 版构建和测试。
3.6.0 版
- 支持 Moloco Android 适配器 4.8.0.0 版。
- 支持 Moloco iOS 适配器 4.6.0.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.5.1 版
- 支持 Moloco Android 适配器 4.7.0.0 版。
- 支持 Moloco iOS 适配器 4.5.1.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.5.0 版
- 支持 Moloco Android 适配器 4.7.0.0 版。
- 支持 Moloco iOS 适配器 4.5.0.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.4.1 版
- 支持 Moloco Android 适配器 4.6.0.0 版。
- 支持 Moloco iOS 适配器 4.4.1.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.4.0 版
- 支持 Moloco Android 适配器 4.6.0.0 版。
- 支持 Moloco iOS 适配器 4.4.0.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.3.1 版
- 支持 Moloco Android 适配器 4.5.0.0 版。
- 支持 Moloco iOS 适配器 4.3.0.2 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
3.3.0 版
- 支持 Moloco Android 适配器 4.5.0.0 版。
- 支持 Moloco iOS 适配器 4.3.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.7.0 版构建和测试。
3.2.0 版
- 支持 Moloco Android 适配器 4.4.0.0 版。
- 支持 Moloco iOS 适配器 4.2.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.7.0 版构建和测试。
3.1.0 版
- 支持 Moloco Android 适配器 4.4.0.0 版。
- 支持 Moloco iOS 适配器 4.1.2.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
3.0.0 版
- 支持 Moloco Android 适配器 4.3.1.0 版。
- 支持 Moloco iOS 适配器 4.1.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
2.2.1 版
- 支持 Moloco Android 适配器 4.2.1.0 版。
- 支持 Moloco iOS 适配器 3.13.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
2.2.0 版
- 支持 Moloco Android 适配器 4.2.0.0 版。
- 支持 Moloco iOS 适配器 3.13.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
2.1.0 版
- 支持 Moloco Android 适配器 4.1.0.0 版。
- 支持 Moloco iOS 适配器 3.13.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.5.0 版构建和测试。
2.0.0 版
- 支持 Moloco Android 适配器 4.0.0.0 版。
- 支持 Moloco iOS 适配器 3.13.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.4.2 版构建和测试。
1.6.1 版
- 支持 Moloco Android 适配器 3.12.1.0 版。
- 支持 Moloco iOS 适配器 3.12.1.0 版。
- 使用 Google 移动广告 Unity 插件 10.4.1 版构建和测试。
1.6.0 版
- 支持 Moloco Android 适配器 3.12.0.0 版。
- 支持 Moloco iOS 适配器 3.12.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.3.0 版构建和测试。
1.5.0 版
- 支持 Moloco Android 适配器 3.11.0.0 版。
- 支持 Moloco iOS 适配器 3.11.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.3.0 版构建和测试。
1.4.0 版
- 支持 Moloco Android 适配器 3.10.0.0 版。
- 支持 Moloco iOS 适配器 3.10.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.2.0 版构建和测试。
1.3.1 版
- 支持 Moloco Android 适配器 3.9.0.0 版。
- 支持 Moloco iOS 适配器 3.9.1.0 版。
- 使用 Google 移动广告 Unity 插件 10.1.0 版构建和测试。
1.3.0 版
- 支持 Moloco Android 适配器 3.9.0.0 版。
- 支持 Moloco iOS 适配器 3.9.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.1.0 版构建和测试。
1.2.1 版
- 支持 Moloco Android 适配器 3.8.0.1 版。
- 支持 Moloco iOS 适配器 3.8.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.0.0 版构建和测试。
1.2.0 版
- 支持 Moloco Android 适配器 3.8.0.0 版。
- 支持 Moloco iOS 适配器 3.8.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.0.0 版构建和测试。
1.1.0 版
- 支持 Moloco Android 适配器 3.7.2.0 版。
- 支持 Moloco iOS 适配器 3.7.2.0 版。
- 使用 Google 移动广告 Unity 插件 10.0.0 版构建和测试。
1.0.0 版
- 初始版本!
- 支持 Moloco Android 适配器 3.7.0.0 版。
- 支持 Moloco iOS 适配器 3.6.0.0 版。
- 使用 Google 移动广告 Unity 插件 9.6.0 版构建和测试。