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

# はじめに

> CDNを通じてAdrop Web SDKを連携する方法をご案内します。

## 概要

ビルドツールなしでCDNスクリプトを通じてAdrop Web SDKを連携できます。静的ウェブサイトやシンプルなHTMLページに適しています。

### サポートする広告フォーマット

* バナー広告
* ネイティブ広告（カスタムUI対応）

### 要件

* モダンブラウザ（Chrome、Firefox、Safari、Edge）

***

## インストール

HTMLドキュメントの`<head>`セクションにスクリプトを追加します。

```html theme={null}
<script src="https://cdn.jsdelivr.net/npm/@adrop/ads-web-sdk@latest/dist/adrop-ads.min.js"></script>
```

<Note>
  特定バージョンを固定するには、`@latest`の代わりにバージョン番号を明示してください。
  例：`@adrop/ads-web-sdk@1.0.1`
</Note>

***

## 初期化

スクリプト読み込み後、SDKを初期化します。

```html theme={null}
<script>
  const adrop = Adrop.observe({
    appId: 'YOUR_APP_ID',
    debug: true  // 開発環境でのみtrue
  });
</script>
```

### 初期化オプション (AdropConfig)

<ParamField body="appId" type="string" required>
  Ad Controlコンソールで発行されたアプリID
</ParamField>

<ParamField body="uid" type="string">
  ユーザー識別子（ターゲティングに活用）
</ParamField>

<ParamField body="appKey" type="string">
  API認証キー（ユーザー属性更新時に必要）
</ParamField>

<ParamField body="debug" type="boolean" default={false}>
  デバッグログを有効化
</ParamField>

<ParamField body="backfillMode" type="'responsive' | 'fixed'" default="responsive">
  媒体全体のバックフィルレンダリングモード。スロット単位のオプションが優先されます。詳細は[バックフィルレンダリングモード](/ja/sdk/web/backfill)ガイドを参照してください。（SDK 1.2.3+）
</ParamField>

<Warning>
  本番環境では`debug: false`に設定してください。
</Warning>

### インスタンスアクセス

初期化後、どこからでも`Adrop.instance()`でSDKにアクセスできます。

```javascript theme={null}
const adrop = Adrop.instance();
// SDKを使用
```

### 設定の動的変更

ログイン後にユーザーIDを設定するなど、ランタイムで設定を変更できます。

```javascript theme={null}
// Setterを使用
Adrop.instance().uid = 'USER_ID';
Adrop.instance().appKey = 'YOUR_APP_KEY';

// またはsetConfigを使用
Adrop.instance().setConfig({
  uid: 'USER_ID',
  appKey: 'YOUR_APP_KEY'
});
```

<Note>
  ターゲティング広告が正常に動作するには、広告枠レンダリング前に`uid`を設定してください。
</Note>

***

## WebView設定（バックフィル広告用）

WebアプリがWebViewで実行され、バックフィル広告を表示する場合は、ネイティブアプリの設定が必要です。以下のプラットフォーム別ガイドをご参照ください。

<CardGroup cols={2}>
  <Card title="Android設定" icon="android" href="/ja/sdk/android/webview">
    Android WebView設定方法
  </Card>

  <Card title="iOS設定" icon="apple" href="/ja/sdk/ios/webview">
    iOS WebView設定方法
  </Card>
</CardGroup>

***

## 目次

<CardGroup cols={2}>
  <Card title="バナー広告" href="/ja/sdk/web/cdn-banner">
    バナー広告の実装
  </Card>

  <Card title="ネイティブ広告" href="/ja/sdk/web/cdn-native">
    ネイティブ広告の実装
  </Card>

  <Card title="ターゲティング設定" href="/ja/sdk/web/cdn-targeting">
    オーディエンス/コンテキストターゲティング
  </Card>

  <Card title="リファレンス" href="/ja/sdk/web/reference">
    クラス、インターフェース、定数
  </Card>

  <Card title="サンプル" href="/ja/sdk/web/examples">
    React、CDNサンプルコード
  </Card>
</CardGroup>
