> ## 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 コレクションガバナンスは、コレクションリスト — どのプロパティが番組を運ぶかとは独立した、番組、シリーズ、その他のコンテンツプログラムのための管理された除外・包含リスト — を通じてプログラムレベルのブランドセーフティを可能にする。

<img src="https://mintcdn.com/pier1inc/L0x9SRWxqbpGBzrx/images/walkthrough/collection-gov-01-spreadsheet.png?fit=max&auto=format&n=L0x9SRWxqbpGBzrx&q=85&s=8dd3da40ceecd30b4dbdaa2da2e1c574" alt="Jordan sits at her desk studying a dense brand safety spreadsheet on her monitor — rows of partner names and excluded programs that need to become machine-readable" style={{ width: '100%', borderRadius: '12px', marginBottom: '2rem' }} width="1376" height="768" data-path="images/walkthrough/collection-gov-01-spreadsheet.png" />

Jordan はスプレッドシートを見つめています。ホールディングカンパニーが Nova Motors の CTV「放映しない」リストをちょうど送ってきました — ネットワークで整理された 200 以上のプログラム、特定の番組、ジャンル全体、コンテンツレーティングの混合。一部のエントリーはアプリレベルの除外です。一部は 5 つの異なるプラットフォームで放映される個別のプログラムです。あるセクションは「常に子供向けプログラミングを除外」と言い、3 行後に「G または PG 評価のアニメーションは許可」と言っています。

このスプレッドシートはリニア TV を扱う人間には意味をなします。十数のセラー全体でプログラマティック CTV を管理する AI エージェントには意味をなしません。

Jordan はこれを機械が強制できるものに変える必要があります。プロパティリストはアプリレベルの除外を処理します — 彼女はそれを以前にやりました。しかしプログラムレベルの除外は? 番組は単一のアプリに属しません。どこでも放映されます。彼女は、実行される場所とは独立して *プログラム自体* を識別する構造を必要とします。

それがコレクションリストの目的です。

## ブランドセーフティのギャップ

<img src="https://mintcdn.com/pier1inc/L0x9SRWxqbpGBzrx/images/walkthrough/collection-gov-02-three-layers.png?fit=max&auto=format&n=L0x9SRWxqbpGBzrx&q=85&s=273cc48a5e527fc04d4b20b60f23eed4" alt="Three-layer brand safety diagram — properties on top, collections in the middle, content standards at the bottom — Jordan points at the collection layer she is building" style={{ width: '100%', borderRadius: '12px', marginBottom: '1rem' }} width="1376" height="768" data-path="images/walkthrough/collection-gov-02-three-layers.png" />

コレクションリスト以前、AdCP には 2 つのブランドセーフティ層がありました:

* **プロパティリスト** は広告が *どこで* 実行されるか — どのアプリ、サイト、プラットフォーム — を制御します。Jordan は「このニュースアプリでは不可」と言え、すべてのセラーがそれを強制します。
* **コンテンツ標準** は広告に *どのコンテンツ* が隣接するか — 自然言語ポリシーに対するインプレッションごとの評価 — を制御します。「G/PG アニメーションを除く子供コンテンツを除外」のようなニュアンスを処理します。

欠けている層は、広告が *どのプログラム* で実行されるかです。特定のクライムドラマは 3 つのストリーミングプラットフォームとケーブルシンジケーションで放映されます。1 つのプロパティから除外してもそれを他から除外しません。Jordan は「どこでもこのプログラムでは不可」と言い — すべてのセラーに彼女の意味を理解させる必要があります。

コレクションリストはこのギャップを埋めます。プロパティリストとコンテンツ標準とともに、3 つの合成可能な層を形成します:

| Layer      | Construct     | What it controls       | When       |
| ---------- | ------------- | ---------------------- | ---------- |
| Property   | プロパティリスト      | 広告が実行される場所（アプリ、サイト）    | セットアップ     |
| Collection | **コレクションリスト** | 広告が実行されるコンテンツ（番組、シリーズ） | セットアップ     |
| Content    | コンテンツ標準       | 広告に隣接する特定のコンテンツ        | インプレッションごと |

ほとんどのバイヤーは 1 つか 2 つの層を使います。特定のプログラムだけを除外する必要のあるバイヤーはコレクションリスト単独を使います。3 層モデルは合成フレームワークであり、要件ではありません。

## プログラム識別子の解決

<img src="https://mintcdn.com/pier1inc/L0x9SRWxqbpGBzrx/images/walkthrough/collection-gov-03-resolving.png?fit=max&auto=format&n=L0x9SRWxqbpGBzrx&q=85&s=43e26c46e88be7a1d16f1c3737325c2d" alt="Jordan maps program names to distribution identifiers at a display — green lines connect resolved programs, amber lines show unresolved ones she marks for follow-up" style={{ width: '100%', borderRadius: '12px', marginBottom: '1rem' }} width="1376" height="768" data-path="images/walkthrough/collection-gov-03-resolving.png" />

