Skip to main content
AdCP のコンバージョントラッキングは、広告費と事業成果を結びつける。ライフサイクルを管理するタスクは2つある。sync_event_sources はイベントの収集元を設定し、log_event はイベント自体を送信します。 イベントデータは配信レポート（コンバージョン数、ROAS、獲得単価）にフィードされ、メディアバイパッケージの最適化ゴールを有効にします。

​
フロー

これは推奨される順序を示しています。実際には、イベントが流れる前にメディアバイを作成することもできます。セラーは十分なイベント履歴が蓄積されてから最適化を開始します。

​
イベントソース

イベントソースは、コンバージョンイベントを収集するチャネルを表します。ウェブサイトピクセル、モバイル SDK、サーバー間連携、CRM インポートなどがあります。 sync_event_sources でイベントソースを設定します。event_source_id、任意の name、event_types、allowed_domains を指定します。レスポンスには各ソースの追加フィールドが含まれます。
フィールド型説明
seller_idstringセラーの広告プラットフォームが割り当てた識別子
actionstring発生したこと: created、updated、unchanged、deleted、failed
managed_bystringbuyer（自分が設定した）または seller（常時オン、セラー管理）
action_sourceActionSourceイベントソースの種類（ウェブサイトピクセル、アプリ SDK など）
setupobject実装の詳細 — スニペットコード、スニペットタイプ、手順

​
バイヤー管理 vs セラー管理

バイヤー管理ソースは sync_event_sources を通じて自分が設定するものです。イベントタイプ、ドメイン、ライフサイクルを自分で管理します。 セラー管理ソースは常時オンで、レスポンスに managed_by: "seller" として現れる。これはコマースメディアでよく見られ、リテーラーが組み込みアトリビューション（例：自社プラットフォームでの購入トラッキング）を提供する場合に使われます。conversion_tracking.platform_managed: true を持つプロダクトは、セラーがこれらのソースを提供することを示しています。 アカウント上のすべてのソース（セラー管理のものを含む）を検出するには、event_sources 配列を指定せずに sync_event_sources を呼び出す。 
{
  "$schema": "https://adcontextprotocol.org/schemas/v3/media-buy/sync-event-sources-request.json",
  "account": { "account_id": "acct_12345" }
}

​
イベント

イベントは、購入、リード送信、ページビュー、アプリインストール、その他の標準イベントタイプといったユーザーアクションを表します。 log_event でイベントを送信します。 
{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/event.json",
  "event_id": "evt_purchase_12345",
  "event_type": "purchase",
  "event_time": "2026-01-15T14:30:00Z",
  "action_source": "website",
  "event_source_url": "https://www.example.com/checkout/confirm",
  "user_match": {
    "hashed_email": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "click_id": "abc123def456",
    "click_id_type": "gclid"
  },
  "custom_data": {
    "value": 149.99,
    "currency": "USD",
    "order_id": "order_98765",
    "num_items": 3
  }
}
フィールド型必須説明
event_idstringYes重複排除のための一意識別子（event_type + event_source_id のスコープ）。最大256文字。
event_typeEventTypeYes標準イベントタイプ
event_timedate-timeYesイベント発生時刻の ISO 8601 タイムスタンプ
user_matchUserMatchNoアトリビューションマッチングのためのユーザー識別子
custom_dataCustomDataNoイベント固有のデータ（value、currency、items）
action_sourceActionSourceNoイベントが発生した場所
event_source_urluriNoイベントが発生した URL（action_source が website の場合は必須）
custom_event_namestringNoカスタムイベントの名前（event_type が custom の場合）
イベントは event_id + event_type + event_source_id で重複排除されます。同じイベントを複数回送信しても安全です。

​
ユーザーマッチ

ユーザー識別子により、セラーはコンバージョンを広告インプレッションにアトリビュートできます。利用可能な最も強力な識別子を提供すること。識別子が多いほどマッチ率が高くなります。 
{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/user-match.json",
  "hashed_email": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "uids": [
    { "type": "uid2", "value": "AbC123XyZ..." }
  ],
  "click_id": "abc123def456",
  "click_id_type": "gclid"
}
少なくとも1つの識別子が必要です。強いものから弱いものへの順序:
フィールド型マッチ品質説明
uidsUID[]確定的ユニバーサル ID の値（rampid、id5、uid2、euid、pairid、maid）
hashed_emailstring確定的小文字・トリム済みメールアドレスの SHA-256 ハッシュ（64文字の16進数）
hashed_phonestring確定的E.164 形式の電話番号の SHA-256 ハッシュ（64文字の16進数）
click_idstring確定的プラットフォームのクリック識別子（fbclid、gclid、ttclid など）
click_id_typestring—クリック識別子の種類
client_ipstring確率的クライアント IP アドレス（client_user_agent が必要）
client_user_agentstring確率的クライアントユーザーエージェント（client_ip が必要）
ハッシュ化: ハッシュ前に正規化すること。メールアドレスは小文字にして空白をトリムし、電話番号は E.164 形式（例: +12065551234）にします。SHA-256 でハッシュ化し、64文字の小文字16進数として出力します。 利用可能な場合は複数の識別子タイプを送信すること。セラーは最善のマッチを使用します。

