# AppLovin 集成

> 通过设置网络参数并将 AppLovin 适配器添加到构建中，将 AppLovin 作为广告网络集成到 Unity LevelPlay 中。

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

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

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

## 先决条件##prerequisites

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

**Integration guides:**

* [奖励广告服务](/grow/levelplay/sdk/ios/rewarded-ads-integration.md)
* [插屏广告](/grow/levelplay/sdk/ios/interstitial-integration.md)
* [横幅广告](/grow/levelplay/sdk/ios/banner-integration.md)

## 步骤 1.创建 AppLovin 帐户

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

## 步骤 2.获取 AppLovin SDK 和报告密钥

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

* \*\*举报密钥：\*\*这是 AppLovin 帐户的唯一标识符，允许 Unity LevelPlay 从 AppLovin 帐户导入性能数据以用于报告和优化。
* \*\*SDK 密钥：\*\*这是 AppLovin 帐户的唯一标识符。LevelPlay Mediation SDK 使用此属性为应用程序初始化 AppLovin 适配器。

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

1. ### 报告密钥

   要查找 **Report Key**，请转到 **帐户** 选项卡并从左侧菜单中选择 **Keys**。

   ![帐户设置中的 AppLovin Report Key 位置](/api/media?file=/grow/media/images/SDK-Key-2.png)

2. ### SDK 密钥

   要查找 **SDK** **密钥**，请转到 **帐户** 选项卡并从左侧菜单中选择 **Keys**。

   ![帐户设置中的 AppLovin SDK 密钥位置](/api/media?file=/grow/media/images/SDK-Key-1.png)

## 步骤 3.在 LevelPlay 上激活 AppLovin

* 登录 LevelPlay 帐户，然后转到 **LevelPlay 侧导航栏** > **Setup** > **Networks**。

* 从 **Manage Networks** 页面上的可用广告网络列表中选择 AppLovin。然后在 Ad network setup（广告网络设置）页面上输入 Report Key（报告密钥），然后选择 **Save**（保存）。

  ![在 LevelPlay 中输入 AppLovin Report Key](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.28.49.png)

* 接下来，从左侧导航栏中转到 **Instances 页面**。在 **Instances 页面**顶部选择要使用 **AppLovin** 运行 Unity LevelPlay 的 Mediation 的应用程序。

* 从广告网络的设置列表中选择 Applovin。

  ![从网络列表中选择 AppLovin](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.34.46.png)

* 在 app 设置 页面上，插入在步骤 2 中检索的 SDK 密钥。然后，为要通过 Applovin 变现的每种广告格式（插页式、奖励广告服务和横幅广告）创建一个实例。选择您的首选广告格式，然后选择页面底部的 **Add instance**（添加实例）。输入所需的信息，然后选择 **保存**。

  ![添加 AppLovin 实例配置](/api/media?file=/grow/media/images/Screenshot-2024-12-12-at-15.35.49.png)

您的 app 现在正在通过 AppLovin 广告网络进行变现。

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

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

### Cocoapods##cocoapods

要将 AppLovin SDK 与 Cocoapods 集成，请在 Podfile 中输入以下行，即可开始使用！

```ruby
pod 'IronSourceAppLovinAdapter','5.4.0'
```

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

1. **启用 Xcode Flags：\*\*\*\*必须**添加 **-ObjC** 标志才能使 iOS 静态库（例如 AppLovin SDK）正常运行。要启用 **-ObjC** 标志，请单击项目设置，转到 **构建设置** 搜索其他链接器标志，然后添加 **-ObjC**。
2. \*\*将 AppLovin XCFrameworks 添加到项目中：\*\*下载适配器 (ISAppLovinAdapter.XCFramework) 和 SDK 文件后，将这两个 **XCframework** 文件放入 Xcode 项目。
3. \*\*下载 AppLovin 适配器：\*\*将 AppLovin 适配器和 SDK (XCFrameworks) 添加到构建中。您可以在[此处](/grow/levelplay/sdk/ios/mediation-networks.md)找到最新的 AppLovin 适配器

## 步骤 5。在 AppLovin 的 Admin 中配置奖励广告服务

将 AppLovin 适配器添加到构建后，需要在 AppLovin Admin 中启用奖励广告服务功能。

1. 在 AppLovin Admin 中，转到 **Manage Apps**，然后选择要配置的指定 app。

   ![AppLovin Manage Apps 屏幕](/api/media?file=/grow/media/images/apps.png)

2. 向下滚动到**奖励广告服务**部分并设置以下开关：
   1. **频率限制** - 不限制奖励广告服务的频率
   2. **虚拟货币详细信息** - Unity LevelPlay 聚合适配器将进行此设置，因此您可以保留默认值
   3. **显示预视频模式** - 否
   4. **显示后期视频模式** - 否
   5. **回调选项** - 仅限客户端回调
      ![AppLovin 奖励视频配置设置](/api/media?file=/grow/media/images/apps-1.png)

3. 完成后，点击“**保存**”

## 步骤 6。AppLovin 其他设置##step-6.-applovin-additional-settings

### 设置 Age Restriction##set-age-restriction

> **Note:**
>
> 从 AppLovin iOS SDK 13.0.0 和 AppLovin iOS 适配器 4.3.49 开始，不支持 AppLovin 年龄限制设置。

LevelPlay 的聚合平台允许发行商将 AppLovin 年龄限制设置直接传达给 AppLovin 网络。此功能是使用 LevelPlay SDK 6.17.0+、AppLovin iOS 适配器 4.3.15+ 已启用的。

使用以下语法，使用参数 true 设置 AppLovin setIsAgeRestrictedUser：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AppLovin_AgeRestrictedUser" value:@"YES"];
   ```

2. **Swift**

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

使用以下语法，使用参数 False 设置 AppLovin setIsAgeRestrictedUser：

1. **Objective-C**

   ```objective-c
   [LevelPlay setMetaDataWithKey:@"AppLovin_AgeRestrictedUser" value:@"NO"];
   ```

2. **Swift**

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

要了解有关 AppLovin 网络下年龄限制设置的更多信息，请访问[此处](https://dash.applovin.com/docs/integration#iosPrivacySettings)。

**验证您的广告网络集成**

* 验证您的广告网络与我们的 [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 及更高版本支持。 

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

## 后续步骤##next-steps

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