# Pangle 集成

> 通过创建 Pangle 帐户、添加 app 以及配置插页和奖励视频的广告单位，将 Pangle 与 Unity LevelPlay 集成。

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

本指南将逐步说明如何在 Unity LevelPlay 聚合中实时设置 Pangle。

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

## 先决条件##prerequisites

* Pangle 在以下位置为用户提供广告服务：日本、韩国、台湾、泰国、菲律宾、新加坡、柬埔寨、越南、马来西亚、沙特阿拉伯、阿拉伯联合酋长国、埃及、土耳其、印度尼西亚、加拿大、阿根廷、智利、秘鲁、哥伦比亚、巴西、墨西哥、白俄罗斯、乌克兰、以色列、哈萨克斯坦、俄罗斯、澳大利亚、新西兰、南非、巴基斯坦、科威特、伊拉克、摩洛哥、卡塔尔、约旦、阿曼、巴林、乌拉圭、厄瓜多尔、黎巴嫩、肯尼亚、斯里兰卡、阿尔及利亚、阿塞拜疆、塞尔维亚、巴拉圭和玻利维亚\*\*（iOS 和 Android、竞价和非竞价）\*\*
* Pangle 支持 Android 操作系统版本 5（API 级别 21）及更高版本。

## 步骤 1.创建 Pangle 帐户

要通过 Unity LevelPlay 访问 Pangle 的广告库存，必须使用 Pangle 创建帐户。您可以在[此处](http://ad.toutiao.com/union/media/login/)执行此操作。

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

接下来，在您的 Pangle 帐户中添加 app。

### 添加 app

1. 日志 Pangle 帐户。在控制面板上，悬停\*\*应用程序\*\*\*\*'\*\*并选择 **Add**
   ![应用程序添加菜单](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-11.41.43-1.png)2.添加 app 或选择要变现的现有 app。

   ![添加或选择现有 app](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-11.44.44.png)

## 步骤 3.在 LevelPlay Network Setup 模块中激活 Pangle

通过 Unity LevelPlay 为 Pangle 提供广告服务从未如此简单。在 LevelPlay SDK Networks 设置页面上设置 Pangle 时，请登录 Pangle 帐户，然后插入所有必要的参数以运行 Pangle Interstitials 和奖励广告服务。

![Pangle 帐户设置](/api/media?file=/grow/media/images/Screen-Shot-2022-06-19-at-15.43.14.png)

### app 设置

![Pangle app 设置](/api/media?file=/grow/media/images/4-1.png)
您需要将 Pangle 帐户中的参数输入 LevelPlay Network Setup 模块，以便 Pangle 能够与 LevelPlay 连接：

| 用户 ID              | 在 Pangle 后台上分配给用户的唯一 ID。                                  |
| ------------------ | --------------------------------------------------------- |
| **API 密钥**         | **Pangle 生成的\*\*\*\*用于报告 API 的密钥（在 Pangle 平台中称为 API 密钥）** |
| **Application ID** | 分配给 app **的唯一 ID，位于** **Pangle 的\*\*\*\*后台上。**            |
| **Placement ID**   | **分配给您在 Pangle **后台**上创建的广告的唯一 ID。**                      |

获取此信息后，在 LevelPlay 帐户中**配置 Pangle 的参数**。通过正确添加上述信息，您将能够充分利用 Pangle 在 LevelPlay 平台上的广告库存和报告数据。

### 用户 ID

登录 Pangle 帐户后，您可以在控制面板的右上角找到 User ID

![用户 ID 位置](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-11.50.01.png)

### API 密钥

![API 密钥位置](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-12.26.08.png)

### 应用程序 ID

在 **Pangle** Dashboard（面板）中创建应用程序后（如步骤 2 中所述），将在 **Apps（应用**程序）下找到**应用程序 ID**（悬停 **Applications**\*\*'\*\* 并选择 **Apps**）。
![应用程序 ID 位置](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-12.31.29.png)

### Placement ID

在 **Pangle**（角度）后台中创建应用程序后，需要包含广告服务。将鼠标悬停在**应用程序\*\*\*\*'**上，然后选择 **Ad placements****'**。手动添加放置/位置或选择现有放置/位置以获取其放置/位置 ID。
![放置/位置 ID 位置](/api/media?file=/grow/media/images/Screen-Shot-2022-03-17-at-12.33.26.png)

## 步骤 4.将 Pangle 适配器添加到构建中##step-4.-add-the-pangle-adapter-to-your-build

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

### Gradle##gradle

1. 确保 app 模块的构建.gradle 脚本中存在以下 Maven 网址。

```groovy
repositories {
   mavenCentral()
   maven {
      url 'https://artifact.bytedance.com/repository/pangle'
   }
}
```

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

```groovy
dependencies {
   implementation 'com.unity3d.ads-mediation:pangle-adapter:5.10.0'
   implementation 'com.pangle.global:pag-sdk:7.9.0.9'
}
```

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

1. **下载 Pangle Adapter 和 SDK：**
   将 Pangle Adapter 和 SDK 添加到构建中。您可以在[此处](/grow/levelplay/sdk/android/mediation-networks.md)找到最新的 Pangle 文件。

2. **将 Pangle Adapter 添加到项目中：**
   下载适配器和 SDK 后，将 Pangle 文件放入 Android 项目的 **libs** 文件夹。

   ![将适配器 JAR 文件拖放到 Android 项目的 libs 文件夹中。](/api/media?file=/grow/media/images/Supersonic-Mediation-Drop-Libs.png)

3. 确保在 Gradle 构建文件的 **dependencies** 部分下添加以下内容：

```groovy
dependencies {
   implementation 'com.unity3d.ads-mediation:pangle-adapter:5.10.0'
   implementation 'com.pangle.global:pag-sdk:7.9.0.9'
}
```

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

如果要将 ProGuard 与 Pangle 适配器结合使用，必须将以下代码添加 ProGuard 文件中：

```text
-keep 类 com.bytedance.SDK。** { *; }
```

## 步骤 5。更新 AndroidManifest.xml##step-5.-update-androidmanifest.xml

从 Pangle Android 适配器版本 4.1.1 +（Android SDK 版本 6.17.0）开始，Pangle 适配器将以 AAR 形式发布。如果您打算保持 Jar 集成，请添加清单。

**清单权限：**

```xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
```

## 步骤 6。Pangle 附加设置##step-6.-pangle-additional-settings

### 设置 COPPA##set-coppa

Unity LevelPlay 平台允许发布者将 Pangle COPPA 设置直接传达给 Pangle 网络。此功能是使用 LevelPlay SDK 6.17.0+、Pangle Android Adapter 4.1.2+ 已启用的。

使用以下语语法 Pangle COPPA 设置为值 1 以报告 Child：

```java
LevelPlay.setMetaData("Pangle_COPPA","1");
```

使用以语法 Pangle COPPA 设置为值 0，以报告成人：

```java
LevelPlay.setMetaData("Pangle_COPPA","0");
```

要验证 IronSource 和其他广告网络的集成情况，请遵循本[文档](/grow/levelplay/sdk/unity/integration-helper.md.md)。

现在可以在应用程序中交付 Pangle。
