> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Sponsored Placement アダプターコントラクト

> 単一の sponsored_placement 正準の下で出荷される 4 つのランタイムコントラクトファミリー — Amazon SP、Criteo/CitrusAd、Pinterest/Snap Collection、generative-per-SKU。

`sponsored_placement` 正準は、リテールメディアのカタログ駆動クリエイティブ — Amazon SP、Criteo SP、CitrusAd SP、Pinterest Collection、generative-per-SKU — をカバーします。スキーマはバイナリ軸（`composition_model`、`fanout_mode`、`item_production_model`）を捕捉しますが、ランタイムコントラクト — ファンアウトセマンティクス、カタログアセット配線、アダプターごとのトラッキング — はアダプターファミリー間で十分に異なるため、`sponsored_placement` に対して検証されるマニフェストは、それが特定のリテールメディアネットワークで実際にサーブするかどうかについてバイヤーにほとんど伝えません。

このページは、4 つのコントラクトファミリー、その現在の実験的準備状況、スキーマに存在しないアダプター固有の癖を文書化します。正準は、少なくとも 2 つのリテールメディアネットワークが `format_schema` 証拠を出荷するまで、3.1 GA を過ぎても `experimental: true` のままです（[`canonical-formats.mdx` §`experimental` — 1 フィールド、両軸](/docs/creative/canonical-formats#experimental--one-field-both-axes) を参照）。

## 4 つのコントラクトファミリー

| Family                     | `composition_model`      | `fanout_mode`            | `item_production_model`          | Nondeterminism flag                | Adopters                                      |
| -------------------------- | ------------------------ | ------------------------ | -------------------------------- | ---------------------------------- | --------------------------------------------- |
| **リテールメディア決定的、バイヤーアップロード** | `deterministic`          | `per_item`               | `buyer_uploaded`                 | Not set                            | Amazon SP                                     |
| **リテールメディアネットワーク合成**       | `deterministic`          | `per_item`               | `seller_pre_rendered_from_brief` | Not set                            | Criteo SP、CitrusAd SP                         |
| **インプレッションごとコレクションレイアウト**  | `deterministic`（議論の余地あり） | `multi_item_in_creative` | `buyer_uploaded`                 | Not set                            | Pinterest Collection、Snap Collection          |
| **Generative-per-SKU**     | `deterministic`          | `per_item`               | `agent_synthesized`              | `synthesis_nondeterministic: true` | ベンダー固有（Pencil、Persado、バーティカルリテールメディアプラットフォーム） |

### 1. リテールメディア決定的、バイヤーアップロード（Amazon SP）

バイヤーは `sync_creatives` 経由でカタログアセット（製品画像、ヘッドライン、説明）をアップロードします。リテールメディアネットワークはカタログ行 + アセットを取り込み、クエリ/カテゴリートリガーに対して決定的にサーブします — レンダー時のファンアウトなし。バイヤーはインプレッションごとのレンダリングを予測できます。

* **カタログアセットコントラクト:** バイヤーはカタログアイテムごとに 1 クリエイティブを供給。`source_catalog` スロットはバイヤーの製品フィードを指す。アイテムごとのアセットが必要。
* **トラッキング:** Amazon ASIN + 標準リテールメディアイベント語彙。アイテムごとのアトリビューションはカタログ行の識別子にマップ。
* **アダプターの癖:** Amazon のカテゴリートリガーシステムは、同じアップロードされたクリエイティブが異なるカテゴリーコンテキストの下でサーブされうることを意味します — バイヤーはインプレッションレベルのカテゴリーをクリエイティブ形状によって信頼できないものとして扱わなければなりません（MUST）。カテゴリーアトリビューションには Amazon のレポートに依存します。
* **実験的準備状況:** サンドボックスと制御されたアダプター使用に十分予測可能。最も予測可能なファミリー。Amazon からの `format_schema` 証拠は非実験的への昇格をサポートするでしょう。

### 2. リテールメディアネットワーク合成（Criteo SP、CitrusAd SP）

バイヤーはブリーフ + ブランドアセット（ロゴ、ブランドカラー）を供給します。リテールメディアネットワークは自身のカタログ + デザインテンプレートに対してプレースメントを合成します。バイヤーはアセットバンドルレベルではインプレッションごとのレンダリングを予測できず、ブランドディレクションレベルでのみ予測できます。

* **カタログアセットコントラクト:** バイヤーはブリーフ + ブランドアセットを供給。`source_catalog` は *セラーの* カタログ（リテールメディアネットワークの製品インデックス）で、バイヤーのものではありません。バイヤーの製品参照は SKU / GTIN / カテゴリー経由でセラーカタログ行に一致されます。
* **トラッキング:** リテールメディアネットワーク自身のイベント語彙。バイヤーアトリビューションは直接クリエイティブイベントではなくネットワークのレポート API を通じてマップ。
* **アダプターの癖:** Criteo の合成ロジックはリテーラー統合によって変わります — 同じバイヤーブリーフが Criteo 経由で Walmart 対 Target 対 Best Buy で異なるプレースメントを生成します。バイヤーはリテーラーごとのレンダリングを不透明として扱い Criteo の集計レポートに依存しなければなりません（MUST）。
* **実験的準備状況:** 制御されたアダプター使用に適する。合成の不透明性が非実験的昇格へのギャップです — `format_schema` 証拠がリテーラーごとの変動性を文書化する必要があります。

### 3. インプレッションごとコレクションレイアウト（Pinterest Collection、Snap Collection）

バイヤーはヒーロー画像 + カタログアイテムのコレクションを供給します。表面はインプレッションごとにコレクションレイアウト（グリッド、カルーセル、カバー + リビール）を選びます。`composition_model: deterministic` はアセットレベルでは技術的に真ですが、レイアウトレベルでは緩いです。

* **カタログアセットコントラクト:** バイヤーはヒーローアセットスロット + アイテム配列（各アイテム: 画像 + キャプション + URL）を持つ 1 クリエイティブを供給。`source_catalog` スロットはバイヤーのキュレートされたアイテムコレクションで、完全な製品フィードではありません。
* **トラッキング:** Pinterest のコレクションアイテムイベント（`collection_item_click`、`collection_close_up`）プラス標準インプレッション/クリック。アイテムごとのアトリビューション利用可能。レイアウトバリアントアトリビューションは公開されません。
* **アダプターの癖:** Snap Collection の「カバー + リビール」レイアウトは特定のアスペクト比とアセット数の組み合わせを要求します — スキーマは強制しません。バイヤーは同期前に事前検証すべきです（SHOULD）。
* **実験的準備状況:** 制御されたアダプター使用に適する。「決定的」クレームはアセットレベルで生き残りますが、レイアウト変動性が、表面ごとの適合性証拠なしの非実験的昇格をブロックします。

### 4. Generative-per-SKU（ベンダー固有）

バイヤーはブリーフ + カタログ参照を供給します。セラーの生成パイプラインが SKU ごとにユニークなクリエイティブを生成します。1 ブリーフ × N カタログアイテム → N レンダーされたクリエイティブ。`composition_model` は `deterministic` のままです。なぜなら各レンダーされたアイテムは配信前に生成され、次に生成されたとおりにサーブされるからです。生成メカニズムは `item_production_model: "agent_synthesized"` で捕捉されます。

* **カタログアセットコントラクト:** バイヤーはブリーフ + カタログスコープ（SKU、カテゴリー、または完全なフィード）を供給。セラーは `item_production_model: agent_synthesized` と `fanout_mode: per_item` で `build_creative` 経由でクリエイティブを生成。`source_catalog` スロットはバイヤーの製品フィード。アセットはセラー生成。
* **非決定性:** このファミリーの製品は、QA ループが完了する前に生成がスペック内出力を保証できないとき `synthesis_nondeterministic: true` を宣言すべきです（SHOULD）。
* **トラッキング:** 生成出力 ID + バイヤーのカタログアイテムキー（SKU/GTIN）。バイヤーは各生成されたクリエイティブを、ブリーフのコピーではなく、自身のパフォーマンスシグナルを持つ別個のレンダー出力として扱うべきです（SHOULD）。
* **アダプターの癖:** 生成シードとプロンプトは通常バイヤーに返されません。バイヤーは特定の生成を再現できません。アセット編集サイクルではなく再生成サイクルを計画します。
* **実験的準備状況:** 生成品質証拠がアダプターごとに文書化されるまで `experimental: true` のままにします。制御された使用は可能ですが、合成はバイヤーに不透明でベンダーごとのフレーミングが必要です。

## 実験的準備状況マトリクス

| Family                 | 制御されたアダプター使用 | デフォルト本番ルーティング   | 昇格証拠                           |
| ---------------------- | ------------ | --------------- | ------------------------------ |
| リテールメディア決定的、バイヤーアップロード | 準備完了         | 証拠が到達するまで実験的を保つ | Amazon `format_schema` 証拠      |
| リテールメディアネットワーク合成       | 準備完了         | 証拠が到達するまで実験的を保つ | リテーラーごとの変動性文書                  |
| インプレッションごとコレクションレイアウト  | 準備完了         | 証拠が到達するまで実験的を保つ | 表面ごとの適合性証拠                     |
| Generative-per-SKU     | ベンダー固有のみ     | 実験的を保つ          | 生成品質証拠。ベンダーごとのフレーミングなしに昇格しないかも |

`experimental` は正準と製品宣言の両方に存在します。フィールドレベルコントラクトについては [`canonical-formats.mdx` §`experimental` — 1 フィールド、両軸](/docs/creative/canonical-formats#experimental--one-field-both-axes) を参照してください。

## このページが何でないか

* **規範的仕様拡張ではない。** 4 つのファミリーは既存の `sponsored_placement` スキーマを共有します。この文書は、セラーとバイヤーが正準に対して遭遇する変動性を名指しますが、必須フィールドを追加しません。
* **昇格ゲートではない。** 正準の非実験的への昇格は、[canonical-formats.mdx](/docs/creative/canonical-formats) に従い、少なくとも 2 つのアダプター全体の `format_schema` 証拠にゲートされます。このページは `format_schema` 証拠が各ファミリーについて何をカバーする必要があるかを文書化します。
* **網羅的ではない。** ランタイムコントラクトが上の 4 つのファミリーの 1 つに適合しないアダプターは、マトリクスを拡張できるよう canonical-formats トラックに issue を提出すべきです（SHOULD）。

## 参照

* [#3307](https://github.com/adcontextprotocol/adcp/pull/3307) — 元の `sponsored_placement` 正準
* [#4592](https://github.com/adcontextprotocol/adcp/issues/4592) — この文書
* [`canonical-formats.mdx`](/docs/creative/canonical-formats) — 全体の canonical-formats 語彙
