マーケティング分析担当向け
広告効果分析API
広告メトリクスの取得は広告サーバーAPIの metrics エンドポイントで提供されます。インプレッション・クリック・コンバージョンをリアルタイムで集計し、ROAS・CPAの算出に活用できます。
api/v1/advertiser/adserver
APIリファレンスで確認
エンドポイント一覧
| メソッド | パス | 説明 | レスポンス |
|---|---|---|---|
| GET |
/api/v1/advertiser/adserver/metrics
|
広告メトリクスサマリーを取得
インプレッション・クリック・コンバージョンの集計データを返します。期間やキャンペーンでフィルタリング可能です。
|
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
広告表示イベントを記録します。
完全パス：
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?campaignId=camp-001&from=2025-03-01&to=2025-03-31
Authorization: Bearer {access_token}
レスポンス
{
"impressions": 125000,
"clicks": 3400,
"conversions": 280,
"ctr": 0.0272,
"cvr": 0.0824,
"spend": 250000,
"roas": 3.2
}
認証について
このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。
トークンの取得方法は認証ガイドをご確認ください。