本指南介绍了如何使用 Google 移动广告 SDK 使用中介加载和展示 Mintegral 中的广告,涵盖广告瀑布流和出价集成。其中介绍了如何将 Mintegral 添加到广告单元的中介配置,以及如何将 Mintegral SDK 和适配器集成到应用中。 Unity
支持的集成和广告格式
AdMob 适用于 Mintegral 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
打开应用 | 1 |
横幅 | |
插页式广告 | |
激励广告 | |
插页式激励广告 |
1 适用于开屏广告格式的出价和广告瀑布流集成目前处于封闭式 Beta 版测试阶段。
要求
- 最新版 Google 移动广告 SDK
第 1 步:在 Mintegral 界面中设置配置
找到应用密钥
前往应用设置标签页,并记下应用密钥。
添加新应用
在应用设置标签页中,点击添加应用按钮。
选择平台,然后填写表单的其余部分。然后,点击保存。
Android
iOS
记下应用的 APP ID。
Android
iOS
创建广告展示位置
创建应用后,前往展示位置和广告单元标签页,然后点击添加展示位置按钮(如下所示),以创建广告展示位置。
Android
iOS
输入展示位置名称和广告格式。
出价
选择标头出价作为出价类型。填写表单的其余部分,然后点击保存。
瀑布
选择传统作为出价类型。填写表单的其余部分,然后点击保存。
创建广告展示位置后,请记下展示位置 ID。
Android
iOS
点击 1 AD units(1 个广告单元)下拉菜单,并记下 AD Unit ID(广告单元 ID)。
Android
iOS
找到您的 Mintegral Reporting API 密钥
出价
出价集成不需要执行此步骤。
瀑布
您需要 Mintegral Reporting API 密钥才能设置 AdMob 广告单元 ID。依次转到 Account(账号)> API Tools(API 工具)。记下您的 Skey 和 Secret。
第 2 步:在 AdMob 界面中设置 Mintegral 需求来源
为广告单元配置中介设置
将 Mintegral 添加到 GDPR 和美国州级法规广告合作伙伴名单
请按照 GDPR 设置和 美国州级法规设置中的步骤,将 Mobvista/Mintegral 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴名单中。
第 3 步:导入 Mintegral SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI,则可以从项目的根目录运行以下命令,将适用于 Unity 的 Google 移动广告 Mintegral 中介插件安装到您的项目中:
openupm add com.google.ads.mobile.mediation.mintegral
OpenUPM
在 Unity 项目编辑器中,依次选择 Edit(修改)> Project Settings(项目设置)> Package Manager(软件包管理器),打开 Unity Package Manager Settings(Unity Package Manager 设置)。
在受限注册库标签页下,将 OpenUPM 添加为受限注册库,并提供以下详细信息:
- 名称:
OpenUPM
- URL:
https://package.openupm.com
- 范围:
com.google
然后,依次前往 Window > Package Manager 以打开 Unity Package Manager,然后从下拉菜单中选择 My Registries。
选择 Google 移动广告 Mintegral Mediation 软件包,然后点击 Install。
Unity 软件包
从更新日志中的下载链接下载适用于 Mintegral 的最新版 Google 移动广告中介插件,然后从 ZIP 文件中解压 GoogleMobileAdsMintegralMediation.unitypackage
。
在 Unity 项目编辑器中,依次选择 Assets(资源)> Import Package(导入资源包)> Custom Package(自定义资源包),然后找到您下载的 GoogleMobileAdsMintegralMediation.unitypackage
文件。确保选择所有文件,然后点击 Import。
然后,依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析,并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android
目录中。
第 4 步:添加所需的代码
Android
无需额外代码即可集成 Mintegral。
iOS
SKAdNetwork 集成
按照 Mintegral 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试您的实现
错误代码
如果适配器未能从 Mintegral 收到广告,发布商可以使用以下类下的 ResponseInfo
检查广告响应的根本错误:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
以下是 Mintegral 适配器在广告加载失败时抛出的代码和随附消息:
Android
错误代码 | 网域 | 原因 |
---|---|---|
101 | com.google.ads.mediation.mintegral | 服务器参数无效(例如缺少应用 ID 或展示位置 ID)。 |
102 | com.google.ads.mediation.mintegral | 请求的广告尺寸与 Mintegral 支持的横幅广告尺寸不符。 |
103 | com.google.ads.mediation.mintegral | 出价响应缺失或无效。 |
104 | com.google.ads.mediation.mintegral | Mintegral SDK 返回了未填充错误。 |
iOS
错误代码 | 网域 | 原因 |
---|---|---|
101 | com.google.mediation.mintegral | 服务器参数无效(例如,缺少应用 ID 或展示位置 ID)。 |
102 | com.google.mediation.mintegral | Mintegral SDK 返回了未填充错误。 |
103 | com.google.mediation.mintegral | Mintegral SDK 未能展示广告。 |
104 | com.google.mediation.mintegral | 请求的广告尺寸与 Mintegral 支持的横幅广告尺寸不符。 |
Mintegral Unity 中介插件更新日志
版本 1.8.2
- 支持 Mintegral Android 适配器版本 16.8.61.0。
- 支持 Mintegral iOS 适配器版本 7.7.2.1。
- 使用 Google 移动广告 Unity 插件 9.2.1 版构建和测试。
版本 1.8.1
- 支持 Mintegral Android 适配器版本 16.8.51.0。
- 支持 Mintegral iOS 适配器版本 7.7.2.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 1.8.0
- 支持 Mintegral Android 适配器版本 16.8.31.0。
- 支持 Mintegral iOS 适配器版本 7.7.0.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 1.7.0
- 将
DummyClient
重命名为了PlaceholderClient
。 - 支持 Mintegral Android 适配器版本 16.8.11.0。
- 支持 Mintegral iOS 适配器版本 7.6.9.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 1.6.5
- 支持 Mintegral Android 适配器版本 16.7.81.0。
- 支持 Mintegral iOS 适配器版本 7.6.8.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 1.6.4
- 支持 Mintegral Android 适配器版本 16.7.61.0。
- 支持 Mintegral iOS 适配器版本 7.6.7.0。
- 使用 Google 移动广告 Unity 插件 9.1.0 版构建和测试。
版本 1.6.3
- 支持 Mintegral Android 适配器版本 16.7.41.0。
- 支持 Mintegral iOS 适配器版本 7.6.6.0。
- 使用 Google 移动广告 Unity 插件 9.1.0 版构建和测试。
版本 1.6.2
- 支持 Mintegral Android 适配器版本 16.7.41.0。
- 支持 Mintegral iOS 适配器版本 7.6.4.0。
- 使用 Google 移动广告 Unity 插件 9.1.0 版构建和测试。
版本 1.6.1
- 支持 Mintegral Android 适配器版本 16.7.21.0。
- 支持 Mintegral iOS 适配器版本 7.6.3.0。
- 使用 Google 移动广告 Unity 插件 9.1.0 版构建和测试。
版本 1.6.0
- 支持 Mintegral Android 适配器版本 16.7.11.0。
- 支持 Mintegral iOS 适配器版本 7.6.2.0。
- 使用 Google 移动广告 Unity 插件 9.0.0 版构建和测试。
版本 1.5.0
- 支持 Mintegral Android 适配器版本 16.6.71.0。
- 支持 Mintegral iOS 适配器版本 7.6.0.0。
- 使用 Google 移动广告 Unity 插件 9.0.0 版构建和测试。
版本 1.4.0
- 支持 Mintegral Android 适配器版本 16.6.34.0。
- 支持 Mintegral iOS 适配器版本 7.5.6.0。
- 使用 Google 移动广告 Unity 插件 8.7.0 版进行构建和测试。
版本 1.3.0
- 支持 Mintegral Android 适配器版本 16.5.91.0。
- 支持 Mintegral iOS 适配器版本 7.5.3.0。
- 向
Mintegral
类添加了以下方法:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- 使用 Google 移动广告 Unity 插件 8.6.0 版构建和测试。
版本 1.2.1
- 支持 Mintegral Android 适配器版本 16.4.61.0。
- 支持 Mintegral iOS 适配器版本 7.3.8.0。
- 使用 Google 移动广告 Unity 插件 8.3.0 版构建和测试。
版本 1.2.0
- 将适配器内容移至
GoogleMobileAds/Mediation/Mintegral/
。 - 支持 Mintegral Android 适配器版本 16.4.41.0。
- 支持 Mintegral iOS 适配器版本 7.3.6.0。
- 使用 Google 移动广告 Unity 插件 8.3.0 版构建和测试。
版本 1.1.0
- 支持 Mintegral Android 适配器版本 16.3.61.0。
- 支持 Mintegral iOS 适配器版本 7.2.9.1。
- 使用 Google 移动广告 Unity 插件 7.4.1 版构建和测试。
版本 1.0.0
- 初始版本!
- 支持 Mintegral Android 适配器版本 16.2.61.0。
- 支持 Mintegral iOS 适配器版本 7.2.6.0。
- 使用 Google 移动广告 Unity 插件 7.3.1 版构建和测试。