価格の移行

AdCP 3.0 は明確化のために価格フィールドの名前を変更し、ハード制約（パブリッシャーが適用する価格）とソフトヒント（バイヤーが入札を調整するための過去データ）を分離します。

変更内容

v2 フィールド	v3 フィールド	変更タイプ
`fixed_rate`	`fixed_price`	名前変更
`price_guidance.floor`	`floor_price`	トップレベルに移動

pricing_model、currency、pricing_option_id、price_guidance パーセンタイル（p25、p50、p75、p90）は変更なし。

ハード制約とソフトヒント

v3 は明示的なセマンティックの区別を設ける: ハード制約 — 違反した場合に入札が拒否されるパブリッシャー適用の価格:

fixed_price — ユニットあたりの正確な価格（固定価格ディール）
floor_price — 許容される最低入札額（オークション価格）

これらは相互排他的です。価格オプションは fixed_price（保証レート）または floor_price（最低価格付きオークション）のいずれかを持ち、両方は持たない。 ソフトヒント — バイヤーが入札を調整するための過去のパーセンタイル:

price_guidance.p25 — 最近の落札入札の25パーセンタイル
price_guidance.p50 — 最近の落札入札の中央値
price_guidance.p75 — 最近の落札入札の75パーセンタイル
price_guidance.p90 — 最近の落札入札の90パーセンタイル

ディールタイプのマッピング

これらのフィールドは標準的なプログラマティックディールタイプにマッピングされます:

ディールタイプ	AdCP フィールド	説明
プログラマティックギャランティード（PG）	`fixed_price`	固定 CPM、保証配信
プリファードディール	`fixed_price`	固定 CPM、非保証（バイヤーがファーストルック）
プライベートマーケットプレイス（PMP）	`floor_price`	最低入札付きオークション
オープンオークション	どちらでもない	フロアや固定価格なし — オープン入札

PG とプリファードディールはどちらも fixed_price を使用します。両者の区別は価格ではなく配信コミットメントにある — PG は配信ボリュームを保証するが、プリファードディールはボリューム保証なしでファーストルックアクセスを提供します。

固定価格ディール

v2:

{
  "pricing_option_id": "cpm_usd_fixed",
  "pricing_model": "cpm",
  "currency": "USD",
  "fixed_rate": 25.00
}

v3:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/pricing-options/cpm-option.json",
  "pricing_option_id": "cpm_usd_fixed",
  "pricing_model": "cpm",
  "currency": "USD",
  "fixed_price": 25.00
}

fixed_rate を fixed_price に名前変更します。構造的な変更はない。

オークション価格

v2:

{
  "pricing_option_id": "cpm_usd_auction",
  "pricing_model": "cpm",
  "currency": "USD",
  "price_guidance": {
    "floor": 10.00,
    "p50": 15.00,
    "p75": 18.00
  }
}

v3:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/pricing-options/cpm-option.json",
  "pricing_option_id": "cpm_usd_auction",
  "pricing_model": "cpm",
  "currency": "USD",
  "floor_price": 10.00,
  "price_guidance": {
    "p50": 15.00,
    "p75": 18.00
  }
}

2つの変更:

price_guidance.floor がトップレベルの floor_price に移動
price_guidance はパーセンタイルヒントのみを保持

価格ガイダンスオブジェクト

v3 の price_guidance オブジェクトには統計パーセンタイルのみが含まれます:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/pricing-options/price-guidance.json",
  "p25": 8.50,
  "p50": 15.00,
  "p75": 18.00,
  "p90": 22.00
}

すべてのフィールドはオプションです。パブリッシャーは提供できるパーセンタイルを含めます。

フラットレート価格

v2（識別子なしのパラメーター付き DOOH）:

{
  "pricing_option_id": "dooh_times_square",
  "pricing_model": "flat_rate",
  "currency": "USD",
  "fixed_rate": 50000.00,
  "parameters": {
    "duration_hours": 24,
    "sov_percentage": 100,
    "estimated_impressions": 1500000
  }
}

v3:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/pricing-options/flat-rate-option.json",
  "pricing_option_id": "dooh_times_square",
  "pricing_model": "flat_rate",
  "currency": "USD",
  "fixed_price": 50000.00,
  "parameters": {
    "type": "dooh",
    "duration_hours": 24,
    "sov_percentage": 100,
    "estimated_impressions": 1500000
  }
}

2つの変更:

fixed_rate が fixed_price に名前変更（他の価格モデルと同じ）
parameters に DOOH インベントリの必須 "type": "dooh" 識別子が追加

v2 で parameters がなかったスポンサーシップの flat_rate オプションは v3 でも引き続き省略します。fixed_price はフラットレートオプションでオプションであることに注意 — 存在しない場合、フラットレートはオークションベースだ（まれだが一部の DOOH インベントリで有効）。

最低支出

v3 はすべての価格オプションにオプションの min_spend_per_package フィールドを追加します:

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/pricing-options/cpm-option.json",
  "pricing_option_id": "cpm_usd_premium",
  "pricing_model": "cpm",
  "currency": "USD",
  "floor_price": 15.00,
  "min_spend_per_package": 5000.00,
  "price_guidance": {
    "p50": 22.00,
    "p75": 28.00
  }
}

これにより、パブリッシャーはパッケージごとの最低支出要件を宣言できます。

移行期間中の処理

移行中に、リーダーは古いフィールド名と新しいフィールド名の両方に遭遇する場合があります。両方の確認を検討する:

test=false

const price = option.fixed_price ?? option.fixed_rate;
const floor = option.floor_price ?? option.price_guidance?.floor;

v3 ライターは新しいフィールド名のみを出力する必要があります。古いフィールド名（fixed_rate、price_guidance.floor）は v3 スキーマバリデーションで認識されない。上流のすべてのセラーが v3 スキーマに移行したら v2 フォールバックを削除します。

移行ステップ

fixed_rate の名前を変更する

すべての価格オプションで fixed_rate を fixed_price に名前変更します。

floor を移動する

floor を price_guidance の内部からトップレベルの floor_price に移動します。

price_guidance をクリーンアップする

price_guidance オブジェクトから floor を削除する（パーセンタイルのみが残る）。

リーダーを更新する

新しいフィールド名を探すようにコードを更新します。移行中は両方の一時的なフォールバックを検討します。

オークション入札をテストする

フロア適用が新しいフィールド位置で機能することを確認します。

スキーマに対して検証する

各価格モデルは /schemas/v3/pricing-options/ に独自のスキーマを持ちます。

メディアプロダクト

プロダクトが価格オプション、チャンネル、ケイパビリティをどう宣言するか。

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

価格の移行

価格の移行

変更内容

ハード制約とソフトヒント

ディールタイプのマッピング

固定価格ディール

オークション価格

価格ガイダンスオブジェクト

フラットレート価格

最低支出

移行期間中の処理

移行ステップ

メディアプロダクト

​価格の移行

​変更内容

​ハード制約とソフトヒント

​ディールタイプのマッピング

​固定価格ディール

​オークション価格

​価格ガイダンスオブジェクト

​フラットレート価格

​最低支出

​移行期間中の処理

​移行ステップ

メディアプロダクト

価格の移行

変更内容

ハード制約とソフトヒント

ディールタイプのマッピング

固定価格ディール

オークション価格

価格ガイダンスオブジェクト

フラットレート価格

最低支出

移行期間中の処理

移行ステップ