広告代理店・開発者向け
広告サーバーAPI
配信枠・クリエイティブを一元管理し、サイネージやアプリへ自動配信します。インプレッション・クリック・コンバージョンの計測にも対応しています。
api/v1/advertiser/adserver
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/advertiser/adserver/fetch
|
配信枠の広告を取得
配信枠やユーザーコンテキストに適した広告を取得します。
|
200 |
| POST |
/api/v1/advertiser/adserver/impression
|
インプレッションを記録
広告が表示された際のインプレッションを記録します。
|
200 |
| POST |
/api/v1/advertiser/adserver/click
|
クリックを記録
ユーザーが広告をクリックした際のイベントを記録します。
|
200 |
| POST |
/api/v1/advertiser/adserver/conversion
|
コンバージョンを記録
広告クリック後のコンバージョンイベントを記録します。
|
200 |
| GET |
/api/v1/advertiser/adserver/metrics
|
広告メトリクスを取得
インプレッション・クリック・コンバージョンの集計データを返します。
|
200 |
エンドポイント詳細
配信枠やユーザーコンテキストに適した広告を取得します。
完全パス：
GET /api/v1/advertiser/adserver/fetch
レスポンスコード：
200
広告が表示された際のインプレッションを記録します。
完全パス：
POST /api/v1/advertiser/adserver/impression
レスポンスコード：
200
ユーザーが広告をクリックした際のイベントを記録します。
完全パス：
POST /api/v1/advertiser/adserver/click
レスポンスコード：
200
広告クリック後のコンバージョンイベントを記録します。
完全パス：
POST /api/v1/advertiser/adserver/conversion
レスポンスコード：
200
インプレッション・クリック・コンバージョンの集計データを返します。
完全パス：
GET /api/v1/advertiser/adserver/metrics
レスポンスコード：
200
リクエスト例
リクエスト
GET /api/v1/advertiser/adserver/fetch?spaceId=space-001&userId=user-123
Authorization: Bearer {access_token}
レスポンス
{
"adId": "ad-456",
"creativeUrl": "https://cdn.example.com/banner.jpg",
"clickUrl": "https://example.com/lp",
"trackingPixel": "https://api/impression?id=imp-789"
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。