# Liftoff Monetize 集成

> 通过创建 Liftoff Monetize 帐户、添加广告位并将 Liftoff Monetize 适配器添加到项目中，将 Liftoff Monetize 与 Unity LevelPlay 集成。

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

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

> **Note:**
>
> 要查看此聚合网络的适配器更改日志，请参阅[适用于 Android 的聚合网络](/grow/levelplay/sdk/android/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。

### Android##android

LevelPlay 支持 Gradle 依赖关系和手动下载机制。

#### Gradle##gradle

1. 确保在 app 模块的构建.gradle 脚本中存在以下 Maven 网址。（所有适配器只能出现一次）

```groovy
repositories {
   mavenCentral()
}
```

2. 将适配器的 Maven 名称添加到 app 模块的构建.gradle 脚本。

```groovy
dependencies {
   implementation 'com.unity3d.ads-mediation:vungle-adapter:5.5.0'
   implementation 'com.vungle:vungle-ads:7.7.0'
}
```

#### 手动下载##manual-download

1. \*\*下载 Vungle 适配器：\*\*将 Vungle 适配器添加到构建中。您可以在[此处](/grow/levelplay/sdk/android/mediation-networks.md)找到最新的 Vungle 适配器。
2. **下载 Vungle AAR 文件**
   1. 您可以在[此处](/grow/levelplay/sdk/android/mediation-networks.md)找到最新的 Vungle AAR。
   2. 如果使用 Eclipse：将 AAR 文件作为库项目导入。
   3. 如果使用 Android Studio，请下载 Vungle [AAR 文件](https://developers.is.com/wp-content/uploads/2019/10/publisher-sdk-android-6.4.11.aar)并作为依赖项添加到您自己的模块。转到**文件** > **New** > **New Module** > **Import AAR**，然后导航到 Vungle AAR 文件的下载位置。
3. 确保在 Gradle 构建文件的 **dependencies** 部分下添加以下内容：

```groovy
dependencies {
   implementation 'com.unity3d.ads-mediation:vungle-adapter:4.3.31'
   implementation 'com.vungle:vungle-ads:7.5.1'
}
```

#### 仅适用于 Proguard 用户##for-proguard-users-only

如果将 ProGuard 与 Vungle 适配器结合使用，必须将以下代码添加到 ProGuard 文件（Android Studio：proguard-rules.pro 或 Eclipse：proguard-project.txt）：

```text
# Vungle##vungle
-keep 类 com.vungle.warren** { *; }
-dontwarn com.vungle.warren.error.VungleError$ErrorCode
# Moat SDK##moat-sdk
-keep class com.moat.** { *; }
-dontwarn com.moat。**
# Okio##okio
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
# Retrofit##retrofit
- 不要警告 okio。**
-dontwarn retrofit2.Platform$Java8
# Gson##gson
-keepattributes 签名
-keepattributes *Annotation*
-dontwarn sun.misc**
-keep class com.google.gson.examples.android.model.** { *; }
-keep 类 * 实现 com.google.gson.TypeAdapterFactory
-keep 类 * 实现 com.google.gson.JsonSerializer
-keep 类 * 实现 com.google.gson.JsonDeserializer
# Google Android Advertising ID##google-android-advertising-id
-keep class com.google.android.gms.internal.** { *; }
-dontwarn com.google.android.gms.ads.identifier.** { *; }
```

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

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

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

使用以语法 Vungle 的 COPPA 用户状态更新为 true：

```java
LevelPlay.setMetaData("Vungle_coppa","true");
```

使用以语法 Vungle 的 COPPA 用户状态更新为 false：

```java
LevelPlay.setMetaData("Vungle_coppa","false");
```

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

## 后续步骤##next-steps

要通过 Unity LevelPlay 利用其他广告网络，请集成适配器并按照我们的集成指南进行操作。

**Platform adapters:**

* [Unity](/grow/levelplay/sdk/unity/mediation-networks.md)
* [Android](/grow/levelplay/sdk/android/mediation-networks.md)
* [iOS](/grow/levelplay/sdk/ios/mediation-networks.md)
* [Adobe AIR](/grow/levelplay/sdk/adobe/mediation-networks.md)
* [Flutter](/grow/levelplay/sdk/flutter/mediation-networks.md)
* [React Native](/grow/levelplay/sdk/react/mediation-networks.md)