​

Web パブリッシャー向け TMP

​

今日どう機能するか

​

Context Match

​

Context Match Request

{
  "type": "context_match_request",
  "request_id": "ctx-7f2a-oakwood-91b3",
  "property_rid": "01916f3a-9c4e-7000-8000-000000000010",
  "property_id": "oakwood-publishing-main",
  "property_type": "website",
  "placement_id": "article-sidebar-300x250",
  "seller_agent_url": "https://oakwood.example",
  "artifact_refs": [
    { "type": "url", "value": "https://oakwood.example.com/sustainable-kitchen-2026-03" }
  ]
}

• リクエストごとにパッケージリストは送られない。プロバイダーはメディアバイセットアップからの同期されたパッケージセットを使って、このプレースメントのすべての適格なパッケージを評価する。同じパッケージがすべてのユーザーについて評価され、アイデンティティのコンテキストパスへの漏洩を防ぎ、レスポンスキャッシュを可能にする。
• artifact_refs はコンテンツをタイプと値で参照する。バイヤーエージェントはアーティファクトメタデータをそのキャッシュから解決する — リクエストにインラインシグナルは不要。

​

Context Match Response

{
  "type": "context_match_response",
  "request_id": "ctx-7f2a-oakwood-91b3",
  "offers": [
    { "package_id": "pkg-display-0041" },
    { "package_id": "pkg-native-0078" }
  ],
  "signals": {
    "segments": ["sustainability", "home_cooking"],
    "targeting_kvs": [
      { "key": "adcp_seg", "value": "sustainability" },
      { "key": "adcp_seg", "value": "home_cooking" },
      { "key": "adcp_pkg", "value": "pkg-display-0041" },
      { "key": "adcp_pkg", "value": "pkg-native-0078" }
    ]
  }
}

• offers はアクティベートされたパッケージごとに 1 エントリを含む。このプレースメントのプロバイダーの同期されたセットは 3 つのパッケージを含んでいた — この 2 つがキッチン/サステナビリティのコンテキストに一致し、3 つ目（pkg-display-0103）は一致せず欠如している。
• web/GAM アクティベーションについては、オファーはシンプル — package_id のみ。よりリッチなフィールド（brand、price、summary、creative_manifest、macros）はそれらを必要とする統合に利用可能だが必須ではない。
• signals.targeting_kvs は、Prebid モジュールが GAM 広告リクエストに設定するキー値ペア。GAM ラインアイテムはこれらのキーで一致するよう設定される。

​

Identity Match

​

Identity Match Request

{
  "type": "identity_match_request",
  "request_id": "id-3k9p-oakwood-d4f1",
  "seller_agent_url": "https://oakwood.example",
  "identities": [
    { "user_token": "tok_uid2_8f2a3b7c", "uid_type": "uid2" },
    { "user_token": "XY1a2b3c4d5e6f7g8h9i0jKlMnOpQrSt", "uid_type": "rampid" },
    { "user_token": "ID5*aB3xY9kL...", "uid_type": "id5" }
  ],
  "package_ids": [
    "pkg-display-0041",
    "pkg-display-0042",
    "pkg-display-0043",
    "pkg-native-0078",
    "pkg-native-0079",
    "pkg-display-0103",
    "pkg-display-0104",
    "pkg-video-0201"
  ]
}

• request_id は context match の request_id と無関係。2 つは互いから導出可能であってはならない。
• package_ids の例は all-active モードを示す: このプレースメントの context match にあった 3 つだけでなく、サイト全体にわたるバイヤーのすべてのアクティブパッケージ。ページ固有のサブセットは禁止 — それはバイヤーがパッケージセットを比較してアイデンティティをコンテキストと相関させることを許す。fuzzed モード（バイヤーが黙って落とす合成 ID でパディングされたランダムサンプル）も許容される。
• identities はパブリッシャーが利用可能なすべてのトークン（UID2、ID5、LiveRamp、hashed email、publisher first-party）を運ぶ。各トークンは不透明 — バイヤーはそれを PII に逆変換できない。完全なセットを送ることは、異なるバイヤーが異なるグラフで解決するためマッチ率を最大化する。

