> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# キーコンセプト

> アセット、フォーマット、マニフェスト、クリエイティブエージェントは、プログラマティック広告クリエイティブのための AdCP クリエイティブプロトコルの4つの構成要素。

一度のアップロードで、すべてのフォーマット。このガイドでは、フォーマット要件の定義から広告の組み立てとデリバリーまで、AdCP でクリエイティブがどのように機能するかを説明します。

## 4つのキーコンセプト

### 1. **アセット**

アセットはクリエイティブを構成するために使用される個々のビルディングブロックです。各アセットには、その使用方法と検証方法を決定する定義済みのタイプがあります。

**例:**

* 画像ファイル（PNG、JPG、WebP）
* ビデオファイル（MP4、WebM、MOV）
* テキストのブロック（ヘッドラインまたは CTA）
* 音声ファイル（MP3、M4A）
* HTML または JavaScript タグ
* トラッキングまたはクリックスルー URL

### 2. **フォーマット**

フォーマットは IAB フォーマットタクソノミーに基づいて、アセットがどのように組み立てられてレンダリングされるかを定義します。フォーマットは以下を指定します:

* メディアファミリー（例: ディスプレイ、ビデオ、オーディオ、ネイティブ）
* 必要なアセットタイプ
* 技術的な制約（デュレーション、寸法、コーデック、ファイルサイズ）
* レンダリングとインタラクションの期待

**例:**

* ビデオフォーマットは1つのビデオアセット（MP4、30秒、定義済みの解像度とコーデック）と1つのクリックスルー URL が必要
* ディスプレイフォーマットは1つ以上の画像または HTML アセット、オプションのテキストアセット、トラッキング URL が必要

### 3. **マニフェスト**

マニフェストはクリエイティブプリセットを定義します: 最終的にどこでどのように配信されるかに関わらず、ブランドが伝えたいことと見せたいことをキャプチャする再利用可能な設定です。

マニフェストは広告フォーマットやレンダリングロジックを記述しません。代わりに、互換性のあるフォーマットがサポートされるどこでも一貫して適用できる、クリエイティブの選択の名前付きセット（メディア、メッセージング、デスティネーション、トラッキングインテント）を宣言します。

**例**: "video\_30s" のマニフェストは実際の 30 秒ビデオファイルの URL、プラストラッキングピクセルとランディングページ URL を提供します。

### 4. **クリエイティブエージェント**

クリエイティブエージェントは以下を行うサービスだ:

* フォーマットを定義して文書化する（権威あるソース）
* 各フォーマットのレンダリング方法を説明します
* フォーマット要件に対してマニフェストを検証します
* クリエイティブがどのように表示されるかを示すプレビューを生成します
* オプションで自然言語ブリーフからマニフェストを構築します

各フォーマットはその権威あるクリエイティブエージェントを識別します。

## どのように組み合わさるか

```
フォーマット定義（クリエイティブエージェントによる）
  ↓
  "video_30s フォーマットに必要なもの:
   - 1つのビデオファイルアセット（MP4、30秒、1920x1080）
   - 1つのクリックスルー URL"

クリエイティブマニフェスト（バイヤーによる）
  ↓
  "実際のビデオファイルを提供:
   https://cdn.brand.com/spring_30s.mp4
   ランディングページ: https://brand.com/spring-sale"

セールスエージェント（検証してデリバリー）
  ↓
  - チェック: 本当に30秒か? MP4 か?
  - 追加: インプレッショントラッキング、クリックトラッキング
  - デリバリー: 広告サーバーにクリエイティブを配信
```

## ワークフロー

### 1. **発見** — 「どのフォーマットをサポートするか?」

バイヤーはセールスエージェントまたはクリエイティブエージェントで `list_creative_formats` を呼び出して、利用可能なフォーマットとその完全な仕様を発見します。各フォーマットには、そのフォーマットの権威あるクリエイティブエージェントを識別する `agent_url` が含まれます。

フォーマット発見の詳細については[クリエイティブフォーマット](/docs/creative/formats)を参照。

### 2. **組み立て** — 「アセットを提供する」

バイヤーは選択したフォーマットの要件を満たすアセットを提供するマニフェストを作成します。マニフェストはフォーマット仕様と実際のアセット URL、テキスト、トラッキングデータをペアにします。

マニフェスト構造の詳細については[クリエイティブマニフェスト](/docs/creative/creative-manifests)を参照。

### 3. **検証** — 「要件に一致するか?」

クリエイティブエージェントは以下を確認してマニフェストを検証する:

* 必要なアセットがすべて存在するか?
* アセットは技術的な制約（デュレーション、寸法、ファイルタイプ、ファイルサイズ）を満たすか?
* トラッキング URL とマクロは正しくフォーマットされているか?

### 4. **デリバリー** — 「広告サーバーにトラフィックする」

セールスエージェントは検証済みのクリエイティブを広告サーバーに配信し、AdCP の普遍的なコンセプトをプラットフォーム固有のフォーマットに変換します。

## コアコンセプト

### アセットとアセットタイプ

アセットはクリエイティブの原材料です。各アセットにはその役割を定義するタイプがある:

* **image**: 静的画像（JPEG、PNG、WebP）
* **video**: ビデオファイル（MP4、WebM、MOV）または VAST タグ
* **audio**: 音声ファイル（MP3、M4A）または DAAST タグ
* **text**: ヘッドライン、説明、CTA
* **html**: HTML5 クリエイティブまたはサードパーティタグ
* **javascript**: JavaScript タグ
* **url**: トラッキングピクセル、クリックスルー URL、ウェブフック

詳細仕様については[アセットタイプ](/docs/creative/asset-types)を参照。

