- パブリッシャープロパティ — 広告が配信される場所(youtube.com、spotify.com)
- 番組/エピソード — 広告が挿入されるコンテンツ(特定のシリーズとその各回)
- プレースメント — 広告が表示されるポジション(プレロール、ミッドロール、ホストリード)
show オブジェクト
番組(show)は、時間をかけてエピソードを生み出す継続的なコンテンツプログラムです。番組はプロパティと同じように機能する — パブリッシャーがadagents.json で宣言し、商品は publisher_domain と show_ids を持つ shows セレクターで参照します。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
show_id | string | Yes | パブリッシャーが割り当てる識別子。パブリッシャーの adagents.json で宣言されます。商品は shows セレクターで番組を参照します。クロスセラーマッチングには配信識別子を使うこと。 |
name | string | Yes | 人間が読める番組名 |
description | string | No | 番組の内容 |
genre | string[] | No | ジャンルタグ。genre_taxonomy が存在する場合、値はタクソノミーID(例:IAB Content Taxonomy 3.0)。それ以外は自由形式。 |
genre_taxonomy | string | No | ジャンル値のタクソノミーシステム(例:iab_content_3.0)。機械可読なブランドセーフティのために推奨。 |
language | string | No | 主要言語(BCP 47) |
content_rating | object | No | 基準レーティング:system + rating。システム:tv_parental、mpaa、podcast、esrb、bbfc、fsk、acb、custom。エピソードで上書き可能。 |
cadence | string | No | daily、weekly、seasonal、event、irregular |
season | string | No | 現在またはもっとも最近のシーズン識別子(例:"3"、"2026") |
status | string | No | active、hiatus、ended、upcoming |
production_quality | string | No | professional、prosumer、ugc。セラー申告。OpenRTB の content.prodq に対応。 |
talent | array | No | ホスト、レギュラーキャスト、クリエイター。各エントリは role、name、および brand.json へのリンクとなるオプションの brand_url を持ちます。 |
special | object | No | 存在する場合、この番組は特番 — 現実世界のイベントやシーンに紐付いたコンテンツ。特番とリミテッドシリーズを参照。 |
limited_series | object | No | 存在する場合、この番組はリミテッドシリーズ — 定義されたアークと終了日を持つ有限の放送。特番とリミテッドシリーズを参照。 |
distribution | array | No | この番組が配信されている場所と、パブリッシャーごとのプラットフォーム固有識別子。 |
related_shows | array | No | 他の番組との関係:spinoff、companion、sequel、prequel、crossover。各エントリは show_id + relationship を持ちます。参照は同じパブリッシャーの adagents.json 内にスコープされます。対称型(companion、crossover)は両方の番組が宣言する必要はない。 |
episode オブジェクト
エピソードは番組の特定の回です。すべてのエピソードが事前にわかるとは限らない — 週次ポッドキャストは翌週のエピソードしかスケジュールされていないかもしれないし、一部のエピソードは暫定的(プレーオフ第7戦は第6戦の結果次第)なこともあります。| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
episode_id | string | Yes | 番組内の一意識別子 |
show_id | string | 必要な場合 | 親番組。商品が複数の番組にまたがる場合に必須。 |
name | string | No | エピソードタイトル |
season | string | No | シーズン識別子(例:"1"、"2026") |
episode_number | string | No | シーズン内のエピソード番号 |
scheduled_at | datetime | No | エピソードの放送または公開日時 |
status | string | No | scheduled、tentative、live、postponed、cancelled、aired、published |
duration_seconds | integer | No | 想定される尺 |
flexible_end | boolean | No | 終了時刻が概算かどうか(ライブイベント) |
valid_until | datetime | No | このデータの有効期限。暫定エピソードに予算をコミットする前に、エージェントは再クエリすべきです。 |
content_rating | object | No | 存在する場合に番組の基準を上書きする |
topics | string[] | No | ブランドセーフティのためのエピソードレベルのコンテンツトピック。存在する場合は番組の genre_taxonomy を使用します。 |
special | object | No | エピソード固有のイベントコンテキスト。存在する場合、このエピソードは現実世界のイベントに紐付く。番組レベルの special を上書きします。 |
guest_talent | array | No | エピソード固有のゲスト。番組のレギュラー talent に追加されます。 |
ad_inventory | object | No | ブレークベースの広告インベントリ設定 |
derivative_of | object | No | このエピソードがフルエピソードから派生したクリップ、ハイライト、または要約である場合。episode_id + type(clip、highlight、recap、trailer、bonus)を持ちます。ソースの episode_id は同じレスポンス内になければなりません。 |
エピソードステータスのライフサイクル
| ステータス | 意味 |
|---|---|
scheduled | 確定済み、放送される |
tentative | 放送されない可能性がある(外部条件次第) |
live | 現在放送中またはライブストリーミング中 |
postponed | スケジュールされていたが将来の日付に延期された |
cancelled | 放送されない |
aired | 既に放送済み — バックカタログとリプレイインベントリ用 |
published | 既に公開済み — オンデマンドのキャッチアップインベントリ用 |
scheduled または tentative → live → aired または published。scheduled エピソードは postponed(延期)または cancelled になる場合があります。postponed エピソードは再スケジュール時に scheduled に戻る。tentative エピソードは scheduled、cancelled、または postponed に解決されます。
番組からの継承
エピソードは上書きしない番組レベルのフィールドを継承します:content_rating:エピソードの値が番組の基準を上書きします。存在しない場合は番組のレーティングが適用されます。special:エピソードの値が番組レベルの special を上書きします。存在しない場合は番組の special が適用されます。通常の番組でもイベントに紐付いたエピソードを持てる(例:選挙夜特番のある日刊ニュース番組)。guest_talent:番組のレギュラーtalentに追加される — 置き換えではありません。topics:ブランドセーフティのための追加コンテキストであり、番組のgenreの代替ではありません。
特番とリミテッドシリーズ
番組はバイヤーエージェントにその性質を伝えるオプションのアノテーションを持てる。これらは組み合わせ可能 — ある番組は特番かつリミテッドシリーズ(例:4話構成のオリンピックドキュメンタリー)になれる。特番
特番は現実世界のイベントやシーンに紐付いたコンテンツです。special オブジェクトは番組とエピソードの両方に付けられます。番組に付いている場合は番組全体がイベントに紐付くことを意味します。エピソードに付いている場合はそのエピソードがイベントに紐付くことを意味し(content_rating と同じ継承パターンに従い、存在する場合は番組レベルの special を上書きします)。
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
name | string | Yes | イベントの名称(例:“Olympics 2028”、“Super Bowl LXI”) |
category | string | No | awards、championship、concert、conference、election、festival、gala、holiday、premiere、product_launch、reunion、tribute |
starts | datetime | No | イベントの開始日時 |
ends | datetime | No | イベントの終了日時。単日イベントの場合は省略します。 |
special フィールドは cadence とは別物です。cadence はリリース頻度を表す(event = 単発または散発的)。special オブジェクトはコンテンツを紐付ける現実世界のイベントと、それがいつ起きるかを表す — バイヤーエージェントがタイミングの関連性とプレミアム価格を評価するために必要な情報です。
リミテッドシリーズ
リミテッドシリーズは、定義されたアークを持つ有限のコンテンツ放送です。継続中のシリーズとは異なり、リミテッドシリーズには計画された終了があります。| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
total_episodes | integer | No | 予定エピソード数 |
starts | datetime | No | シリーズの開始日時 |
ends | datetime | No | シリーズの終了日時 |
limited_series フィールドは season とは別物です:シリーズはリミテッドでなくても season を持てる(継続中のシリーズも season を持つ)。リミテッドシリーズは番組に計画された終了があるという構造的なコミットメントです。
商品が番組を参照する方法
商品はshows — パブリッシャーの adagents.json で宣言された番組を指す {publisher_domain, show_ids} セレクターの配列 — を通じて番組を参照します。これは publisher_properties と同じパターンです。バイヤーはパブリッシャーの adagents.json から完全な番組オブジェクトを解決します。同じ番組の異なるエピソードをスコープする商品が存在し得るため、エピソードは商品ごとに episodes 配列で列挙されます。
ラン・オブ・ショー(特定のエピソードなし)
商品はエピソードを列挙せずに番組を参照できます。これは「フライト期間中に放送されるエピソードを問わず、この番組全体のインベントリ」を意味します:特定のエピソード
プレミアムまたはギャランティードバイの場合、セラーは特定のエピソードにスコープします:get_products レスポンス構造
商品はshows セレクターで番組を参照する — publisher_properties と同じパターンです。各セレクターは publisher_domain と、そのパブリッシャーの adagents.json で宣言された番組を指す show_ids 配列を持ちます。バイヤーは adagents.json から完全な番組オブジェクトを解決します。
番組の正規アイデンティティ
番組のアイデンティティは{publisher_domain, show_id} — adagents.json で宣言するパブリッシャーにスコープされます。つまり、番組クリエイターは自身が正規のレジストリとして機能できます。
クリエイターを正規パブリッシャーとして
MrBeast のようなクリエイターはmrbeast.com/adagents.json で番組を宣言します。そのクリエイターのインベントリをパッケージングするセラー — YouTube セールスハウス、CTV ディストリビューター、クリエイター自身のチーム — はすべて同じ正規ソースを参照します:
mrbeast.com + beast_games を目にします。IMDb IDや配信識別子のクロスリファレンスは不要 — クリエイターのドメインがレジストリそのものです。
クリエイターが adagents.json を公開していない場合
すべての番組がクリエイター所有のドメインを持つわけではありません。ストリーミングプラットフォームのオリジナルシリーズは、そのプラットフォームのadagents.json にしか存在しない場合があります。その場合、プラットフォームが正規パブリッシャーとなり、shows はそのドメインを指します。単一の正規ソースなしに同じ番組が複数のプラットフォームに存在する場合、番組オブジェクトの配信識別子がクロスセラーマッチングを担う。
アイデンティティ解決の優先順位
バイヤーエージェントは次の順番で番組のアイデンティティを解決すべきです:- 正規パブリッシャー — クリエイター自身の
adagents.jsonのpublisher_domain+show_id。最も強いシグナル。 - プラットフォーム非依存識別子 — 番組の
distribution配列のimdb_id、gracenote_id、eidr_id。正規パブリッシャーが存在しない場合の信頼できるクロスリファレンス。 - プラットフォーム固有識別子 — Spotify、Apple、YouTube のID。プラットフォーム内では有用だが普遍的ではありません。
ディスカバリーの例
エピソード付き CTV 番組
既知の番組と予定エピソードに対してスポンサーシップを販売するストリーミングプラットフォーム:関連番組と派生コンテンツ
メイン番組とその companion アフターショー、およびハイライトクリップを提供するストリーミングプラットフォーム:derivative_of でソースエピソードを参照します。companion のアフターショーはメイン番組の related_shows でリンクされている — Nova Kitchen をターゲティングするバイヤーはアフターショーを追加のリーチ機会として発見できます。
配信付きポッドキャスト
複数の配信プラットフォームにまたがって販売するポッドキャストネットワーク。adagents.json の番組の distribution 配列が完全な配信フットプリントを記録し、バイヤーはクロスセラーマッチングに配信識別子を使う:
テンタティブエピソード付きライブイベント
ライブイベントシリーズに対してスポンサーシップを販売するスポーツリーグ。ライブ放送はゲーム時間が読めないためflexible_end を使い、広告ブレークがタイムアウトやピリオド間など試合の流れに従うため unplanned_breaks を使います。テンタティブな第5戦はシリーズの結果次第 — 4試合でどちらのチームも勝てなかった場合にのみ開催されます。
cadence: "event" は非繰り返しシリーズを示し、flexible_end は放送時間が概算であることをバイヤーに伝え、unplanned_breaks: true は広告ブレークが予定されたスケジュールではなく試合の流れに従うことを示します。テンタティブな第5戦には valid_until が含まれており、バイヤーエージェントはいつ再クエリすべきかを知ることができる — シリーズが4試合で終われば、そのエピソードは cancelled に解決されます。バイヤーは暫定エピソードに予算をコミットする前に常に valid_until を確認すべきです。
番組のディスカバリー
バイヤーは標準のget_products ワークフローで番組を発見します。自然言語のブリーフが番組の選択を導く:
shows セレクター付きの商品を返します。バイヤーは各パブリッシャーの adagents.json から完全な番組オブジェクトを解決します。番組専用のディスカバリーエンドポイントは存在しない — 番組はプロダクトディスカバリーと adagents.json のクローリングを通じて発見されます。
ブランドセーフティ
番組は2レベルのブランドセーフティモデルを提供します:番組のベースラインとエピソードごとの上書き。番組ベースライン
番組のデフォルトブランドセーフティプロファイルは次から構成されます:content_rating— 番組の申告されたレーティングシステムと値genre— コンテンツカテゴリ(機械可読な評価のためにgenre_taxonomyの使用を推奨)talent— ホストとレギュラーキャスト。より深い評価のためにオプションで brand.json 参照付き
エピソードの上書き
エピソードの詳細が利用可能な場合、セーフティプロファイルを変える可能性があります:- 番組ベースラインと異なる
content_rating(今週は TV-PG ではなく TV-14) - タレントプロファイルを変える
guest_talent(問題のあるゲスト) - エピソード固有のコンテンツシグナルを追加する
topics
モデル化されていないもの
AdCP は未知の将来のエピソードのコンテンツセーフティを予測しません。「4月の全エピソード」にコミットするバイヤーは番組のベースラインプロファイルに基づいて購入し、変動を受け入れる。セラーのコンテンツ基準と番組の実績がバイヤーにとっての判断根拠となります。配信識別子
各番組のdistribution 配列は、プラットフォーム固有の識別子で番組を特定のパブリッシャープラットフォームにマッピングします。これにより、2つの異なるセラーが同じ番組の商品を提供している場合に、バイヤーエージェントが共通識別子でそれらを照合できます。
クロスセラーマッチング
プラットフォーム非依存識別子が重複排除に最も信頼できます:| 型 | 例 | 備考 |
|---|---|---|
imdb_id | tt1234567 | プラットフォームを横断する汎用リファレンス |
gracenote_id | EP012345678 | TVメタデータの業界標準 |
eidr_id | 10.5240/XXXX-XXXX-XXXX-XXXX-XXXX-C | 映像コンテンツの ISO 10528 |
プラットフォーム固有識別子
apple_podcast_id、spotify_show_id、rss_url、podcast_guid、amazon_music_id、iheart_id、podcast_index_id。利用可能なビデオ/CTV型:youtube_channel_id、youtube_playlist_id、amazon_title_id、roku_channel_id、pluto_channel_id、tubi_id、peacock_id、tiktok_id、twitch_channel。その他:domain、substack_id。
広告インベントリ
エピソードはad_inventory オブジェクトにブレークベースの広告インベントリを宣言します:
| フィールド | 型 | 説明 |
|---|---|---|
expected_breaks | integer | 予定広告ブレーク数 |
total_ad_seconds | integer | 全ブレーク合計の広告秒数 |
max_ad_duration_seconds | integer | ブレーク内の1広告の最大尺 |
unplanned_breaks | boolean | false:全ブレーク事前定義済み。true:ライブ状況(スポーツのタイムアウト、ライブニュース)によってブレークが発生。 |
supported_formats | string[] | ブレークでサポートされるフォーマット型(例:"video"、"audio") |
ad_inventory の一部ではなく商品のプレースメントです。
LEAP との関係
エピソードモデルは、ライブストリーミングイベント向けの IAB Tech Lab の LEAP Forecasting API に合わせています:| LEAP コンセプト | AdCP の対応 |
|---|---|
| UpcomingEvent | Episode(scheduled_at + status) |
| Content(AdCOM 1.0) | 番組メタデータ(genre、content_rating、talent) |
| AdInventoryConfiguration | Episode の ad_inventory + 商品プレースメント |
| Event status | Episode の status(scheduled、tentative、cancelled) |
| Unplanned breaks | ad_inventory.unplanned_breaks |
| Flexible end time | Episode の flexible_end |
番組ターゲティング
複数の番組を持つ商品はデフォルトでバンドル — バイヤーは列挙されたすべての番組を取得します。セラーはshow_targeting_allowed: true を設定して、プロパティの property_targeting_allowed と同じパターンでバイヤーがサブセットをターゲティングできるようにすることができます。
show_targeting_allowed | 意味 |
|---|---|
false(デフォルト) | バンドル — バイヤーは全番組を取得する |
true | バイヤーはメディアバイで特定の番組を選択できる |
マルチショーバンドル
1つの商品はshows に複数の show ID を列挙することで複数の番組にまたがれる。商品が複数の番組を持つ場合、各エピソードはバイヤーエージェントがどのエピソードがどの番組に属するかを判断できるよう show_id を含めなければなりません。
関連項目
- メディア商品 — 完全な商品モデル
- brand.json — タレントのアイデンティティとブランドセーフティ評価
- プロダクトディスカバリー — バイヤーが
get_productsでインベントリを発見する方法