> ## 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 アトリビューションウィンドウを v2 から v3 に移行します。整数の日数を構造化された Duration オブジェクトに置き換え、必須のアトリビューションモデルフィールドを追加します。

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

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

## 変更内容

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

***

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

### 変更前（v2）

```json theme={null}
{
  "attribution_window": {
    "click_window_days": 7,
    "view_window_days": 1,
    "model": "last_touch"
  }
}
```

### 変更後（v3）

```json theme={null}
{
  "$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` タイプは、フリークエンシーキャップ、アトリビューションウィンドウ、その他の時間ベース設定で共有されます。

```json theme={null}
{
  "interval": 30,
  "unit": "minutes"
}
```

| ユニット       | 意味                                       |
| ---------- | ---------------------------------------- |
| `minutes`  | 時計の分                                     |
| `hours`    | 時計の時間                                    |
| `days`     | カレンダー日数                                  |
| `campaign` | キャンペーンのフライト全体（interval は `1` でなければなりません） |

***

## 移行ステップ

<Steps>
  <Step title="アトリビューションフィールドの名前を変更する">
    すべてのアトリビューションウィンドウオブジェクトで `click_window_days` を `post_click` に、`view_window_days` を `post_view` に置き換える。
  </Step>

  <Step title="整数の日数を Duration オブジェクトに変換する">
    整数の日数（例: `7`）を構造化された Duration オブジェクト（例: `{ "interval": 7, "unit": "days" }`）に置き換える。
  </Step>

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

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

<Card title="コンバージョントラッキングと最適化目標" icon="arrow-right" href="/docs/media-buy/conversion-tracking/index">
  イベントソースを設定し、コンバージョンイベントを送信し、アトリビューションウィンドウを設定します。
</Card>

***

**関連:** [チャンネル](/docs/reference/migration/channels) | [価格](/docs/reference/migration/pricing) | [ジオターゲティング](/docs/reference/migration/geo-targeting) | [クリエイティブ](/docs/reference/migration/creatives) | [カタログ](/docs/reference/migration/catalogs) | [AdCP 3.0 概要](/docs/reference/whats-new-in-v3)