本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介功能从 myTarget 中展示的广告, 涵盖广告瀑布流集成其中介绍了如何将 myTarget 添加到广告单元的中介配置,以及如何将 myTarget SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
插页式激励广告 |
要求
- Unity 4 或更高版本
- 最新版 Google 移动广告 SDK
- 如需在 Android 上部署,请执行以下操作:
- Android API 级别 21 或更高级别
- 要在 iOS 上部署,需具备以下条件:
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 移动广告 SDK 配置的有效 Unity 项目。请参阅 如需了解详情,请开始使用。
- 完成中介入门指南
第 1 步:在 myTarget 界面中设置配置
首先,注册或登录 myTarget 账号。点击应用页面上的应用,以转到“应用”页面 标头。点击添加应用以添加您的应用。
如果您的应用同时支持 Android 和 iOS 平台,则需要分别为这两种平台设置。
Android
接下来,提供应用的 Google Play 网址。
iOS
接下来,提供应用的 iTunes 网址**。
添加应用时,myTarget 要求您先创建广告单元,然后才能完成该流程。
横幅
从可用的广告格式中选择BANNER,然后点击 添加广告单元按钮。
插页式广告
从可用的广告格式中选择插页式广告,然后点击添加广告单元按钮。
激励广告
从可用的广告格式中选择激励视频广告,然后点击添加广告单元按钮。
原生
从可用的广告格式中选择原生广告,然后点击添加广告单元。
在广告单元的详情页面中,记下您的广告位 ID,您可以在 作为 slot_id。此广告位 ID 将用于设置 设置 AdMob 广告单元。
除了 slot_id 之外,您还需要 myTarget 永久性访问令牌才能设置 AdMob 广告单元 ID。前往个人资料标签页 然后选择访问令牌。点击创建令牌或显示令牌,查看您的 myTarget 永久访问令牌。
开启测试模式
请按照 myTarget 的文档 在 myTarget 界面中添加和配置测试设备
第 2 步:在界面中设置 myTarget 需求 Ad Manager
为广告单元配置中介设置
将 Mail.ru 添加到 GDPR 和美国州级法规广告合作伙伴列表
第 3 步:导入 myTarget SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI,则可以从项目的根目录运行以下命令,将 Google 移动广告 myTarget 中介插件(适用于 Unity)安装到您的项目中:
openupm add com.google.ads.mobile.mediation.mytarget
OpenUPM
在 Unity 项目编辑器中,依次选择 Edit(修改)> Project Settings(项目设置)> Package Manager(软件包管理器),打开 Unity Package Manager Settings(Unity Package Manager 设置)。
在受限注册库标签页下,将 OpenUPM 添加为受限注册库,并提供以下详细信息:
- 名称:
OpenUPM
- URL:
https://package.openupm.com
- 范围:
com.google
然后,依次转到窗口 >Package Manager 打开 Unity Package Manager 和 从下拉菜单中选择 My Registries。
选择 Google 移动广告 myTarget 中介软件包,然后点击 Install。
Unity 软件包
从更新日志中的下载链接下载适用于 myTarget 的最新版 Google 移动广告中介插件,然后从 ZIP 文件中提取 GoogleMobileAdsMyTargetMediation.unitypackage
。
在 Unity 项目编辑器中,依次选择 Assets(资源)> Import Package(导入资源包)> Custom Package(自定义资源包),然后找到您下载的 GoogleMobileAdsMyTargetMediation.unitypackage
文件。确保已选择所有文件,然后点击导入。
然后,依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器
库将从头开始执行依赖项解析,并将
声明的依赖项的 Assets/Plugins/Android
目录
Unity 应用。
第 4 步:在 myTarget SDK 中实现隐私设置
欧盟地区意见征求和 GDPR
根据 Google 《欧盟地区用户意见征求政策》,您必须确保向位于欧洲经济区 (EEA) 的用户披露相关信息并征得他们的同意,以便使用设备标识符和个人数据。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法自动将用户的意见征求选择传递给此类广告联盟。
适用于 myTarget 版本 2.1.0 的 Google 移动广告中介插件包含
SetUserConsent()
和 SetUserAgeRestricted()
方法。以下示例代码展示了如何将用户意见征求信息传递给 myTarget SDK。如果您选择调用此方法,建议您先调用此方法,然后再通过 Google 移动广告 SDK 请求广告。
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
如果已知用户处于有年龄限制的类别中,您也可以调用
SetUserAgeRestricted()
方法结合使用。
MyTarget.SetUserAgeRestricted(true);
查看 myTarget 的 隐私权和 GDPR 指南 。
美国州级隐私保护法律
美国州级隐私保护法律 要求向用户提供 来退出“促销”的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal”(不出售我的个人数据) 信息”请点击“销售”链接主页。美国州级隐私保护法合规指南提供了为 Google 广告投放启用受限的数据处理的功能,但 Google 无法将此设置应用于中介链中的每个广告网络。因此,您必须识别中介链中可能参与销售个人信息的每个广告网络,并遵循每个广告网络的指南,以确保合规。
适用于 myTarget 版本 3.13.3 的 Google 移动广告中介插件包含
SetCCPAUserConsent(bool)
方法结合使用。以下示例代码展示了如何将用户意见征求信息传递给 myTarget SDK。如果您选择调用此方法,建议您先调用此方法,然后再通过 Google 移动广告 SDK 请求广告。
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
如需了解更多详情,请与 myTarget 支持团队联系。 。
第 5 步:添加所需的代码
Android
无需额外的代码即可集成 myTarget。
iOS
SKAdNetwork 集成
按照 myTarget 的文档中的说明操作
将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 6 步:测试实现效果
启用测试广告
请务必为Ad Manager 注册您的测试设备,并在 myTarget 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自myTarget的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 myTarget (Waterfall)
错误代码
如果适配器未能从 myTarget 收到广告,发布商可以使用以下类下的 ResponseInfo
检查广告响应的根本错误:
Android
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
iOS
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
以下是 myTarget 适配器在广告加载失败时抛出的代码和随附消息:
Android
错误代码 | 原因 |
---|---|
100 | myTarget SDK 返回了错误。 |
101 | 界面中配置的 myTarget 服务器参数缺失/无效。 Ad Manager |
102 | 请求的广告尺寸与 myTarget 支持的横幅广告尺寸不符。 |
103 | 广告请求不是统一原生广告请求。 |
104 | 从 myTarget 加载的原生广告与请求的原生广告不同。 |
105 | 从 myTarget 加载的原生广告缺少一些必需的素材资源(例如图片或图标)。 |
iOS
错误代码 | 原因 |
---|---|
100 | myTarget SDK 尚无广告可用。 |
101 | 界面中配置的 myTarget 服务器参数缺失/无效。 Ad Manager |
102 | myTarget Adapter 不支持所请求的广告格式。 |
103 | 尝试显示未加载的 myTarget 广告。 |
104 | 请求的广告尺寸与 myTarget 支持的横幅尺寸不匹配。 |
105 | 缺少必需的原生广告素材资源。 |
myTarget Unity 中介插件更新日志
版本 3.18.1
- 支持 myTarget Android 适配器版本 5.22.1.0。
- 支持 myTarget iOS 适配器版本 5.21.8.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 3.18.0
- 将
DummyClient
重命名为了PlaceholderClient
。 - 支持 myTarget Android 适配器版本 5.22.1.0。
- 支持 myTarget iOS 适配器版本 5.21.6.0。
- 使用 Google 移动广告 Unity 插件 9.2.0 版构建和测试。
版本 3.17.1
- 支持 myTarget Android 适配器版本 5.21.1.0。
- 支持 myTarget iOS 适配器版本 5.21.5.0。
- 利用 Google 移动广告 Unity 插件 9.2.0 版进行制作和测试。
版本 3.17.0
- 支持 myTarget Android 适配器版本 5.21.0.0。
- 支持 myTarget iOS 适配器版本 5.21.4.0。
- 使用 Google 移动广告 Unity 插件 9.1.0 版构建和测试。
版本 3.16.2
- 支持 myTarget Android 适配器版本 5.20.1.0。
- 支持 myTarget iOS 适配器版本 5.21.2.0。
- 利用 Google 移动广告 Unity 插件 9.1.0 版进行制作和测试。
版本 3.16.1
- 支持 myTarget Android 适配器版本 5.20.1.0。
- 支持 myTarget iOS 适配器版本 5.21.1.0。
- 使用 Google 移动广告 Unity 插件 9.0.0 版构建和测试。
版本 3.16.0
- 支持 myTarget Android 适配器版本 5.20.0.0。
- 支持 myTarget iOS 适配器版本 5.21.0.1。
- 使用 Google 移动广告 Unity 插件 9.0.0 版构建和测试。
版本 3.15.0
- 支持 myTarget Android 适配器版本 5.20.0.0。
- 支持 myTarget iOS 适配器版本 5.20.1.0。
- 使用 Google 移动广告 Unity 插件 8.7.0 版进行构建和测试。
版本 3.14.0
- 支持 myTarget Android 适配器版本 5.18.0.0。
- 支持 myTarget iOS 适配器版本 5.19.0.0。
- 利用 Google 移动广告 Unity 插件 8.5.0 版进行制作和测试。
版本 3.13.2
- 支持 myTarget Android 适配器版本 5.16.5.0。
- 支持 myTarget iOS 适配器版本 5.17.5.0。
- 使用 Google 移动广告 Unity 插件 8.3.0 版构建和测试。
版本 3.13.1
- 将适配器内容移至
GoogleMobileAds/Mediation/MyTarget/
。 - 重构了适配器命名空间,以使用
GoogleMobileAds.Mediation.MyTarget
。 - 支持 myTarget Android 适配器版本 5.16.4.1。
- 支持 myTarget iOS 适配器版本 5.17.4.0。
- 利用 Google 移动广告 Unity 插件 8.1.0 版进行制作和测试。
版本 3.13.0
- 支持 myTarget Android 适配器版本 5.16.4.0。
- 支持 myTarget iOS 适配器版本 5.17.4.0。
- 利用 Google 移动广告 Unity 插件 8.0.0 版进行制作和测试。
版本 3.12.0
- 支持 myTarget Android 适配器版本 5.15.5.0。
- 支持 myTarget iOS 适配器版本 5.16.0.0。
- 使用 Google 移动广告 Unity 插件 7.3.0 版进行构建和测试。
版本 3.11.4
- 支持 myTarget Android 适配器版本 5.15.4.0。
- 支持 myTarget iOS 适配器版本 5.15.2.0。
- 使用 Google 移动广告 Unity 插件 7.2.0 版进行构建和测试。
版本 3.11.3
- 将
MyTarget
类中的IsConsent()
方法重命名为GetUserConsent()
。 - 向
MyTarget
类添加了以下方法:SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- 支持 myTarget Android 适配器版本 5.15.3.0。
- 支持 myTarget iOS 适配器版本 5.15.2.0。
- 使用 Google 移动广告 Unity 插件 7.2.0 版进行构建和测试。
版本 3.11.2
- 支持 myTarget Android 适配器版本 5.15.2.1。
- 支持 myTarget iOS 适配器版本 5.15.2.0。
- 使用 Google 移动广告 Unity 插件 7.0.2 版构建和测试。
版本 3.11.1
- 支持 myTarget Android 适配器版本 5.15.1.0。
- 支持 myTarget iOS 适配器版本 5.15.1.0。
- 使用 Google 移动广告 Unity 插件 7.0.0 版构建和测试。
版本 3.11.0
- 支持 myTarget Android 适配器版本 5.15.0.0。
- 支持 myTarget iOS 适配器版本 5.15.0.1。
- 使用 Google 移动广告 Unity 插件 7.0.0 版构建和测试。
版本 3.10.2
版本 3.10.1
版本 3.10.0
版本 3.9.0
版本 3.8.2
版本 3.8.1
版本 3.8.0
版本 3.7.0
版本 3.6.1
- 将
MyTarget.IsUserConsent()
方法重命名为了MyTarget.IsConsent()
。 - 支持 myTarget Android 适配器版本 5.9.1.0。
- 支持 myTarget iOS 适配器版本 5.7.2.0。
版本 3.6.0
版本 3.5.2
版本 3.5.1
版本 3.5.0
版本 3.4.0
版本 3.3.0
版本 3.2.0
版本 3.1.0
版本 3.0.0
- 更新了该插件,以支持新的开放式 Beta 版激励广告 API。
- 支持 myTarget Android 适配器版本 5.3.9.0。
- 支持 myTarget iOS 适配器版本 5.0.4.0。
版本 2.3.2
- 支持 myTarget Android 适配器版本 5.2.5.0。
- 支持 myTarget iOS 适配器版本 4.8.9.0。
版本 2.3.1
- 支持 myTarget Android 适配器版本 5.2.5.0。
- 支持 myTarget iOS 适配器版本 4.8.5.0。
版本 2.3.0
- 支持 myTarget Android 适配器版本 5.2.2.0。
- 支持 myTarget iOS 适配器版本 4.8.0.0。
版本 2.2.0
- 支持 myTarget Android 适配器版本 5.1.4.0。
- 支持 myTarget iOS 适配器版本 4.8.0.0。
版本 2.1.2
- 支持 myTarget Android 适配器版本 5.1.3.0。
- 支持 myTarget iOS 适配器版本 4.7.11.0。
版本 2.1.1
- 支持 myTarget Android 适配器版本 5.1.1.0。
- 支持 myTarget iOS 适配器版本 4.7.10.0。
版本 2.1.0
- 支持 myTarget Android SDK 版本 5.1.0。
- 支持 myTarget iOS SDK 版本 4.7.9。
- 添加了以下方法:
MyTarget.SetUserConsent()
方法,用于将用户的同意情况转发给 MyTarget SDK。MyTarget.SetUserAgeRestricted
方法,用于设置一个标志,以指明用户是否属于受年龄限制的类别(即未满 16 周岁)。MyTarget.IsUserConsent()
方法,用于获取用户当前的同意情况。MyTarget.IsUserAgeRestricted()
方法来获取标志,该标志表示用户已知属于受年龄限制的类别(即未满 16 周岁)。
版本 2.0.1
- 支持 myTarget Android SDK 版本 5.0.2。
- 支持 myTarget iOS SDK 版本 4.7.8。
版本 2.0.0
- 支持 myTarget Android SDK 5.0.0 版。
- 支持 myTarget iOS SDK 4.7.7 版。
版本 1.1.0
- 支持 myTarget Android SDK 4.7.2 版。
- 支持 myTarget iOS SDK 版本 4.7.6。
版本 1.0.0
- 第一个版本!
- 支持 myTarget Android SDK 版本 4.6.27。
- 支持 myTarget iOS SDK 版本 4.6.24。