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 がオーディオ広告フォーマットをどのように表現するかを説明します。
オーディオフォーマットの特徴
オーディオフォーマットには次が含まれます。
- ホスト型オーディオ - 音声ファイル URL(MP3, M4A)
- VAST オーディオ - プログラマティックオーディオ向け DAAST/VAST タグ
- コンパニオンバナー付き - オーディオ + 同期されたディスプレイバナー
- ポッドキャストインサーション - ポッドキャストの動的広告挿入(DAI)
オーディオ広告は通常スキップ不可で、コンテンツの自然なブレイクで再生されます。
標準オーディオフォーマット
ストリーミングオーディオ(15/30/60 秒)
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "30s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps",
"max_file_size_mb": 5
}
}
]
}
コンパニオンバナー付きオーディオ
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_companion"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "30s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps"
}
},
{
"asset_id": "companion_banner",
"asset_type": "image",
"asset_role": "companion_banner",
"required": false,
"requirements": {
"width": 640,
"height": 640,
"file_types": ["jpg", "png", "webp"],
"notes": "Displays during audio playback on screen-enabled devices"
}
}
]
}
ポッドキャスト Mid-Roll(60 秒)
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "podcast_midroll_60s"
},
"type": "audio",
"assets": [
{
"asset_id": "audio_file",
"asset_type": "audio",
"asset_role": "hero_audio",
"required": true,
"requirements": {
"duration": "60s",
"format": ["MP3", "M4A"],
"bitrate_min": "128kbps",
"max_file_size_mb": 10
}
}
]
}
ダイナミックオーディオクリエイティブ (DAC)
複数セグメントの音声を動的に組み立てます。
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_dynamic_30s"
},
"type": "audio",
"assets": [
{
"asset_id": "intro_audio",
"asset_type": "audio",
"asset_role": "intro",
"required": true,
"requirements": {
"duration": "5s",
"format": ["MP3"]
}
},
{
"asset_id": "product_audio",
"asset_type": "audio",
"asset_role": "product_message",
"required": true,
"requirements": {
"duration": "15s",
"format": ["MP3"]
}
},
{
"asset_id": "cta_audio",
"asset_type": "audio",
"asset_role": "call_to_action",
"required": true,
"requirements": {
"duration": "10s",
"format": ["MP3"]
}
}
],
"delivery": {
"method": "server_side_stitching"
}
}
クリエイティブマニフェスト
ホスト型オーディオマニフェスト
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s"
},
"assets": {
"audio_file": {
"asset_type": "audio",
"url": "https://cdn.brand.com/audio_spring_30s.mp3",
"duration": 30,
"format": "audio/mpeg"
},
"impression_tracker": {
"asset_type": "url",
"url_type": "tracker",
"url": "https://track.brand.com/imp?buy={MEDIA_BUY_ID}&station={APP_BUNDLE}&cb={CACHEBUSTER}"
},
"landing_url": {
"asset_type": "url",
"url_type": "clickthrough",
"url": "https://brand.com/spring?campaign={MEDIA_BUY_ID}"
}
}
}
VAST オーディオタグマニフェスト
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_vast"
},
"assets": {
"vast_url": {
"asset_type": "url",
"url_type": "tracker",
"url": "https://adserver.brand.com/vast?cb={CACHEBUSTER}"
},
"impression_tracker": {
"asset_type": "url",
"url_type": "tracker",
"url": "https://track.brand.com/vast_imp?buy={MEDIA_BUY_ID}"
}
}
}
コンパニオンバナー付きオーディオマニフェスト
{
"format_id": {
"agent_url": "https://creative.adcontextprotocol.org",
"id": "audio_30s_companion"
},
"assets": {
"audio_file": {
"asset_type": "audio",
"url": "https://cdn.brand.com/audio_spring_30s.mp3",
"duration": 30,
"format": "audio/mpeg"
},
"companion_banner": {
"asset_type": "image",
"url": "https://cdn.brand.com/companion_640x640.png",
"width": 640,
"height": 640
},
"landing_url": {
"asset_type": "url",
"url_type": "clickthrough",
"url": "https://brand.com/audio_offer"
}
}
}
DOOH 専用マクロ
オーディオでよく使うユニバーサルマクロ例:
{MEDIA_BUY_ID} - メディアバイの識別子
{APP_BUNDLE} - ステーション/アプリのバンドル ID
{CACHEBUSTER} - キャッシュ回避用ランダム値
リアルタイムプレビュー
preview_creative を用いてオーディオマニフェストのプレビューを生成できます。output_format: "url" でプレーヤーの URL を取得し、output_format: "html" で埋め込み可能な HTML を取得します。
関連ドキュメント