本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过 AdMob 中介 加载和展示来自 PubMatic 的广告（内容涵盖出价集成）。如何将 PubMatic 添加到广告单元的中介配置中，以及如何将 PubMatic SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
PubMatic 的 AdMob 中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | 1 |
| 激励广告 | 1 |
| 插页式激励广告 | |
1 此格式为 Beta 版。请联系您的客户经理，请求访问权限。
要求
- 最新版 Google Mobile Ads Unity Plugin
- Unity 2019.4 或更高版本
- 如需在 Android 上部署，则要求：
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本
- 一个正常运行的 Unity 项目，且已配置 Google Mobile Ads Unity Plugin。如需了解详情，请参阅 设置 Google Mobile Ads Unity Plugin。
- 设置 AdMob 中介
第 1 步：在 PubMatic 界面中设置配置
注册或 登录您的 PubMatic 账号，然后 选择 OpenWrap SDK 卡片。
添加新应用
前往应用 标签页，然后点击 Add App （添加应用）按钮。
为您的应用选择平台 ，以及 App Store 网址 （应用商店网址）和 App Name （应用名称）。
Android
在 Integration Path（集成路径）下，选择 Unity ，然后选择 AdMob - SDK Bidding（AdMob - SDK 出价）作为 Sub-integration Path（子集成路径）。然后，点击 Add App （添加应用）按钮。
iOS
在 Integration Path（集成路径）下，选择 Unity ，然后选择 AdMob - SDK Bidding（AdMob - SDK 出价）作为 Sub-integration Path（子集成路径）。然后，点击 Add App （添加应用）按钮。
更新 app-ads.txt
应用授权卖方（或 app-ads.txt）是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的
应用广告资源。为避免损失大量广告收入，您需要实现
app-ads.txt 文件。
如果您尚未为应用设置 app-ads.txt 文件，请立即设置。
set up an app-ads.txt file for your app.
在应用最终确定之前，系统会向您显示要添加到 app-ads.txt 中的相应条目。
如需详细了解如何为 PubMatic 实现 app-ads.txt，
请参阅 如何实现 app-ads.txt。
配置文件 ID
创建应用后，前往应用 标签页，然后记下新创建的应用的配置文件 ID 。
创建广告单元
在 Ad Units （广告单元）标签页下，选择您在上一个部分中创建的应用，然后点击 Create Ad Unit （创建广告单元）按钮。
填写表单，提供广告单元的详细信息，然后点击 Save （保存）。
记下新创建的 OpenWrap 广告单元 ID 。
获取发布商 ID
前往 Analytics 信息中心。 将鼠标悬停在个人资料图标上，然后记下您的 ID 。
第 2 步：在 AdMob 界面中设置 PubMatic 需求
为广告单元配置中介设置
将 PubMatic 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照 欧洲法规设置 和 美国州级法规设置 中的步骤，将 PubMatic 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步：导入 PubMatic SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI ，则可以通过从项目的 根目录运行以下命令，将 Google 移动广告 PubMatic OpenWrap SDK 中介插件 for Unity 安装到您的项目中：
openupm add com.google.ads.mobile.mediation.pubmaticOpenUPM
在 Unity 项目编辑器中，依次选择 Edit （修改）> Project Settings （项目设置）> Package Manager （资源包管理器），打开 Unity Package Manager Settings（Unity 资源包管理器设置）。
在 Scoped Registries （限定范围的注册表）Tab 页下，将 OpenUPM 添加为限定范围的注册表，并提供以下详细信息：
- 名称：
OpenUPM - 网址：
https://package.openupm.com - 范围：
com.google
然后，依次选择 Window （窗口）> Package Manager （资源包管理器），打开 Unity Package Manager，并 从下拉菜单中选择 My Registries （我的注册表）。
选择 Google Mobile Ads PubMatic Mediation （Google 移动广告 PubMatic 中介）软件包，然后点击 Install （安装）。
Unity 软件包
在 Unity 项目编辑器中，依次选择 Assets （资源）> Import Package （导入软件包）> Custom Package （自定义软件包），然后找到您下载的 GoogleMobileAdsPubMaticMediation.unitypackage 文件。确保选择所有文件，然后点击 Import （导入）。
然后，依次选择 Assets （资源）> External Dependency Manager （外部依赖项管理器）> Android Resolver （Android 解析器）> Force Resolve （强制解析）。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步：在 PubMatic SDK 上实现隐私设置
欧盟地区意见征求和《一般数据保护条例》(GDPR)
为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须：向位于欧洲经济区 (EEA)、英国和瑞士境内的用户披露相关信息；如果法律要求在使用 Cookie 或存储在本地的其他 ID 之前必须先征得用户同意，您必须照做；如果需要收集、分享和使用个人数据来实现广告个性化，也必须征得用户同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。 Google 无法自动将用户意见传递给此类广告资源网。
PubMatic 会自动读取支持 Google's Additional Consent specification（包括 UMP SDK）的意见征求管理平台设置的 GDPR 意见征求。如需了解详情，请参阅 传递 GDPR 和 GDPR 意见征求。
美国州级隐私保护法律
美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。
PubMatic 会自动读取支持 Google 的额外意见征求规范（包括 UMP SDK）的意见征求管理平台设置的 CCPA 意见征求。如需了解详情，请参阅 设置 CCPA 字符串。
第 5 步：添加必需的代码
Android
PubMatic 集成不需要任何额外的代码。
iOS
SKAdNetwork 集成
请按照 PubMatic 的文档
将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 6 步：测试您的实现
启用测试广告
验证测试广告
若要验证您是否能收到来自 PubMatic OpenWrap SDK 的测试广告，请在广告检查器中启用 single ad source testing （单个广告来源测试），并选择 PubMatic (Bidding)（PubMatic [出价]）作为广告来源。
错误代码
如果适配器未能收到来自 PubMatic 的广告，发布商可以使用
广告响应中归属于以下类的底层错误，通过
ResponseInfo来检查
以下类：
Android
com.pubmatic.sdk
com.google.ads.mediation.pubmatic
iOS
GADMediationAdapterPubMatic
以下是当广告加载失败时，PubMatic 适配器会抛出的代码和随附的消息：
Android
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | 服务器配置缺少必需的发布商 ID。 |
| 102 | com.google.ads.mediation.pubmatic | 用于加载广告的广告配置无效。 |
| 103 | com.google.ads.mediation.pubmatic | 未能展示广告，因为广告尚未准备就绪。 |
| 1001-5002 | 由 PubMatic SDK 发送 | PubMatic SDK 返回了错误。如需了解详情，请参阅 PubMatic 的 文档。 |
iOS
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.pubmatic | 服务器配置缺少必需的发布商 ID。 |
| 102 | com.google.ads.mediation.pubmatic | 出价信号收集请求失败，因为请求参数中指定了多种格式、未指定任何格式或指定了不受支持的格式。 |
| 103 | com.google.ads.mediation.pubmatic | 用于加载广告的广告配置无效。 |
| 104 | com.google.ads.mediation.pubmatic | 未能展示插页式广告，因为广告尚未准备就绪。 |
| 105 | com.google.ads.mediation.pubmatic | 未能展示激励广告，因为广告尚未准备就绪。 |
| 106 | com.google.ads.mediation.pubmatic | 未能加载其中一个原生广告图片来源。 |
| 1001-5002 | 由 PubMatic SDK 发送 | PubMatic SDK 返回了错误。如需了解详情，请参阅 PubMatic 的 文档。 |
PubMatic Unity 中介插件变更日志
2.0.0 版（正在开发中）
1.5.0 版
- 支持 PubMatic Android 适配器 4.12.0.0 版。
- 支持 PubMatic iOS 适配器 4.12.0.0 版。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建和测试。
1.4.1 版
- 支持 PubMatic Android 适配器 4.11.0.1 版。
- 支持 PubMatic iOS 适配器 4.11.0.1 版。
- 使用 Google 移动广告 Unity 插件 10.7.0 版构建和测试。
1.4.0 版
- 支持 PubMatic Android 适配器 4.11.0.0 版。
- 支持 PubMatic iOS 适配器 4.11.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
1.3.1 版
- 支持 PubMatic Android 适配器 4.10.0.1 版。
- 支持 PubMatic iOS 适配器 4.10.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
1.3.0 版
- 支持 PubMatic Android 适配器 4.10.0.0 版。
- 支持 PubMatic iOS 适配器 4.10.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建和测试。
1.2.0 版
- 支持 PubMatic Android 适配器 4.9.1.0 版。
- 支持 PubMatic iOS 适配器 4.9.0.0 版。
- 使用 Google 移动广告 Unity 插件 10.5.0 版构建和测试。
1.1.0 版
- 支持 PubMatic Android 适配器 4.9.1.0 版。
- 支持 PubMatic iOS 适配器 4.8.1.0 版。
- 使用 Google 移动广告 Unity 插件 10.5.0 版构建和测试。
1.0.0 版
- 首次发布！
- 支持 PubMatic Android 适配器 4.8.0.0 版。
- 支持 PubMatic iOS 适配器 4.8.1.0 版。
- 使用 Google 移动广告 Unity 插件 10.4.2 版构建和测试。