> ## 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.

# DOOH (デジタル屋外広告)

このガイドでは、デジタルビルボード、交通機関のスクリーン、店舗や施設のディスプレイ向けに、AdCP がデジタル屋外広告 (DOOH) フォーマットをどのように表現するかを解説します。

## DOOH フォーマットの特性

DOOH フォーマットは他のデジタル広告と異なり次の特徴があります。

* 公共空間の物理スクリーンに表示
* 空港・モール・高速道路など会場コンテキストを含みます
* デバイス ID ではなく会場ベースのインプレッショントラッキングを使用
* クリック先 URL はなく、代わりに QR コードを使用
* 多くの場合オーディオなしで表示

## 標準的な DOOH フォーマット

### デジタルビルボード（横型）

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "dooh_billboard_1920x1080"
  },
  "type": "dooh",
  "assets": [
    {
      "asset_id": "billboard_image",
      "asset_type": "image",
      "asset_role": "hero_image",
      "required": true,
      "requirements": {
        "width": 1920,
        "height": 1080,
        "file_types": ["jpg", "png"],
        "max_file_size_kb": 1000
      }
    },
    {
      "asset_id": "impression_tracker",
      "asset_type": "url",
      "url_type": "tracker",
      "required": true
    }
  ]
}
```

### トランジットスクリーン（縦型）

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "dooh_transit_1080x1920"
  },
  "type": "dooh",
  "assets": [
    {
      "asset_id": "screen_image",
      "asset_type": "image",
      "asset_role": "hero_image",
      "required": true,
      "requirements": {
        "width": 1080,
        "height": 1920,
        "aspect_ratio": "9:16",
        "file_types": ["jpg", "png"]
      }
    },
    {
      "asset_id": "impression_tracker",
      "asset_type": "url",
      "url_type": "tracker",
      "required": true
    }
  ]
}
```

### ビデオビルボード

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "dooh_video_15s"
  },
  "type": "dooh",
  "assets": [
    {
      "asset_id": "video_file",
      "asset_type": "video",
      "asset_role": "hero_video",
      "required": true,
      "requirements": {
        "duration": "15s",
        "width": 1920,
        "height": 1080,
        "format": ["MP4"],
        "audio_required": false,
        "max_file_size_mb": 50
      }
    },
    {
      "asset_id": "impression_tracker",
      "asset_type": "url",
      "url_type": "tracker",
      "required": true
    }
  ]
}
```

## DOOH のインプレッショントラッキング

DOOH では「proof-of-play」とも呼ばれるインプレッショントラッカーを使い、クリエイティブが物理スクリーンで表示されたことを検証します。DOOH 固有のマクロを含む標準的な URL アセットです。

```json theme={null}
{
  "asset_id": "impression_tracker",
  "asset_type": "url",
  "url_type": "tracker",
  "required": true,
  "requirements": {
    "required_macros": [
      "SCREEN_ID",
      "PLAY_TIMESTAMP",
      "VENUE_LAT",
      "VENUE_LONG"
    ]
  }
}
```

仕組み自体はデジタル広告のインプレッショントラッキングと同じで、表示時に URL が発火します。違いは、デバイス ID ではなく物理的な会場コンテキストをマクロで送る点です。

## クリエイティブマニフェスト

### 静止画ビルボードのマニフェスト

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "dooh_billboard_1920x1080"
  },
  "assets": {
    "billboard_image": {
      "asset_type": "image",
      "url": "https://cdn.brand.com/dooh_billboard.jpg",
      "width": 1920,
      "height": 1080
    },
    "impression_tracker": {
      "asset_type": "url",
      "url_type": "tracker",
      "url": "https://track.brand.com/pop?buy={MEDIA_BUY_ID}&screen={SCREEN_ID}&venue={VENUE_TYPE}&ts={PLAY_TIMESTAMP}&lat={VENUE_LAT}&long={VENUE_LONG}"
    }
  }
}
```

### ビデオビルボードのマニフェスト

```json theme={null}
{
  "format_id": {
    "agent_url": "https://creative.adcontextprotocol.org",
    "id": "dooh_video_15s"
  },
  "assets": {
    "video_file": {
      "asset_type": "video",
      "url": "https://cdn.brand.com/dooh_15s.mp4",
      "duration": 15,
      "width": 1920,
      "height": 1080,
      "audio": false
    },
    "impression_tracker": {
      "asset_type": "url",
      "url_type": "tracker",
      "url": "https://track.brand.com/pop?buy={MEDIA_BUY_ID}&screen={SCREEN_ID}&ts={PLAY_TIMESTAMP}"
    }
  }
}
```

## DOOH 固有のマクロ

[ユニバーサルマクロ](/docs/creative/universal-macros) に加えて、DOOH では次をサポートします。

### 会場情報

* `{SCREEN_ID}` - スクリーンのユニーク ID
* `{VENUE_TYPE}` - 空港、モール、交通機関、高速道路、小売など
* `{VENUE_NAME}` - 特定の会場名
* `{VENUE_LAT}` / `{VENUE_LONG}` - GPS 座標

### 再生情報

* `{PLAY_TIMESTAMP}` - クリエイティブが表示された時刻（Unix タイムスタンプ）
* `{DWELL_TIME}` - その場所での平均滞留時間（秒）
* `{LOOP_LENGTH}` - 広告ローテーション全体の長さ（秒）

**インプレッショントラッキング URL の例:**

```
https://track.brand.com/imp?
  buy={MEDIA_BUY_ID}&
  screen={SCREEN_ID}&
  venue={VENUE_TYPE}&
  venue_name={VENUE_NAME}&
  ts={PLAY_TIMESTAMP}&
  lat={VENUE_LAT}&
  long={VENUE_LONG}&
  dwell={DWELL_TIME}
```

## よく使われるアスペクト比

* **16:9** (1920x1080) - 横型ビルボードや高速道路のスクリーン
* **9:16** (1080x1920) - 縦型の交通機関・リテールディスプレイ
* **1:1** (1080x1080) - 正方形フォーマット

## インプレッションの検証

DOOH のインプレッショントラッカーは次を確認します。

* クリエイティブが実際に物理スクリーンに表示されたか
* 表示された正確なタイムスタンプ
* スクリーンの場所と会場コンテキスト

**取得されるインプレッションデータの例:**

```json theme={null}
{
  "media_buy_id": "mb_dooh_q1",
  "screen_id": "LAX_T1_GATE24",
  "venue_type": "airport",
  "venue_lat": "33.9416",
  "venue_long": "-118.4085",
  "play_timestamp": "1704067200",
  "dwell_time_seconds": "45"
}
```

他チャネルのインプレッショントラッキングと同様に、表示時に URL が発火し、請求やレポートのための検証データを提供します。

## 関連ドキュメント

* [ユニバーサルマクロ](/docs/creative/universal-macros) - DOOH マクロを含む完全なリファレンス
* [クリエイティブマニフェスト](/docs/creative/creative-manifests) - マニフェストの構造と例
* [Asset Types](/docs/creative/asset-types) - URL アセットの仕様