スプレッドシートは名前でプログラムをリストします。機械は識別子を必要とします。Jordan のバイヤーエージェントは各プログラム名を、どの CTV プラットフォームが運ぶかにかかわらずプログラムを一意に識別する、プラットフォーム非依存の [distribution identifier](/docs/media-buy/product-discovery/collections-and-installments) — IMDb ID、Gracenote ID、または EIDR ID — に解決します。

ほとんどのプログラムは即座に解決します。いくつかは解決しません — エージェントは Jordan が手動で確認するためこれらをフラグします。これは翻訳ステップです: 人間可読な名前が、エコシステムのすべてのセラーが理解する機械可読な識別子になります。

**Gracenote ID ガイダンス:** ルートレベル ID を使ってください — シリーズには SH プレフィックス、映画には MV プレフィックス、スポーツプログラムには SP プレフィックス。エピソードレベル ID（EP プレフィックス）はコレクションリストに属しません。エピソードレベル評価はコンテンツ標準の関心事です。

## コレクションリストの構築

<img src="https://mintcdn.com/pier1inc/L0x9SRWxqbpGBzrx/images/walkthrough/collection-gov-04-filters.png?fit=max&auto=format&n=L0x9SRWxqbpGBzrx&q=85&s=d3df3b3ef0d8c0151d9ad5a9ed6a9c59" alt="A funnel filters collections through rating, genre, and explicit exclusion layers — Jordan reviews the clean resolved list emerging at the bottom" style={{ width: '100%', borderRadius: '12px', marginBottom: '1rem' }} width="1376" height="768" data-path="images/walkthrough/collection-gov-04-filters.png" />

Jordan のバイヤーエージェントは、明示的なプログラム除外を構造フィルターと組み合わせて、ガバナンスエージェントにコレクションリストを作成します:

```json theme={null}
{
  "tool": "create_collection_list",
  "arguments": {
    "name": "Nova Motors CTV Do Not Air — 2026",
    "base_collections": [
      {
        "selection_type": "distribution_ids",
        "identifiers": [
          { "type": "imdb_id", "value": "tt9999901" },
          { "type": "imdb_id", "value": "tt9999902" },
          { "type": "gracenote_id", "value": "SH000003" }
        ]
      }
    ],
    "filters": {
      "content_ratings_exclude": [
        { "system": "tv_parental", "rating": "TV-MA" },
        { "system": "bbfc", "rating": "18" }
      ],
      "genres_exclude": ["news"],
      "genre_taxonomy": "iab_content_3.0"
    },
    "brand": { "domain": "novamotors.com" }
  }
}
```

明示的なエントリーは名指しされたプログラムを処理します。フィルターは構造除外を処理します — TV-MA コンテンツなし、ニュースジャンルなし。フィルターはセーフティネットです: 任意のプラットフォームの任意の新しい TV-MA シリーズは、Jordan がリストを更新することなく自動的に除外されます。

「子供 vs. G/PG アニメーション」の矛盾は? それはコレクションリストの問題ではありません — メタデータではなく実際のエピソードコンテンツの評価を要求します。Jordan はそれをそれが属する [コンテンツ標準](/docs/governance/content-standards/index) に入れます。

### フィルターの合成方法

Include フィルターは allowlist、exclude フィルターは blocklist です。両方が同じ次元に存在するとき、include が最初に適用され、次に exclude がさらに狭めます。

**例:** `genres_include: ["drama", "comedy"]` + `genres_exclude: ["crime"]` はまずドラマとコメディのコレクションのみを含め、次に crime としてもタグ付けされたものを削除します。`["drama", "crime"]` とタグ付けされたコレクションは除外されます — exclude フィルターが勝ちます。

## セラーは自身の在庫に対してマッチ

<img src="https://mintcdn.com/pier1inc/L0x9SRWxqbpGBzrx/images/walkthrough/collection-gov-05-seller-matching.png?fit=max&auto=format&n=L0x9SRWxqbpGBzrx&q=85&s=a4caf77df1a9cd18708653cf8397e274" alt="Split scene — Jordan's governance agent sends the collection list to Priya at StreamHaus, whose inventory lights up showing matched exclusions" style={{ width: '100%', borderRadius: '12px', marginBottom: '1rem' }} width="1376" height="768" data-path="images/walkthrough/collection-gov-05-seller-matching.png" />

Jordan のメディアバイがコレクションリストを参照すると、StreamHaus の Priya のセールスエージェントがそれをフェッチし、エントリーを StreamHaus のコレクション在庫に対してマッチし、マッチしたプログラムを配信から除外します。マッチングは distribution identifier を使います — StreamHaus は `adagents.json` でコレクションに Gracenote ID を宣言したため、マッチは自動的です。

