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.
カタログアイテムスキーマ
各バーティカルカタログタイプは、Google、Meta、LinkedIn などのプラットフォーム全体で機能する単一の AdCP スキーマにマッピングされます。このフォーマットで一度アイテムを提供すれば、すべてのプラットフォームが必要なものを取得できます。
すべてのバーティカルアイテムは共通のパターンを共有する: 一意の ID フィールド、コアの表示フィールド、型付きクリエイティブアセットプールのためのオプションの assets 配列、フィルタリングのためのオプションの tags 配列、ベンダー固有の拡張のための ext オブジェクト。各バーティカルに記載されているコンバージョンイベントは、広告がカタログアイテムのアクションを促した際のアトリビューションに使用される標準イベント名です。
共通フィールド
各バーティカルのテーブルに記載されているドメイン固有のフィールドに加えて、すべてのバーティカルアイテムは次のフィールドをサポートする:
| フィールド | 型 | 説明 |
|---|
image_url | uri | プライマリ画像 URL（ほとんどのバーティカル — 注記を参照） |
url | uri | ランディングページ URL（ほとんどのバーティカル — 注記を参照） |
assets | OfferingAssetGroup[] | 型付きクリエイティブアセットプール（landscape、vertical、square、logo、video） |
tags | string[] | フィルタリングとターゲティング用のタグ |
ext | object | ベンダー固有の拡張 |
url の代わりに apply_url を使用し、image_url がない。App アイテムは image_url と url の代わりに icon_url と store_url を使用します。正確なフィールドについては各バーティカルのフィールドテーブルを参照。
求人カタログ
採用キャンペーン用の求人情報。LinkedIn Jobs XML、Google DynamicJobsAsset、schema.org JobPosting にマッピングされます。
スキーマ: /schemas/core/job-item.json
必須: job_id、title、company_name、description
コンバージョンイベント: submit_application、complete_registration
| フィールド | 型 | 説明 |
|---|
job_id | string | この求人の一意の識別子 |
title | string | 職種 |
company_name | string | 採用企業名 |
description | string | 求人の詳細説明 |
location | string | 表示文字列 — “Amsterdam, NL” または “Remote” |
employment_type | enum | full_time、part_time、contract、temporary、internship、freelance |
experience_level | enum | entry_level、mid_level、senior、director、executive |
salary | object | { min, max, currency, period } — period は hour、month、year |
date_posted | date | ISO 8601 日付 |
valid_through | date | 応募締め切り日 |
apply_url | uri | 直接応募 URL |
job_functions | string[] | 例: ["engineering", "marketing"] |
industries | string[] | 例: ["technology", "healthcare"] |
tags | string[] | フィルタリング用 — 例: ["remote", "visa-sponsorship"] |
assets、tags、ext）も使用できます。Job アイテムは url の代わりに apply_url を使用し、image_url がない。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/job-item.json",
"job_id": "eng-sr-2025-042",
"title": "Senior Software Engineer",
"company_name": "Acme Corp",
"description": "Senior engineer to lead our platform team, designing distributed systems serving millions of daily requests."
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/job-item.json",
"job_id": "eng-sr-2025-042",
"title": "Senior Software Engineer",
"company_name": "Acme Corp",
"description": "We're looking for a senior engineer to lead our platform team. You'll design and build distributed systems serving millions of daily requests.",
"location": "Amsterdam, NL",
"employment_type": "full_time",
"experience_level": "senior",
"salary": { "min": 80000, "max": 110000, "currency": "EUR", "period": "year" },
"date_posted": "2025-06-01",
"valid_through": "2025-08-01",
"apply_url": "https://acmecorp.com/careers/eng-sr-2025-042",
"job_functions": ["engineering"],
"industries": ["technology"],
"tags": ["visa-sponsorship", "equity"]
}
ホテルカタログ
旅行広告とダイナミックリマーケティング用のホテル・宿泊施設物件。Google Hotel Center フィードと Meta ホテルカタログにマッピングされます。
スキーマ: /schemas/core/hotel-item.json
必須: hotel_id、name、location
コンバージョンイベント: purchase（予約）
| フィールド | 型 | 説明 |
|---|
hotel_id | string | 一意の識別子 |
name | string | 施設名 |
description | string | 施設の説明 |
location | object | { lat, lng } — WGS 84 座標 |
address | object | { street, city, region, postal_code, country } |
star_rating | integer | 1–5 |
price | object | { amount, currency, period } — period は "night" を使用 |
image_url | uri | メインの施設画像 |
url | uri | 施設のランディングページ |
amenities | string[] | 例: ["spa", "pool", "wifi"] |
check_in_time | string | HH:MM フォーマット（例: "15:00"） |
check_out_time | string | HH:MM フォーマット（例: "11:00"） |
phone | string | 施設の電話番号（E.164 形式） |
valid_from | date | 季節の空き状況ウィンドウの開始 |
valid_to | date | 季節の空き状況ウィンドウの終了 |
tags | string[] | 例: ["luxury", "city-center"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/hotel-item.json",
"hotel_id": "grand-amsterdam",
"name": "Grand Hotel Amsterdam",
"location": { "lat": 52.3676, "lng": 4.9041 }
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/hotel-item.json",
"hotel_id": "grand-amsterdam",
"name": "Grand Hotel Amsterdam",
"description": "Five-star canal-side hotel in the heart of Amsterdam with rooftop bar and spa.",
"location": { "lat": 52.3676, "lng": 4.9041 },
"address": {
"street": "Herengracht 100",
"city": "Amsterdam",
"region": "NL-NH",
"postal_code": "1015 BS",
"country": "NL"
},
"star_rating": 5,
"price": { "amount": 289, "currency": "EUR", "period": "night" },
"image_url": "https://images.acmehotels.com/grand-amsterdam/hero.jpg",
"url": "https://acmehotels.com/amsterdam/grand",
"amenities": ["spa", "pool", "restaurant", "wifi", "parking"],
"check_in_time": "15:00",
"check_out_time": "11:00",
"tags": ["luxury", "city-center", "business"]
}
車両カタログ
自動車在庫広告用の車両リスト。Meta Automotive Inventory Ads、Microsoft Auto Inventory フィード、Google 車両広告にマッピングされます。
スキーマ: /schemas/core/vehicle-item.json
必須: vehicle_id、title、make、model、year
コンバージョンイベント: lead、schedule（試乗）
| フィールド | 型 | 説明 |
|---|
vehicle_id | string | 一意の識別子 |
title | string | リストタイトル（例: “2024 Apex Horizon EX Sedan”） |
make | string | メーカー |
model | string | モデル名 |
year | integer | 年式 |
price | object | { amount, currency } |
condition | enum | new、used、certified_pre_owned |
vin | string | 17 文字の VIN |
trim | string | トリムレベル（例: “EX”、“Limited”） |
mileage | object | { value, unit } — unit は km または mi |
body_style | enum | sedan、suv、truck、coupe、convertible、wagon、van、hatchback |
transmission | enum | automatic、manual、cvt |
fuel_type | enum | gasoline、diesel、electric、hybrid、plug_in_hybrid |
exterior_color | string | 外装色 |
interior_color | string | 内装色 |
location | object | { lat, lng } — ディーラーまたは車両の場所 |
tags | string[] | 例: ["low-mileage", "one-owner"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/vehicle-item.json",
"vehicle_id": "dlr-2024-horizon-001",
"title": "2024 Apex Horizon EX Sedan",
"make": "Apex",
"model": "Horizon",
"year": 2024
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/vehicle-item.json",
"vehicle_id": "dlr-2024-horizon-001",
"title": "2024 Apex Horizon EX Sedan",
"make": "Apex",
"model": "Horizon",
"year": 2024,
"trim": "EX",
"price": { "amount": 28500, "currency": "USD" },
"condition": "new",
"body_style": "sedan",
"transmission": "cvt",
"fuel_type": "gasoline",
"exterior_color": "Lunar Silver Metallic",
"image_url": "https://images.apexmotors.com/horizon-ex-2024.jpg",
"url": "https://apexmotors.com/inventory/horizon-001",
"tags": ["new-arrival"]
}
フライトカタログ
旅行広告とダイナミックリマーケティング用のフライトルート。Google DynamicFlightsAsset と Meta フライトカタログにマッピングされます。
スキーマ: /schemas/core/flight-item.json
必須: flight_id、origin、destination
コンバージョンイベント: purchase（予約）
| フィールド | 型 | 説明 |
|---|
flight_id | string | このルートの一意の識別子 |
origin | object | { airport_code, city } — IATA 3 文字コードが必須 |
destination | object | { airport_code, city } — IATA 3 文字コードが必須 |
airline | string | 航空会社名または IATA コード |
price | object | { amount, currency } |
description | string | ルートの説明またはプロモーションテキスト |
departure_time | datetime | ISO 8601 |
arrival_time | datetime | ISO 8601 |
image_url | uri | 目的地の写真 |
url | uri | 予約ページ |
tags | string[] | 例: ["direct", "red-eye"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/flight-item.json",
"flight_id": "ams-jfk-summer",
"origin": { "airport_code": "AMS" },
"destination": { "airport_code": "JFK" }
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/flight-item.json",
"flight_id": "ams-jfk-summer",
"origin": { "airport_code": "AMS", "city": "Amsterdam" },
"destination": { "airport_code": "JFK", "city": "New York" },
"airline": "Acme Air",
"price": { "amount": 449, "currency": "EUR" },
"description": "Direct flights from Amsterdam to New York, daily departures.",
"image_url": "https://images.acmeair.com/routes/ams-jfk.jpg",
"url": "https://acmeair.com/flights/ams-jfk",
"tags": ["direct", "transatlantic"]
}
不動産カタログ
不動産広告用の物件リスト。Google DynamicRealEstateAsset と Meta 住宅物件カタログにマッピングされます。
スキーマ: /schemas/core/real-estate-item.json
必須: listing_id、title、address
コンバージョンイベント: lead、schedule（内覧）
| フィールド | 型 | 説明 |
|---|
listing_id | string | 一意の識別子 |
title | string | リストタイトル |
description | string | 物件の説明 |
address | object | { street, city, region, postal_code, country } |
price | object | { amount, currency, period } — 賃貸の場合は "month" を使用 |
property_type | enum | house、apartment、condo、townhouse、land、commercial |
listing_type | enum | for_sale、for_rent |
bedrooms | integer | 寝室数 |
bathrooms | number | バスルーム数（例: 2.5） |
area | object | { value, unit } — unit は sqft または sqm |
location | object | { lat, lng } |
neighborhood | string | エリア名 |
year_built | integer | 建築年 |
tags | string[] | 例: ["garden", "renovated"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/real-estate-item.json",
"listing_id": "ams-jordaan-3br",
"title": "Spacious 3BR Apartment in Jordaan",
"address": { "city": "Amsterdam", "country": "NL" }
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/real-estate-item.json",
"listing_id": "ams-jordaan-3br",
"title": "Spacious 3BR Apartment in Jordaan",
"description": "Bright canal-view apartment with original features and modern kitchen, steps from Noordermarkt.",
"address": {
"street": "Prinsengracht 450",
"city": "Amsterdam",
"region": "NL-NH",
"postal_code": "1017 KE",
"country": "NL"
},
"price": { "amount": 650000, "currency": "EUR" },
"property_type": "apartment",
"listing_type": "for_sale",
"bedrooms": 3,
"bathrooms": 1,
"area": { "value": 95, "unit": "sqm" },
"location": { "lat": 52.3667, "lng": 4.8833 },
"neighborhood": "Jordaan",
"year_built": 1920,
"tags": ["canal-view", "renovated"]
}
教育カタログ
学生募集用の教育プログラムとコース。Google DynamicEducationAsset と schema.org Course にマッピングされます。
スキーマ: /schemas/core/education-item.json
必須: program_id、name、school
コンバージョンイベント: submit_application、complete_registration
| フィールド | 型 | 説明 |
|---|
program_id | string | 一意の識別子 |
name | string | プログラム名 |
school | string | 機関名 |
description | string | プログラムの説明 |
subject | string | 研究分野 |
degree_type | enum | certificate、associate、bachelor、master、doctorate、professional、bootcamp |
level | enum | beginner、intermediate、advanced |
price | object | { amount, currency, period } |
duration | string | 例: “4 weeks”、“2 years” |
start_date | date | 次の開始可能日 |
language | string | 言語コード（例: “en”） |
modality | enum | online、in_person、hybrid |
location | string | キャンパスの場所（例: “Amsterdam, NL”）。完全オンラインの場合は省略。 |
tags | string[] | 例: ["stem", "research"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/education-item.json",
"program_id": "pinnacle-msc-cs-2025",
"name": "MSc Computer Science",
"school": "Pinnacle University"
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/education-item.json",
"program_id": "pinnacle-msc-cs-2025",
"name": "MSc Computer Science",
"school": "Pinnacle University",
"description": "Two-year research master's covering AI, distributed systems, and software engineering.",
"subject": "computer-science",
"degree_type": "master",
"level": "advanced",
"price": { "amount": 2314, "currency": "EUR", "period": "year" },
"duration": "2 years",
"start_date": "2025-09-01",
"language": "en",
"modality": "in_person",
"location": "Amsterdam, NL",
"url": "https://pinnacle-university.com/programmes/masters/computer-science",
"tags": ["stem", "research"]
}
目的地カタログ
目的地広告と旅行リマーケティング用の旅行目的地。Meta 目的地カタログと Google トラベル広告にマッピングされます。
スキーマ: /schemas/core/destination-item.json
必須: destination_id、name
コンバージョンイベント: purchase（予約）
| フィールド | 型 | 説明 |
|---|
destination_id | string | 一意の識別子 |
name | string | 目的地名 |
description | string | ハイライトと魅力 |
city | string | 都市名 |
region | string | 州/県 |
country | string | ISO 3166-1 alpha-2 |
location | object | { lat, lng } |
destination_type | enum | beach、mountain、urban、cultural、adventure、wellness、cruise |
price | object | 旅行の開始価格 |
rating | number | 1–5 |
tags | string[] | 例: ["family", "romantic"] |
image_url、url、assets、tags、ext）も使用できます。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/destination-item.json",
"destination_id": "barcelona",
"name": "Barcelona"
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/destination-item.json",
"destination_id": "barcelona",
"name": "Barcelona",
"description": "Mediterranean city blending Gaudí architecture, beaches, and world-class dining.",
"city": "Barcelona",
"region": "Catalonia",
"country": "ES",
"location": { "lat": 41.3874, "lng": 2.1686 },
"destination_type": "urban",
"price": { "amount": 399, "currency": "EUR" },
"image_url": "https://images.acmetravel.com/barcelona/hero.jpg",
"url": "https://acmetravel.com/destinations/barcelona",
"rating": 4.7,
"tags": ["city-break", "beach", "culture"]
}
アプリカタログ
アプリインストールとリエンゲージメントキャンペーン用のモバイルアプリケーション。Google App Campaigns、Apple Search Ads、Meta App Ads、TikTok App Campaigns、Snapchat App Install Ads にマッピングされます。iOS と Android のバリアントは別々のアイテムです。
スキーマ: /schemas/core/app-item.json
必須: app_id、name、platform
コンバージョンイベント: app_install、app_launch
| フィールド | 型 | 説明 |
|---|
app_id | string | バイヤーが割り当てた一意の識別子 |
name | string | アプリの表示名 |
platform | enum | ios、android |
bundle_id | string | リバースドメイン識別子（例: com.acme.app） |
apple_id | string | 数値の Apple App Store ID（iOS のみ） |
description | string | アプリの説明（ストアリストを上書き） |
category | string | ストアカテゴリ（例: “games”、“finance”） |
genre | string | サブジャンル（例: “puzzle”、“strategy”） |
icon_url | uri | アプリアイコン（1024x1024 px） |
screenshots | uri[] | アプリストアのスクリーンショット |
preview_video_url | uri | ビデオ広告クリエイティブ用のゲームプレイまたはデモ動画 |
store_url | uri | アプリストアのリスティング URL |
deep_link_url | uri | リエンゲージメントキャンペーン用 |
price | object | { amount, currency } — 無料の場合は amount を 0 に設定 |
rating | number | 0–5 のストア評価 |
rating_count | integer | ストア評価の総数 |
content_rating | string | 年齢レーティング（例: “4+”、“Everyone”） |
tags | string[] | 例: ["casual", "offline"] |
assets、tags、ext）も使用できます。App アイテムは image_url と url の代わりに icon_url と store_url を使用します。
最小限 — 必須フィールドのみ:
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/app-item.json",
"app_id": "puzzlequest-ios",
"name": "Puzzle Quest: Match 3",
"platform": "ios"
}
{
"$schema": "https://adcontextprotocol.org/schemas/v3/core/app-item.json",
"app_id": "puzzlequest-ios",
"name": "Puzzle Quest: Match 3",
"platform": "ios",
"bundle_id": "com.acmegames.puzzlequest",
"apple_id": "1234567890",
"category": "games",
"genre": "puzzle",
"icon_url": "https://assets.acmegames.com/puzzlequest/icon-1024.png",
"store_url": "https://apps.apple.com/app/puzzle-quest-match-3/id1234567890",
"price": { "amount": 0, "currency": "USD" },
"rating": 4.7,
"rating_count": 82000,
"content_rating": "4+",
"tags": ["casual", "offline"]
}