​
カスタムデータ

アトリビューションとレポートのためのイベント固有データ。購入イベントでは、ROAS レポートを有効にするために常に value と currency を含めること。 
{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/event-custom-data.json",
  "value": 149.99,
  "currency": "USD",
  "order_id": "order_98765",
  "content_ids": ["SKU-1234", "SKU-5678"],
  "num_items": 3,
  "contents": [
    { "id": "SKU-1234", "quantity": 2, "price": 49.99, "brand": "Acme" },
    { "id": "SKU-5678", "quantity": 1, "price": 50.01, "brand": "Nova" }
  ]
}
フィールド型説明
valuenumberイベントの金銭的価値
currencystringISO 4217 通貨コード（例: USD、EUR、GBP）
order_idstring一意の注文または取引識別子
content_idsstring[]商品またはコンテンツの識別子
content_typestringコンテンツのカテゴリー（product、service など）
content_namestring商品またはコンテンツの名前
content_categorystring商品またはコンテンツのカテゴリー
num_itemsintegerイベントのアイテム数
search_stringstring検索クエリ（検索イベントの場合）
contentsContent[]アイテムごとの詳細: id（必須）、quantity、price、brand

​
イベントタイプ

IAB ECAPI に準拠した標準マーケティングイベントタイプ:
イベントタイプ説明
page_viewユーザーがページを閲覧した
view_contentユーザーが特定のコンテンツ（商品、記事など）を閲覧した
select_contentユーザーがコンテンツを選択またはクリックした
select_itemユーザーがリストから特定の商品またはアイテムを選択した
searchユーザーが検索を実行した
shareユーザーがソーシャルまたはメッセージングでコンテンツをシェアした
add_to_cartユーザーがカートにアイテムを追加した
remove_from_cartユーザーがカートからアイテムを削除した
viewed_cartユーザーがショッピングカートを閲覧した
add_to_wishlistユーザーがウィッシュリストにアイテムを追加した
initiate_checkoutユーザーがチェックアウトプロセスを開始した
add_payment_infoユーザーが支払い情報を追加した
purchaseユーザーが購入を完了した
refund購入が全額または一部払い戻された（ROAS を調整します）
leadユーザーが関心を示した（フォーム送信、サインアップなど）
qualify_leadリードが営業またはスコアリング基準で適格とされた
close_convert_leadリードが顧客に転換したまたはディールがクローズした
disqualify_leadリードが不適格とされたまたは見込みなしとマークされた
complete_registrationユーザーがアカウント登録を完了した
subscribeユーザーがサービスまたはニュースレターを購読した
start_trialユーザーが無料トライアルを開始した
app_installユーザーがアプリケーションをインストールした
app_launchユーザーがアプリケーションを起動した
contactユーザーが連絡を開始した（電話、メッセージなど）
scheduleユーザーが予約またはイベントをスケジュールした
donateユーザーが寄付をした
submit_applicationユーザーが申し込みを送信した（ローン、求人など）
customカスタムイベントタイプ（custom_event_name で指定）

​
アクションソース

コンバージョンイベントの発生元:
アクションソース説明
websiteウェブサイト上でイベントが発生した
appモバイルまたはデスクトップアプリ内でイベントが発生した
offlineオフラインでイベントが発生した（インポートデータ）
phone_call電話から発生したイベント
chatチャット会話から発生したイベント
emailメールのインタラクションから発生したイベント
in_store実店舗でイベントが発生した
system_generated自動化システムによって生成されたイベント
otherその他のソース（ext で指定）

​
最適化ゴール

