Skip to main content

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

AdCP 3.0 はアトリビューションウィンドウフィールドの名前を変更し、整数の日数を構造化された Duration オブジェクトに置き換える。アトリビューション model フィールドが必須になりました。

​
変更内容

v2 フィールドv3 フィールド変更タイプ
click_window_days（整数）post_click（Duration）名前変更 + タイプ変更
view_window_days（整数）post_view（Duration）名前変更 + タイプ変更
model（必須）model（必須）変更なし

​
アトリビューションウィンドウオブジェクト

​
変更前（v2）

{
  "attribution_window": {
    "click_window_days": 7,
    "view_window_days": 1,
    "model": "last_touch"
  }
}

​
変更後（v3）

{
  "$schema": "https://adcontextprotocol.org/schemas/v3/core/attribution-window.json",
  "post_click": {
    "interval": 7,
    "unit": "days"
  },
  "post_view": {
    "interval": 1,
    "unit": "days"
  },
  "model": "last_touch"
}
主な違い:
  • フィールド名変更 — click_window_days → post_click、view_window_days → post_view。新しい名前はルックバックウィンドウを開始するユーザーアクションを表します。
  • 構造化された Duration — 時間ウィンドウは整数の日数ではなく { interval, unit } オブジェクトになりました。これにより時間単位（minutes、hours）やキャンペーンスコープのウィンドウが使える。
  • アトリビューションモデル — v2 と v3 の両方で必須。変更不要。

​
Duration オブジェクト

Duration タイプは、フリークエンシーキャップ、アトリビューションウィンドウ、その他の時間ベース設定で共有されます。 
{
  "interval": 30,
  "unit": "minutes"
}
ユニット意味
minutes時計の分
hours時計の時間
daysカレンダー日数
campaignキャンペーンのフライト全体（interval は 1 でなければなりません）

​
移行ステップ

1

アトリビューションフィールドの名前を変更する

すべてのアトリビューションウィンドウオブジェクトで click_window_days を post_click に、view_window_days を post_view に置き換える。
2

整数の日数を Duration オブジェクトに変換する

整数の日数（例: 7）を構造化された Duration オブジェクト（例: { "interval": 7, "unit": "days" }）に置き換える。
3

フリークエンシーキャップウィンドウを更新する

フリークエンシーキャップにも同様の移行があります。v2 は suppress_minutes（整数）を使用していました。v3 は suppress（Duration オブジェクト）を使用し、window（Duration）を持つ max_impressions を追加します。suppress_minutes: 30 を suppress: { "interval": 30, "unit": "minutes" } に変換します。
4

v3 スキーマに対して検証する

アトリビューションウィンドウオブジェクトが attribution-window.json スキーマに対して検証されることを確認します。

コンバージョントラッキングと最適化目標

イベントソースを設定し、コンバージョンイベントを送信し、アトリビューションウィンドウを設定します。
関連: チャンネル | 価格 | ジオターゲティング | クリエイティブ | カタログ | AdCP 3.0 概要