# APS 마이그레이션 가이드

> Unity 레벨플레이 사용하여 기존 APS 통합에 광고 유닛 API를 활용하여 APS 광고 유닛 API로 마이그레이션합니다.

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

이 가이드는 기존 APS 통합에 광고 유닛 API를 활용하여 Amazon 퍼블리셔 서비스(APS) 네트워크를 레벨플레이 연동하는 방법에 대한 단계별 지침을 제공합니다.

## 필수 조건

최소 SDK 버전: 9.0.0+

## APS 설정 확인 및 다운로드

> **Note:**
>
> CSV 파일을 다운로드 전에 설정 변경해야 합니다. 언제든지 APS 계정으로 돌아가서 추가 변경 사항을 적용할 수 있습니다.

1. APS 계정으로 이동합니다.
2. 관련 애플리케이션 CSV 설정 파일을 다운로드.

## 레벨플레이 플랫폼에서 APS 설정을 업데이트합니다.

1. 레벨플레이 플랫폼에서 앱의 인스턴스 페이지로 이동합니다.
2. CSV 설정 파일을 업로드하여 APS 설정을 업데이트합니다.
3. **대체**를 선택합니다.

APS 앱 설정 페이지 인터페이스 새로 고침됩니다.

## 레벨플레이 대시보드에서 APS 데이터 업데이트

일부 APS 데이터 필드는 자동으로 채워집니다. 하지만 다음 단계를 수동으로 수행해야 합니다.

1. 각 슬롯 이름에 대해 다음 필드를 작성합니다.

* UUID
* APS 포맷
* Size

> **Note:**
>
> 이 정보를 확인하려면 [APS 사이트](https://ams.amazon.com/webpublisher/mdtb/mobile_apps#/apps/integration)를 참조하십시오.

2. **저장**을 선택합니다.

> **Note:**
>
> 이 Mediation 네트워크의 어댑터 변경 기록을 보려면 [Unity용 Mediation 네트워크](/grow/levelplay/sdk/unity/mediation-networks.md.md#integrate-network-adapters)를 참조하십시오.

## APS Unity 플러그인 임포트##import-the-aps-unity-plugin

1. APS Unity 플러그인을 [APS 웹사이트](https://ams.amazon.com/webpublisher/uam/docs/aps-mobile/unity)에서 다운로드합니다.
2. Unity 프로젝트 열려 있는지 확인한 다음 패키지를 임포트.
3. Unity 메뉴에서 **Amazon** > **Manage SDKs**를 선택합니다.
4. Ironsource 어댑터 설치하고 Unity 패키지를 임포트.

## APS 어댑터 추가##add-the-aps-adapter

SDK 연동이 완료되면 Unity 네트워크 관리자 사용하여 APS 어댑터 추가합니다.

Unity 개발 플랫폼에서 **Ads Mediation** > **Integration Manager**로 이동합니다.

> **Note:**
>
> 이미 최신 버전의 어댑터가 있는 경우 행동 버튼이 **Updated**로 표시되고 비활성화됩니다.

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

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

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

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

통합에 대한 자세한 내용은 Unity용 [APS 리소스](https://ams.amazon.com/webpublisher/uam/docs/aps-mobile/unity)를 참조하십시오.

## 이전 로드 로직 제거##remove-prior-load-logic

이 어댑터 더 이상 레벨플레이 Mediation APS 단가 정보를 공유할 필요가 없습니다. 다음 코드를 제거합니다.

* 각 광고 유닛 로드 전에 APS 광고 요청의 로딩입니다.
* 레벨플레이와 APS 단가 정보를 공유하려는 `setNetworkData`의 호출입니다.

## 빌드 문제 해결##troubleshooting-build-issues

### Android##android

Android 빌드에 APS 어댑터가 없는 경우 `dependencyResolutionManagement` 아래의 `settings.gradle` 파일에 Maven URL을 추가합니다.

```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이어야 합니다.