最適化ゴールは、セラーに対して何に向けて配信を最適化するかを伝える。create_media_buy のパッケージに設定します。パッケージはゴールの配列を受け付け、各ゴールにはオプションの priority（1が最高）を指定できます。プロダクトは、パッケージが持てるゴール数を制限する場合に max_optimization_goals を宣言する（ほとんどのソーシャルプラットフォームは1つのみ受け付ける）。 スキーマ: /schemas/v3/core/optimization-goal.json ゴールは kind で識別される2種類があります。
  • kind: "metric" — セラーがトラッキングする配信メトリクス（クリック、ビュー、エンゲージメントなど）に向けて最適化します。イベントソースやコンバージョントラッキングの設定は不要です。プロダクトはサポートするメトリクスを metric_optimization で宣言します。
  • kind: "event" — 広告主がトラッキングするコンバージョンイベントに向けて最適化します。sync_event_sources で登録されたイベントソースが必要です。プロダクトはサポートを conversion_tracking で宣言します。

​
kind: event

広告主がトラッキングするコンバージョンイベントに向けて最適化します。event_sources 配列は、このゴールにフィードするソースとタイプのペアを定義します。セラーが multi_source_event_dedup（get_adcp_capabilities で宣言）をサポートしている場合、すべてのエントリを通じて event_id で重複排除します。複数のソースから報告された同じビジネスイベントは1回としてカウントされ、最初にマッチしたエントリの value_field と value_factor が使用されます。multi_source_event_dedup が存在しないまたは false の場合、バイヤーはゴールごとに1つのイベントソースを使用すべきです。 コンバージョン単価（単一ソース）: 
{
  "kind": "event",
  "event_sources": [
    { "event_source_id": "website_pixel", "event_type": "lead" }
  ],
  "target": { "kind": "cost_per", "value": 25.00 },
  "priority": 1
}
広告費用対効果（返金を含む複数ソース）: 
{
  "kind": "event",
  "event_sources": [
    { "event_source_id": "web_pixel", "event_type": "purchase", "value_field": "order_total" },
    { "event_source_id": "app_sdk", "event_type": "purchase", "value_field": "order_total" },
    { "event_source_id": "web_pixel", "event_type": "refund", "value_field": "refund_amount", "value_factor": -1 }
  ],
  "target": { "kind": "per_ad_spend", "value": 4.0 },
  "attribution_window": { "post_click": { "interval": 28, "unit": "days" }, "post_view": { "interval": 1, "unit": "days" } },
  "priority": 1
}
per_ad_spend ターゲットでは、各イベントソースエントリに value_field（custom_data のどのフィールドが金銭的価値を持つか）とオプションの value_factor（乗数、デフォルトは1）を指定します。セラーは重複排除されたすべてのイベントに対して sum(value_field * value_factor) / spend を計算します。 コンバージョン価値の最大化（特定の ROAS ターゲットなし）: 
{
  "kind": "event",
  "event_sources": [
    { "event_source_id": "web_pixel", "event_type": "purchase", "value_field": "value" }
  ],
  "target": { "kind": "maximize_value" },
  "priority": 1
}
maximize_value ターゲットは、特定のリターン比率にコミットせずに高価値コンバージョンに向けて支出を誘導します。少なくとも1つのイベントソースエントリに value_field が必要です。
フィールド型必須説明
kind"event"Yes識別子
event_sourcesarrayYesこのゴールにフィードするソースとタイプのペア。セラーはエントリを通じて event_id で重複排除します。同じ event_id が異なる value_field を持つ複数のソースから届いた場合、セラーはこの配列の最初にマッチしたエントリの value_field と value_factor を使用します。
event_sources[].event_source_idstringYesイベントソース（sync_event_sources で設定済みであること）
event_sources[].event_typeEventTypeYes含めるイベントタイプ（例: purchase、lead、refund）
event_sources[].custom_event_namestringevent_type が custom の場合プラットフォーム固有のカスタムイベント名
event_sources[].value_fieldstringターゲットが per_ad_spend または maximize_value の場合custom_data のどのフィールドが金銭的価値を持つか。セラーはこれを価値の抽出と集計に使用しなければなりません。基盤となるプラットフォーム API に直接渡されるわけではありません。
event_sources[].value_factornumberNoセラーが集計前に value_field に適用しなければなりません乗数（デフォルト1）。返金には -1、センティーム（1/100）には 0.01、カウントには含めながら価値の貢献をゼロにするには 0 を使用します。
target.kind"cost_per" | "per_ad_spend" | "maximize_value"Noターゲットタイプ。省略した場合、セラーは予算内でコンバージョン数を最大化します。
target.valuenumberYes（ターゲット設定時）購入通貨でのイベント単価、またはリターン比率（例: 4.0 = 1の支出に対して1 の支出に対して 4）
attribution_windowobjectNoクリックスルーとビュースルーのウィンドウ。省略した場合、セラーはデフォルトを使用します。
priorityintegerNo1が最高優先度。省略した場合、セラーは配列の順序を使用します。