Priya のエージェントが報告し返します: 200 の除外プログラムのうち 47 が StreamHaus のライブラリにあります。TV-MA フィルターで捕捉された 12 の追加コレクション。残りは StreamHaus が運ぶプログラムではありません — 認識され無視されます。

リストは 1 週間キャッシュされます（コレクションメタデータはプロパティメタデータより頻繁に変わりません）。ガバナンスエージェントがリストを再解決すると — 新しいシーズンが番組のコンテンツレーティングを変える、または Jordan がプログラムを追加 — セラーは webhook を受け取りキャッシュをリフレッシュします。

## ターゲティング統合

コレクションリストはターゲティングオーバーレイでプロパティリストと並んで参照されます:

```json theme={null}
{
  "targeting": {
    "property_list": {
      "agent_url": "https://governance.pinnacleagency.com",
      "list_id": "pl_novamotors_approved_ctv"
    },
    "collection_list_exclude": {
      "agent_url": "https://governance.pinnacleagency.com",
      "list_id": "cl_novamotors_dna_2026"
    }
  }
}
```

| Field                     | Semantics                | Use case              |
| ------------------------- | ------------------------ | --------------------- |
| `collection_list`         | 包含 — これらのコレクションでのみ実行     | 「これら 3 番組でのみプリロールを購入」 |
| `collection_list_exclude` | 除外 — これらのコレクションで決して実行しない | ブランドセーフティの放映しないリスト    |

メディアバイは両方を同時に参照できます — 「これらの承認された番組で実行するが、承認リストに現れてもこれらの特定のプログラムでは決して実行しない」。除外リストは重複で常に勝ちます。

<Info>
  **なぜコレクションには 2 つのフィールドでプロパティには 1 つか?** プロパティリストは、他のターゲティング次元（geo、audience、device）で今使われるペア化された include/exclude パターンに先行します。コレクションリストは現在のパターンに従います。将来の進化は対称性のため `property_list_exclude` を追加するかもしれません。
</Info>

## Jordan の 3 層構成

Jordan が終える頃には、Nova Motors の CTV ブランドセーフティは 3 つの機械可読なアーティファクトで表現されます:

1. **プロパティリスト** — 除外されたアプリと承認された CTV プラットフォーム
2. **コレクションリスト** — distribution identifier によって除外されたプログラム + TV-MA とニュースジャンルフィルター
3. **コンテンツ標準** — エピソードごとの判断を要求するニュアンスのある子供/アニメーションポリシー

各層は独立に管理され、独立にキャッシュ可能で、独立に強制可能です。ホールディングカンパニーが来四半期に更新された放映しないリストを送るとき、Jordan のエージェントはそれを既存のコレクションリストと差分し、変わったものだけを更新します。

もうスプレッドシートはありません。もうネットワークごとの手動トラフィッキングはありません。1 つのリスト、どこでも強制。

## プロパティリストとの関係

プロパティリストとコレクションリストは兄弟構造です — 両方とも同じライフサイクルパターン（create、get、update、list、delete、webhook）でガバナンスエージェントが管理する在庫リストです。それらは何に対処するかで異なります:

| Dimension  | Property list               | Collection list                              |
| ---------- | --------------------------- | -------------------------------------------- |
| 識別するもの     | 技術的表面（ドメイン、アプリ）             | コンテンツプログラム（番組、シリーズ）                          |
| プライマリ識別子   | プロパティ識別子（ドメイン、バンドル ID）      | Distribution identifier（IMDb、Gracenote、EIDR） |
| フィルター      | 国、チャネル、プロパティタイプ、フィーチャー      | コンテンツレーティング、ジャンル、種類、制作品質                     |
| キャッシュデフォルト | 24 時間                       | 168 時間（1 週間）                                 |
| クロスパブリッシャー | プロパティレジストリ経由（property\_rid） | コレクションレジストリ経由（collection\_rid）               |

## タスク

### コレクションリスト管理

* **[create\_collection\_list](/docs/governance/collection/tasks/collection_lists#create_collection_list)**: ガバナンスエージェントに新しいコレクションリストを作成
* **[get\_collection\_list](/docs/governance/collection/tasks/collection_lists#get_collection_list)**: 解決されたコレクションを取得（キャッシングガイダンス付き）
* **[update\_collection\_list](/docs/governance/collection/tasks/collection_lists#update_collection_list)**: フィルターまたはベースコレクションを変更
* **[list\_collection\_lists](/docs/governance/collection/tasks/collection_lists#list_collection_lists)**: アカウントのコレクションリストをリスト
* **[delete\_collection\_list](/docs/governance/collection/tasks/collection_lists#delete_collection_list)**: コレクションリストを削除