​

Identity Match Response

{
  "type": "identity_match_response",
  "request_id": "id-3k9p-oakwood-d4f1",
  "eligible_package_ids": [
    "pkg-display-0041",
    "pkg-display-0042",
    "pkg-native-0078",
    "pkg-native-0079",
    "pkg-display-0104"
  ],
  "serve_window_sec": 60
}

• 適格なパッケージのみがリストされる。リストに欠如するパッケージ（例: pkg-display-0043、pkg-display-0103、pkg-video-0201）は不適格。バイヤーはフリークエンシーキャップ、オーディエンスメンバーシップ、購入履歴、その他のアイデンティティベースのシグナルから適格性を計算する。理由はパブリッシャーにとって不透明。
• serve_window_sec はルーターにこのレスポンスをどのくらいキャッシュするかを伝える。そのウィンドウ中、ルーターはバイヤーに再クエリせずにキャッシュされた適格性を返す。パブリッシャーはキャッシュされた適格性を使ってページ上のすべてのプレースメントに割り当てる。
• frequency_capped、audience_match、recency フィールドはない。バイヤーの内部的な理由はバイヤーに留まる。

​

アクティベーション: コンテキストとアイデンティティの結合

​

Step 1: 交差

​

Step 2: GAM ターゲティングを設定

adcp_seg = sustainability, home_cooking
adcp_pkg = pkg-display-0041, pkg-native-0078

​

Step 3: GAM が選択

​

GAM ラインアイテム設定

• ラインアイテムタイプ。 create_media_buy からのディール条件に応じて Sponsorship または Standard。保証ディールは Sponsorship、非保証ディールは Standard を使う。
• 優先度。 ディールタイプに基づいて設定。保証ディールは優先度 4-8、非保証は優先度 12-16。これは TMP 需要が GAM の選択ロジックで他のラインアイテムとどう競うかを決める。
• クリエイティブ割り当て。 sync_creatives からの事前同期されたクリエイティブを参照するか、バイヤーが提供する場合は Context Match レスポンスのクリエイティブマニフェストを使う。
• ライフサイクル。 メディアバイが終了またはキャンセルされると、対応するラインアイテムを非アクティブ化する。ルーターは 1 時間以内にパッケージを Identity Match に含めるのを停止する。
• 自動化。 パブリッシャーは、新しい create_media_buy 完了をリッスンしパッケージ詳細を GAM API 呼び出しにマップすることで、ラインアイテム作成を自動化できる。パッケージ ID、ディールタイプ、優先度、クリエイティブ参照はすべてメディアバイレスポンスから利用可能。

​

Prebid 統合

1. オークション初期化時: ページ上の各プレースメントについて TMP ルーターに Context Match リクエストを送る。
2. context match レスポンス時: オファーとターゲティングシグナルを保存する。
3. 時間的相関除去の後: ユーザーのアイデンティティトークンと各バイヤーのすべてのアクティブパッケージ ID を伴う Identity Match リクエストを送る。相関除去は 2 つの部分を持つ — ランダムな 100-2000ms 遅延 かつ ランダム化された順序: 各オークションは Identity Match リクエストが先に送られるか Context Match リクエストが先に送られるかのほぼ等しい確率を持つ。
4. identity match レスポンス時: context match 結果と結合する。広告ユニットにターゲティングキー値を設定する。
5. 入札リクエスト時: GAM は TMP ターゲティングキーで豊かにされた広告リクエストを受け取り、通常どおりラインアイテムを選択する。

​

Impression ID の代入

import { ulid } from 'ulid';

