# Liftoff Monetize 集成

> 通过创建帐户、设置广告位并将 Liftoff 适配器添加到构建中，在 Unity LevelPlay 中将 Liftoff Monetize 添加为广告网络。

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

本指南将逐步说明如何在 Unity LevelPlay 上将 Liftoff Monetize（以前称为 Vungle）设置为广告网络直播。要使用 Liftoff Monetize，您需要安装 [Vungle SDK](https://liftoff.io/monetize/vungle-sdk/)。

> **Note:**
>
> Vungle iOS SDK v.6.8.0+（Vungle 适配器 4.3.6+）支持 Xcode 12 或更高版本。不支持在 Xcode 11 或更高版本上构建。

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

## 先决条件##prerequisites

确保将奖励广告服务、插页式广告服务或横幅广告服务正确集成到应用程序中。请参阅以下指定的于平台的指南以了解集成说明：

**Rewarded ads integration:**

* [Unity](/grow/levelplay/sdk/unity/rewarded-ad-integration-package.md.md)
* [Android](/grow/levelplay/sdk/android/rewarded-ads-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/rewarded-ads-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/rewarded-ads-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/rewarded-ads-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/rewarded-ads-integration.md.md)

**Interstitial integration:**

* [Unity](/grow/levelplay/sdk/unity/interstitial-integration.md.md)
* [Android](/grow/levelplay/sdk/android/interstitial-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/interstitial-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/interstitial-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/interstitial-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/interstitial-integration.md.md)

**Banner integration:**

* [Unity](/grow/levelplay/sdk/unity/banner-integration.md.md)
* [Android](/grow/levelplay/sdk/android/banner-integration.md.md)
* [iOS](/grow/levelplay/sdk/ios/banner-integration.md.md)
* [Adobe Air](/grow/levelplay/sdk/adobe/banner-integration.md.md)
* [Flutter](/grow/levelplay/sdk/flutter/banner-integration.md.md)
* [原生反应](/grow/levelplay/sdk/react/banner-integration.md.md)

## 步骤 1.创建 Liftoff Monetize 帐户

1. 使用 Liftoff Monetize 创建帐户。您可以在[此处](https://app.vungle.com/signup/)执行此操作
2. 验证您的帐户后，您可以在[此处](https://app.vungle.com/login/)登录他们的合作伙伴

## 步骤 2.在 Liftoff Monetize 中创建应用程序

登录后，转到左上角左侧下拉菜单上的 **Applications** 选项卡，然后选择 **Add Application**。

## 步骤 3. 添加放置/位置

从应用程序列表中选择相关 app。在 app 的专用页面上，选择 **Add Placement/位置**。

然后输入必要的详细信息以创建启动放置/位置，然后选择 \*\*Continue，\*\*然后选择 **Sounds Good**。

\*\*横幅放置/\*\*位置 创建横幅广告放置/位置时，建议禁用“Ad Refresh”选项。稍后可以在 Unity LevelPlay 上控制刷新速率。

## 步骤 4.在 LevelPlay SDK Networks 模块上激活 Liftoff Monetize

Liftoff 帐户中有 4 条数据需要插入到 LevelPlay 网络设置模块中，以便 Liftoff 能够与 LevelPlay 正常工作：

| **启动 app ID**  | 这是 Liftoff 系统中应用程序的唯一标识符。                                                                 |
| -------------- | ----------------------------------------------------------------------------------------- |
| **报告 API ID**  | 这是 Liftoff 系统中 app 的唯一标识符，与 Reporting API 一起使用以轨道 app 性能。                                 |
| **报告 API 密钥**  | 这是 Liftoff 帐户的唯一标识符。除了 Reporting API ID，Unity LevelPlay 还可以从您的 Liftoff Monetize 帐户导入性能数据。 |
| **放置/位置参考 ID** | 这是广告单元的唯一标识符，用于将奖励广告服务与插页式广告服务和横幅广告服务区分开来。                                                |

获取此信息后，必须在 Unity LevelPlay 中\*\*配置 Liftoff 的参数。\*\*正确添加上述信息后，您将能够充分利用 Liftoff 在 Unity LevelPlay 上的广告库存和报告数据。

1. ### 报告 API 密钥

   转到屏幕右上角的 **My Account**（我的帐户），然后您将看到 Reporting API Key（报告 API 密钥）。

2. ### **启动 Monetize 应用程序 ID**

   转到左侧菜单的 Applications（应用程序）选项卡，然后在 LevelPlay（关卡播放）后台上选择要配置的应用程序。然后，您将看到 Liftoff app ID。

3. ### 报告 API ID

   转到左侧菜单的 Applications（应用程序）选项卡，然后在 LevelPlay（关卡播放）后台中选择要配置的应用程序。然后，您将看到 Liftoff Reporting API ID。

4. ### **放置/位置参考 ID**

   转到左侧菜单的 **Placements** 选项卡，然后选择要在 LevelPlay 后台上配置的应用程序的位置。

### **在 Unity LevelPlay 上激活启动 Monetize**

收集完所有必要的参数后，日志 LevelPlay 帐户。

* 转到 **Monetize** > **Setup** > **SDK Networks**：
* 从 Available Ad Networks 列表中选择 Liftoff，然后输入 Liftoff“Reporting API Key”。仅需要此步骤一次。
* 要激活自动设置功能，请在 Liftoff Monetize 自动设置工具上切换。这将启用在 Liftoff Monetize 平台上自动创建 app 和出价者放置/位置，并允许 LevelPlay 在自动设置工具上切换并输入 Liftoff Monetize 平台上的 Overview 页面上找到的 Secret Token 后从 Liftoff Monetize 获取放置/位置详细信息。然后，选择保存
* 选择 **Save（保存）**。 然后，将在 **Available Networks** 表中启用 Liftoff

## 5.在 app 级别上设置 Liftoff Monetize

### 传统瀑布流设置

* 从 SDK Networks 页面左侧的列表中选择要集成的app程序
* 在广告单元行中，单击 Setup 并输入 Reporting API Key、app ID 和 Reporting API ID。然后在相关的广告单元设置下，添加放置/位置参考 ID。
* 选择 **Save（保存）**。然后，您将在设置控制面板 (Setup Dashboard) 上看到 Liftoff Monetize 为 激活 for Mediation。

### **Bidder 设置**

有两种方法可以在 LevelPlay 上设置 Liftoff Monetize 出价者：

1. **自动设置** – 在 Liftoff Monetize（变现）后台上自动创建新 app 和广告位，并在 LevelPlay 上填充所有必要的设置
2. **Manual** – 在 LevelPlay 和 Liftoff Monetize 平台上手动输入必要的 app 详细信息

**自动设置**

* 选择要在 Unity Ads 中运行插页式广告、奖励广告或横幅广告服务的app。然后选择 Liftoff 行中的 define 图标。
* 选择 **Add bider**（添加出价人）可在 Liftoff Monetize 平台上自动创建新的 app 和竞价广告位，并将相关信息导入 LevelPlay。
* 选择 **保存** 以批准并接受所有配置。如果未保存模块，则会在 Liftoff Monetize 平台上创建资源，而不会将数据导入 LevelPlay 平台。

> **Note:**
>
> Liftoff Monetiz 出价者实例的状态与 ironSource 广告服务出价者的状态相同（按广告单元）。例如，如果您不使用 ironsource 广告服务出价器获取奖励广告服务，则不会为 Liftoff Monetize 网络自动激活此出价器。要激活奖励广告服务的 Liftoff Monetize 竞价实例，请选择 Liftoff Monetize 行并在广告单元上切换。

**手动设置**

* 选择要在哪个 app 中运行横幅广告、插页式广告或奖励广告服务 (liftoff Monetize)

* 从 Ad Networks 的设置列表中选择 Liftoff，选择 define 图标，然后插入 **Reporting API Key**、**app ID** 和 **Reporting API** **ID。然后**在相关的广告单元设置下，添加**放置/位置参考 ID。**

* 单击 **Save（保存**）

现在，您将看到 Lifotff 在帐户中选择的广告单位激活。

## 步骤 6。将 Vungle 适配器添加到构建中##step-6.-add-the-vungle-adapter-to-your-build

要使用 Liftoff Monetize，需要在[此处](https://liftoff.io/monetize/vungle-sdk/)安装 Vungle SDK。

### iOS##ios

LevelPlay 支持 **Cocoapods** 和 **Manual** 下载机制。

### Cocoapods##cocoapods

要将 Vungle SDK 与 Cocoapods 集成，请在 pod 文件中输入以下行，即可开始使用！

```ruby
pod 'IronSourceVungleAdapter','5.6.0'
```

**手动下载**

1. \*\*下载 Vungle 适配器：\*\*将 Vungle Adapter 和 SDK 文件添加到构建中。请参阅 [iOS 调解网络](/grow/levelplay/sdk/ios/mediation-networks.md)。\*\*重要信息！\*\*Vungle 适配器不包含 Vungle SDK。还需要添加 Vungle SDK。
2. \*\*将 Vungle XCframeworks 添加到项目中：\*\*下载并解压缩适配器和 SDK 文件后，将 **XCframework** 文件放入 Xcode 项目。
3. **移除 iOS 状态栏** 为了获得最佳用户体验，Vungle 强烈建议在向用户投放广告单元时移除 iOS 状态栏。为此，请打开 **Info.pList**，添加键“**View controller-based status bar appearance**”并将其设置为“**No**”。

### 评估广告网络集成##evaluate-your-ad-network-integration

* 验证您的广告网络与我们的 [Integration Helper](/grow/levelplay/sdk/ios/integration-helper.md) 集成。LevelPlay SDK 提供了一个工具，可确保已成功集成我们的 SDK 以及任何其他网络适配器。
* 使用此布尔值管理集成的聚合广告网络的调试日志

  1. **Objective-C**

     ```objective-c
     [LevelPlay setAdaptersDebug:YES];
     ```

  2. **Swift**

     ```swift
     LevelPlay.setAdaptersDebug(true)
     ```

  设置为 YES 时，这行代码将启用调试日志，以帮助您解决所有聚合广告网络的问题。在 app 与我们的广告单位上线之前，请删除此代码！SDK 6.5.2 及更高版本支持。

## 步骤 7。Liftoff 其他设置##step-7.-liftoff-additional-settings

### COPPA 用户状态##coppa-user-status

Unity LevelPlay 允许发行商将 Vungle COPPA 设置直接传达给提升网络。此功能是使用 LevelPlay SDK 7.2.2+、Vungle Android 适配器 4.3.20+ 已启用的。在[此处](https://support.vungle.com/hc/en-us/articles/360047780372#coppa-api-0-8)阅读有关 Vungle COPPA API 的更多信息。

使用以下语法使用参数“Yes”更新 Vungle 的 COPPA User Status：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"Vungle_coppa" value:@"Yes"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("Vungle_coppa", value: "true")
   ```

使用以下语法使用参数“No”更新 Vungle 的 COPPA User Status：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"Vungle_coppa" value:@"No"];
   ```

2. **Swift**

   ```swift
   LevelPlay.setMetaDataWithKey("Vungle_coppa", value: "false")
   ```

您现在可以在应用程序中投放提升变现广告服务。

## 后续步骤##next-steps

要通过 Unity LevelPlay 利用其他广告网络，请集成[适配器](/grow/levelplay/sdk/ios/mediation-networks.md)并按照我们的集成指南进行操作。