# APS 集成

> 通过配置 APS 帐户并设置与 LevelPlay 的集成，将 Amazon Publisher Services (APS)与 Unity LevelPlay 集成。

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

> **Note:**
>
> Amazon 发布者服务 (APS) 是一个仅限邀请的计划。要集成 APS，您需要初始化 LevelPlay SDK 和 APS SDK。确保执行以下详细说明的完整集成流程，以便在应用程序中显示 APS 广告服务。
>
> 本指南适用于 LevelPlay SDK 9.0.0 及更高版本。有关旧版本（8.0.0 和更高版本），请参阅[这篇文章](aps)。

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

## 支持 APS Android SDK 范围##supporting-aps-android-sdk-range

Android APS 适配器 5.0.0 旨在通过范围依赖项集成 APS Android SDK。通过使用 9.8+ 依赖项，无需集成新的 LevelPlay 适配器，即可自动集成到任何未来的 APS Android SDK（小于 9.8.8）。

## 创建 APS 帐户##create-an-aps-account

1. 联系 APS 以设置app程序的帐户。要创建 APS 帐户，请访问 [APS 网站](https://aps.amazon.com/aps/contact-us/)，选择 **Contact us**，然后发出请求。
2. 如果您的 APS 请求获得批准，您将收到一个邀请链接，用于在 APS 中注册和创建帐户。
3. 在 LevelPlay 中设置 APS 之前，必须完成上述步骤。

## 在 APS 网络中设置席位##set-up-your-slots-in-aps-network

1. 从 **Apps** 菜单中选择正确的应用程序，然后选择 **Setup**。
2. 选择 LevelPlay 作为 Monetization 服务设置菜单
3. 添加字段并为每个字段定义：
   * Name（名称）
   * 广告大小
   * 价格点（自动/手动）
4. 完成添加所有字段并获取凭据：
   1. 获取 app ID
   2. 下载价格点 CSV 文件。

## 激活 APS 网络##activate-aps-network

在 LevelPlay 平台中，访问 SDK Networks 设置以将 APS 参数配置到您的 LevelPlay 帐户中。

1. 拥有上述凭据后，登录 LevelPlay 帐户，然后选择 **Monetize** > **Setup** > **SDK Networks**。
2. 从 Available Networks 的表中选择 APS，然后选择 **Activate**
3. 从广告网络列表中选择 APS，然后选择 **Setup**。
4. 输入您的 APS app ID 并按原样上传 CSV 文件。
5. APS app 设置页面界面将刷新。

## 在 LevelPlay 控制面板中更新 APS 数据##update-aps-data-in-levelplay-dashboard

* 请注意，系统会自动填充“Slot Name”、“Price Points”和“大小”字段。
* 为每个字段名称填写以下字段：
  * UUID
  * APS 格式
  * 大小
* 您可能需要参阅 [APS 网站](https://ams.amazon.com/webpublisher/mdtb/mobile_apps#/apps/integration)以获取此信息。
* 填写 UUID、APS Format 和 Size 字段后，选择 **Save**。

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

### Gradle##gradle

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

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

2. 将适配器的 Maven 名称添加到 app 模块的构建.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'
   }
   ```

## 更新 AndroidManifest.xml##update-androidmanifest.xml

1. **Manifest Permissions**

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

2. **Manifest Activities**

   ```xml
   <activity android:name="com.amazon.device.ads.DTBInterstitialActivity"/>
   <activity android:name="com.amazon.device.ads.DTBAdActivity"/>
   ```

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

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

```text
- 保留类 com.amazon.device.广告服务。** { *; }
```

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

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

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

1. **Java**

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

2. **Kotlin**

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

## 高级设置##advanced-settings

### 美国隐私合规性##us-privacy-compliance

LevelPlay 的聚合平台允许发行商根据美国各州隐私法（例如加利福尼亚州隐私权法 (CPRA)）限制销售或共享终端用户的个人信息。此功能是使用 LevelPlay SDK 8.4.0 及更高版本以及 APS Android 适配器 5.1.0 及更高版本已启用的。

有关更多信息，请参阅[法规高级设置](../../regulation-advanced-settings)。

您现在可以在应用程序中交付 APS 需求。