​
kind: metric

セラーがトラッキングする配信メトリクスに向けて最適化します。イベントソースは不要です。セラーはこれらをネイティブにトラッキングします。プロダクトはサポートするメトリクスを metric_optimization.supported_metrics で宣言します。 クリック数の最大化（ターゲットなし — セラーが予算内でボリュームを最適化）: 
{
  "kind": "metric",
  "metric": "clicks"
}
クリック単価: 
{
  "kind": "metric",
  "metric": "clicks",
  "target": { "kind": "cost_per", "value": 2.00 },
  "priority": 2
}
最低クリック率: 
{
  "kind": "metric",
  "metric": "clicks",
  "target": { "kind": "threshold_rate", "value": 0.001 },
  "priority": 2
}
最低アテンション時間: 
{
  "kind": "metric",
  "metric": "attention_seconds",
  "target": { "kind": "threshold_rate", "value": 5.0 },
  "priority": 3
}
エンゲージメントの最大化（ソーシャルリアクション、コメント、シェア、ストーリー開封、オーバーレイタップ）: 
{
  "kind": "metric",
  "metric": "engagements"
}
再生時間しきい値付きの完了ビュー（TikTok での6秒ビュー）: 
{
  "kind": "metric",
  "metric": "completed_views",
  "view_duration_seconds": 6,
  "target": { "kind": "cost_per", "value": 0.02 },
  "priority": 1
}
フィールド型必須説明
kind"metric"Yes識別子
metricstringYesセラーネイティブのメトリクス（下記のメトリクス表を参照）
view_duration_secondsnumberNocompleted_views イベントとして認定される最低動画再生時間（秒単位）。メトリクスが completed_views の場合にのみ適用されます。省略した場合、セラーはプラットフォームのデフォルトを使用します。プロダクトの metric_optimization.supported_view_durations に記載された値でなければなりません。セラーはサポートされていない値を拒否します。
target.kind"cost_per" | "threshold_rate"Noターゲットタイプ。省略した場合、セラーは予算内でメトリクスのボリュームを最大化します。
target.valuenumberYes（ターゲット設定時）購入通貨でのメトリクス単位あたりのコスト、またはインプレッションごとの最低値
priorityintegerNo1が最高優先度。省略した場合、セラーは配列の順序を使用します。
メトリクス:
メトリクス単位threshold_rate の例説明
clicks回数/インプレッション0.001（0.1% CTR）離脱するリンクのクリック、スワイプスルー、CTA タップ
views回数/インプレッション0.70（70% ビューアビリティ）視認可能なインプレッション
completed_views回数/インプレッション0.85（85% VCR）動画または音声の完了。view_duration_seconds で認定しきい値を制御する（例: 2秒、6秒、15秒）。
viewed_seconds秒/インプレッション3.0（3秒表示）インプレッションごとの表示時間
attention_seconds秒/インプレッション5.0（5秒アテンション）インプレッションごとのアテンション時間
attention_scoreスコア/インプレッション40.0（ベンダー固有）インプレッションごとのアテンションスコア
engagements回数/インプレッション—閲覧を超えた直接インタラクション — ソーシャルリアクション/コメント/シェア、ストーリー/ユニット開封、CTV のインタラクティブオーバーレイタップ、音声のコンパニオンバナーインタラクション
follows回数/インプレッション—新規フォロワー、ページいいね、アーティスト/ポッドキャスト/チャンネルの購読
saves回数/インプレッション—保存、ブックマーク、プレイリスト追加、ピン — 再訪意図のシグナル
profile_visits回数/インプレッション—ブランドのプラットフォーム内ページへのアクセス — プロフィール、アーティストページ、チャンネル、ストアフロント。外部ウェブサイトのクリックは含まない（その場合は clicks を使用）。
reachユニーク数/ウィンドウ—フリークエンシーウィンドウ内のユニークオーディエンスリーチ。reach_unit（例: households、individuals）が必要。最適化のフリークエンシーバンドを設定するには target_frequency を使用します。

​
ターゲットの種類

