# APS インテグレーション

> APSアカウントを設定し、LevelPlayとのインテグレーションを設定することで、Amazonパブリッシャー サービス (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

APS Adapter 5.0.0 for Android は、範囲の依存関係によって APS Android SDK を統合するように設計されています。9.8 以降の依存関係を使用すると、新しい LevelPlay アダプタを組み込むことなく、将来の APS Android SDK(9.8.8 未満)に自動的に統合できます。

## APS アカウントの作成##create-an-aps-account

1. APS に連絡してアプリケーションのアカウントを設定します。APS アカウントを作成するには、[APS Web サイト](https://aps.amazon.com/aps/contact-us/)に移動し、**接触**を選択してリクエストを開きます。
2. APS リクエストが承認されると、サインアップして APS でアカウントを作成するための招待リンクが送られてきます。
3. LevelPlay で APS を設定する前に、上記の手順を完了する必要があります。

## APS ネットワークにスロットを設定する##set-up-your-slots-in-aps-network

1. **Apps** メニューから適切なアプリケーションを選択し、**設定**を選択します。
2. Monetization サービスの設定メニューで LevelPlay を選択します。
3. スロットを追加し、各スロットに定義します。 ：
   * 名前
   * 広告サイズ
   * 価格(自動/手動)
4. すべてのスロットの追加を完了し、認証情報を取得します。
   1. App IDの取得
   2. 価格帯の CSV ファイルをダウンロードします。

## APS ネットワークワークのアクティベート##activate-aps-network

LevelPlay プラットフォーム内で、SDK Networks 設定にアクセスして、LevelPlay アカウントに APS パラメータを設定します。

1. 上記の認証情報を取得したら、LevelPlay アカウントにログインし、**Monetize** (収益化)> **設定**> **SDK Networks** に移動します。
2. Available Networks のテーブルから APS を選択し、**アクティベート**を選択します。
3. 広告ネットワークのリストから APS を選択し、**設定** を選択します。
4. APS App ID を入力し、CSV ファイルをそのままアップロードします。
5. APS アプリケーション設定ページのインターフェースが更新されます。

## LevelPlay ダッシュボードで APS データを更新する##update-aps-data-in-levelplay-dashboard

* 「スロット名」、「価格」、「サイズ」の各フィールドは自動的に入力されます。
* 各スロット名の以下のフィールドに入力します。
  * UUID
  * APS 形式
  * サイズ
* この情報を取得するには、[APS サイト](https://ams.amazon.com/webpublisher/mdtb/mobile_apps#/apps/integration)を参照する必要があります。
* UUID、APS 形式、およびサイズのフィールドに入力したら、**SAVE** を選択します。

## APS アダプタをビルドに追加する##add-the-aps-adapter-to-your-build

### Gradle##gradle

1. アプリケーションモジュールの ビルド.gradle スクリプトに以下の Maven URL が存在することを確認します。

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

2. アダプターの Maven 名をアプリケーションモジュールの ビルド.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

APS アダプタで ProGuard を使用している場合は、ProGuard ファイルに以下のコードを追加する必要があります。

```text
-keep class com.amazon.device.ads.** { *; }
```

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

APS ネットワークワークでは、APS 広告をディスプレイするために Ironsource SDK と APS SDK の両方を初期化する必要があります。

アプリケーションを開いた後、LevelPlay SDK を初期化する前に APS SDK を初期化します。APS 設定のステップ 2 で定義した APS App ID を使用します。

1. **Java**

   ```java
   AdRegistration.getInstance(APS_アプリケーション_ID, this);
   //'this' はアクティビティコンテキストです。
   ```

2. **Kotlin**

   ```kotlin
   AdRegistration.getInstance(APS_アプリケーション ID, this)
   //'this' はアクティビティコンテキストです。
   ```

## 詳細設定##advanced-settings

### 米国プライバシーコンプライアンス##us-privacy-compliance

LevelPlay のメディエーションプラットフォームを使用すると、パブリッシャーは、カリフォルニア州プライバシー権法 (CPRA) などの米国州プライバシー法の下で、エンドユーザーの個人情報の販売や共有を制限できます。この特徴は、LevelPlay SDK 8.4.0 以降と APS Android アダプターバージョン 5.1.0 以降を使用して有効化されます。

詳細については、[規制の詳細設定](../../regulation-advanced-settings) を参照してください。

これで、アプリケーション内でAPSの需要を満たす準備が整いました。