> ## Documentation Index
> Fetch the complete documentation index at: https://guide.daro.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 마이그레이션 가이드

> 2.0.0 미만의 레거시 SDK에서 DARO 2.0 SDK로 전환하는 순서와 확인 사항을 안내합니다.

성능, 수익 최적화, 디맨드, 용량, 보안, 안정성의 여섯 가지 개선 사항은 [DARO 2.0 SDK 소개](/ko/new-daro-sdk/overview)에서 확인하세요.

2.0.0 미만의 레거시 SDK를 사용 중이라면 **대시보드 업데이트 → Integration Key 확인 → SDK 업데이트** 순서로 진행하세요.

## 시작하기 전에

[DARO 대시보드](https://dashboard.daro.so)에서 **업데이트 시작하기**를 선택해 대시보드 업데이트를 먼저 완료하세요. 앱별 Integration Key와 사용 중인 애드유닛의 Ad Unit Key를 확인합니다. Android와 iOS를 모두 지원하는 앱은 플랫폼별 키를 각각 확인하세요.

대시보드가 업데이트되어도 현재 배포된 앱의 SDK는 유지됩니다. 새 SDK가 포함된 앱을 빌드하고 배포해야 전환이 완료됩니다.

## 애드유닛 호환성

| SDK | 기존 애드유닛 | 신규 애드유닛 |
| - | - | - |
| 레거시 SDK (2.0.0 미만) | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> 사용 가능</span> | <span className="font-semibold text-red-700 dark:text-red-400"><span aria-hidden="true">×</span> 사용 불가</span> |
| DARO 2.0 SDK | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> 사용 가능</span> | <span className="font-semibold text-green-700 dark:text-green-400"><span aria-hidden="true">✓</span> 사용 가능</span> |

기존 애드유닛은 새로 발급받지 않고 사용할 수 있습니다. 다만 SDK 설정과 API 변경 사항은 반영해야 합니다. 레거시 SDK (2.0.0 미만)의 사용 가능 기간은 [지원 계획](/ko/new-daro-sdk/legacy-support)을 확인하세요.

## 마이그레이션 절차

<Steps>
  <Step title="대시보드 업데이트">
    대시보드 업데이트를 완료하고, 전환할 앱과 애드유닛을 확인하세요.
  </Step>

  <Step title="기존 키 파일과 설정 제거">
    Android의 `daro-key.txt` 또는 `android-daro-key.txt`, iOS의 `ios-daro-key.txt`와 해당 파일을 사용하는 기존 연동 설정을 제거하세요. 구체적인 제거 대상은 플랫폼별 가이드를 따르세요.
  </Step>

  <Step title="DARO 연동 도구 설정">
    플랫폼별 가이드에 따라 DARO 플러그인 또는 연동 도구를 설치하고 적용하세요. 기존 플러그인을 사용 중인 경우 새 SDK에 맞게 업데이트합니다.
  </Step>

  <Step title="Integration Key 및 앱 설정">
    대시보드에서 확인한 Integration Key를 프로젝트에 등록하세요. Android와 iOS의 설정 위치가 다르므로 해당 플랫폼의 예제를 사용하세요.
  </Step>

  <Step title="app-ads.txt 업데이트">
    대시보드에서 안내하는 최신 app-ads.txt 항목을 개발자 웹사이트에 반영하세요. 게시 위치와 확인 방법은 [app-ads.txt 설정 가이드](/ko/app-ads-txt-settings)를 참고하세요.
  </Step>

  <Step title="SDK 업데이트 및 앱 배포">
    아래 플랫폼별 가이드에 따라 SDK를 업데이트하고, 초기화와 사용 중인 광고 포맷의 연동 코드를 확인하세요. 광고 로드·표시·콜백을 확인한 뒤 앱을 배포합니다.
  </Step>
</Steps>

## 플랫폼별 가이드

| 플랫폼 | 업데이트 절차 |
| - | - |
| Android | [Android 마이그레이션 가이드](/ko/sdk-integration-v2/android/migration-guide) |
| iOS | [iOS 마이그레이션](/ko/sdk-integration-v2/ios_new/migration-guide) |
| React Native | [React Native 마이그레이션](/ko/sdk-integration-v2/react-native/migration-guide) |
| Flutter | [Flutter 마이그레이션](/ko/sdk-integration-v2/flutter/migration-guide) |
| Unity | [Unity SDK 설치 및 설정](/ko/sdk-integration-v2/unity/get-started) |

## 배포 전 확인

* 기존 키 파일과 2.0.0 미만의 레거시 SDK 설정을 정리하고 Integration Key를 등록했는지 확인하세요.
* app-ads.txt에 최신 항목이 반영되었는지 확인하세요.
* SDK 초기화가 완료된 후 광고를 요청하는지 확인하세요.
* 사용 중인 광고 포맷에서 로드·표시·닫기 등 필요한 콜백이 동작하는지 확인하세요. 리워드 비디오 광고는 보상 지급도 확인하세요.
* 기존 애드유닛과 새로 추가한 애드유닛을 각각 확인하세요.

전환 중 도움이 필요하면 [DARO 지원팀](mailto:cs@daro.so)에 문의하세요.

## 이전 연동 방법 확인하기

* 레거시 SDK 통합하기 가이드는 레거시 SDK 지원 기간 동안 함께 제공됩니다. 자세한 일정은 [레거시 SDK 지원 계획](/ko/new-daro-sdk/legacy-support#지원-일정)을 참고하세요.
* 2.0.0 미만의 레거시 SDK 설정은 플랫폼별 가이드에서 확인할 수 있습니다: [Android](/ko/sdk-integration/android/get-started) · [iOS](/ko/sdk-integration/ios_new/get-started) · [React Native](/ko/sdk-integration/react-native/get-started) · [Flutter](/ko/sdk-integration/flutter/get-started).
