本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介功能从 myTarget 中展示的广告, 涵盖广告瀑布流集成其中介绍了如何将 myTarget 添加到广告单元的 中介配置,以及如何将 myTarget SDK 和适配器集成到 一个 Unity 应用。
支持的集成和广告格式
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
插页式激励广告 |
要求
- Unity 4 或更高版本
- 最新版 Google 移动广告 SDK
- 在 Android 上部署
<ph type="x-smartling-placeholder">
- </ph>
- Android API 级别 21 或更高级别
- 在 iOS 上部署
<ph type="x-smartling-placeholder">
- </ph>
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 移动广告 SDK 配置的有效 Unity 项目。请参阅 如需了解详情,请开始使用。
- 完成中介流程 入门指南
第 1 步:在 myTarget 界面中设置配置
首先,注册或登录您的 myTarget 帐号。点击标题上的应用以转到“应用”页面。点击添加应用以添加应用。
如果您的应用同时支持 Android 和 iOS 平台,您需要单独设置其中每个平台。
Android
接下来,提供您应用的 Google Play 网址。
iOS
接下来,提供应用的 iTunes 网址**。
添加应用时,myTarget 会要求您先创建一个广告单元,然后才能完成此流程。
横幅
从可用的广告格式中选择BANNER,然后点击BANNER按钮。
插页式广告
从可用的广告格式中选择插页式广告,然后点击添加广告单元按钮。
已奖励
从可用的广告格式中选择激励视频,然后点击添加广告单元按钮。
原生
从可用的广告格式中选择原生,然后点击添加广告单元。
在广告单元的详情页面中,记下您的广告位 ID(您可以在广告单元设置下找到 slot_id)。在下一部分中,此广告位 ID 将用于设置您的 AdMob 广告单元。
除了 slot_id 之外,您还需要使用 myTarget 永久访问令牌来设置 AdMob 广告单元 ID。前往 Profile 标签页,然后选择 Access Tokens。点击创建令牌或显示令牌以查看 myTarget 永久访问令牌。
开启测试模式
按照 myTarget 文档中的说明在 myTarget 界面中添加和配置测试设备。
第 2 步:在界面中设置 myTarget 需求 AdMob
为广告单元配置中介设置
将 Mail.ru 添加到 GDPR 和美国州级法规广告合作伙伴列表
按照 GDPR 设置 和 美国州级法规设置 中的步骤,将 Mail.ru 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步:导入 myTarget SDK 和适配器
下载适用于 myTarget 的最新版 Google 移动广告中介插件
下载链接
更新日志,并从
zip 文件中的 GoogleMobileAdsMyTargetMediation.unitypackage
。
在 Unity 项目编辑器中,选择 Assets >导入软件包 >自定义
Package 中的描述,并找到您准备的 GoogleMobileAdsMyTargetMediation.unitypackage
文件
已下载。确保选择所有文件,然后点击 Import(导入)。
然后,选择素材资源 >Play 服务解析器 >Android 解析器 >强制
解决。Unity Play Services Resolver 库将执行依赖项处理,
并将声明的依赖项复制到
Assets/Plugins/Android
目录中。
第 4 步:在 myTarget SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 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 步:测试实现效果
启用测试广告
请务必为AdMob 注册您的测试设备,并在 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 服务器参数缺失/无效。 AdMob |
102 | 请求的广告尺寸与 myTarget 支持的横幅尺寸不匹配。 |
103 | 广告请求不是统一原生广告请求。 |
104 | 通过 myTarget 加载的原生广告与请求的原生广告不同。 |
105 | 从 myTarget 加载的原生广告缺少一些必需的素材资源(例如图片或图标)。 |
iOS
错误代码 | 原因 |
---|---|
100 | myTarget SDK 尚无可用广告。 |
101 | 界面中配置的 myTarget 服务器参数缺失/无效。 AdMob |
102 | myTarget Adapter 不支持所请求的广告格式。 |
103 | 尝试展示未加载的 myTarget 广告。 |
104 | 请求的广告尺寸与 myTarget 支持的横幅尺寸不匹配。 |
105 | 缺少必需的原生广告素材资源。 |
myTarget Unity 中介插件更新日志
版本 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
- 将
IsConsent()
方法从MyTarget
类重命名为了GetUserConsent()
。 - 向
MyTarget
类添加了以下方法: <ph type="x-smartling-placeholder">- </ph>
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 版。