本指南将向您介绍如何使用 Google 移动广告 SDK,利用中介从 myTarget 加载和展示广告(涵盖广告瀑布流集成)。它介绍了如何将 myTarget 添加到广告单元的中介配置,以及如何将 myTarget SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
已奖励 | |
插页式激励广告 |
要求
- Unity 4 或更高版本
- 最新版 Google 移动广告 SDK
- 在 Android 上部署
- Android API 级别 19 或更高级别
- 在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
- 一个配置了 Google 移动广告 SDK 且处于有效状态的 Unity 项目。如需了解详情,请参阅使用入门。
- 完成中介 入门指南
第 1 步:在 myTarget 界面中设置配置
首先,註冊或登入 myTarget 帳戶。按一下標頭上的「Application」(應用程式),前往「應用程式」頁面。按一下「新增應用程式」新增應用程式。
如果您的應用程式同時支援 Android 和 iOS 平台,就必須分別設定。
Android
接著,請提供應用程式的 Google Play 網址。
iOS
接著,請提供應用程式的 iTunes 網址**。
新增應用程式時,myTarget 必須先建立廣告單元,才能完成程序。
橫幅廣告
從可用的廣告格式中選取「橫幅廣告」BANNER,然後按一下「新增廣告單元」BANNER按鈕。
插頁式
從可用的廣告格式中選取「插頁式」,然後按一下「新增廣告單元」按鈕。
已獲得獎勵
從可用的廣告格式中選取「獎勵影片」,然後按一下「新增廣告單元」按鈕。
原生
從可用的廣告格式中選取「導覽」,然後按一下「新增廣告單元」。
在廣告單元詳細資料頁面中,記下廣告版位 ID (顯示在廣告單元設定下方),格式為 slot_id。下一節將使用這個版位 ID 設定 AdMob 廣告單元。
除了 slot_id 以外,您還需要 myTarget 永久存取權杖,才能設定 AdMob 廣告單元 ID。前往「Profile」分頁,然後選取「Access Tokens」。按一下「Create Token」或「Show Token」,即可查看 myTarget Permanent Access Token。
開啟測試模式
按照 myTarget 的說明文件操作,在 myTarget UI 中新增及設定測試裝置。
第 2 步:在界面中设置 myTarget 需求 AdMob
調整廣告單元中介服務設定
添加到 GDPR 和美国州级法规的广告合作伙伴列表中 Mail.ru
請按照 GDPR 設定 和 美國州級法規設定 ,在 AdMob UI 和美國州級法規廣告合作夥伴清單中新增 Mail.ru。
第 3 步:导入 myTarget SDK 和适配器
通过更新日志中的下载链接下载适用于 myTarget 的最新版 Google 移动广告中介插件,并从 ZIP 文件中提取 GoogleMobileAdsMyTargetMediation.unitypackage
。
在 Unity 项目编辑器中,依次选择 Assets > Import Package > Custom Package,然后找到您下载的 GoogleMobileAdsMyTargetMediation.unitypackage
文件。确保选择所有文件,然后点击 Import。
然后,依次选择 Assets > Play Services Resolver > Android Resolver > Force Resolve。Unity Play 服务解析器库将从头开始执行依赖项解析,并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android
目录中。
第 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 指南。
美国州级隐私保护法律
美国州级隐私保护法律 规定,必须让用户有权选择不“出售”其“个人信息”(该法律对这些术语进行了定义)。“出售”方须在首页醒目位置提供“请勿出售我的个人信息”链接,以供用户选择。美国州级隐私保护法律合规性指南让您可以为 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 | 在界面中配置的 AdMob Target 服务器参数缺失/无效。 |
102 | 请求的广告尺寸与 myTarget 支持的横幅广告尺寸不匹配。 |
103 | 广告请求不是统一原生广告请求。 |
104 | 从 myTarget 加载的原生广告与请求的原生广告不同。 |
105 | 从 myTarget 加载的原生广告缺少一些必需的素材资源(例如图片或图标)。 |
iOS
错误代码 | 原因 |
---|---|
100 | myTarget SDK 还没有广告。 |
101 | 在界面中配置的 AdMob Target 服务器参数缺失/无效。 |
102 | myTarget Adapter 不支持请求的广告格式。 |
103 | 尝试展示未加载的 myTarget 广告。 |
104 | 请求的广告尺寸与 myTarget 支持的横幅广告尺寸不匹配。 |
105 | 缺少必需的原生广告素材资源。 |
myTarget Unity 中介插件更新日志
版本 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
类添加了以下方法: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 版 Rewarded 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 版。