廣告日誌、成效測量資料

廣告活動優惠券成效測量

本文的對象
適用於想將活動、廣告成效資料匯入分析工具或 BI 的開發者。

ReceiptRoller 可一元化處理活動、優惠券、廣告播送日誌、對購買的歸因（歸因分析）。特徵是可將行銷施策的費用對效果（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