最適化目標の移行
AdCP 3.0 rc.1 は単数のoptimization_goal オブジェクトを optimization_goals 配列に置き換える。各目標は kind の識別子付きユニオンで、優先順位付きのマルチゴールパッケージをサポートします。
変更内容
目標の種類
すべての目標にはkind 識別子がある:
metric— セラーネイティブのデリバリーメトリック（クリック、視聴、リーチ、エンゲージメントなど）event—sync_event_sourcesで設定されたイベントソースに紐づいたコンバージョントラッキング
メトリック目標
clicks、views、completed_views、viewed_seconds、attention_seconds、attention_score、engagements、follows、saves、profile_visits、reach。
ターゲットタイプ:
cost_per— メトリックユニットあたりの目標コスト（例: $2.50 CPC）threshold_rate— 目標レート閾値（例: 2% CTR の 0.02）
イベント目標
cost_per— コンバージョンあたりの目標コスト（CPA）per_ad_spend— 広告費用対効果（ROAS）の目標。value_fieldが必要。maximize_value— 総コンバージョン価値を最大化。value_fieldが必要。
リーチ目標
リーチは追加フィールドを持つメトリック目標だ:reach_unit の値: individuals、households、devices、accounts、cookies、custom。
target_frequency は min または max の少なくとも一方と、Duration オブジェクトとしての window（例: {"interval": 7, "unit": "days"} または {"interval": 1, "unit": "campaign"}）が必要です。
マルチゴールパッケージ
複数の目標はpriority（1 = 最高）で順序付けられます。セラーは優先度の高い目標を優先的に最適化し、低い優先度の目標をタイブレーカーとして使用します。
beta.3:
プロダクトケイパビリティ
プロダクトはmetric_optimization を通じて最適化サポートを宣言する:
test=false
supported_metrics— プロダクトが最適化できるメトリックsupported_reach_units—reachが supported_metrics にある場合に必要supported_view_durations—completed_viewsメトリックの秒数supported_targets— 利用可能なターゲット種類。省略された場合、ターゲットなしの目標（ボリューム最大化）のみ許可されますmax_optimization_goals— パッケージあたりの目標の最大数
移行ステップ
1
フィールドの名前を変更する
すべてのリクエスト構築コードで
optimization_goal（単数）を optimization_goals（配列）に置き換える。2
kind 識別子を追加する
既存の目標を
"kind": "metric" または "kind": "event" でラップします。メトリック目標はセラーネイティブのメトリックを使用し、イベント目標は sync_event_sources からのイベントソースを参照します。3
ターゲットを再構造化する
フラットなターゲットフィールド（例:
target_cpc）を識別子付きの target オブジェクトに置き換える: { "kind": "cost_per", "value": 2.50 }。4
優先度を追加する
単一目標パッケージには
priority: 1 を設定します。マルチゴールパッケージには昇順の優先度値を割り当てる（1 = 最高）。5
レスポンス解析を更新する
レスポンスから最適化目標を読む場合（例:
get_media_buy）、タイプ固有のフィールドにアクセスする前に kind で分岐して目標タイプを決定します。6
プロダクトケイパビリティを確認する
目標を送信する前に、プロダクトの
metric_optimization.supported_metrics と max_optimization_goals を確認します。セラーはサポートされていないメトリックと制限を超えた目標を拒否します。7
スキーマに対して検証する
リクエストを
optimization-goal.json スキーマに対して実行します。識別子付きユニオンは種類ごとに正しいフィールドを適用します。コンバージョントラッキングと最適化目標
イベントソースを設定し、コンバージョンイベントを送信し、デリバリー目標を最適化します。
関連: チャンネル | 価格 | シグナル | AdCP 3.0 概要