シグナルの移行

AdCP 3.0 rc.1 はシグナルプロトコルに3つの変更を加える: デリバリーターゲットのフラット化、構造化された価格オプション、使用状況レポートの簡素化。

deliver-to のフラット化

get_signals リクエストのネストされた deliver_to オブジェクトが2つのトップレベルフィールドに置き換えられます。

beta.3	rc.1	注記
`deliver_to.destinations`	`destinations`	トップレベルに移動
`deliver_to.countries`	`countries`	トップレベルに移動

beta.3:

test=false

{
  "signal_spec": "in-market auto intenders",
  "deliver_to": {
    "destinations": [
      { "agent_url": "https://dsp.example.com", "seat_id": "seat_123" }
    ],
    "countries": ["US", "CA"]
  }
}

rc.1:

test=false

{
  "signal_spec": "in-market auto intenders",
  "destinations": [
    { "agent_url": "https://dsp.example.com", "seat_id": "seat_123" }
  ],
  "countries": ["US", "CA"]
}

価格オプション

レガシーの pricing オブジェクト（単一の cpm フィールドを持つ）が pricing_options 配列に置き換えられます。各オプションは model による識別子付きユニオンです。

beta.3	rc.1	注記
`pricing: { cpm: 2.50 }`	`pricing_options[]`	価格モデルオブジェクトの配列
暗黙的な価格選択	`activate_signal` での `pricing_option_id`	バイヤーの明示的なコミットメント
冪等性なし	`report_usage` での `idempotency_key`	重複請求を防ぐ

3つの価格モデル

CPM — 1000インプレッションあたりの固定コスト:

{
  "$schema": "https://adcontextprotocol.org/schemas/latest/core/signal-pricing-option.json",
  "pricing_option_id": "po_auto_cpm",
  "model": "cpm",
  "cpm": 2.50,
  "currency": "USD"
}

メディア費用の割合 — メディア支出のパーセンテージ、オプションの CPM 上限付き:

{
  "$schema": "https://adcontextprotocol.org/schemas/latest/core/signal-pricing-option.json",
  "pricing_option_id": "po_auto_pom",
  "model": "percent_of_media",
  "percent": 15,
  "max_cpm": 5.00,
  "currency": "USD"
}

固定料金 — レポート期間ごとの固定料金（月次ライセンスセグメント）:

{
  "$schema": "https://adcontextprotocol.org/schemas/latest/core/signal-pricing-option.json",
  "pricing_option_id": "po_auto_flat",
  "model": "flat_fee",
  "amount": 10000.00,
  "period": "monthly",
  "currency": "USD"
}

価格を伴うアクティベーション

シグナルをアクティベートするとき、選択した pricing_option_id を渡す:

test=false

{
  "signal_agent_segment_id": "luxury_auto_intenders",
  "destinations": [
    { "type": "agent", "agent_url": "https://dsp.example.com", "account": { "account_id": "acct_pinnacle" } }
  ],
  "pricing_option_id": "po_auto_cpm"
}

使用状況レポート

report_usage は idempotency_key を追加し、kind と operator_id フィールドを削除します。

beta.3	rc.1	注記
`kind` フィールド	削除	使用状況レコードは `signal_agent_segment_id` または `standards_id` で自己記述
`operator_id` フィールド	削除	アカウント参照がオペレーターアイデンティティを提供
冪等性なし	`idempotency_key`	クライアント生成の UUID がリトライ時の重複請求を防ぐ

rc.1 使用状況レポート:

{
  "$schema": "https://adcontextprotocol.org/schemas/latest/account/report-usage-request.json",
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
  "reporting_period": {
    "start": "2025-03-01T00:00:00Z",
    "end": "2025-03-31T23:59:59Z"
  },
  "usage": [
    {
      "account": { "account_id": "acct_pinnacle_signals" },
      "signal_agent_segment_id": "luxury_auto_intenders",
      "pricing_option_id": "po_auto_cpm",
      "impressions": 4200000,
      "media_spend": 21000.00,
      "vendor_cost": 2100.00,
      "currency": "USD"
    }
  ]
}

使用状況レコードの pricing_option_id はアクティベーション時に渡したものと一致する必要があり、ベンダーが正しいレートが適用されたことを確認できます。

移行ステップ

deliver_to をフラット化する

get_signals リクエストで deliver_to.destinations と deliver_to.countries をトップレベルフィールドに移動します。

pricing_options 配列を解析する

pricing（オブジェクト）の代わりに pricing_options（配列）を読み取るようにシグナルレスポンスの解析を更新します。model フィールドで価格タイプを判別します。

アクティベーション時に価格を選択する

activate_signal を呼び出すとき、シグナルの pricing_options 配列から選択した pricing_option_id を渡します。

report_usage に idempotency_key を追加する

各 report_usage 呼び出しに一意のキー（UUID）を生成します。同じキーを使ったリトライは冪等です。

kind と operator_id を削除する

使用状況レコードから kind と operator_id を削除します。使用状況タイプは signal_agent_segment_id（シグナル）または standards_id（ガバナンス）の存在で判別されます。

ライフサイクルを通じて pricing_option_id を追跡する

アクティベーション時に pricing_option_id を保存し、ベンダーが請求を確認できるように report_usage レコードで渡します。

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

get-signals-request.json、activate-signal-request.json、report-usage-request.json スキーマに対してリクエストを実行します。

シグナルプロトコル

シグナル探索、アクティベーション、使用状況レポート、価格モデルの完全リファレンス。

関連: 価格 | 最適化目標 | AdCP 3.0 概要

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

シグナルの移行

シグナルの移行

deliver-to のフラット化

価格オプション

3つの価格モデル

価格を伴うアクティベーション

使用状況レポート

移行ステップ

シグナルプロトコル

​シグナルの移行

​deliver-to のフラット化

​価格オプション

​3つの価格モデル

​価格を伴うアクティベーション

​使用状況レポート

​移行ステップ

シグナルプロトコル

シグナルの移行

deliver-to のフラット化

価格オプション

3つの価格モデル

価格を伴うアクティベーション

使用状況レポート

移行ステップ