# APS 迁移指南

> 使用 LevelPlay for Unity 迁移到 APS 广告单位 API，将广告单位 API 用于现有的 APS 集成。

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

本指南提供了有关将 Amazon Publisher 服务 (APS) 网络与 LevelPlay 集成的分步说明，其中将 Ad 单位 API 用于现有的 APS 集成。

## 先决条件

SDK 最低版本：9.0.0+

## 验证并下载 APS 配置

> **Note:**
>
> 在下载 CSV 文件之前，请对配置进行任何必要的更改。您可以随时返回到 APS 帐户以进行进一步更改。

1. 转到 APS 帐户。
2. 下载相关应用程序的 CSV 配置文件。

## 更新 LevelPlay 平台上的 APS 设置

1. 转到 LevelPlay 平台中 app 的实例页面。
2. 通过上传 CSV 配置文件来更新 APS 设置。
3. 选择 **Replace**（替换）。

APS app 设置页面界面将刷新。

## 在 LevelPlay 控制面板中更新 APS 数据

某些 APS 数据字段会自动填充。但是，必须手动执行以下步骤：

1. 为每个字段名称填写以下字段：

* UUID
* APS 格式
* 大小

> **Note:**
>
> 要获取此信息，请参阅 [APS 站点](https://ams.amazon.com/webpublisher/mdtb/mobile_apps#/apps/integration)。

2. 选择 **保存**。

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

## 导入 APS Unity 插件##import-the-aps-unity-plugin

1. 从 [APS 网站](https://ams.amazon.com/webpublisher/uam/docs/aps-mobile/unity)下载 APS Unity 插件。
2. 确保 Unity 项目已打开，然后导入软件包。
3. 在 Unity 菜单中，选择 **Amazon** > **Manage SDKs**。
4. 安装 ironSource 适配器并导入 Unity 软件包。

## 添加 APS 适配器##add-the-aps-adapter

完成 SDK 集成后，请使用 Unity Network Manager 添加 APS 适配器。

在 Unity 开发平台中，转到 **广告服务聚合** > **Integration Manager**。

> **Note:**
>
> 如果您已经有最新版本的适配器，则操作按钮显示为 **Updated** 并已禁用。

## Init APS SDK##init-aps-sdk

APS 网络要求初始化 ironSource 和 APS SDK 以显示 APS 广告服务。

在打开应用程序后以及在初始化 LevelPlay SDK 之前，立即初始化 APS SDK。使用在 APS 设置期间定义的 APS app ID。

```cs
Amazon.Initialize(amazonApiKey);
```

有关集成的更多详细信息，请参阅 [APS Resources for Unity](https://ams.amazon.com/webpublisher/uam/docs/aps-mobile/unity)。

## 删除先前加载逻辑##remove-prior-load-logic

此适配器不再需要与 LevelPlay 聚合共享 APS 出价信息。删除以下代码：

* 在每个广告单元加载之前加载 APS 广告请求。
* 调用 `setNetworkData` 与 LevelPlay 共享 APS 出价信息。

## 构建问题故障排除##troubleshooting-build-issues

### Android##android

如果 Android 构建中不存在 APS 适配器，请将 Maven 网址添加到 `dependencyResolutionManagement` 下的 `settings.gradle` 文件：

```java
dependencyResolutionManagement {
   repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
   repositories {
   google()
   mavenCentral()
   maven {
      url "https://s3.amazonaws.com/ssa.public/ironsource-mobile/android-adapters"
   }
}
```

### iOS##ios

为 iOS 构构建时，请确保目标最低 iOS 版本设置为 12.0。