両方のゴールタイプにまたがるすべてのターゲット種類:
target.kindメトリクスゴールイベントゴール説明
cost_perクリック/ビューなどの単価コンバージョンイベント単価spend / count
threshold_rateインプレッションごとの最低値—インプレッションごとに少なくとも X
per_ad_spend—ターゲット広告費用対効果sum(value_field * value_factor) / spend
maximize_value—総コンバージョン価値の最大化高価値コンバージョンに向けて支出を誘導します。value_field が必要。

​
戦略の選択

ゴール使用場面設定内容
コンバージョン数の最大化予算内でできるだけ多くのコンバージョンkind: "event" + イベントソース、ターゲットなし
ターゲットコンバージョン単価イベントごとの特定のコストkind: "event" + target: { kind: "cost_per", value: 25.0 }
ターゲット広告費用対効果イベント価値に対する特定のリターン比率kind: "event" + ソースの value_field + target: { kind: "per_ad_spend", value: 4.0 }
コンバージョン価値の最大化ROAS ターゲットなしで高価値コンバージョンに誘導kind: "event" + ソースの value_field + target: { kind: "maximize_value" }
クリック数の最大化予算内でクリックを最大化kind: "metric"、metric: "clicks"、ターゲットなし
ターゲットクリック単価特定のクリック単価kind: "metric"、metric: "clicks" + target: { kind: "cost_per", value: 2.0 }
ターゲット CTR最低クリック率kind: "metric"、metric: "clicks" + target: { kind: "threshold_rate", value: 0.001 }
ターゲットビューアビリティ最低ビューアビリティ率kind: "metric"、metric: "views" + target: { kind: "threshold_rate", value: 0.70 }
ターゲットアテンション最低アテンション時間kind: "metric"、metric: "attention_seconds" + target: { kind: "threshold_rate", value: 5.0 }
ターゲット VCR最低動画完了率kind: "metric"、metric: "completed_views" + target: { kind: "threshold_rate", value: 0.85 }
再生時間付き完了ビュー特定の再生時間しきい値付きの動画ビューkind: "metric"、metric: "completed_views" + view_duration_seconds: 6
エンゲージメントの最大化予算内でソーシャルインタラクションを最大化kind: "metric"、metric: "engagements"、ターゲットなし
フォロワーの最大化新規フォロワー/購読者を最大化kind: "metric"、metric: "follows"、ターゲットなし
保存数の最大化保存/ブックマーク/プレイリスト追加を最大化kind: "metric"、metric: "saves"、ターゲットなし
プロフィール訪問の最大化ブランドページ/プロフィールへのトラフィックを誘導kind: "metric"、metric: "profile_visits"、ターゲットなし
最大ユニークリーチ予算内でユニークオーディエンスを最大化kind: "metric"、metric: "reach" + reach_unit: "households"、ターゲットなし
フリークエンシー付きリーチ週1〜3回のフリークエンシーバンドでリーチkind: "metric"、metric: "reach" + reach_unit + target_frequency: { min: 1, max: 3, window: "7d" }

​
複数ゴールと優先度

パッケージは複数のゴールを持てる。優先度はセラーがどれをメインとして扱うかを制御します。よくあるパターンは、イベントデータが少ない場合にメトリクスゴールをプロキシシグナルとして使用することです。 
"optimization_goals": [
  {
    "kind": "metric",
    "metric": "clicks",
    "target": { "kind": "cost_per", "value": 2.00 },
    "priority": 2
  },
  {
    "kind": "event",
    "event_sources": [
      { "event_source_id": "mobile_sdk", "event_type": "app_install" },
      { "event_source_id": "mmp_adjust", "event_type": "app_install" }
    ],
    "target": { "kind": "cost_per", "value": 10.00 },
    "priority": 1
  }
]
セラーは priority: 1 のゴール（SDK と MMP をまたいで重複排除した $10 インストール単価）に注力し、インストールデータが蓄積されるまでクリックをプロキシシグナルとして使用します。

​
価格モデルと最適化ゴール

価格モデル（CPC、CPM、CPA など）はバイヤーが支払う対象を決める。最適化ゴールはセラーがどのようにインプレッションを配分するかを決める。これらは独立しています。パッケージは CPM 価格を使いながら CPA ターゲットに向けて最適化したり、CPA 価格を使いながら ROAS に向けて最適化したりできます。請求の詳細については価格モデルを参照。

​
リーチとフリークエンシー

