# VK Ad Network 集成

> 将 VK Ad Network 集成到 Unity LevelPlay 中，通过定向广告服务增强Monetization能力，确保广告在app中顺利投放。

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

本指南将逐步说明如何在 Unity LevelPlay 上将 VK Ad Network Live 设置为广告网络。

> **Note:**
>
> 在新的 VK 广告网络中，*帐户放置/位置 ID = Slot ID 参数*

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

## 先决条件##prerequisites

所需的 Gradle 构建具为 3.5.4+

## 步骤 1.创建 VK Ad Network 帐户

1. 要在 VK Ad Network 中创建帐户，请转到[此处](https://ads.vk.com/hq/registration/partner)。
2.验证您的帐户后，在[此处](https://ads.vk.com/hq/registration/partner/new)登录您的合作伙伴帐户。

## 步骤 2.在 VK Ad Network 中创建应用程序

按照以下步骤创建 VK Ad Network 应用程序：

1. 在您的 VK Ad Network 帐户中，转到 **Apps > 添加 app**

   ![VK 添加 app](/api/media?file=/grow/media/images/vk-6D-46B9A4.png)

2. 设置新 app 后，您可以检索“放置/位置 ID” - 以便在 Unity LevelPlay 中进行设置。

   ![VK 放置/位置 ID](/api/media?file=/grow/media/images/vk-1F-DF2610.png)

## 步骤 3.获取 VK Ad Network Access 密钥

在您的 VK Ad Network 帐户中，转到 **设置 > 常规**
![VK 访问密钥设置](/api/media?file=/grow/media/images/vk-A8-D44B0E.png)

## 步骤 4.在聚合设置模块中激活 VK Ad Network

在 ironSource 平台中，访问 SDK Networks 设置以将 myTarget 参数配置为 LevelPlay 帐户。

1. 获得所有所需参数后，登录 LevelPlay 帐户，然后转到 **Monetize > Setup > SDK > Networks**。

   ![VK SDK Networks 页面](/api/media?file=/grow/media/images/vk-4A-BCD760.png)

2. 从 **Available Networks** 的表中选择 myTarget，添加参数，然后选择 **Activate**。然后选择 **保存**。

   ![VK 激活网络](/api/media?file=/grow/media/images/vk-F3-2F1BBC.png)

3. 从广告网络列表中选择 myTarget，然后选择 **Setup**。

   ![VK 设置按钮](/api/media?file=/grow/media/images/vk-81-DDFD22.png)

4. 输入 VK Ad Networkd app程序的“Generated token”，然后为每个广告单元添加两次步骤 1（点 2）中的“ID”。将状态设置为 **激活** 并选择 **保存**。在 Setup（设置）后台上，您将看到 myTarget 列为 **Active** for Mediation（激活聚合）。

## 步骤 5。集成 LevelPlay 聚合网络适配器##step-5.-integrate-the-levelplay-mediation-network-adapters

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

### Gradle##gradle

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

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

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

```groovy
dependencies {
      implementation 'com.unity3d.ads-mediation:mytarget-adapter:5.2.0'
      implementation 'com.my.target:mytarget-sdk:5.27.2'
}
```

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

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

2. 将 VK Ad Network Adapter 和 SDK 添加 Android 项目中。下载适配器后，将 VK Ad Network 适配器 AAR 放入 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:mytarget-adapter:5.2.0'
      implementation 'com.my.target:mytarget-sdk:5.27.2'
}
```

4. 将 SDK AAR 添加到项目中。
   1. 如果使用 Eclipse：将 .AAR 文件作为库项目导入。
   2. 如果使用 Android Studio，请下载 VK Ad Network .AAR 文件并作为依赖项添加到您自己的模块。转到**文件** > **New** > **New Module** > **Import .AAR**，然后导航到 VK Ad Network .AAR 文件的下载位置。

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

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

```text
-keep class com.my.target.** {*;}
```

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

### 清单权限##manifest-permissions

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

### 清单活动##manifest-activities

在**清单**的 `<application>` 标签中添加以下活动：

```xml
<activity
    android:name="com.my.target.common.MyTargetActivity"
    Android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" />
```

您现在可以在应用程序中投放 VK Ad Network 广告服务。

## 后续步骤##next-steps

要通过 LevelPlay Mediation 利用其他广告网络，请集成[适配器](/grow/levelplay/sdk/unity/mediation-networks.md.md)，然后遵循我们的集成指南。