マーケティング分析担当向け

広告レポートAPI

リテールメディア広告の配信実績を取得します。表示回数・クリック・広告費・クーポン配布と利用・配信店舗数を、日別・広告面の種類別・店舗別・キャンペーン別に返し、キャンペーンごとの売上リフト（配信がなかった場合の見込みとの差の推計）も含みます。店舗数や利用件数が少ない区分の購入額は、個人の特定を防ぐため返しません。organizationId に広告主アカウントのIDを指定します。代理店のトークンは、連携中のクライアントのIDを指定するとそのクライアントとして操作できます（代理店が審査に提出したキャンペーンは、クライアントの確認待ちになります）。必要なスコープは advertiser.reports.read です。

api/v1/advertiser APIリファレンスで確認

エンドポイント一覧

メソッド パス 説明 レスポンス
GET /api/v1/advertiser/reports 配信レポートを取得
from・to（日本時間の日付、両端を含む、最大366日。省略時は直近30日）。campaignId で1つのキャンペーンに絞れます。
 200 400 403 404

エンドポイント詳細

from・to（日本時間の日付、両端を含む、最大366日。省略時は直近30日）。campaignId で1つのキャンペーンに絞れます。

完全パス： GET /api/v1/advertiser/reports
レスポンスコード： 200 400 403 404

リクエスト例

リクエスト 
GET /api/v1/advertiser/reports?organizationId={organizationId}&from=2026-09-01&to=2026-09-30
Authorization: Bearer {access_token}
レスポンス 
{
  "from": "2026-09-01",
  "to": "2026-09-30",
  "totals": {
    "impressions": 125000,
    "clicks": 3400,
    "ctrPercent": 2.72,
    "spend": 62500,
    "redemptions": 280,
    "couponSalesYen": 412000,
    "stores": 18
  },
  "campaigns": [
    {
      "campaignId": "5f0c…",
      "name": "秋の新商品",
      "spend": 62500,
      "lift": { "extraYen": 186000, "deliveringStores": 18, "controlStores": 40 }
    }
  ]
}
認証について

このAPIを利用するには、Authorization: Bearer {access_token} ヘッダーが必要です。トークンの取得方法は認証ガイドをご確認ください。

認証・アクセスAPIを見る
APIリファレンスへ