リーチベースの最適化は metric: "reach" と2つの追加フィールドを使用します。
  • reach_unit（必須）: 測定単位 — プロダクトの metric_optimization.supported_reach_units で宣言された値でなければなりません（例: households、individuals）。
  • target_frequency（任意）: 最適化を誘導するフリークエンシーバンド。セラーは未リーチのエンティティへのインプレッションを高価値として、すでに飽和したエンティティへのインプレッションを低価値として扱います。min、max、window（例: "7d"、"campaign"）を含みます。省略した場合、セラーはユニークリーチを最大化します。
{
  "kind": "metric",
  "metric": "reach",
  "reach_unit": "households",
  "target_frequency": { "min": 1, "max": 3, "window": "7d" },
  "priority": 1
}
GRP ベースのバイには CPP 価格を使用します。最適化とは独立したハードなフリークエンシー制限には、パッケージの frequency_cap を使用します。リーチとフリークエンシーのメトリクスは get_media_buy_delivery の配信レポートで確認できます。

​
前提条件

メトリクスゴール（kind: "metric"）の場合:
  1. プロダクトのサポートを確認する — プロダクトは metric_optimization で目的のメトリクスを supported_metrics に宣言していなければなりません。イベントソースやコンバージョントラッキングの設定は不要です。
  2. ターゲットのサポートを確認する — ターゲットを設定する場合は、ターゲットの種類が metric_optimization.supported_targets に記載されていることを確認すること。
  3. 再生時間を確認する — view_duration_seconds 付きの completed_views を使用する場合は、その値が metric_optimization.supported_view_durations に記載されていることを確認すること。
イベントゴール（kind: "event"）の場合:
  1. イベントソースを設定する — sync_event_sources を呼び出して、event_sources で参照するイベントソースをセットアップします。
  2. プロダクトのサポートを確認する — プロダクトは conversion_tracking で目的のターゲット種類を supported_targets に宣言していなければなりません。
  3. 重複排除のサポートを確認する — ゴールごとに複数のイベントソースを使用する場合は、セラーが get_adcp_capabilities で multi_source_event_dedup をサポートしていることを確認すること。サポートされていない場合は、ゴールごとに1つのイベントソースを使用すること。
  4. イベントを送信する — log_event を使用してコンバージョンデータを送信します。セラーが効果的に最適化するにはイベント履歴が必要です。

​
アトリビューションウィンドウ

アトリビューションウィンドウは、セラーがコンバージョンに広告インプレッションをクレジットするためにどれだけ遡るかを制御します。一般的なオプション:
ウィンドウ意味
post_click: {interval: 7, unit: "days"}クリックから7日以内のコンバージョン
post_click: {interval: 28, unit: "days"}クリックから28日以内のコンバージョン
post_view: {interval: 1, unit: "days"}広告視聴から1日以内のコンバージョン
post_view: {interval: 7, unit: "days"}広告視聴から7日以内のコンバージョン
値はセラーの conversion_tracking.attribution_windows ケーパビリティのオプションと一致しなければなりません。省略した場合、セラーはデフォルトのウィンドウを適用します。

​
配信レポートとの連携

イベントソースが設定されてイベントが流れ始めると、get_media_buy_delivery のレスポンスにコンバージョンメトリクスが表示されます。
  • conversions — キャンペーンにアトリビュートされたポストクリックまたはポストビューのコンバージョン
  • conversion_value — アトリビュートされたコンバージョンの金銭的価値
  • roas — 広告費用対効果（conversion_value / spend）
  • cost_per_acquisition — コンバージョン単価（spend / conversions）
これらのメトリクスは、パッケージに optimization_goals が設定されている場合にパッケージごとにレポートされます。by_action_source ブレークダウンをサポートするセラーは、コンバージョンをソース別（website、app、in_store など）に分けて表示できます。

​
カタログアイテムのアトリビューション

カタログドリブンのパッケージでは、コンバージョンイベントに関連するカタログアイテムを識別する content_ids が含まれます。カタログの content_id_type は期待される識別子タイプ（sku、gtin、job_id など）を宣言します。 アトリビューションは意図的に幅広く設計されています。ユーザーがあるアイテム（求人 A）をクリックして別のアイテム（求人 B に応募）でコンバージョンする場合もあります。イベントはクリックされたアイテムではなく、コンバージョンの実際の content_id で発火します。アイテムごとのクリックからコンバージョンまでのパス分析はプラットフォームの最適化の問題であり、プロトコルの問題ではありません。 get_media_buy_delivery の by_catalog_item ブレークダウンは、アイテムごとのメトリクス（インプレッション、支出、クリック、コンバージョン）を表示します。

​
関連ドキュメント