# 将 PubMatic 与 LevelPlay 集成

> 了解如何将 PubMatic 与已启用 LevelPlay 的 iOS app 集成

> **Important:**
>
> 以下文档涉及非 Unity 开发、拥有或运营的产品或服务（“第三方产品”）。
> 这些信息可能已过时或不完整，仅为方便您参考才提供。
> 您对任何第三方产品的使用均受产品自身条款的约束。
> Unity 对这些产品不提供任何担保，也不对因使用这些产品而造成的任何损害或损失负责，包括与第三方供应商提供的内容、广告或材料有关的问题。

了解如何将 PubMatic 与已启用 LevelPlay 的 iOS app 集成。此部分将介绍 LevelPlay 中的帐户设置、app 配置、广告单元创建和适配器安装。请按照以下步骤操作，确保为 PubMatic 竞价正确配置广告位。

> **Note:**
>
> 要查看此聚合网络的适配器更改日志，请参阅[iOS 聚合网络](/grow/levelplay/sdk/ios/mediation-networks.md.md#integrate-network-adapters)。

## 先决条件##prerequisites

确保已将 LevelPlay 的[奖励视频](/grow/levelplay/sdk/ios/rewarded-ads-integration/.md)、[插页](/grow/levelplay/sdk/ios/interstitial-integration/.md)或[横幅](/grow/levelplay/sdk/ios/banner-integration/.md)正确集成到应用程序中。

## 创建 PubMatic 帐户

1. 访问 [PubMatic 网站](https://go.pubmatic.com/openwrap-sdk-capture-more-direct-brand-spend)并创建帐户。
2. 等待您的帐户获得批准。
3. 登录 [PubMatic Monetization 后台](https://apps.pubmatic.com/login/publisher)。

## 创建 app 和广告单位

### 添加 app

添加 app 并在 PubMatic 后台中配置广告单位，然后才能在 LevelPlay 中激活 PubMatic。

1. 登录 [PubMatic Monetization 后台](https://apps.pubmatic.com/login/publisher)。
2. 选择 **Set Up**（设置）> **Apps（应用**）。
3. 选择 **Add app**（添加应用）。

![PubMatic 后台中的 Add app 表单。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step2-add-app.png)

4. 在 General（常规）部分中：
   * 选择目标平台（iOS 或 Android）。
   * 输入有效的 App Store 或 Google 播放网址。
   * 查看或编辑自动生成的 app 名称。
5. 在 Configuration 部分中：
   * 选择您的**集成路径**。
   * 将 **Sub-Integration Path** 设置为 **LevelPlay – SDK Bidding**。
6. 在高级部分中：
   * 确保货币设置为 USD。
7. 选择 **Add app**（添加应用）。

![PubMatic 后台中的 app 配置设置。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step2-app-config.png)

### 创建广告单位

添加 app 后，创建 LevelPlay 在竞价期间会请求的广告单位。

1. 选择 **Set Up** > **Ad Units**。
2. 选择app程序以查看其广告单位。
3. 选择 **Create Ad Unit**（创建广告单元）。

![PubMatic 后台中的 Create Ad Unit 按钮。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step2-create-ad-unit.png)

4. 输入广告单元 ID。
5. 选择广告格式并填写所有必填字段。
6. 选择 **Save** 或 **Save & Create Another**。

![PubMatic 后台中的广告单元创建表单。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step2-ad-unit-creation.png)

PubMatic 会生成一个广告单位 ID，显示在 Ad Unit 部分中。

### 管理出价合作伙伴

查看哪些出价合作伙伴有权访问您的广告单位。

1. 选择 **Set Up** > **Bidder Partners**。
2. 选择您的app。
3. 使用开关为每个出价合作伙伴启用或禁用广告单位。

## 在 LevelPlay 设置中激活 PubMatic

在 PubMatic 中配置您的 app 和广告单位后，在 LevelPlay 中激活 PubMatic 网络以将 PubMatic 凭据连接到您的广告位。

1. 在 LevelPlay 中，打开 **Monetize** > **Setup** > **SDK Networks**。
2. 从可用网络列表中选择 **PubMatic**。
3. 输入所需参数，选择 **Activate**，然后**保存**。
4. 从配置的网络中再次选择 **PubMatic**，然后选择 **Setup**。
5. 从 PubMatic 后台输入以下值：
   * **Publisher ID**：在 PubMatic 发布者帐户中找到
   * **配置文件 ID**：在 **Apps** 页面上找到
   * **广告单位 ID**：在 **Ad Units** 部分中找到

![PubMatic 后台中的 Publisher ID 位置。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step3-publisher-id.png)

![PubMatic 后台中的配置文件 ID 位置。](/api/media?file=/grow/media/levelplay/networks/guides/pubmatic-flutter-step3-profile-id.png)

6. 将状态设置为 **激活** 并选择 **保存**。

PubMatic 现在在 Setup（设置）后台上显示为激活的聚合。

## 添加 PubMatic 适配器##add-the-pubmatic-adapter

要完成投标人集成，请将 PubMatic SDK 和 LevelPlay PubMatic 适配器添加到 iOS 项目中。有两种方法：使用 CocoaPods 或手动将 SDK 和适配器集成到项目中。

### 与 CocoaPods 集成（推荐）##integrate-with-cocoapods-(recommended)

将以下行添加到 Podfile 可将 PubMatic 适配器集成到 LevelPlay：

```ruby
pod 'LevelPlayPubMaticAdapter', '5.0.0.0'
```

运行以下代码来安装适配器和 SDK：

```sh
pod 安装 --repo-update
```

### 手动集成##manual-integration

1. 下载最新的 [PubMatic SDK for iOS](https://help.pubmatic.com/openwrap/reference/home-get-started-with-ios-openwrap-sdk-as-primary-ad-sdk#integrate-manually)。
2. 将所有必需的 .xcframework 文件和捆绑包添加到项目中。
3. 下载最新的 LevelPlay PubMatic 适配器。

## 处理用户同意

为了符合 GDPR 和其他隐私框架，请确保 app 向 PubMatic SDK 提供正确的同意信息。

* PubMatic SDK 使用 IAB TCF 2.0 标准通过共享偏好或用户默认值（理想情况下是通过 CMP SDK）检索 GDPR 值。
* PubMatic 还支持用于检索 GPP 同意信号的 IAB GPP 标准。
* 有关传递同意值的信息，请参阅 [PubMatic SDK 高级主题](https://help.pubmatic.com/openwrap/reference/advanced-topics)。