// In the TMP Prebid module, at auctionInit.
// Resolve the impression_id in priority order:
//   1. publisher pre-mint (e.g., server-side, attached as adUnit.tmp.impressionId)
//   2. Prebid transactionId (decision-layer reuse) when enableTIDs is on
//   3. fresh decision-layer mint (ULID, UUID, or any collision-resistant scheme)
function resolveImpressionId(adUnit) {
  if (adUnit.tmp?.impressionId) {
    return adUnit.tmp.impressionId;  // publisher-side mint — highest priority
  }
  if (pbjs.getConfig('enableTIDs') && adUnit.transactionId) {
    return adUnit.transactionId;     // reuse Prebid's tid when available
  }
  return ulid();                     // decision-layer fresh mint
}
const impId = resolveImpressionId(adUnit);
pbjs.setTargeting(adUnit.code, { tmp_impression_id: impId });

https://buyer.example/imp
  ?imp_id=%%PATTERN:tmp_impression_id%%
  &tmpx=%%PATTERN:tmp_tmpx%%
  &cb=%%CACHEBUSTER%%

​

シーケンス図

Page Load
  |
  |-- Prebid TMP Module ---> TMP Router (Context)
  |                              |-- fan out --> Buyer Agent A
  |                              |-- fan out --> Buyer Agent B
  |                              |<- merge <--- offers + signals
  |<--- Context Match Response --
  |
  |   (100-2000ms random delay; Context/Identity order randomized
  |    per auction — diagram shows Context-first; Identity-first
  |    runs the two phases in reverse)
  |
  |-- Prebid TMP Module ---> TMP Router (Identity)
  |                              |-- fan out --> Buyer Agent A
  |                              |-- fan out --> Buyer Agent B
  |                              |<- merge <--- eligibility
  |<--- Identity Match Response --
  |
  |-- Join locally: intersect offers with eligibility
  |-- Set targeting KVs on GAM ad request
  |-- GAM selects and serves ad

​

OpenRTB との共存

• 追加需要としての TMP。 TMP パッケージは GAM でラインアイテムとして現れ、優先度と価格で Prebid ラインアイテムと競う。GAM がイールド決定を扱う — TMP は Prebid を置き換えず、事前交渉された需要を追加する。
• 競合排除。 TMP と Prebid の需要ソースをまたいで衝突するブランドが一緒に現れるのを防ぐため、GAM 競合排除ルールを設定する。
• 収益帰属。 TMP アクティベートされたインプレッションは get_media_buy_delivery 経由で追跡され、Prebid インプレッションは既存の SSP レポートを通じて流れる。パブリッシャーは BI 層で再照合する。
• タイムアウトの独立性。 TMP と Prebid のリクエストは並列で実行される。TMP タイムアウト（50ms）は通常 Prebid タイムアウト（1000-1500ms）より速いので、TMP 結果は GAM が必要とする前に準備できる。

​

Web のプライバシー制約

• context match はユーザーデータを運ばない。 cookie なし、ユーザートークンなし、IP アドレスなし。プロバイダーはプレースメント上のすべてのユーザーについて同じ同期されたパッケージセットを評価する。
• identity match はページデータを運ばない。 URL なし、コンテンツシグナルなし、プレースメント ID なし。package_ids リストは、送られるとき、現在のページと独立した構成（all-active または fuzzed）を持つ — 決してページ固有のサブセットではない。
• パブリッシャーがローカルで結合する。 ルーターは同じインプレッションについてコンテキストとアイデンティティの両方を決して見ない。ページコンテキストとユーザーアイデンティティの両方を既に持つパブリッシャーのみが交差を実行する。
• 時間的相関除去。 2 つのリクエスト間のランダムな遅延 かつ ランダム化された順序（Context Match または Identity Match が等しく先に送られる可能性）が、ネットワークレベルでのタイミングと順序ベースの相関を防ぐ。固定順序は順序を通じてペアリングを漏らすため、ランダムな遅延だけでは不十分。