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

広告レポート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} โปรดดูวิธีขอ token ได้ที่คู่มือการยืนยันตัวตน

ดู API การยืนยันตัวตนและการเข้าถึง
ไปที่เอกสารอ้างอิง API