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 がデジタル屋外広告 (DOOH) フォーマットをどのように表現するかを解説します。
DOOH フォーマットの特性
DOOH フォーマットは他のデジタル広告と異なり次の特徴があります。
- 公共空間の物理スクリーンに表示
- 空港・モール・高速道路など会場コンテキストを含みます
- デバイス ID ではなく会場ベースのインプレッショントラッキングを使用
- クリック先 URL はなく、代わりに QR コードを使用
- 多くの場合オーディオなしで表示
標準的な DOOH フォーマット
デジタルビルボード（横型）
{
"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
}
]
}
トランジットスクリーン（縦型）
{
"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
}
]
}
ビデオビルボード
{
"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 アセットです。
{
"asset_id": "impression_tracker",
"asset_type": "url",
"url_type": "tracker",
"required": true,
"requirements": {
"required_macros": [
"SCREEN_ID",
"PLAY_TIMESTAMP",
"VENUE_LAT",
"VENUE_LONG"
]
}
}
クリエイティブマニフェスト
静止画ビルボードのマニフェスト
{
"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}"
}
}
}
ビデオビルボードのマニフェスト
{
"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 固有のマクロ
ユニバーサルマクロ に加えて、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 のインプレッショントラッカーは次を確認します。
- クリエイティブが実際に物理スクリーンに表示されたか
- 表示された正確なタイムスタンプ
- スクリーンの場所と会場コンテキスト
取得されるインプレッションデータの例:
{
"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"
}
関連ドキュメント
