カタログアイテムスキーマ
各バーティカルカタログタイプは、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 がない。
最小限 — 必須フィールドのみ:
ホテルカタログ
旅行広告とダイナミックリマーケティング用のホテル・宿泊施設物件。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)も使用できます。
最小限 — 必須フィールドのみ:
車両カタログ
自動車在庫広告用の車両リスト。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)も使用できます。
最小限 — 必須フィールドのみ:
フライトカタログ
旅行広告とダイナミックリマーケティング用のフライトルート。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)も使用できます。
最小限 — 必須フィールドのみ:
不動産カタログ
不動産広告用の物件リスト。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)も使用できます。
最小限 — 必須フィールドのみ:
教育カタログ
学生募集用の教育プログラムとコース。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)も使用できます。
最小限 — 必須フィールドのみ:
目的地カタログ
目的地広告と旅行リマーケティング用の旅行目的地。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)も使用できます。
最小限 — 必須フィールドのみ:
アプリカタログ
アプリインストールとリエンゲージメントキャンペーン用のモバイルアプリケーション。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 を使用します。
最小限 — 必須フィールドのみ: