> ## 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.

# 事前準備

> Ad Control SDK連携のための事前準備事項です。

## 準備項目

SDK連携には以下の情報が必要です：

| 項目           | 説明         | 発行場所       |
| ------------ | ---------- | ---------- |
| **アプリID**    | SDK初期化に使用  | 設定 > アプリ   |
| **広告ユニットID** | 広告リクエストに使用 | 広告ユニットメニュー |

<Note>
  [広告ユニット作成](/ja/ad-unit/create)の過程でアプリを一緒に登録できます。
</Note>

<Note>
  まだ広告プラットフォームがない場合は、コンソール担当者に[プラットフォーム作成](/ja/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="/ja/sdk/android/banner">
    Android SDK連携ガイド
  </Card>

  <Card title="iOS" icon="apple" href="/ja/sdk/ios/banner">
    iOS SDK連携ガイド
  </Card>

  <Card title="React Native" icon="react" href="/ja/sdk/react-native/banner">
    React Native SDK連携ガイド
  </Card>

  <Card title="Flutter" icon="flutter" href="/ja/sdk/flutter">
    Flutter SDK連携ガイド
  </Card>

  <Card title="Web" icon="globe" href="/ja/sdk/web/react">
    Web SDK連携ガイド（React、CDN、モバイルWebView含む）
  </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>
