# APS 연동

> APS 계정을 구성하고 레벨플레이와의 통합을 설정하여 Amazon 퍼블리셔 서비스 (APS)를 Unity 레벨플레이와 통합할 수 있습니다.

> **Important:**
>
> 다음 기술 자료는 Unity가 개발하거나, 소유하거나, 운영하지 않는 제품 또는 서비스('타사 제품')에 관한 내용입니다.
> 이 정보는 오래되었거나 불완전할 수 있으며 편의를 위해 제공됩니다.
> 타사 제품을 사용하는 경우 해당 제품의 약관이 적용됩니다.
> Unity는 이러한 제품에 대해 어떠한 보증도 하지 않으며, 타사 제공자의 콘텐츠, 광고 또는 머티리얼과 관련된 문제를 포함하여 제품 사용으로 인한 손해나 손실에 대해서도 책임지지 않습니다.

> **Note:**
>
> Amazon 퍼블리셔 서비스(APS)는 초대만 프로그램입니다. APS를 연동하려면 레벨플레이 SDK와 APS SDK를 모두 초기화해야 합니다. 아래에 설명된 대로 전체 연동 플로를 수행하여 애플리케이션 APS 광고를 표시해야 합니다.
>
> 이 가이드는 레벨플레이 SDK 버전 9.0.0 이상에 적용됩니다. 레거시 버전(8.0.0 이상)은 [이 문서](aps)를 참조하십시오.

> **Note:**
>
> 이 Mediation 네트워크의 어댑터 변경 기록을 보려면 [Android용 Mediation 네트워크](/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 이상의 종속성을 사용하면 새 레벨플레이 어댑터 통합하지 않고도 향후 모든 APS Android SDK9.8.8 미만)에 자동으로 통합할 수 있습니다.

## APS 계정 생성##create-an-aps-account

1. 앱 계정을 설정하려면 APS에 도달률. APS 계정을 생성하려면 [APS 웹사이트](https://aps.amazon.com/aps/contact-us/)로 이동한 다음 \*\* 문의하기\*\*를 선택하고 요청을 엽니다.
2. APS 요청이 승인되면 APS에 가입하고 계정을 생성할 수 있는 초대 링크가 표시됩니다.
3. 레벨플레이 APS를 설정하려면 위 단계를 완료해야 합니다.

## APS 네트워크에서 슬롯 설정##set-up-your-slots-in-aps-network

1. **앱** 메뉴에서 올바른 애플리케이션을 선택하고 **설정**을 선택합니다.
2. 수익화 서비스 설정 메뉴로 레벨플레이 선택합니다.
3. 각 슬롯에 슬롯을 추가하고 정의합니다.
   * 이름
   * 광고 크기
   * 가격 지점 (자동/매뉴얼)
4. 모든 슬롯을 추가하고 자격 증명을 수집합니다.
   1. 앱 ID 가져오기
   2. 가격대 CSV 파일을 다운로드.

## APS 네트워크 활성화##activate-aps-network

레벨플레이 플랫폼 내에서 SDK 네트워크 설정에 액세스, 접근 레벨플레이 계정에 APS 파라미터를 설정.

1. 위에서 언급한 자격 증명이 있으면 레벨플레이 계정에 로그인하고 **수익화** > **설정** > **SDK 네트워크**로 이동합니다.
2. 사용 가능한 네트워크 표에서 APS를 선택하고 **활성화**를 선택합니다.
3. 광고 네트워크 목록에서 APS를 선택하고 **설정**을 선택합니다.
4. APS 앱 ID를 입력하고 CSV 파일을 그대로 업로드합니다.
5. APS 앱 설정 페이지 인터페이스 새로 고침됩니다.

## 레벨플레이 대시보드에서 APS 데이터 업데이트##update-aps-data-in-levelplay-dashboard

* 참고로 "슬롯 이름", "가격 지점" 및 "크기" 필드는 자동으로 채워집니다.
* 각 슬롯 이름에 대해 다음 필드를 입력합니다.
  * UUID
  * APS 포맷
  * Size
* 이 정보를 얻으려면 [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. 앱 모듈의 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

ProGuard를 APS 어댑터와 함께 사용하는 경우 다음 코드를 ProGuard 파일에 추가해야 합니다.

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

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

APS 네트워크를 사용하려면 APS 광고를 표시하려면 Ironsource 및 APS SDK를 모두 초기화해야 합니다.

애플리케이션 열리자마자 그리고 레벨플레이 SDK를 초기화하기 전에 APS SDK를 초기화합니다. APS 설정 2단계에 정의된 APS 앱 ID를 사용합니다.

1. **Java**

   ```java
   AdRegistration.getInstance(APS_APP_ID, 이);
   //여기서 'this'는 활동 컨텍스트.
   ```

2. **Kotlin**

   ```kotlin
   AdRegistration.getInstance(APS_APP_ID, 이)
   //여기서 'this'는 활동 컨텍스트.
   ```

## 고급 설정##advanced-settings

### 미국 개인정보 보호 규정 준수##us-privacy-compliance

레벨플레이 Mediation 플랫폼을 사용하면 퍼블리셔가 CPRA(캘리포니아 개인정보 보호 권리법)와 같은 미국 주 개인정보 보호법에 따라 최종 사용자의 개인정보를 판매하거나 공유할 수 있습니다. 이 기능은 레벨플레이 SDK 8.4.0 이상과 APS Android 어댑터 버전 5.1.0 이상을 사용하여 활성화된, 사용 가능한 수 있습니다.

자세한 내용은 [규정 고급 설정](../../regulation-advanced-settings)을 참조하십시오.

이제 애플리케이션 내에서 APS 수요를 제공할 준비가 되었습니다.