本指南介绍了如何使用 Google 移动广告 SDK 通过 AdMob 中介加载和展示来自 PubMatic 的广告（内容涵盖出价集成）、如何将 PubMatic 添加到广告单元的中介配置，以及如何将 PubMatic 和适配器集成到 iOS 应用中。
支持的集成和广告格式
PubMatic 的中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 表现形式 | |
| 开屏广告 | |
| 横幅 | |
| 插页式广告 | |
| 激励广告 | |
| 插页式激励广告 | |
| 原生广告 | |
要求
- iOS 部署目标版本为 12.0 或更高版本
最新版 Google 移动广告 SDK。
通读中介入门指南。
第 1 步：在 PubMatic 界面中设置配置
登录您的 PubMatic 账号，然后选择 OpenWrap SDK 卡片。
添加新应用
前往应用标签页，然后点击添加应用按钮。
选择应用的平台、应用商店网址和应用名称。
在集成路径下，选择 iOS (Objective-C / Swift)，然后选择 AdMob - SDK 出价作为子集成路径。然后，点击添加应用按钮。
更新 app-ads.txt
应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。
如果您尚未完成此项设置，请为您的应用设置 app-ads.txt 文件。
在应用最终确定之前，系统会显示相应条目，供您添加到 app-ads.txt 中。
如需详细了解如何为 PubMatic 实现 app-ads.txt，请参阅如何实现 app-ads.txt。
配置文件 ID
创建应用后，前往 Apps（应用）标签页，并记下新创建的应用的个人资料 ID。
创建广告单元
在广告单元标签页下，选择您在上一个部分中创建的应用，然后点击创建广告单元按钮。
在表单中填写广告单元的详细信息，然后点击保存。
记下新创建的 OpenWrap 广告单元 ID。
获取发布商 ID
前往分析信息中心。 将光标悬停在个人资料图标上，并记下您的 ID。
第 2 步：在 AdMob 界面中设置 PubMatic 需求
为广告单元配置中介设置
您需要将 PubMatic OpenWrap SDK 添加到广告单元的中介配置。
首先，登录您的 AdMob 账号。接下来，前往中介标签页。如果您要修改某个现有中介组，请点击该中介组的名称进行修改，然后跳至将 PubMatic OpenWrap SDK 添加为广告来源。
若要创建新中介组，请选择创建中介组。
输入广告格式和平台，然后点击继续。
为中介组命名，然后选择要定位到的地理位置。接下来，将中介组状态设置为已启用，然后点击添加广告单元。
将此中介组与您的一个或多个现有 AdMob 广告单元相关联。然后，点击完成。
现在，您应该会看到“广告单元”卡片中填充了您选择的广告单元：
将 PubMatic OpenWrap SDK 添加为广告来源
在出价卡片的广告来源部分，选择添加广告来源。然后选择 PubMatic OpenWrap SDK。点击如何签署合作伙伴协议，然后与 PubMatic OpenWrap SDK 建立出价合作伙伴关系。
点击确认并同意，然后点击继续。
如果您已为 PubMatic OpenWrap SDK 创建映射，可以选择该映射。否则，请点击添加映射。
接下来，输入在上一部分获得的 OpenWrap 广告单元 ID。然后点击完成。
将 PubMatic 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照欧洲法规设置和美国州级法规设置中的步骤，将 PubMatic 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步：导入 PubMatic SDK 和适配器
CocoaPods（推荐）
将以下行添加到项目的 Podfile：
pod 'GoogleMobileAdsMediationPubMatic'在命令行中，运行以下代码：
pod install --repo-update
手动集成
下载最新版本的 PubMatic OpenWrap SDK for iOS，并将项目中的所有
.xcframework文件和软件包关联起来。从更改日志中的下载链接下载最新版本的 PubMatic 适配器，并在项目中关联
PubMaticAdapter.xcframework。
第 4 步：在 PubMatic SDK 上实现隐私设置
为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息，并征得他们同意，才能在法律要求的情况下使用 Cookie 或其他本地存储空间，以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。
PubMatic 会自动读取支持 Google 的“征得用户同意情况”规范（包括 UMP SDK）的意见征求管理平台设置的 GDPR 同意情况。 如需了解详情，请参阅传递 GDPR 和 GDPR 意见征求。
美国州级隐私保护法律
美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。
PubMatic 会自动读取支持 Google“额外同意模式”规范（包括 UMP SDK）的意见征求管理平台设置的 GPP 同意情况。 如需了解详情，请参阅传递 GPP 意见征求信息。
第 5 步：添加必需的代码
SKAdNetwork 集成
按照 PubMatic 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 6 步：测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。
验证测试广告
若要验证您是否能收到来自 PubMatic OpenWrap SDK 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 PubMatic (Bidding)（PubMatic [出价]）作为广告来源。
可选步骤
原生广告
广告呈现
PubMatic 适配器以 GADNativeAd 对象的形式返回其原生广告。它会为 GADNativeAd 填充以下字段。
| 字段 | PubMatic 适配器始终包含的素材资源 |
|---|---|
| 标题 | |
| 图片 | |
| 正文 | |
| 图标 | |
| 号召性用语 | |
| 星级 | |
| 商店 | |
| 价格 | |
| 广告客户 |
错误代码
如果适配器未能收到来自 PubMatic 的广告，您可以使用 GADResponseInfo.adNetworkInfoArray 来检查广告响应中归属于以下类的底层错误：
GADMediationAdapterPubMatic
以下是当广告加载失败时，PubMatic 适配器会抛出的代码和随附的消息：
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 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 iOS 中介适配器变更日志
版本 4.8.1.1（正在开发中）
- 支持瀑布流插页式广告格式。
- 支持瀑布流激励广告格式。
- 支持瀑布流横幅广告格式。
- 支持瀑布流原生广告格式。
- 修复了原生广告委托未正确设置的 bug。
- 包括框架中的 Info.plist。
4.8.1.0 版
- 已验证与 PubMatic OpenWrap SDK 4.8.1 版的兼容性。
构建和测试所需版本：
- Google 移动广告 SDK 12.9.0 版。
- PubMatic OpenWrap SDK 4.8.1 版。
4.8.0.0 版
- 已验证与 PubMatic OpenWrap SDK 4.8.0 版的兼容性。
构建和测试所需版本：
- Google 移动广告 SDK 12.8.0 版。
- PubMatic OpenWrap SDK 4.8.0 版。
4.7.0.0 版
- 初始版本。
- 支持为横幅广告、插页式广告、激励广告和原生广告格式出价。
- 已验证与 PubMatic OpenWrap SDK 4.7.0 版的兼容性。
构建和测试所需版本：
- Google 移动广告 SDK 12.6.0 版。
- PubMatic OpenWrap SDK 4.7.0 版。