​

クリエイティブトランスフォーマーへの移行（3.1）

• Format.input_format_ids / Format.output_format_ids
• Format.pricing_options
• list_creative_formats の input_format_ids / output_format_ids ディスカバリー フィルター

​

何が変わったか

​

移行する

​

Format I/O シグネチャ → トランスフォーマー

{
  "format_id": { "agent_url": "https://creative.example", "id": "resize_to_meta" },
  "input_format_ids":  [{ "agent_url": "https://creative.example", "id": "display_master" }],
  "output_format_ids": [{ "agent_url": "https://creative.example", "id": "meta_reels_9x16" }]
}

{
  "transformer_id": "resize_to_meta",
  "name": "Resize to Meta Reels",
  "input_format_ids":  [{ "agent_url": "https://creative.example", "id": "display_master" }],
  "output_format_ids": [{ "agent_url": "https://creative.example", "id": "meta_reels_9x16" }],
  "params": [],
  "pricing_options": [ { "pricing_option_id": "per_format", "model": "per_unit", "unit": "format", "unit_price": 0.10, "currency": "USD" } ]
}

​

Format 価格 → トランスフォーマー価格

​

list_creative_formats ディスカバリーフィルター → list_transformers

​

何もしないと何が静かに壊れるか

1. ディスカバリー読み取りの劣化（バイヤー）。 バイヤー/ストーリーボードが、Format.input_format_ids / output_format_ids を読むか、それらで list_creative_formats をフィルターすることによって のみ ビルドケイパビリティを学ぶ場合、3.1 セラーに対して動作し続けますが、セラーが非推奨フィールドを発するのをやめてケイパビリティをトランスフォーマーに移すにつれ 次第に空になる結果 を見ます。エラーなし — ただオプションがどんどん減るだけ。フィールドがそのデータより長生きする。 ディスカバリーを list_transformers に移してください。
2. 出力ごとの価格ギャップ（複数パブリッシャーのテンプレートセラー）。 出力を異なる価格にしていたテンプレートは、applies_to_output_format_ids でその形状を保てますが、すべての出力にスコープされた価格オプションかスコープされていないデフォルトのいずれかが必要です。そうでなければ、価格のない出力のビルドは UNPRICEABLE_OUTPUT で拒否されます。
3. ファンアウト / best-of-N の支出過少カウント（課金パイプライン）。 max_variants / max_creatives では、生成されたすべてのバリアントが課金されますが、トラフィックされた リーフのみが遅延的に creative_id を得ます。破棄された best-of-N のリーフは、build_creative レスポンスの インラインのリーフごとの vendor_cost 経由で のみ 課金されます — それらは決して creative_id を得ず、したがって決して report_usage に現れません。report_usage のみから支出を再照合するパイプライン（3.0 の不変条件「すべての課金単位は creative_id 経由で再照合される」）は、破棄されたすべてのバリアントの分だけ 過少カウント します。トラフィックされていないリーフの権威あるレコードとして、インラインのリーフごとの領収書を取り込んでください。その領収書が唯一のレコードなので、スキーマがそれを強制します: ビルドがコストをレポートするとき（集計 vendor_cost が存在するとき）、生成されたすべてのリーフは独自の vendor_cost + currency を運ばなければならず（MUST）、支払いビルドが機械可読なコストのないリーフを返せません。境界に注意: スキーマはレポートされたコストの 内部的な完全性と一貫性 を強制します — 真に無料のビルド（または正当に 0 の CPM 遅延リーフ）を、過少レポートするために集計を省略する支払いビルドと区別できません。「集計が欠如」は、ゼロコストの証明ではなく、再照合すべき信頼アサーション（セラー請求書対 report_usage + インライン領収書、pricing_option_id 基準で区別）です — スキーマ有効性を課金の正直さと取り違えないでください。

​

SDK の動作とタイムライン

​

関連項目

• list_transformers — トランスフォーマー、そのパラメーター、オプション値、価格を発見
• build_creative — トランスフォーマーを選択、設定、乗算、絞り込み
• 3.1 の新機能