将 myTarget 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 myTarget 的广告，其中涵盖了瀑布流集成。如何将 myTarget 添加到广告单元的中介配置，以及如何将 myTarget SDK 和适配器集成到 Unity 应用中。

支持的集成和广告格式

集成
出价
瀑布流
表现形式
横幅
插页式广告
激励广告
插页式激励广告

要求

  • 最新版 Google 移动广告 SDK
  • Unity 2019.4 或更高版本
  • 如需在 Android 上部署，则要求：
    • Android API 级别 23 或更高级别
  • 如需在 iOS 上部署，则要求：
    • iOS 部署目标版本为 12.0 或更高版本
  • 已配置 Google 移动广告 SDK 的 Unity 项目，该项目应正常运行。 如需了解详情，请参阅使用入门。
  • 完成中介入门指南阅读。

第 1 步：在 myTarget 界面中设置配置

登录您的 myTarget 账号。点击标题中的应用，前往“应用”页面。点击添加应用，添加您的应用。

如果您的应用同时支持 Android 和 iOS 平台，则需要分别设置这两个平台。

Android

接下来，提供应用的 Google Play 网址。

iOS

接下来，提供应用的 iTunes 网址**。

添加应用时，myTarget 要求您先创建广告单元，然后才能完成该流程。

从可用的广告格式中选择横幅，然后点击添加广告单元按钮。

插页式广告

从可用的广告格式中选择插页式广告，然后点击添加广告单元按钮。

激励广告

从可用的广告格式中选择激励视频，然后点击添加广告单元按钮。

原生

从可用的广告格式中选择原生，然后点击添加广告单元。

在广告单元的详情页面中，记下您的广告位 ID，该 ID 可在广告单元设置下找到，显示为 slot_id。此 slot ID 将用于在下一部分中设置 Ad Manager 广告单元。

除了 slot_id 之外，您还需要 myTarget Permanent Access Token 来设置 AdMob 广告单元 ID。前往个人资料标签页，然后选择访问令牌。点击 Create Token（创建令牌）或 Show Token（显示令牌）以查看您的 myTarget 永久访问令牌。

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。 如果您尚未完成此项操作，请为 Ad Manager 创建 app-ads.txt 文件。

如需为 myTarget 实现 app-ads.txt，请参阅如何创建和发布文件。

启用测试模式

按照 myTarget 的文档中的说明，在 myTarget 界面中添加和配置测试设备。

第 2 步：在 Ad Manager 界面中设置 myTarget 需求

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需查看相关说明，请参阅 iOS 指南中的第 2 步。

将 Mail.ru 添加到 GDPR 和美国州级法规广告合作伙伴名单中

请按照欧洲法规设置和美国州级法规设置中的步骤，将 Mail.ru 添加到 Ad Manager 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。

第 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。

在范围内的注册表标签页下，添加 OpenUPM 作为范围内的注册表，并提供以下详细信息：

  • 名称：OpenUPM
  • URL：https://package.openupm.com
  • 范围：com.google

OpenUPM 详细信息

然后，依次前往 Window > Package Manager，打开 Unity Package Manager，并从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google Mobile Ads MyTarget 中介软件包，然后点击 Install。

从 OpenUPM 安装

Unity 软件包

从更改日志中的下载链接下载适用于 myTarget 的最新版 Google 移动广告中介插件，然后从 ZIP 文件中提取 GoogleMobileAdsMyTargetMediation.unitypackage。

在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsMyTargetMediation.unitypackage 文件。确保已选择所有文件，然后点击导入。

从 Unity 导入

然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

强制解决

第 4 步：在 myTarget SDK 上实现隐私设置

为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息，并征得他们同意，才能在法律要求的情况下使用 Cookie 或其他本地存储空间，以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。Google 无法自动将用户意见传递给此类广告资源网。

适用于 myTarget 的 Google 移动广告中介插件 2.1.0 版包含 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 Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。

适用于 myTarget 的 Google 移动广告中介插件 3.13.3 版包含 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 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 myTarget (Waterfall)（myTarget [瀑布流]）作为广告来源。

错误代码

如果适配器未能收到来自 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 在 Ad Manager 界面中配置的 myTarget 服务器参数缺失/无效。
102 所请求的广告尺寸与 myTarget 支持的横幅尺寸不符。
103 广告请求不是统一原生广告请求。
104 从 myTarget 加载的原生广告与请求的原生广告不同。
105 从 myTarget 加载的原生广告缺少一些必需的素材资源（例如图片或图标）。

iOS

错误代码 原因
100 myTarget SDK 尚无可用广告。
101 在 Ad Manager 界面中配置的 myTarget 服务器参数缺失/无效。
102 myTarget 适配器不支持所请求的广告格式。
103 尝试展示未加载的 myTarget 广告。
104 所请求的广告尺寸与 myTarget 支持的横幅尺寸不符。
105 缺少必需的原生广告素材资源。

myTarget Unity 中介插件变更日志

3.29.0 版

3.28.0 版

版本 3.27.1

3.27.0 版

3.26.0 版

3.25.0 版

3.24.0 版

3.23.0 版

3.22.0 版

版本 3.21.1

3.21.0 版

3.20.0 版

3.19.0 版

版本 3.18.2

版本 3.18.1

3.18.0 版

版本 3.17.1

3.17.0 版

版本 3.16.2

版本 3.16.1

3.16.0 版

3.15.0 版

3.14.0 版

版本 3.13.2

版本 3.13.1

3.13.0 版

3.12.0 版

3.11.4 版

3.11.3 版

3.11.2 版

版本 3.11.1

3.11.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

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。