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

# Brief Expectations

効果的なメディアバイには充実したブリーフが不可欠です。本ドキュメントでは `get_products` 仕様におけるブリーフの期待値と必須要件を定義し、パブリッシャーへの実装ガイダンスとバイヤーへの明確な期待値を示します。

## 概要

AdCP におけるブリーフは、キャンペーン要件を自然言語で記述し、パブリッシャーがメディアバイのリクエストを理解し実行するうえでの助けとなります。ブリーフはシンプルでも詳細でも構いませんが、充実しているほど、より適切な商品提案と効率的なキャンペーン運用が可能になります。

## 必須コンポーネント

すべての `get_products` と `create_media_buy` リクエストに **必須**:

### Brand Manifest

`brand_manifest` フィールドはすべてのリクエストで **必須** です。広告主ブランドを特定します。

```json theme={null}
{
  "brand_manifest": {
    "name": "Nike",
    "url": "https://nike.com",
    "category": "athletic_apparel"
  }
}
```

これによりパブリッシャーは次を行えます。

* ポリシー制限の適用（年齢制限、禁止カテゴリなど）
* ブランドの真正性確認
* ブランドセーフティ基準の遵守

### Brief フィールド

`brief` フィールドでは **何を訴求しているか** と **キャンペーン要件** を記述します。

```json theme={null}
{
  "brief": "Nike Air Max 2024 - the latest innovation in cushioning technology featuring sustainable materials, targeting runners and fitness enthusiasts"
}
```

## ブリーフが任意となるケース

`brief` フィールドは **任意** です。標準カタログを取得したいときなど正当なケースがあります。

### 標準カタログの探索

ターゲティングなしでパブリッシャーの標準商品カタログを確認したい場合:

* パブリッシャーの **標準商品カタログ** を取得
* オーディエンスターゲティングやニッチ商品はなし
* 全広告主に提供される基本的な商品を返す
* 初期の情報収集やプランニングに有効

### ブリーフ不要となるシナリオ

1. **初期探索** - パブリッシャーのインベントリを把握したい
2. **バイヤー側のターゲティング** - [TMP](/docs/trusted-match) 経由で独自のオーディエンスセグメントを利用します
3. **商品を直接指定** - 特定の商品 ID をすでに把握しています
4. **常時稼働キャンペーン** - 既存キャンペーンの補充

### 例: 標準カタログのリクエスト

```json theme={null}
{
  "brand_manifest": {
    "name": "Nike",
    "url": "https://nike.com"
  },
  "brief": null,  // No brief = standard catalog
  "filters": {
    "delivery_type": "non_guaranteed",
    "format_types": ["display", "video"],
    "standard_formats_only": true
  }
}
```

この場合:

1. パブリッシャーは **標準カタログ** を返す
2. パーソナライズやブリーフに紐づく商品は返さない
3. 広告主が利用できるベースラインの在庫を提供
4. バイヤーは [TMP](/docs/trusted-match) を通じて独自のターゲティングを適用可能
5. 目的は利用可能な在庫の把握

## ブリーフの主要要素

`brief` を提供する場合、次の要素を含めると効果的です。

### 1. ビジネス目標

**キャンペーンで達成したいこと**

* **Awareness**: ブランド認知やプロダクト認知の向上
* **Consideration**: 興味・検討を促進
* **Conversion**: 売上やサインアップの獲得
* **Retention**: 既存顧客の再エンゲージ
* **App installs**: モバイルアプリのインストール促進
* **Lead generation**: リード獲得
* **Traffic**: Web/店舗への送客

ブリーフ記載例: *"Drive awareness for our new product launch among young professionals"*

### 2. 成功指標

**成功をどう測るか**

* **CTR** (Click-Through Rate): エンゲージメントの測定
* **CPA** (Cost Per Acquisition): コンバージョン効率
* **ROAS** (Return on Ad Spend): 収益貢献
* **Brand lift**: 認知・好意度の向上
* **Video completion rate**: コンテンツ消化度
* **Conversion rate**: 行動完了率
* **Reach and frequency**: 到達と接触頻度

ブリーフ記載例: *"Success measured by achieving 2% CTR and \$50 CPA"*

### 3. フライト期間

**いつ配信するか**

* **Start date**: 開始日
* **End date**: 終了日
* **Specific periods**: 祝日・イベント・プロモーション期間
* **Blackout dates**: 配信を避ける日
* **Dayparting requirements**: 時間帯の希望

ブリーフ記載例: *"Run from March 1-31, focusing on weekday morning commutes"*

## 任意のコンポーネント

これらを含めると提案の質が向上します。

### ターゲットオーディエンス

**誰に届けたいか**

#### Demographics

