# APS 迁移指南

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

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

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

本指南提供了有关将 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. 选择 **保存**。

## 将 APS 适配器添加到构建中##add-the-aps-adapter-to-your-build

1. 确保 app 模块的`build.gradle`脚本中存在以下 Maven 网址：

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

2. 将适配器的 Maven 名称添加到 app 模块的`build.gradle`脚本：

```groovy
dependencies {
    implementation 'com.unity3d.ads-mediation:aps-adapter:5.0.0'
    implementation 'com.amazon.android:aps-sdk:11.1.0+'
    implementation 'com.iabtcf:iabtcf-decoder:2.0.10'
}
```

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

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

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

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

1. **Java**

   ```java
   AdRegistration.getInstance(APS_app_ID, this);
   //其中“this”是活动上下文。
   ```

2. **Kotlin**

   ```kotlin
   AdRegistration.getInstance(APS_app_ID, this)
   //其中“this”是活动上下文。
   ```

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

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

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