ข้อมูลบันทึกโฆษณาและการวัดประสิทธิภาพ

ReceiptRoller จัดการแคมเปญ・คูปอง・บันทึกการแสดงโฆษณา・การมีส่วนช่วยต่อการซื้อ (Attribution) ไว้ในที่เดียว จุดเด่นคือสามารถวัดความคุ้มค่าของการลงทุนด้านการตลาด (ROI) โดยผสานกับข้อมูลใบเสร็จได้

รีซอร์สหลัก

สโคปที่เกี่ยวข้อง

• campaign.read / campaign.write
• coupon.read / coupon.write
• ad_log.read — อ่านบันทึกโฆษณา
• analytics.read — อ่านรายงานที่สรุปแล้ว

เอนด์พอยต์หลัก

GET  /v1/campaigns                       ← รายการแคมเปญ
POST /v1/campaigns                       ← สร้างใหม่
GET  /v1/coupons                         ← รายการคูปอง
GET  /v1/coupon_redemptions              ← บันทึกการใช้คูปอง
GET  /v1/ad_logs?campaign_id=...         ← บันทึกโฆษณา
GET  /v1/analytics/campaign/{id}         ← สรุปแยกตามแคมเปญ

Attribution (การเชื่อมโยงยอดซื้อ)

การซื้อที่เกิดขึ้นภายในช่วงเวลาที่กำหนดหลังการคลิกโฆษณา (ค่าเริ่มต้น 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

คู่มือที่เกี่ยวข้อง

• การเชื่อมต่อข้อมูลการซื้อและใบเสร็จ
• รายการสโคปของ OAuth
• วันที่เผยแพร่: 2569-04-27 วันที่อัปเดต: 2569-07-06