* 年齢範囲（例: 25-34, 35-44）
* 性自認
* 世帯収入
* 学歴
* 親かどうか
* 雇用状況

#### Psychographics

* 興味・関心
* ライフスタイル属性
* 価値観・信念
* 購買行動
* メディア接触習慣
* テクノロジー採用度

#### Behavioral Signals

* 過去の購買行動
* Web 訪問履歴
* アプリ利用状況
* コンテンツエンゲージメント
* カート放棄

ブリーフ記載例: *"Target pet owners aged 25-45 with household income over \$75K who have shown interest in premium pet products"*

### 予算情報

**支出条件**

* **Total budget**: 総予算
* **Daily budget**: 日次上限
* **Budget flexibility**: 変更余地
* **Cost constraints**: CPM 上限や効率要件
* **Budget allocation**: 商品や期間への配分

ブリーフ記載例: *"\$50,000 total budget with flexibility to increase by 20% for high-performing inventory"*

### 地域

**どこに配信するか**

* **Countries**: 国
* **Regions/States**: 国内の地域や州
* **Cities/DMAs**: 都市・DMA
* **Postal codes**: より細かい地域
* **Exclusions**: 配信除外エリア

ブリーフ記載例: *"Focus on California and New York, specifically Los Angeles and New York City metros"*

### クリエイティブの制約

**フォーマットやコンテンツ要件**

* **Available formats**: Video, audio, display, native
* **Creative variations**: 用意できるバリエーション数
* **Language versions**: 対応言語
* **Technical limitations**: ファイルサイズ、尺など
* **Brand guidelines**: 色・ロゴ・メッセージの要件

ブリーフ記載例: *"We have 30-second and 15-second video creatives in English and Spanish"*

### ブランドセーフティ要件

**避けたいコンテンツ**

* **Blocked categories**: 除外したいカテゴリ
* **Sensitive topics**: 回避したいテーマ
* **Competitor separation**: 競合ブランドの同時掲載回避
* **Quality standards**: ビューアビリティや不正防止
* **Certification requirements**: TAG, MRC など

ブリーフ記載例: *"Avoid news, political content, and competitive automotive brands"*

## ブリーフの充実度レベル

パブリッシャーは、ブリーフの充実度に応じて柔軟に対応すべきです。

### ブリーフなし（標準カタログ）

```json theme={null}
{
  "brand_manifest": {"name": "Acme Corp", "url": "https://acmecorp.com"},
  "brief": null,  // Signals standard catalog request
  "filters": {
    "delivery_type": "non_guaranteed",
    "standard_formats_only": true
  }
}
```

**パブリッシャー応答**: 標準カタログ商品を返す（スケールを重視した広い在庫）。ターゲティングやニッチ商品は不要。提案も不要。

### 最小限のブリーフ

```json theme={null}
{
  "brand_manifest": {"name": "Acme Corp", "url": "https://acmecorp.com"},
  "brief": "Reach business decision makers"
}
```

**パブリッシャー応答**: 予算、期間、具体的な目標の確認を求める。

### 標準的なブリーフ

```json theme={null}
{
  "brand_manifest": {"name": "Acme Corp", "url": "https://acmecorp.com"},
  "brief": "Acme Corp project management software - cloud-based solution for remote teams. Reach IT decision makers in tech companies with 50-500 employees, $25K budget for Q1, focusing on driving free trial signups"
}
```

**パブリッシャー応答**: 根拠を明示した関連商品の提案を返します。

### 包括的なブリーフ

```json theme={null}
{
  "brand_manifest": {"name": "Acme Corp", "url": "https://acmecorp.com"},
  "brief": "Acme Corp project management software - cloud-based solution for remote teams with AI-powered automation. Drive 500 free trial signups from IT decision makers and project managers at tech companies (50-500 employees) in SF Bay Area and NYC. $25K budget for March 1-31, measured by $50 CPA. We have video and display creatives. Avoid competitor content and news sites."
}
```

**パブリッシャー応答**: 詳細なパフォーマンス予測付きで最適化された商品構成を提示。

## 実装ガイドライン

### パブリッシャー向け

1. **ブリーフ要素の抽出**: 重要項目をプログラム的に抽出
2. **不完全な情報への対応**: 不足している重要情報を丁寧に確認
3. **ガイダンスの提供**: 追加すると有益な情報を示します
4. **スマートなマッチング**: 自然言語を解釈し、AI を活用して商品にマップ
5. **関連性の説明**: レスポンスでは必ず `brief_relevance` を返す

### バイヤー向け

1. **具体的に記述**: 詳細が多いほど精度の高い提案が得られます
2. **目標の優先順位**: 主要目標と副次目標を明確にします
3. **背景の共有**: 市場状況や競合環境を含めます
4. **反復的に更新**: パブリッシャーのフィードバックを受けてブリーフを改善
5. **整合性の維持**: ブリーフと promoted offering を一致させる

