本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 myTarget 广告来自使用 中介、 包括广告瀑布流集成其中介绍了如何将 myTarget 添加到广告单元的 中介配置,以及如何将 myTarget SDK 和适配器集成到 一款 Android 应用。
支持的集成和广告格式
myTarget 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- Android API 级别 21 或更高级别
最新版 Google 移动广告 SDK
完成中介流程 入门指南
第 1 步:在 myTarget 界面中设置配置
第 2 步:在界面中设置 myTarget 需求 Ad Manager
将 Mail.ru 添加到 GDPR 和美国州级法规广告合作伙伴列表
第 3 步:导入 myTarget SDK 和适配器
Android Studio 集成(推荐)
在应用级 build.gradle.kts
文件中,添加以下实现
依赖项和配置使用最新版本的 myTarget SDK
和适配器:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mytarget:5.22.1.0")
}
手动集成
要添加 myTarget SDK,请查阅 myTarget Android SDK 文档。
转到 myTarget 适配器 制品 。选择最新版本,下载 myTarget 适配器的 .aar 文件,并将其添加到您的项目。
第 4 步:在 myTarget SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 设备标识符和个人数据的使用。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
在 SDK 版本中 5.1.0, myTarget 添加了一个 User Consent API 来满足隐私权要求。通过 以下示例代码展示了如何将此意见征求信息传递给 myTarget SDK。如果您选择调用此方法,建议 以及通过 Google 移动广告 SDK 请求广告。
Java
import com.my.target.common.MyTargetPrivacy;
// ...
MyTargetPrivacy.setUserConsent(true);
Kotlin
import com.my.target.common.MyTargetPrivacy
// ...
MyTargetPrivacy.setUserConsent(true)
此外,如果已知的用户属于有年龄限制的类别,您可以 请使用以下代码将此用户意见征求信息传递给 myTarget SDK。
Java
import com.my.target.common.MyTargetPrivacy;
// ...
MyTargetPrivacy.setUserAgeRestricted(true);
Kotlin
import com.my.target.common.MyTargetPrivacy
// ...
MyTargetPrivacy.setUserAgeRestricted(true)
查看 myTarget 的 隐私权和 GDPR 指南 。
美国州级隐私保护法律
美国州级隐私保护法律 要求向用户提供 来退出“促销”的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法对每个广告应用此设置 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
在 SDK 版本中 5.9.0, myTarget 添加了一个 User Consent API 来满足隐私权要求。通过 以下示例代码展示了如何将此意见征求信息传递给 myTarget SDK。如果您选择调用此方法,建议 以及通过 Google 移动广告 SDK 请求广告。
Java
import com.my.target.common.MyTargetPrivacy;
// ...
MyTargetPrivacy.setCcpaUserConsent(true);
Kotlin
import com.my.target.common.MyTargetPrivacy
// ...
MyTargetPrivacy.setCcpaUserConsent(true)
如需了解更多详情,请与 myTarget 支持团队联系。 以及可在方法中提供的值。
第 5 步:添加所需的代码
myTarget 集成无需额外代码。
第 6 步:测试实现效果
启用测试广告
请务必为Ad Manager 注册您的测试设备,并在 myTarget 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自myTarget的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 myTarget (Waterfall)
可选步骤
使用原生广告
广告呈现
myTarget 适配器将其原生广告作为
NativeAd
对象的操作。它会填充以下内容
字段
针对
NativeAd
。
字段 | 由 myTarget 适配器填充 |
---|---|
标题 | 始终 |
映像 | 始终 |
正文 | 始终 |
应用图标 | 始终 |
号召性用语 | 始终 |
星级 | 不保证 |
商店 | 不保证 |
价格 | 不保证 |
徽标 | 不保证 |
广告客户 | 始终 |
myTarget SDK 始终针对 mediaView
的宽度和高度返回 0
,因此
对于以下情况,myTarget 适配器始终返回 0
:
getAspectRatio()
。
myTarget SDK 将在未来的版本中修复这一问题。
展示跟踪和点击跟踪
Google 移动广告 SDK 将 myTarget SDK 的回调函数用于展示和 因此,这两个来源的报告应该与 以确保没有任何差异。
错误代码
如果适配器无法从 myTarget 接收广告,您可以检查
使用
ResponseInfo.getAdapterResponses()
分为以下类:
com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
以下是 myTarget 适配器抛出的代码及其附带消息 当广告加载失败时:
错误代码 | 原因 |
---|---|
100 | myTarget SDK 返回了错误。 |
101 | 界面中配置的 myTarget 服务器参数缺失/无效。 Ad Manager |
102 | 请求的广告尺寸与 myTarget 支持的横幅尺寸不匹配。 |
103 | 广告请求不是统一原生广告请求。 |
104 | 通过 myTarget 加载的原生广告与请求的原生广告不同。 |
105 | 从 myTarget 加载的原生广告缺少一些必需的素材资源(例如图片或图标)。 |
myTarget Android 中介适配器更新日志
版本 5.22.1.0
- 将 Gradle JVM 的最大堆大小从 512MB 增加到了 1GB。
- 已验证与 myTarget SDK 5.22.1 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 23.2.0 版。
- MyTarget SDK 5.22.1 版。
版本 5.21.1.0
- 已验证与 myTarget SDK 5.21.1 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 23.2.0 版。
- MyTarget SDK 5.21.1 版。
版本 5.21.0.0
- 已验证与 myTarget SDK 5.21.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 版本 23.0.0。
- MyTarget SDK 5.21.0 版。
版本 5.20.1.0
- 将所需的最低 Google 移动广告 SDK 版本更新为 23.0.0。
- 已验证与 myTarget SDK 5.20.1 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 版本 23.0.0。
- MyTarget SDK 5.20.1 版。
版本 5.20.0.0
- 已验证与 myTarget SDK 5.20.0 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 22.5.0 版。
- MyTarget SDK 5.20.0 版。
版本 5.19.0.0
- 已验证与 myTarget SDK 5.19.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.3.0 版。
- MyTarget SDK 5.19.0 版。
版本 5.18.0.0
- 已验证与 myTarget SDK 5.18.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.2.0 版。
- MyTarget SDK 5.18.0 版。
版本 5.17.0.0
- 已验证与 myTarget SDK 5.17.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.2.0 版。
- MyTarget SDK 5.17.0 版。
版本 5.16.5.0
- 已验证与 myTarget SDK 5.16.5 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 22.0.0 版。
- MyTarget SDK 5.16.5 版。
版本 5.16.4.1
- 更新了适配器,以使用新的
VersionInfo
类。 - 将所需的最低 Google 移动广告 SDK 版本更新为 22.0.0。
构建和测试时所用平台:
- Google 移动广告 SDK 22.0.0 版。
- MyTarget SDK 5.16.4 版。
版本 5.16.4.0
- 已验证与 myTarget SDK 5.16.4 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 21.5.0。
构建和测试时所用平台:
- Google 移动广告 SDK 21.5.0 版。
- MyTarget SDK 5.16.4 版。
版本 5.16.3.0
- 已验证与 myTarget SDK 5.16.3 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 21.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 21.4.0 版。
- MyTarget SDK 5.16.3 版。
版本 5.16.2.0
- 已验证与 myTarget SDK 5.16.2 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 21.3.0 版。
- MyTarget SDK 5.16.2 版。
版本 5.16.1.0
- 已验证与 myTarget SDK 5.16.1 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 21.3.0 版。
- MyTarget SDK 5.16.1 版。
版本 5.16.0.0
- 已验证与 myTarget SDK 5.16.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 21.3.0 版。
- MyTarget SDK 5.16.0 版。
版本 5.15.5.0
- 已验证与 myTarget SDK 5.15.5 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 21.3.0。
构建和测试时所用平台:
- Google 移动广告 SDK 21.3.0 版。
- MyTarget SDK 5.15.5 版。
版本 5.15.4.0
- 已验证与 myTarget SDK 5.15.4 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 21.1.0。
构建和测试时所用平台:
- Google 移动广告 SDK 21.1.0 版。
- MyTarget SDK 5.15.4 版。
版本 5.15.3.0
- 已验证与 myTarget SDK 5.15.3 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 21.0.0 版。
- MyTarget SDK 5.15.3 版。
版本 5.15.2.1
- 将所需的最低 Google 移动广告 SDK 版本更新为 21.0.0。
- 将所需的最低 Android API 级别更新为 19。
构建和测试时所用平台:
- Google 移动广告 SDK 21.0.0 版。
- MyTarget SDK 5.15.2 版。
版本 5.15.2.0
- 已验证与 myTarget SDK 5.15.2 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.6.0 版。
- MyTarget SDK 5.15.2 版。
版本 5.15.1.0
- 已验证与 myTarget SDK 5.15.1 版兼容。
- 将
compileSdkVersion
和targetSdkVersion
更新到了 API 31。 - 将所需的最低 Google 移动广告 SDK 版本更新为 20.6.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.6.0 版。
- MyTarget SDK 5.15.1 版。
版本 5.15.0.0
- 已验证与 myTarget SDK 5.15.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.5.0 版。
- MyTarget SDK 5.15.0 版。
版本 5.14.4.0
- 已验证与 myTarget SDK 5.14.4 版本的兼容性。
- 为
CustomParams
添加了中介额外信息 (extras) 处理。 - 修复了原生广告
MediaView
未正确注册为可点击素材资源的问题。 - 将所需的最低 Google 移动广告 SDK 版本更新为 20.5.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.5.0 版。
- MyTarget SDK 5.14.4 版。
版本 5.14.3.0
- 已验证与 myTarget SDK 5.14.3 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.4.0 版。
- MyTarget SDK 5.14.3 版。
版本 5.14.2.0
- 已验证与 myTarget SDK 5.14.2 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.4.0 版。
- MyTarget SDK 5.14.2 版。
版本 5.14.1.0
- 已验证与 myTarget SDK 5.14.1 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.4.0 版。
- MyTarget SDK 5.14.1 版。
版本 5.13.4.0
- 已验证与 myTarget SDK 5.13.4 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.3.0 版。
- MyTarget SDK 5.13.4 版。
版本 5.13.3.0
- 已验证与 myTarget SDK 5.13.3 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.3.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.3.0 版。
- MyTarget SDK 5.13.3 版。
版本 5.13.2.0
- 已验证与 myTarget SDK 5.13.2 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.2.0 版。
- MyTarget SDK 5.13.2 版。
版本 5.13.1.0
- 已验证与 myTarget SDK 5.13.1 版兼容。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.2.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.2.0 版。
- MyTarget SDK 5.13.1 版。
版本 5.13.0.0
- 已验证与 myTarget SDK 5.13.0 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 20.1.0 版。
- MyTarget SDK 5.13.0 版。
版本 5.12.3.0
- 已验证与 myTarget SDK 5.12.3 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.1.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.1.0 版。
- MyTarget SDK 5.12.3 版。
版本 5.12.2.0
- 已验证与 myTarget SDK 5.12.2 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 20.0.0。
构建和测试时所用平台:
- Google 移动广告 SDK 20.0.0 版。
- MyTarget SDK 5.12.2 版。
版本 5.11.12.0
- 已验证与 myTarget SDK 5.11.12 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 19.7.0 版。
- MyTarget SDK 5.11.12 版。
版本 5.11.10.0
- 已验证与 myTarget SDK 5.11.10 版兼容。
- 添加了描述性错误代码和适配器加载/显示失败的原因。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.7.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.7.0 版。
- MyTarget SDK 5.11.10 版。
版本 5.11.7.0
- 已验证与 myTarget SDK 5.11.7 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.6.0 版。
- MyTarget SDK 5.11.7 版。
版本 5.11.6.0
- 已验证与 myTarget SDK 5.11.6 版本的兼容性。
- 取消了对已弃用的
NativeContentAd
和NativeAppInstallAd
格式的支持。应用应请求统一原生广告。 - 修复了横幅广告有时加载尺寸大于请求尺寸的问题。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.6.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.6.0 版。
- MyTarget SDK 5.11.6 版。
版本 5.11.5.0
- 已验证与 myTarget SDK 5.11.5 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.5.0 版。
- MyTarget SDK 5.11.5 版。
版本 5.11.4.0
- 已验证与 myTarget SDK 5.11.4 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.5.0 版。
- MyTarget SDK 5.11.4 版。
版本 5.11.3.0
- 添加了对 myTarget 的自适应横幅广告尺寸的支持。
- 已验证与 myTarget SDK 5.11.3 版本的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.5.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.5.0 版。
- MyTarget SDK 5.11.3 版。
版本 5.10.0.0
- 已验证与 myTarget SDK 5.10.0 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 19.4.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.4.0 版。
- MyTarget SDK 5.10.0 版。
5.9.1.0 版
- 已验证与 myTarget SDK 5.9.1 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.2.0 版。
- MyTarget SDK 5.9.1 版。
版本 5.8.4.0
- 已验证与 myTarget SDK 5.8.4 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.2.0 版。
- MyTarget SDK 5.8.4 版。
版本 5.8.3.0
- 已验证与 myTarget SDK 5.8.3 版本的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.2.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.2.0 版。
- MyTarget SDK 5.8.3 版。
版本 5.8.2.0
- 已验证与 myTarget SDK 5.8.2 版本的兼容性。
- 更新了适配器,以支持内嵌自适应横幅广告请求。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- MyTarget SDK 5.8.2 版。
版本 5.8.1.0
- 已验证与 myTarget SDK 5.8.1 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- MyTarget SDK 5.8.1 版。
版本 5.8.0.0
- 已验证与 myTarget SDK 5.8.0 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- MyTarget SDK 5.8.0 版。
版本 5.7.1.0
- 已验证与 myTarget SDK 5.7.1 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- MyTarget SDK 5.7.1 版。
版本 5.7.0.0
- 已验证与 myTarget SDK 5.7.0 版本的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.1.0。
构建和测试时所用平台:
- Google 移动广告 SDK 19.1.0 版。
- MyTarget SDK 5.7.0 版。
版本 5.6.3.0
- 已验证与 myTarget SDK 5.6.3 版本的兼容性。
构建和测试时所用平台:
- Google 移动广告 SDK 19.0.1 版。
- MyTarget SDK 5.6.3 版。
版本 5.6.2.0
- 已验证与 myTarget SDK 5.6.2 版本的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 19.0.1。
构建和测试时所用平台:
- Google 移动广告 SDK 19.0.1 版。
- MyTarget SDK 5.6.2 版。
版本 5.6.1.0
- 已验证与 myTarget SDK 5.6.1 版兼容。
构建和测试时所用平台:
- Google 移动广告 SDK 19.0.0 版。
- MyTarget SDK 5.6.1 版。
版本 5.6.0.0
- 已验证与 myTarget SDK 5.6.0 版兼容。
- 将所需的最低 Google 移动广告 SDK 版本更新为 19.0.0。
- 将所需的最低 Android API 级别更新为 16。
构建和测试时所用平台:
- Google 移动广告 SDK 19.0.0 版。
- MyTarget SDK 5.6.0 版。
版本 5.5.5.0
- 已验证与 myTarget SDK 5.5.5 版的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 18.3.0。
构建和测试时所用平台:
- Google 移动广告 SDK 18.3.0 版。
- MyTarget SDK 5.5.5 版。
版本 5.4.6.0
- 已验证与 myTarget SDK 5.4.6 版本的兼容性。
- 将所需的最低 Google 移动广告 SDK 版本更新为 18.2.0。
版本 5.4.5.0
- 已验证与 myTarget SDK 5.4.5 版本的兼容性。
- 将要求的最低 Google 移动广告 SDK 版本更新为 18.1.0。
版本 5.4.0.0
- 已验证与 myTarget SDK 5.4.0 版本的兼容性。
版本 5.3.9.1
- 新增了对灵活横幅广告尺寸的支持。
版本 5.3.9.0
- 已验证与 myTarget SDK 5.3.9 版本的兼容性。
- 更新了适配器,以支持新的开放式 Beta 版激励广告 API。
- 将所需的最低 Google 移动广告 SDK 版本更新为 17.2.0。
版本 5.3.6.0
- 已验证与 myTarget SDK 5.3.6 版本的兼容性。
版本 5.2.5.0
- 已验证与 myTarget SDK 5.2.5 版的兼容性。
- 修复了以下 bug:使用自定义尺寸时,适配器无法请求横幅广告。
版本 5.2.2.0
- 已验证与 myTarget SDK 5.2.2 版的兼容性。
版本 5.2.1.0
- 已验证与 myTarget SDK 5.2.1 版兼容。
版本 5.2.0.0
- 已验证与 myTarget SDK 5.2.0 版兼容。
版本 5.1.4.0
- 已验证与 myTarget SDK 5.1.4 版兼容。
版本 5.1.3.0
- 已验证与 myTarget SDK 5.1.3 版兼容。
版本 5.1.2.0
- 已验证与 myTarget SDK 5.1.2 版兼容。
版本 5.1.1.0
- 已验证与 myTarget SDK 5.1.1 版兼容。
版本 5.1.0.1
- 更新了适配器,以便使用统一原生广告适配器 API。
版本 5.1.0.0
- 已验证与 myTarget SDK 5.1.0 版兼容。
版本 5.0.4.0
- 已验证与 myTarget SDK 5.0.4 版本的兼容性。
版本 5.0.2.1
- 更新了适配器,使其与 Google 移动广告 SDK 15.0.0 版兼容。
版本 5.0.2.0
- 已验证与 myTarget SDK 5.0.2 版兼容。
版本 5.0.0.0
- 已验证与 myTarget SDK 5.0.0 版兼容。
- 更新了适配器,使其与 myTarget SDK 5.0.0 和 Android 兼容 Studio 3.1
4.7.2.0 版
- 已验证与 myTarget SDK 4.7.2 版兼容。
4.7.1.0 版
- 已验证与 myTarget SDK 4.7.1 版兼容。
- 在 MediaView 中添加了对视频和轮播广告的支持。
版本 4.6.28.0
- 更新了 Android Studio 3.0 的适配器项目。
- 已验证与 myTarget SDK 4.6.28 版本的兼容性。
版本 4.6.27.0
- 第一个版本!
- 添加了对横幅广告、插页式广告、激励广告和原生广告的支持。