広告ログ・効果測定データ

広告キャンペーンクーポン効果測定

この記事の対象
キャンペーン・広告効果データを分析ツールやBIに取り込みたい開発者向けです。

レシートローラーは、キャンペーン・クーポン・広告配信ログ・購買への寄与（アトリビューション）を一元的に扱えます。マーケ施策の費用対効果（ROI）測定を、レシートデータと組み合わせて行えるのが特徴です。

主なリソース

リソース	内容
`campaign`	キャンペーン定義（期間・対象店舗・予算）
`coupon`	クーポン（コード・割引内容・利用条件）
`coupon_redemption`	クーポン使用記録
`ad_log`	広告のインプレッション・クリック
`attribution`	広告クリックから購買への紐付け

主なエンドポイント

GET  /v1/campaigns                       ← キャンペーン一覧
POST /v1/campaigns                       ← 新規作成
GET  /v1/coupons                         ← クーポン一覧
GET  /v1/coupon_redemptions              ← クーポン使用記録
GET  /v1/ad_logs?campaign_id=...         ← 広告ログ
GET  /v1/analytics/campaign/{id}         ← キャンペーン別集計

アトリビューション

広告クリックから一定期間内（デフォルト30日）に発生した購買は、自動的に該当キャンペーンに紐付けられます。attribution_window はキャンペーン単位で変更可能です。

GET /v1/analytics/campaign/cmp_xyz
→
{
  "campaign_id": "cmp_xyz",
  "impressions": 12500,
  "clicks": 850,
  "ctr": 0.068,
  "attributed_purchases": 47,
  "attributed_revenue": 158400,
  "roas": 2.64
}

Webhookイベント

campaign.started / campaign.ended
coupon.redeemed — クーポン使用
ad.click — 広告クリック（バッチ配信、5分粒度）

クーポン設計の例

金額割引：discount_type: "amount"、discount_value: 500
率割引：discount_type: "percent"、discount_value: 10
商品指定：applicable_products: ["prd_a01", ...]
最低購入金額：min_purchase: 3000
1人1回：per_user_limit: 1