## ブリーフ処理フロー

```mermaid theme={null}
graph TD
    A[Receive Request] --> B{Promoted Offering Valid?}
    B -->|No| C[Return Policy Error]
    B -->|Yes| D{Brief Provided?}
    D -->|No| M[Return All Products Matching Filters]
    D -->|Yes| E{Brief Complete?}
    E -->|No| F[Request Clarification]
    E -->|Yes| G[Process Requirements]
    F --> H[Provide Specific Questions]
    G --> I[Match Products]
    I --> J{Products Found?}
    J -->|No| K[Suggest Alternatives]
    J -->|Yes| L[Return Recommendations]
    L --> N[Include Relevance Explanation]
```

## 確認事項の扱い

ブリーフに明確化が必要な場合、パブリッシャーは次を行います。

1. **具体的な質問をする**: 欠けている重要情報に絞る
2. **例を示す**: 望ましい情報の例を提示
3. **コンテキストを保持**: 以前のブリーフ内容を忘れない
4. **デフォルトを提案**: 妥当な仮定を示します
5. **段階的に開示**: 質問を一度に出し過ぎない

例: 確認のレスポンス

```json theme={null}
{
  "message": "I'd be happy to help find the right products for your campaign. To provide the best recommendations, could you share:\n\n• What's your campaign budget?\n• When do you want the campaign to run?\n• Which geographic markets are you targeting?\n• What are your success metrics (awareness, conversions, etc.)?",
  "clarification_needed": true
}
```

## 自然言語処理

パブリッシャーは NLP を用いて次を抽出すべきです。

* **時間表現**: "next quarter", "holiday season", "ASAP"
* **予算の示唆**: "\$50K", "low budget", "premium spend"
* **オーディエンス描写**: "millennials", "high-income", "parents"
* **地理的参照**: "west coast", "major cities", "nationwide"
* **目標キーワード**: "awareness", "drive sales", "generate leads"

## ベストプラクティス

### DO:

* ✅ brand\_manifest と brief の両方に広告主と商品を記載します
* ✅ 測定可能な成功指標を明示します
* ✅ 配信期間を明確にします
* ✅ ターゲットオーディエンスを具体的に記述します
* ✅ 利用可能なクリエイティブフォーマットを記載します
* ✅ 予算や制約を示します
* ✅ ブランドセーフティ要件を含めます

### DON'T:

* ❌ "good performance" のような曖昧な目標だけを書く
* ❌ 期間を省略して、後からの確認を期待します
* ❌ 定義されていない略語や業界用語だけで記述します
* ❌ brand\_manifest と brief で矛盾した内容を入れる
* ❌ センシティブまたは機密情報を含めます
* ❌ パブリッシャーが自社事情を理解していると想定します

## 例

### 標準カタログ（ブリーフなし）

```json theme={null}
{
  "brand_manifest": {"name": "Ford", "url": "https://ford.com"},
  "brief": null,
  "filters": {
    "delivery_type": "non_guaranteed",
    "channels": ["display", "ctv"]
  }
}
```

**ユースケース**: バイヤーは DMP/CDP に洗練されたオーディエンスセグメントを持っており、[TMP](/docs/trusted-match) でターゲティングを適用するだけでよい。幅広い在庫へのアクセスが目的。

### EC のブリーフ

```
"Launch our new sustainable fashion line targeting environmentally conscious millennials in urban markets. $75K budget for April, focused on driving online sales with a target ROAS of 4:1. We have video and carousel creatives showcasing the manufacturing process."
```

### B2B ソフトウェアのブリーフ

```
"Generate qualified leads for our enterprise CRM solution among sales leaders at companies with 500+ employees. Q2 campaign with $100K budget, targeting 2% conversion rate from landing page visits. Display and native formats available."
```

### ローカルサービスのブリーフ

```
"Drive appointment bookings for our dental practice in Chicago suburbs. $5K monthly budget targeting families with children within 10 miles of our locations. Focus on Saturday availability."
```

## まとめ

ブリーフの役割は買い手によって異なります。

* **発見重視のバイヤー**: 詳細なブリーフにより最適な商品提案を受けられます
* **ターゲティング重視のバイヤー**: ブリーフを省略し、フィルターで広い在庫を取得し、自前のターゲティングを適用
* **ハイブリッド**: 最小限のブリーフで選択肢を絞りつつ、ターゲティングの主導権を維持

パブリッシャーは、ブリーフがない場合から包括的な場合まで幅広く対応できる堅牢な処理を実装し、必要に応じて丁寧に対話することが求められます。
