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

# 사전 준비

> 애드컨트롤 SDK 연동을 위한 사전 준비사항입니다.

## 준비 항목

SDK 연동을 위해 다음 정보가 필요합니다:

| 항목           | 설명          | 발급 위치    |
| ------------ | ----------- | -------- |
| **앱 ID**     | SDK 초기화에 사용 | 설정 > 앱   |
| **광고 유닛 ID** | 광고 요청에 사용   | 광고 유닛 메뉴 |

<Note>
  [광고 유닛 생성](/ko/ad-unit/create) 과정에서 앱을 함께 등록할 수 있습니다.
</Note>

<Note>
  아직 광고 플랫폼이 없다면, 콘솔 담당자에게 [플랫폼 생성](/ko/ad-platform/create)을 요청하세요.
</Note>

***

## 테스트 환경

테스트 환경을 설정하면 라이브 광고 캠페인이 없더라도 테스트 광고를 받을 수 있습니다. 아래 테스트용 키와 유닛 ID를 사용하세요.

### 테스트 App Key

<Tabs>
  <Tab title="Android">
    `adrop_service.json` 파일 내용:

    ```json theme={null}
    {"app_key":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6IjAxSEQ1UTNaOEdYTk5XRjQ2NENOV0NNQlM0OjAxSEQ1UTlER0IzUk40VlBUVlk5U0hYOTFCIiwia2V5VHlwZSI6MSwiaWF0IjoxNjk3Nzc4MDIxLCJleHAiOjI1MzQwMjEyODAwMH0.uPHxYjFNEJVMshF7mv9g5gUDRcaBOXaHviVYMhyggtc"}
    ```
  </Tab>

  <Tab title="iOS">
    `adrop_service.json` 파일 내용:

    ```json theme={null}
    {"app_key":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6IjAxSEQ1UTNaOEdYTk5XRjQ2NENOV0NNQlM0OjAxSEQ1UUJIWFNWNTk5U000MUU1VFlHQU1TIiwia2V5VHlwZSI6MSwiaWF0IjoxNjk3Nzc4MDkxLCJleHAiOjI1MzQwMjEyODAwMH0.5Lut-0y71-IB3fEo1srnX9EIc622kBat4nRRnsp5vsk"}
    ```
  </Tab>

  <Tab title="REST API">
    Authorization 헤더 값:

    ```
    eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6IjAxSEQ1UTNaOEdYTk5XRjQ2NENOV0NNQlM0OjAxSEZCTU1HRkZXUU5OMk5aVkpCNU5GUFZaIiwia2V5VHlwZSI6MSwiaWF0IjoxNzAwMTI0MDQ5LCJleHAiOjI1MzQwMjEyODAwMH0.J877rLr4xvUWqcEzsesEp_KNzO8XnHaJeESPXdABubQ
    ```
  </Tab>
</Tabs>

<Warning>
  플랫폼에 맞는 올바른 키를 사용하세요. Android와 iOS는 각각 다른 App Key가 필요합니다.
</Warning>

### 테스트 광고 유닛 ID

| 포맷         | 유닛 ID                              |
| ---------- | ---------------------------------- |
| 배너 320x50  | `PUBLIC_TEST_UNIT_ID_320_50`       |
| 배너 320x100 | `PUBLIC_TEST_UNIT_ID_320_100`      |
| 배너 300x250 | `PUBLIC_TEST_UNIT_ID_300_250`      |
| 캐러셀 배너     | `PUBLIC_TEST_UNIT_ID_CAROUSEL`     |
| 전면         | `PUBLIC_TEST_UNIT_ID_INTERSTITIAL` |
| 보상형        | `PUBLIC_TEST_UNIT_ID_REWARDED`     |
| 네이티브       | `PUBLIC_TEST_UNIT_ID_NATIVE`       |
| 팝업 (하단)    | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM` |
| 팝업 (중앙)    | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER` |
| 스플래시       | `PUBLIC_TEST_UNIT_ID_SPLASH`       |

### 비디오 광고 유닛 ID

| 포맷            | 유닛 ID                                   |
| ------------- | --------------------------------------- |
| 배너 비디오 16:9   | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_16_9` |
| 배너 비디오 9:16   | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_9_16` |
| 네이티브 비디오 16:9 | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_16_9` |
| 네이티브 비디오 9:16 | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_9_16` |
| 팝업 비디오 16:9   | `PUBLIC_TEST_UNIT_ID_POPUP_VIDEO_16_9`  |
| 팝업 비디오 9:16   | `PUBLIC_TEST_UNIT_ID_POPUP_VIDEO_9_16`  |

***

## 지원 플랫폼

<CardGroup cols={2}>
  <Card title="Android" icon="android" href="/ko/sdk/android/banner">
    Android SDK 연동 가이드
  </Card>

  <Card title="iOS" icon="apple" href="/ko/sdk/ios/banner">
    iOS SDK 연동 가이드
  </Card>

  <Card title="React Native" icon="react" href="/ko/sdk/react-native/banner">
    React Native SDK 연동 가이드
  </Card>

  <Card title="Flutter" icon="flutter" href="/ko/sdk/flutter">
    Flutter SDK 연동 가이드
  </Card>

  <Card title="Web" icon="globe" href="/ko/sdk/web/react">
    Web SDK 연동 가이드 (React, CDN, 모바일 웹뷰 포함)
  </Card>
</CardGroup>

## 지원 광고 포맷

| 포맷   | Android / iOS | Flutter / RN | Web |
| ---- | :-----------: | :----------: | :-: |
| 배너   |       O       |       O      |  O  |
| 네이티브 |       O       |       O      |  O  |
| 전면   |       O       |       O      |  -  |
| 보상형  |       O       |       O      |  -  |
| 팝업   |       O       |       O      |  -  |
| 스플래시 |       O       |       O      |  -  |

<Note>
  백필 광고는 배너, 네이티브, 전면, 보상형을 지원합니다. (Web은 배너, 네이티브만 지원)
</Note>

## SDK 수집 정보

SDK 설치 시 다음 정보가 자동으로 수집됩니다:

* 플랫폼 및 앱 정보 (앱명, 버전)
* OS 정보 (버전, 타입)
* 기기 정보 (화면 사이즈)
* 로케일 및 타임존

<Note>
  광고 ID(ADID/IDFA)는 사용자 동의(ATT 등) 후 또는 고객사가 직접 제공하는 경우에만 수집됩니다.
</Note>