> ## 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.
# コマースメディア
> AdCPにおけるコマースメディア：小売メディアネットワークがセルフサービスプラットフォームを構築する代わりにエージェントストアフロントを立ち上げるべき理由、およびスポンサードプロダクト、店舗内デジタル、クローズドループアトリビューションのモデリング方法。
セルフサービス広告プラットフォームを構築するすべての小売メディアネットワークは、最終的に同じ場所に行き着く。最大規模の食料品店、薬局、総合小売業者と並んでエージェンシーの注目を競い合い、ブランドはまた別のインターフェースを覚え、もう一つのログインを管理し、もう一組のレポートを照合しなければなりません。
別の方法があります。エージェントストアフロントを立ち上げることです。バイヤーエージェントが他のセラーと同じプロトコルを使って探索し、取引し、測定できるよう、インベントリを公開します。エージェントが探索を担当すれば、優位性はUIの品質からデータの品質に移る。そしてデータこそ、多くの小売業者がすでに競争上の堀を持っている領域です。
## ストアフロント、プラットフォームではなく
Danielはマーケットプレイス ShopGrid のリテールメディアを担当しています。このマーケットプレイスには月間2億人のショッパーがおり、ロイヤルティプログラムから決定論的な購買データが得られます。ShopGridの広告ビジネスを構築するよう命じられたとき、ロードマップは見慣れたものでしました。セルフサービスのキャンペーンツール、独自のオーディエンスビルダー、カスタムレポーティングダッシュボード、そして最終的にはDSP。
構築の途中で問題に気づいた。ShopGridが獲得したかったブランド——CPG企業、ヘルス＆ビューティーブランド、家電メーカー——はすでに十数のリテールメディアプラットフォームでキャンペーンを管理していました。各プラットフォームには独自のAPI、独自のオーディエンスタクソノミー、独自のレポーティングフォーマットがあった。ブランドにまた別のプラットフォームの統合を求めることは、エンジニアリング予算が100倍の企業とUIの品質で競争することを意味しました。
ShopGridの堀はダッシュボードにあるのではなかった。堀はデータにある。数百万人のロイヤルティ会員による決定論的な購買アトリビューション、数千の店舗にわたるリアルタイム在庫、そして購買ポイントに設置された店舗内デジタルスクリーン。問題は、そのデータとインベントリをできるだけ多くのバイヤーにアクセスしやすくする方法でしました。
DanielはAdCPセールスエージェントを立ち上げた。ShopGridのリテールメディアカタログ全体——スポンサードプロダクト、オンサイトディスプレイ、店舗内スクリーン——が `get_products` 経由でバイヤーエージェントが探索できるプロダクトとして公開されています。ロイヤルティデータは標準的な配信メトリクスを通じてレポートされるクローズドループアトリビューションを動かす。店舗ロケーションは、近接ターゲティングのためのキャッチメントエリアを持つカタログとしてモデル化されています。
結果として、AdCPに対応しているバイヤーエージェントであれば、カスタム統合なしにShopGridのインベントリで取引できます。Pinnacle AgencyのSamは、Summit Foodsのクロスリテーラーキャンペーンを実行中に、他の小売業者と同じプロトコルとブリーフを使ってShopGridのスポンサードプロダクトを発見しました。
リテールメディアチームが実際に求めているのは、セルフサービスのコントロール、マネージドサービスの簡便さ、そして自社の内部ツールにあるすべてのデータです。セルフサービスプラットフォームはコントロールを与えるが、大規模なエンジニアリング投資が必要です。マネージドサービスはバイヤーにとって簡単だがスケールしません。エージェントストアフロントはこのジレンマを解決します。小売業者はプロダクト、価格設定、ルールを定義し（コントロール）、バイヤーエージェントが営業担当なしに探索と実行を処理し（簡便さ）、小売業者がMCPサーバーを運営しているため、すべてのトランザクションが自社インフラを通じて流れる（データは社内に留まる）。
これはShopGridが他のすべてを放棄したことを意味するわけではありません。バイヤーエージェントを使っていないブランドには依然として基本的なセルフサービスアクセスが必要です。しかしエージェントストアフロントは成長レイヤーです。中規模小売業者の独自プラットフォームを統合しなかったバイヤーにリーチする方法です。
以下の表は、馴染みのあるリテールメディアのコンセプトとAdCP上の対応物をマッピングしています。
## コンセプトマッピング
| リテールメディアのコンセプト | AdCPの対応物 | 参照 |
| ----------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------- |
| 小売業者 / リテールメディアネットワーク | セールスエージェント（MCPサーバー） | [`adagents.json`](/docs/media-buy/advanced-topics/accounts-and-security) |
| 小売業者とのアドバタイザーアカウント | `account_id` + `list_accounts` | [Accounts & Agents](/docs/building/by-layer/L2/accounts-and-agents) |
| ブランドのプロダクトカタログ | `brand.product_catalog` | [Brand identity](/docs/brand-protocol/brand-json) |
| プロモーション用のGTIN / SKU選択 | `Catalog` 上のカタログセレクター（`ids`、`gtins`、`tags`） | [Catalogs](/docs/creative/catalogs) |
| スポンサードプロダクトリスティング | カタログレンダリングクリエイティブを持つプロダクト | [Creative Formats](/docs/creative/formats) |
| オンサイトディスプレイ / ビデオ | 標準 `format_ids` を持つプロダクト | [Media Products](/docs/media-buy/product-discovery/media-products) |
| 小売業者のファーストパーティオーディエンス | ブリーフベース；`data_provider_signals` 経由の名前付きセグメント | [Targeting](/docs/media-buy/advanced-topics/targeting) |
| ROASターゲット / コンバージョン最大化 | パッケージ上の `optimization_goals` | [Optimization & Reporting](/docs/media-buy/media-buys/optimization-reporting) |
| クローズドループ測定 | プロダクト上の `outcome_measurement` + `conversion_tracking` | [Delivery Reporting](/docs/media-buy/task-reference/get_media_buy_delivery) |
| アトリビューションウィンドウ（クリック14日、ビュー1日） | 配信レスポンスの `attribution_window` | [Delivery Reporting](/docs/media-buy/task-reference/get_media_buy_delivery) |
| ROAS / アトリビューテッド収益 | 配信メトリクスの `roas`、`conversion_value` | [Delivery Reporting](/docs/media-buy/task-reference/get_media_buy_delivery) |
| 店舗内アトリビューション | `in_store` を使った `by_action_source` | [Delivery Reporting](/docs/media-buy/task-reference/get_media_buy_delivery) |
| 店舗ロケーション / 店舗ロケーター | 店舗カタログ（セラー提供またはバイヤー同期） | [Catalogs — Stores](/docs/creative/catalogs#stores) |
| リアルタイム在庫 / 在庫あり | `sync_catalogs` 経由のインベントリカタログ | [Catalogs](/docs/creative/catalogs) |
| 近接 / キャッチメントターゲティング | 店舗キャッチメントエリア（等時線、半径、GeoJSON） | [Catalogs — Catchment areas](/docs/creative/catalogs#catchment-areas) |
各小売業者は個別のセールスエージェントです。彼らのメディアオファリングはプロダクトとしてモデル化されています。バイヤーのブランドアイデンティティはSKUレベルのクリエイティブレンダリング用のプロダクトカタログを持ちます。ブランドと小売業者間のアカウント関係はメディアバイ上の `list_accounts` と `account` を通じて管理される——[Accounts & Agents](/docs/building/by-layer/L2/accounts-and-agents) を参照。
## プロダクトスペクトラム
リテールメディアネットワークは多様なプロダクトタイプを提供する——スポンサードリスティングだけではありません。すべては `retail_media` チャネルを共有するが、フォーマット、価格設定、クリエイティブ要件が異なります。Danielは ShopGrid の全ポートフォリオをファネル全体でバイヤーエージェントが組み合わせられるよう、個別のプロダクトとしてモデル化しました。
### スポンサードプロダクトリスティング
最もシンプルなコマースメディアプロダクト。小売業者はバイヤーのプロダクトカタログからクリエイティブをレンダリングする——カスタムクリエイティブのアップロードは不要。価格設定は通常CPC。
```json theme={null}
{
"product_id": "shopgrid_sponsored_products",
"name": "Sponsored Products - Search & Browse",
"description": "Sponsored product listings in search results and category pages. Products are rendered from retailer catalog data.",
"channels": ["retail_media"],
"publisher_properties": [
{ "publisher_domain": "shopgrid.example", "selection_type": "all" }
],
"format_ids": [
{ "agent_url": "https://ads.shopgrid.example", "id": "sponsored_product_listing" }
],
"delivery_type": "non_guaranteed",
"pricing_options": [
{
"pricing_option_id": "sp_cpc",
"pricing_model": "cpc",
"floor_price": 0.25,
"price_guidance": { "p50": 0.85, "p75": 1.20 },
"currency": "USD",
"min_spend_per_package": 50
}
],
"delivery_measurement": {
"provider": "ShopGrid deterministic purchase attribution",
"notes": "Deterministic purchase attribution from first-party shopper data. 14-day lookback."
},
"outcome_measurement": {
"type": "attributed_sales",
"attribution": "deterministic_purchase",
"window": { "interval": 14, "unit": "days" },
"reporting": "daily_api"
},
"conversion_tracking": {
"action_sources": ["website", "app", "in_store"],
"supported_targets": ["cost_per", "per_ad_spend"],
"platform_managed": true
},
"creative_policy": {
"co_branding": "none",
"landing_page": "any",
"templates_available": true
},
"catalog_types": ["product"],
"catalog_match": {
"matched_gtins": ["00013000006408", "00013000006415", "00013000006422"],
"matched_count": 3,
"submitted_count": 1200
}
}
```
`catalog_types` フィールドはこのプロダクトがサポートするカタログタイプを宣言します。`catalog_match` フィールドはバイヤーに対して、このプロダクトでどのカタログアイテムが対象かを伝える。バイヤーはメディアバイを作成する際に、これらの値をカタログセレクター（`gtins`、`ids`）として使用する——`publisher_properties` が絞り込みに使える利用可能なプロパティをリストするのと同様です。セラーは `matched_gtins`、`matched_ids`、またはその両方を含めることができます。
スポンサードプロダクトリスティングはカタログレンダリング式です。小売業者はGTIN照合によって自社カタログデータからタイトル、価格、画像、評価を取得します。拡張プロダクトコンテンツ（比較チャート、ライフスタイルギャラリー、ブランドストーリーモジュール）とブランドストアは、広告購入ではなく小売業者のコンテンツシステムを通じて管理される補完的なコンテンツ戦略です。
主な特徴：
* **CPC価格設定**：オークションベースの入札
* **`platform_managed: true`**：小売業者が常時購買アトリビューションを提供
* **`supported_targets`**：パッケージに `optimization_goals` を設定する際にどのターゲット種別が利用可能かをバイヤーに伝える
* **`templates_available: true`**：小売業者がカタログデータからクリエイティブをレンダリング
* **`action_sources`** に `in_store` が含まれ、オムニチャネルアトリビューションを実現
### オンサイトディスプレイとビデオ
小売業者のプロパティ上のディスプレイおよびビデオ広告で、小売業者のファーストパーティショッパーデータを使ってターゲティングします。バイヤーは標準クリエイティブを提供します。高い最低出稿額とCPMは、小売業者のオーディエンスデータとギャランティードプレースメントの価値を反映しています。
```json theme={null}
{
"product_id": "shopgrid_onsite_display",
"name": "Category Shoppers - On-Site Display & Video",
"description": "Display and video ads on ShopGrid marketplace and app, targeting shoppers with relevant purchase history.",
"channels": ["retail_media"],
"publisher_properties": [
{ "publisher_domain": "shopgrid.example", "selection_type": "all" }
],
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_300x250" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_728x90" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "video_15s" }
],
"delivery_type": "guaranteed",
"pricing_options": [
{
"pricing_option_id": "onsite_cpm",
"pricing_model": "cpm",
"fixed_price": 14.00,
"currency": "USD",
"min_spend_per_package": 10000
}
],
"delivery_measurement": {
"provider": "Retailer ad server with IAS viewability",
"notes": "Impressions per IAB guidelines. MRC-accredited viewability."
},
"outcome_measurement": {
"type": "incremental_sales_lift",
"attribution": "deterministic_purchase",
"window": { "interval": 30, "unit": "days" },
"reporting": "weekly_dashboard"
},
"conversion_tracking": {
"action_sources": ["website", "app"],
"supported_targets": ["cost_per", "per_ad_spend"],
"platform_managed": true
},
"creative_policy": {
"co_branding": "required",
"landing_page": "retailer_site_only",
"templates_available": true
}
}
```
クリエイティブポリシーに注目：小売業者はコブランディングを必須とし、ランディングページを自社サイトに制限することが多い。
### オフサイトオーディエンス拡張
小売業者はファーストパーティ購買データを使って、サードパーティのインベントリでオーディエンスにターゲティングする——小売業者自身のサイトを超えてリーチを拡大します。バイイングコンテキストが小売業者のデータアセットであるため、このプロダクトは依然として `retail_media` チャネルに属します。
```json theme={null}
{
"product_id": "shopgrid_offsite_extension",
"name": "Shopper Audiences - Off-Site Display & Video",
"description": "Reach ShopGrid shoppers across premium display and video inventory using first-party purchase data.",
"channels": ["retail_media"],
"publisher_properties": [
{ "publisher_domain": "shopgrid.example", "selection_type": "all" }
],
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_300x250" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "video_15s" }
],
"delivery_type": "guaranteed",
"pricing_options": [
{
"pricing_option_id": "offsite_cpm",
"pricing_model": "cpm",
"fixed_price": 13.50,
"currency": "USD",
"min_spend_per_package": 10000
}
],
"delivery_measurement": {
"provider": "Self-reported impressions from proprietary ad server",
"notes": "Impressions counted per IAB guidelines. Viewability via IAS."
},
"outcome_measurement": {
"type": "incremental_sales_lift",
"attribution": "deterministic_purchase",
"window": { "interval": 30, "unit": "days" },
"reporting": "weekly_dashboard"
},
"conversion_tracking": {
"action_sources": ["website", "app", "in_store"],
"supported_targets": ["cost_per", "per_ad_spend"],
"platform_managed": true
}
}
```
### プレミアムプレースメント
ホームページテイクオーバー、カテゴリースポンサーシップ、季節イベントプレースメント。これらの高視認性ポジションは固定レートでギャランティード配信として販売される——多くの場合、かなり前から予約されます。
```json theme={null}
{
"product_id": "shopgrid_homepage_takeover",
"name": "Homepage Takeover - 24 Hours",
"description": "Exclusive homepage banner and hero placement for 24 hours.",
"channels": ["retail_media"],
"publisher_properties": [
{ "publisher_domain": "shopgrid.example", "selection_type": "all" }
],
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_970x250" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_300x250" }
],
"placements": [
{
"placement_id": "homepage_hero",
"name": "Homepage Hero Banner",
"format_ids": [{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_970x250" }]
},
{
"placement_id": "homepage_sidebar",
"name": "Homepage Sidebar",
"format_ids": [{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_300x250" }]
}
],
"delivery_type": "guaranteed",
"pricing_options": [
{
"pricing_option_id": "takeover_flat",
"pricing_model": "flat_rate",
"fixed_price": 50000.00,
"currency": "USD"
}
],
"delivery_measurement": {
"provider": "Retailer ad server",
"notes": "Guaranteed impressions based on homepage traffic projections."
},
"outcome_measurement": {
"type": "attributed_sales",
"attribution": "deterministic_purchase",
"window": { "interval": 14, "unit": "days" },
"reporting": "daily_api"
},
"creative_policy": {
"co_branding": "required",
"landing_page": "retailer_site_only",
"templates_available": false
}
}
```
プレミアムプレースメントは `placements` 配列を使うため、バイヤーは同じプロダクト内の異なるポジションに異なるクリエイティブを割り当てられます。
### 店舗内デジタル
物理的な小売ロケーション内のデジタルスクリーン——レジレーン、エンドキャップ、入口ディスプレイ、待合エリア。これらはデジタルと物理の橋渡しをし、測定は店舗内での購買に紐づく。同期された店舗カタログと組み合わせると、店舗内デジタルプロダクトは特定のロケーションをターゲットにし、在庫を考慮したクリエイティブを表示できます。
店舗内こそ、リテールメディアネットワークが他の誰も複製できないインベントリを持っている場所です。数千の物理ロケーションを持つ小売業者には、購買ポイントにスクリーンがある——ショッパーが通路を歩き回り、棚で商品を比較し、列に並んで待っている間にリーチできます。これらのショッパーの多くはオンライン広告をまったく見ない。店舗内でのみ買い物するため、オンラインチャネルでは到達不可能です。
```json theme={null}
{
"product_id": "shopgrid_instore_screens",
"name": "In-Store Digital Screens",
"description": "Digital screens at checkout lanes, end-cap displays, and pharmacy waiting areas across 2,000+ locations.",
"channels": ["retail_media"],
"publisher_properties": [
{ "publisher_domain": "shopgrid.example", "selection_type": "all" }
],
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_1080x1920" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "video_15s" }
],
"placements": [
{
"placement_id": "checkout_screen",
"name": "Checkout Lane Screens",
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_1080x1920" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "video_15s" }
]
},
{
"placement_id": "endcap_screen",
"name": "Aisle End-Cap Displays",
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_1080x1920" }
]
},
{
"placement_id": "pharmacy_waiting",
"name": "Pharmacy Waiting Area",
"format_ids": [
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "display_1080x1920" },
{ "agent_url": "https://creative.adcontextprotocol.org", "id": "video_15s" }
]
}
],
"delivery_type": "guaranteed",
"pricing_options": [
{
"pricing_option_id": "instore_cpm",
"pricing_model": "cpm",
"fixed_price": 12.00,
"currency": "USD",
"min_spend_per_package": 5000
}
],
"delivery_measurement": {
"provider": "Venue traffic sensors",
"notes": "Impressions estimated from foot traffic data. Updated weekly."
},
"conversion_tracking": {
"action_sources": ["in_store"],
"platform_managed": true
},
"creative_policy": {
"co_branding": "none",
"landing_page": "any",
"templates_available": true
}
}
```
異なるスクリーンプレースメントには異なるクリエイティブ要件があります。レジスクリーンは静止したショッパーが近距離で30〜90秒の滞留時間を提供します。エンドキャップディスプレイは通りすがりのショッパーを遠めから2〜3秒の一瞥でキャッチします。薬局の待合エリアは滞留時間が長く、着席したオーディエンスがいます。ほとんどの店舗内ネットワークは無音だ——プレースメントが特に指定しない限り、クリエイティブはサウンドオフで設計すべきです。
店舗内プロダクトは小売業者の店舗カタログと連携します。このカタログはキャッチメントエリア（半径、等時線、またはGeoJSONポリゴン）を持つ店舗ロケーションを公開し、バイヤーエージェントが特定のエリアや店舗クラスターをターゲットにできるようにします。ブランドのプロダクトカタログと組み合わせると、店舗内スクリーンはコンテキストに関連したクリエイティブを表示できる——適切な商品を、適切な店舗で、適切な棚の近くに。
### これらの例を超えて
リテールメディアポートフォリオは上記の5つのプロダクトタイプを超えることが多い。スポンサードブランド広告——ヘッドライン、ブランドロゴ、2〜3つのフィーチャードプロダクト——は、バイヤーからのカスタムヘッドラインとカタログレンダリングのプロダクトタイルを持つ、スポンサードプロダクトリスティングとディスプレイの中間に位置します。デジタルクーポンとキャッシュバックオファーは購買に直接結びつき、インプレッションベースモデルにはうまく収まらない——CPAプライシングと `conversion_tracking` を持つプロダクトとしてモデル化できます。小売業者のメールニュースレターやアプリのプッシュ通知のスポンサードプレースメントは、高パフォーマンスなロウファネルプロダクトで、異なる `format_ids` を持つオンサイトディスプレイと同様にモデル化されます。ショッパブルビデオ——ビデオフレーム内でプロダクトがタグ付けされ、視聴者がカートに追加できる——はビデオフォーマットとカタログレンダリングのプロダクトオーバーレイを組み合わせます。キーワードレベルの検索スポンサーシップ、サンプリングプログラム、レシピ統合はそれぞれ異なる経済性を持つが、同じパターンに従う。適切な価格モデル、フォーマット、測定宣言を持つプロダクトです。
## エンドツーエンドのワークフロー
### プロダクトカタログを持つブランド
バイヤーはプロダクトカタログフィードを含むブランドリファレンスを提供します。これによりSKUレベルのターゲティングとカタログレンダリングのクリエイティブが可能になります：
```json theme={null}
{
"name": "Summit Foods",
"url": "https://summitfoods.example.com",
"product_catalog": {
"feed_url": "https://summitfoods.example.com/products.xml",
"feed_format": "google_merchant_center",
"categories": ["food/sauces", "food/condiments", "beverages"],
"update_frequency": "daily"
}
}
```
フィードにはGTIN、タイトル、価格、画像が含まれており、スポンサードプロダクトリスティングのレンダリングと小売業者間でのプロダクトマッチングに必要なすべてが揃っています。
### アカウントへのカタログ同期
メディアバイを作成する前に、`sync_catalogs` 経由でブランドのデータフィードを小売業者のアカウントに同期します。これにより配信時にクリエイティブとターゲティングが参照するアカウント状態が構築されます。これが全体的なセットアップシーケンスにどう合うかは [Account state](/docs/building/by-layer/L2/account-state) を参照。
```json theme={null}
{
"account": { "account_id": "acct_summitfoods_shopgrid_001" },
"catalogs": [
{
"catalog_id": "product-feed",
"name": "Summit Foods Product Catalog",
"type": "product",
"url": "https://summitfoods.example.com/products.xml",
"feed_format": "google_merchant_center",
"update_frequency": "daily"
},
{
"catalog_id": "inventory-feed",
"name": "Store-Level Inventory",
"type": "inventory",
"url": "https://feeds.summitfoods.example.com/inventory.json",
"feed_format": "custom",
"update_frequency": "hourly"
}
]
}
```
プラットフォームは各フィードを取り込む：
* **プロダクトカタログ** — 小売業者自身のカタログに対してGTINを検証し、アイテムレベルの承認ステータスをレポート
* **インベントリフィード** — クリエイティブが「近くで在庫あり」を表示できるよう、在庫データを毎時更新
**店舗ロケーションはセラー提供であり、バイヤーが同期するものではありません。** リテールメディアでは、小売業者は自社の店舗ロケーションを所有している——CPGブランドは小売業者に小売業者の店舗を同期しません。小売業者の店舗カタログ（近接ターゲティングのためのキャッチメントエリアを持つ）はプラットフォームサイドのデータであり、バイヤーはターゲティングで参照できます。自社の物理ロケーションを運営するバイヤー（例：実店舗を持つDTCブランド、レストランチェーン）は、`sync_catalogs` を通じて自社の店舗カタログを他のプラットフォームに同期することになります。
同期されたカタログが必要なフォーマットは、`assets` 配列に `catalog` アセットタイプを宣言する——バイヤーエージェントはクリエイティブを提出する前にこれをチェックします。スポンサードプロダクトカルーセルには `product` カタログと `inventory` カタログの両方が必要な場合があります。
### プロダクトの検索
`channels: ["retail_media"]` を指定して `get_products` をクエリし、コマースメディアプロダクトを見つける。ブランドアイデンティティにより、セラーはカタログ適格性でフィルタリングできます：
```json theme={null}
{
"brief": "Promote our organic ketchup line across grocery retailers. Focus on high-intent shoppers.",
"brand": {
"domain": "summitfoods.example.com"
},
"filters": {
"channels": ["retail_media"]
}
}
```
セラーは、バイヤーのGTINが小売業者のカタログにマッチするプロダクトを返します。マルチプロダクト小売業者は、スポンサードプロダクト、オンサイトディスプレイ、オフサイト拡張を個別のプロダクトとして返すことがあります。
スポンサードプロダクトリスティングについて、セラーは各プロダクトに `catalog_match` を含め、バイヤーのカタログアイテムのどれが対象かを示す：
```json theme={null}
{
"product_id": "shopgrid_sponsored_products",
"catalog_match": {
"matched_gtins": ["00013000006408", "00013000006415", "..."],
"matched_count": 3,
"submitted_count": 1200
}
}
```
これはバイヤーに対して、この小売業者でどのGTINが対象で、全カタログアイテムの何件が評価されたかを伝える。バイヤーはメディアバイを作成する際に `matched_gtins` の値をカタログの `gtins` セレクターとして使用するか、カタログカバレッジを考慮して `tags` や `category` のような広いセレクターを使用します。
セラーはまた、プロダクトタイプ間での推奨予算配分を持つ[プロポーザル](/docs/media-buy/product-discovery/media-products#proposals)を `get_products` レスポンスとともに返すことができる——これは従来、人間の営業担当が必要だったメディアプランニングの専門知識をエンコードするものです。
### メディアバイの作成
単一のメディアバイが複数のプロダクトタイプと小売業者にまたがることができます。各パッケージは異なるプロダクトをターゲットにします：
```json theme={null}
{
"account": { "account_id": "acct_summitfoods_shopgrid_001" },
"brand": {
"domain": "summitfoods.example.com"
},
"start_time": "2026-04-01T00:00:00Z",
"end_time": "2026-04-30T23:59:59Z",
"packages": [
{
"product_id": "shopgrid_sponsored_products",
"pricing_option_id": "sp_cpc",
"budget": 15000,
"bid_price": 1.10,
"pacing": "even",
"optimization_goals": [{
"kind": "event",
"event_sources": [
{ "event_source_id": "shopgrid_purchases", "event_type": "purchase", "value_field": "value" }
],
"target": { "kind": "per_ad_spend", "value": 3.0 },
"priority": 1
}]
},
{
"product_id": "shopgrid_onsite_display",
"pricing_option_id": "onsite_cpm",
"budget": 25000,
"pacing": "even"
},
{
"product_id": "shopgrid_homepage_takeover",
"pricing_option_id": "takeover_flat",
"budget": 50000
}
]
}
```
`account` はこの小売業者とのブランドの請求関係を識別します。スポンサードプロダクトパッケージは、どのアイテムをプロモーションするかを指定するためにカタログセレクター（`gtins`、`tags`）を使用し、`optimization_goals` に `per_ad_spend` ターゲットを設定して、小売業者に購買額の3倍のリターンに向けて配信を最適化するよう伝える。ディスプレイとプレミアムパッケージは標準的なクリエイティブワークフローを使用します。
### 配信レポーティング
コマースメディアの配信レポートには、従来のメディアにはないアトリビューションメトリクスが含まれます。`attribution_window` はクロスプラットフォーム比較のための測定方法論を透明にします：
```json theme={null}
{
"reporting_period": {
"start": "2026-04-01T00:00:00Z",
"end": "2026-04-14T23:59:59Z"
},
"currency": "USD",
"attribution_window": {
"post_click": { "interval": 14, "unit": "days" },
"post_view": { "interval": 1, "unit": "days" },
"model": "last_touch"
},
"media_buy_deliveries": [
{
"media_buy_id": "mb_shopgrid_001",
"status": "active",
"totals": {
"impressions": 850000,
"spend": 10350
},
"by_package": [
{
"package_id": "pkg_sp_001",
"pricing_model": "cpc",
"rate": 0.92,
"currency": "USD",
"impressions": 850000,
"spend": 10350,
"clicks": 11250,
"conversions": 2100,
"conversion_value": 28500,
"roas": 2.75,
"cost_per_acquisition": 4.93,
"by_action_source": [
{ "action_source": "website", "count": 1500, "value": 20000 },
{ "action_source": "app", "count": 350, "value": 4800 },
{ "action_source": "in_store", "count": 250, "value": 3700 }
],
"delivery_status": "delivering"
}
]
}
]
}
```
`by_action_source` の内訳は、コンバージョンがどこで発生したかを示す——ウェブサイト、アプリ、実店舗。このオムニチャネルビューはコマースメディア固有のものです。
## クローズドループアトリビューション
コマースメディアの決定的な優位性は、決定論的な購買アトリビューションです。小売業者はロイヤルティカードデータ、ログイン状態、POSレコードを使って広告露出とトランザクションをマッチングします。これこそ、リテールメディアを他のすべてのメディアチャネルと根本的に異なるものにするアセットだ——そして、エージェントストアフロントが標準の配信レポーティングを通じてバイヤーエージェントに公開するものです。
### プロダクトによる宣言方法
プロダクトは2つのフィールドを通じてクローズドループ機能を示す：
**`outcome_measurement`** はアトリビューション方法論を説明します：
```json theme={null}
{
"outcome_measurement": {
"type": "attributed_sales",
"attribution": "deterministic_purchase",
"window": { "interval": 14, "unit": "days" },
"reporting": "daily_api"
}
}
```
**`conversion_tracking`** はアクションソースと小売業者が測定を管理するかどうかを宣言します：
```json theme={null}
{
"conversion_tracking": {
"action_sources": ["website", "app", "in_store"],
"supported_targets": ["cost_per", "per_ad_spend"],
"platform_managed": true
}
}
```
`platform_managed` が `true` の場合、小売業者が常時測定を提供します。バイヤーサイドのピクセルやイベントソースの設定は不要です。
小売業者によってアトリビューションウィンドウが異なる（例：クリック14日 vs クリック7日）。配信レスポンスの `attribution_window` はこれを透明にするため、バイヤーは小売業者間でROASの比較を正規化できます。
### 主要な配信メトリクス
| メトリクス | フィールド | 説明 |
| ----------- | ---------------------- | -------------------------------- |
| 広告費用対効果 | `roas` | `conversion_value / spend` |
| アトリビューテッド収益 | `conversion_value` | 広告にアトリビュートされた総購買額 |
| コンバージョン | `conversions` | 広告にアトリビュートされた購買イベント数 |
| 獲得単価 | `cost_per_acquisition` | `spend / conversions` |
| ニューカスタマー率 | `new_to_brand_rate` | 初回購入者からのコンバージョンの割合 |
| 店舗内売上 | `by_action_source` | `website`、`app`、`in_store` 別の内訳 |
| イベントタイプ別 | `by_event_type` | `purchase`、`add_to_cart` などによる内訳 |
## 従来のメディアバイとの違い
| 側面 | 従来のメディア | コマースメディア |
| --------------- | ----------------- | ------------------------------------ |
| アトリビューション | 確率論的、モデルベース | 決定論的、購買ベース |
| ターゲティングデータ | サードパーティ、コンテクスチュアル | ファーストパーティの購買/ロイヤルティデータ |
| 主要KPI | インプレッション、クリック、CTR | ROAS、コンバージョン、アトリビューテッド収益 |
| クリエイティブ（スポンサード） | バイヤー提供 | 小売業者がカタログからレンダリング |
| 測定の所有者 | サードパーティ（IAS、DV） | 小売業者プラットフォーム（`platform_managed`） |
| コンバージョンソース | ウェブサイトのみ | ウェブサイト + アプリ + 店舗内 |
| ランディングページ | 任意の目的地 | 多くの場合、小売業者サイトのみ |
| 価格モデル | CPM、CPC、CPCV | CPC（スポンサード）、CPM（ディスプレイ）、固定レート（プレミアム） |
## ベストプラクティス
### 小売業者向け：エージェントストアフロントの立ち上げ
デフォルトのリテールメディアのプレイブック——セルフサービスプラットフォームを構築し、営業チームを採用し、マネージドサービス収益を伸ばし、最終的にDSPを構築する——は最大の小売業者には機能します。それ以外の場合、桁違いのリソースを持つプラットフォームと競いながら、何年ものエンジニアリング投資が必要になります。
エージェントストアフロントは経済性を変える。ブランドが学ばなければなりませんプラットフォームを構築する代わりに、バイヤーエージェントがすでに使いこなしている標準プロトコルでインベントリを公開します。エンジニアリング投資は実際の差別化要因——データ品質、測定精度、インベントリの幅——に向けられ、ダッシュボードのUXには向けられない。
1. **プロダクトタイプを個別にモデル化する** — スポンサードプロダクト、オンサイトディスプレイ、オフサイト、プレミアムプレースメント、店舗内デジタルは、適切な価格設定とフォーマットを持つ個別のプロダクトであるべきです。これにより、バイヤーエージェントが小売業者間で比較検討できます。
2. **データを前面に出す** — `deterministic_purchase` アトリビューションと `platform_managed: true` の `conversion_tracking` を持つ `outcome_measurement` を宣言します。これがバイヤーエージェントが最適化する対象です。測定が弱い小売業者は、UIの品質に関わらず、測定が強い小売業者に負ける。
3. **物理的なフットプリントを公開する** — バイヤーエージェントが地理でターゲティングできるよう、キャッチメントエリアを持つ店舗カタログを提供します。店舗内デジタルインベントリは、オンラインのみのプラットフォームが提供できないものです。発見可能にすること。
4. **スポンサードプロダクトリスティングに `catalog_match` を返す** — バイヤーがどのGTIN/SKUが対象かを確認できるようにします。これは営業担当が「あなたの1,200商品のうち3点を取り扱っています」と言うのと同等だが——クエリ時に自動的に発生します。
5. **配信レスポンスに `attribution_window` を含める** — 小売業者間で比較するバイヤーは、ルックバックウィンドウとモデルを知る必要があります。
6. **`by_action_source` をレポートする** — ウェブサイト、アプリ、店舗内コンバージョンを示すオムニチャネルの影響を報告します。クロスチャネルビューはコマースメディア固有のものであり、予算配分を促進します。
7. **プロポーザルを使用する** — `get_products` レスポンスとともに、プロダクトタイプ間での推奨予算配分を返します。これにより、営業担当との会話を、バイヤーエージェントが評価できる構造化データに置き換え、メディアプランニングの専門知識をプロトコルにエンコードします。
8. **すべてのコマースメディアプロダクトに `channels: ["retail_media"]` を設定する** — バイヤーがチャネルでフィルタリングできるようにします。
### ブランド向け
1. **アカウントを早期にセットアップする** — バイを行う前に `list_accounts` を使って各小売業者との請求関係を確認します
2. **プロダクトとインベントリフィードを早期に同期する** — プロダクトとインベントリのカタログはバイを作成する前にアカウントに同期しておくべきです。インベントリフィードは毎時更新、プロダクトフィードは毎日更新されます。
3. **ターゲティングで小売業者の店舗カタログを参照する** — 小売業者の店舗ロケーションとキャッチメントエリアはプラットフォームサイドのデータです。自社の店舗カタログを同期せずに近接ターゲティングに使用します。
4. **`optimization_goals` を使用する** — パッケージに `cost_per` または `per_ad_spend` ターゲットを持つイベントゴールを設定し、小売業者が購買データに対して配信を最適化できるようにします
5. **カタログセレクターを戦略的に使用する** — 特定の商品には `gtins`、広範なプロモーションには `tags` や `category`
6. **ファネル全体に予算配分する** — コンバージョンにはスポンサードプロダクト、認知度向上にはオンサイトディスプレイ、リーチ拡大にはオフサイト
7. **アトリビューションウィンドウを比較する** — 異なるルックバックウィンドウを持つ小売業者間でROASを正規化するために、配信レポートの `attribution_window` を使用します
## 関連ドキュメント
* [Account state](/docs/building/by-layer/L2/account-state) — カタログ、イベントソース、キャンペーンがアカウント上にどう構築されるか
* [Accounts & Agents](/docs/building/by-layer/L2/accounts-and-agents) — アカウントのセットアップと請求関係
* [Media Channel Taxonomy](/docs/reference/media-channel-taxonomy) — `retail_media` チャネルの定義
* [Media Products](/docs/media-buy/product-discovery/media-products) — プロダクトモデルのリファレンス
* [Catalogs](/docs/creative/catalogs) — プロダクト、インベントリ、店舗、プロモーションのフィード
* [Brand identity](/docs/brand-protocol/brand-json) — プロダクトカタログとブランドアイデンティティ
* [Pricing Models](/docs/media-buy/advanced-topics/pricing-models) — CPC、CPM、固定レートの詳細
* [Optimization & Reporting](/docs/media-buy/media-buys/optimization-reporting) — `optimization_goals` とコンバージョン最適化
* [Delivery Reporting](/docs/media-buy/task-reference/get_media_buy_delivery) — コマースアトリビューションメトリクス
* [Targeting](/docs/media-buy/advanced-topics/targeting) — ブリーフベースのターゲティングアプローチ