### フォーマットとフォーマット権限

各フォーマットには権威あるソースがある — それを定義するクリエイティブエージェント（`agent_url` で示されます）。そのエージェントは:

* 決定的なドキュメントをホストします
* アセットの組み立て方を説明します
* フォーマットのレンダリング方法を記述します
* 検証ルールを提供します

**標準フォーマット vs カスタムフォーマット:**

* **標準フォーマット**は IAB 仕様に基づいており、リファレンスクリエイティブエージェント（`https://creative.adcontextprotocol.org`）によってホストされます
* **カスタムフォーマット**は特化したインベントリのために個々のパブリッシャーまたはクリエイティブプラットフォームによって定義されます
* 技術的には両方は同じように機能する — `agent_url` フィールドが各フォーマットの権威エージェントを識別します

ビデオ、ディスプレイ、オーディオ、DOOH、カルーセルにわたるフォーマットの例とパターンについては[チャネルガイド](/docs/creative/channels/video)を参照。

### マニフェスト

マニフェストはフォーマット定義のアセット ID と実際のアセットコンテンツをペアにする JSON 構造です。完全なクリエイティブを組み立てるために必要な URL、テキスト値、トラッキングエンドポイントを提供します。

詳細ドキュメントについては[クリエイティブマニフェスト](/docs/creative/creative-manifests)を参照。

### ユニバーサルマクロ

AdCP はプラットフォーム間で機能するユニバーサルマクロを定義します。セールスエージェントはこれらのマクロを広告サーバーのネイティブ構文に変換します。

* **インプレッショントラッキング用**: セールスエージェントは AdCP マクロをインプレッションを配信する前に広告サーバーのネイティブマクロフォーマットに変換します。
* **クリックトラッキング用**: マクロ変換に加えて、セールスエージェントは `{REDIRECT_URL}` を最終デスティネーションクリック URL に置き換え、クリックが記録された後の適切なリダイレクトを確保するために広告サーバーのデスティネーション URL としてクリックトラッキング URL を配信します。

完全なリファレンスについては[ユニバーサルマクロ](/docs/creative/universal-macros)を参照。

## 一般的なパターン

### サードパーティタグ

一部のフォーマットは、ファーストパーティのメディア要素から組み立てられるのではなく、サードパーティシステムによって配信されるクリエイティブをサポートします。

このパターンでは、クリエイティブは HTML タグまたは JavaScript タグとして提供されます。フォーマット定義は必要な要素タイプと適用可能な制約（サンドボックス化やトラッキングの期待など）を指定します。レンダリング、アセット読み込み、インタラクションロジックはサードパーティシステムによって外部で処理されます。

このパターンはディスプレイフォーマットで最も一般的に使用されます。サードパーティタグの例については[ディスプレイチャネルガイド](/docs/creative/channels/display)を参照。

### 繰り返し可能なアセットグループ

一部のフォーマットでは、共通の構造の下で繰り返されるクリエイティブ要素のセットを許可または必要とします。このパターンはカルーセル、スライドショー、ストーリースタイルのシーケンス、プレイリストまたはプロダクトリストなどのクリエイティブに使用されます。

各繰り返しには同じ論理的な要素ロール（例: 画像、テキスト、URL）が含まれ、繰り返しの数はフォーマットによって定義または制約されます。繰り返し可能な要素グループは構造パターンを記述するものであり、フォーマットやレイアウトの保証ではなく、ディスプレイ、ネイティブ、または他の互換性のあるフォーマット間で使用される場合があります。

詳細なドキュメントについては[カルーセル & マルチアセットフォーマット](/docs/creative/channels/carousels)ガイドを参照。

### DOOH インプレッショントラッキング

デジタルアウトオブホーム（DOOH）環境は、パーソナルデバイス環境とは異なる測定セマンティクスが必要です。

このパターンでは:

* インプレッションはベニューまたはスクリーンレベルの識別子を使用してトラッキングされます
* デバイスベースの識別子は使用されない
* トラッキングは環境固有のマクロに依存します

これは測定とレポートにのみ影響し、クリエイティブフォーマットの分類やアセット要件は変更しません。DOOH 固有のマクロの詳細については[DOOH チャネルガイド](/docs/creative/channels/dooh)を参照。

## チャネル別情報

チャネルとフォーマットファミリー別のクリエイティブに関する詳細情報については[クリエイティブマニフェスト](/docs/creative/creative-manifests)を参照:

* **ビデオ広告** — インストリームとアウトストリームのビデオフォーマット（CTV 環境を含む）
* **ディスプレイ広告** — 標準ディスプレイフォーマット（バナーやインタースティシャルなど）
* **オーディオ広告** — インストリームオーディオフォーマット（オプションのコンパニオンディスプレイ付き）
* **DOOH** — デジタルアウトオブホームインベントリとベニューベースのデリバリー環境

## はじめる

1. **フォーマットを発見する**: `list_creative_formats` を呼び出して利用可能なものを確認
2. **チャネルガイドを選ぶ**: キャンペーンタイプに合ったガイドを選択
3. **マニフェストを構築する**: フォーマット要件に従う
4. **ユニバーサルマクロを使用する**: 標準化されたマクロでトラッキングを追加
5. **プレビューする**: `preview_creative` を使用してどのように見えるか確認
6. **送信する**: `create_media_buy` リクエストにマニフェストを含めます

## 追加リソース

* [クリエイティブタスクリファレンス](/docs/creative/task-reference/list_creative_formats) — クリエイティブタスクの API ドキュメント
* [生成クリエイティブ](/docs/creative/generative-creative) — AI 駆動のクリエイティブ生成ガイド