การผสานรวมกับ Stripe

จำเป็นต้องได้รับความช่วยเหลือจากนักพัฒนา

คุณจะต้องได้รับความช่วยเหลือจากทีมนักพัฒนาของคุณเพื่อส่งผ่าน metadata (journey, user, device) เมื่อสร้าง Stripe Checkout Sessions โปรดแชร์คู่มือนี้กับพวกเขา

Stripe คือแพลตฟอร์มการชำระเงินที่ให้คุณรับการชำระเงินและจัดการการสมัครสมาชิกได้ การผสานรวม Stripe กับ Pushwoosh ช่วยให้คุณสามารถติดตามการชำระเงินและการสมัครสมาชิกในแคมเปญ วิเคราะห์รายได้ตาม Journey และผลิตภัณฑ์ แบ่งกลุ่มผู้ใช้ ตาม Event การชำระเงิน และใช้ ManyMoney AI เพื่อรับข้อมูลเชิงลึกเกี่ยวกับรายได้

ภาพรวมการผสานรวม

ประเภทการผสานรวม

แหล่งที่มา: Event การชำระเงินและการสมัครสมาชิกจะถูกส่งจาก Stripe ไปยัง Pushwoosh

ข้อกำหนดเบื้องต้น

ในการตั้งค่าการผสานรวม Stripe กับ Pushwoosh โปรดตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

• คุณมีบัญชี Pushwoosh ที่ใช้งานอยู่
• คุณมีบัญชี Stripe

อภิธานศัพท์ (การจับคู่ชื่อเอนทิตีหากแตกต่างกัน)

ตารางด้านล่างแสดงการจับคู่เอนทิตีของ Stripe กับ Pushwoosh การจับคู่นี้ทำได้โดยการส่งฟิลด์ที่เกี่ยวข้องเป็น metadata เมื่อคุณสร้าง Checkout Session (ดู การกำหนดค่า Metadata)

Stripe	Pushwoosh
Customer	user_id (จำเป็น), device_id (ไม่บังคับ) ใน metadata
Payment / Charge	Event StripePaymentSucceeded (charge.succeeded)
Invoice (paid)	Event StripeInvoicePaid (invoice.paid)
Subscription	StripeSubscriptionCreated + attributes ใน StripeInvoicePaid
Product / Price	product_id, product_name ใน metadata และ event attributes
Campaign (journey)	journey_uuids ใน metadata

เอนทิตีที่ซิงโครไนซ์

• Event การชำระเงิน (การชำระเงินครั้งเดียว, ใบแจ้งหนี้การสมัครสมาชิก)
• Event การสมัครสมาชิก (สร้างการสมัครสมาชิก, ชำระใบแจ้งหนี้การสมัครสมาชิก)

การผสานรวมทำงานอย่างไร

หลังจากที่คุณเชื่อมต่อบัญชี Stripe ของคุณกับ Pushwoosh ผ่าน Stripe Connect แล้ว Pushwoosh จะได้รับข้อมูลการชำระเงินและการสมัครสมาชิกจาก Stripe คุณสามารถเชื่อมโยงแต่ละธุรกรรมกับแคมเปญและผู้ใช้หรืออุปกรณ์ได้โดยการส่งผ่าน metadata เมื่อสร้าง Checkout Session (ดู การกำหนดค่า Metadata)

Pushwoosh จะสร้าง Event ที่คุณสามารถใช้สำหรับการแบ่งกลุ่มผู้ใช้ และการวิเคราะห์

ขั้นตอนการไหลของข้อมูล

1. คุณเชื่อมต่อบัญชี Stripe ของคุณกับ Pushwoosh หนึ่งครั้งผ่าน Stripe Connect ใน Settings → 3rd-party integrations
2. เมื่อสร้าง Checkout Session คุณจะส่งผ่าน metadata เพื่อให้สามารถระบุแหล่งที่มาของการชำระเงินได้ในภายหลัง (ดู การกำหนดค่า Metadata)
3. เมื่อมี Event การชำระเงินหรือการสมัครสมาชิกเกิดขึ้นใน Stripe (เช่น charge.succeeded สำหรับการชำระเงินครั้งเดียว, invoice.paid สำหรับการสมัครสมาชิก) Stripe จะส่งข้อมูลไปยัง Pushwoosh
4. Pushwoosh จะสร้าง Event ที่สอดคล้องกันและใช้ metadata สำหรับการระบุแหล่งที่มา ข้อมูลนี้จะปรากฏใน Finance Overview, Audience → Events และ ManyMoney

กรณีการใช้งาน

ติดตามการชำระเงิน

รับข้อมูลเกี่ยวกับการชำระเงินและการสมัครสมาชิกที่สำเร็จทั้งหมดโดยอัตโนมัติ

เชื่อมโยงการชำระเงินกับแคมเปญ

เชื่อมโยงธุรกรรมกับ customer journeys ที่เฉพาะเจาะจงโดยการส่งผ่าน metadata (ดู การกำหนดค่า Metadata)

วิเคราะห์รายได้

ดูรายได้ตามแคมเปญ ผลิตภัณฑ์ ผู้ใช้ และอุปกรณ์

แบ่งกลุ่มผู้ชมของคุณ

สร้างกลุ่มผู้ใช้ ตาม Event การชำระเงิน

การวิเคราะห์ด้วย AI

ผู้ช่วย ManyMoney AI จะได้รับสถิติการชำระเงินและการสมัครสมาชิกโดยอัตโนมัติ และสามารถตัดสินใจโดยใช้ข้อมูลนี้ได้

ตั้งค่าการผสานรวม

เชื่อมต่อ Stripe กับ Pushwoosh

1. เปิดแอปพลิเคชัน Pushwoosh ใดก็ได้ (บัญชี Stripe จะเชื่อมโยงกับบัญชีทั้งหมดของคุณ ไม่ใช่แอปพลิเคชันใดแอปพลิเคชันหนึ่ง) และไปที่ Settings → 3rd-party integrations
2. ค้นหาการ์ด Stripe และคลิกปุ่ม LOGIN PAGE

3. คุณจะถูกเปลี่ยนเส้นทางไปยังหน้าการให้สิทธิ์ของ Stripe

4. ในหน้า Stripe ให้ป้อนอีเมลของคุณแล้วคลิก Continue
5. เข้าสู่ระบบบัญชี Stripe ของคุณ (หรือสร้างบัญชีใหม่) หากคุณมีหลายบัญชี ให้เลือกบัญชีที่คุณต้องการเชื่อมต่อ
6. คลิก Connect เพื่อยืนยัน
7. หลังจากการให้สิทธิ์สำเร็จ คุณจะถูกเปลี่ยนเส้นทางกลับไปที่ Pushwoosh สถานะการผสานรวมจะเปลี่ยนเป็น Connected

ยกเลิกการเชื่อมต่อการผสานรวม

วิธีที่ 1. ผ่าน Pushwoosh

1. ไปที่ Settings → 3rd-party integrations
2. ค้นหาการ์ด Stripe และคลิกปุ่ม SETTINGS
3. ในหน้าต่างป๊อปอัป คลิกปุ่ม Disconnect

วิธีที่ 2. ผ่าน Stripe Dashboard

1. เข้าสู่ระบบ Stripe Dashboard
2. ไปที่ Settings → Team and security → Installed apps
3. ค้นหาแอปพลิเคชันในส่วน Connect Extensions

เมื่อคุณยกเลิกการเชื่อมต่อผ่าน Stripe, Pushwoosh จะได้รับการแจ้งเตือนโดยอัตโนมัติและลบการผสานรวมออก

การกำหนดค่า Metadata

Stripe จะส่ง Event การชำระเงินไปยัง Pushwoosh แต่หากไม่มีข้อมูลเพิ่มเติม Pushwoosh จะไม่สามารถบอกได้ว่าการชำระเงินนั้นมาจากแคมเปญใดหรือผู้ใช้คนใด เมื่อคุณส่งผ่าน metadata ณ เวลาที่สร้าง Checkout Session (ID แคมเปญ, ID ผู้ใช้หรืออุปกรณ์, ผลิตภัณฑ์) การชำระเงินแต่ละครั้งจะถูกระบุแหล่งที่มาไปยัง Journey และผู้ใช้ที่ถูกต้อง

จากนั้นคุณจะเห็นรายได้ตามแคมเปญใน Finance Overview, สร้างกลุ่มผู้ใช้ตามผู้ชำระเงิน และใช้ ManyMoney พร้อมการระบุแหล่งที่มาที่ถูกต้อง

ฟิลด์ metadata ที่ใช้ได้

ฟิลด์	คำอธิบาย	จำเป็น	ตัวอย่าง
journey_uuids	ID แคมเปญ (journey) คั่นด้วยเครื่องหมายอัฒภาค (semicolon)	ไม่	bfab4bc0-b0a5-414b-befc-4aaddc429b0e;a2bff710-6b49-44d1-96a7-3232feeca6e9
user_id	ตัวระบุผู้ใช้ จำเป็นสำหรับการรวบรวม Event และเพื่อให้ device_id ถูกนำไปใช้	ใช่	user_12345 หรือ email@example.com
device_id	Device Hardware ID (HWID)	ไม่	hwid_abc123
product_id	ID ผลิตภัณฑ์	ไม่	prod_premium
product_name	ชื่อผลิตภัณฑ์	ไม่	Premium Plan

สำคัญ

• หากไม่มี user_id Event จะไม่ถูกรวบรวมและ device_id จะถูกละเว้น สำหรับการวิเคราะห์ที่ครอบคลุม โปรดระบุ journey_uuids และ device_id ด้วย

• journey_uuids เป็นทางเลือกและสามารถตั้งค่าได้ผ่าน metadata เท่านั้น Stripe ไม่ได้ให้ข้อมูลแคมเปญหรือ Journey ดังนั้นโปรดส่งผ่านข้อมูลนี้เมื่อสร้าง Checkout Session หากคุณต้องการให้รายได้ถูกระบุแหล่งที่มาไปยัง Journey

• product_id และ product_name เป็นทางเลือก Pushwoosh จะใช้ metadata ก่อน หากไม่มีค่าใดค่าหนึ่งใน metadata จะนำมาจาก Stripe เมื่อมีข้อมูล หากไม่มีค่าจากทั้งสองแหล่ง ฟิลด์นั้นจะไม่ถูกจัดเก็บ

การส่งผ่าน metadata ผ่าน Checkout Session

Metadata จะถูกส่งผ่านเมื่อสร้าง Checkout Session ขึ้นอยู่กับประเภทการชำระเงิน:

ประเภทการชำระเงิน	พารามิเตอร์	Stripe event
การชำระเงินครั้งเดียว (mode=payment)	payment_intent_data[metadata]	charge.succeeded
การสมัครสมาชิก (mode=subscription)	subscription_data[metadata]	invoice.paid

ลำดับความสำคัญของ metadata ระหว่างการประมวลผล

สำหรับการสมัครสมาชิก (event invoice.paid):

Invoice metadata → if empty → Subscription metadata

สำหรับการชำระเงินครั้งเดียว (event charge.succeeded):

Charge metadata (from payment_intent_data)

การสร้าง checkout session ผ่าน Stripe API (curl)

การชำระเงินครั้งเดียว (mode=payment)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=payment" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_1234567890" \
  -d "line_items[0][quantity]=1" \
  -d "payment_intent_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "payment_intent_data[metadata][user_id]=user_12345" \
  -d "payment_intent_data[metadata][device_id]=hwid_abc123" \
  -d "payment_intent_data[metadata][product_id]=prod_premium" \
  -d "payment_intent_data[metadata][product_name]=Premium Plan"

การสมัครสมาชิก (mode=subscription)

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_live_YOUR_SECRET_KEY: \
  -d "mode=subscription" \
  -d "success_url=https://example.com/success" \
  -d "cancel_url=https://example.com/cancel" \
  -d "line_items[0][price]=price_monthly_premium" \
  -d "line_items[0][quantity]=1" \
  -d "subscription_data[metadata][journey_uuids]=bfab4bc0-b0a5-414b-befc-4aaddc429b0e" \
  -d "subscription_data[metadata][user_id]=user_12345" \
  -d "subscription_data[metadata][device_id]=hwid_abc123" \
  -d "subscription_data[metadata][product_name]=Monthly Premium"

ดูข้อมูล

หลังจากการผสานรวมสำเร็จ แดชบอร์ด Finance Overview ใหม่จะปรากฏในส่วน Dashboards ที่นั่นคุณสามารถดูสถิติ Gross Revenue และ New Subscriptions ที่แบ่งตามแคมเปญ (journey) ได้

สำหรับข้อมูลโดยละเอียดเพิ่มเติม โปรดไปที่ Stripe Dashboard ของคุณ

สร้างกลุ่มผู้ใช้ตามการชำระเงิน

ใช้ Stripe events เพื่อสร้างกลุ่มผู้ใช้:

1. เปิด Audience → Segments
2. คลิก Create Segment → Build Segment
3. ใน Add filter by คลิก Event
4. เลือก Stripe event จากรายการดรอปดาวน์ (ดูตารางด้านล่างสำหรับ event ที่ใช้ได้)

หมายเหตุ

Stripe events จะปรากฏในรายการหลังจากเชื่อมต่อการผสานรวมและได้รับข้อมูลการชำระเงินแล้ว

5. ตั้งค่าเงื่อนไข: จำนวนครั้งที่ event เกิดขึ้นและกรอบเวลา (เช่น ในช่วง 30 วันที่ผ่านมา, ระหว่างวันที่)
6. สามารถจำกัดกลุ่มผู้ใช้ให้แคบลงตาม event attributes ได้ ตารางด้านล่างแสดงรายการ attributes ที่ใช้ได้สำหรับแต่ละ event

Event	คำอธิบาย	Attributes
StripePaymentSucceeded	การชำระเงินสำเร็จ	__amount, __currency, invoice_id, journey_uuids, product_id, product_name, stripe_customer_id, subscription_id
StripeInvoicePaid	ชำระใบแจ้งหนี้การสมัครสมาชิกแล้ว	__amount, __currency, journey_uuids, product_id, product_name, stripe_customer_id, transaction_id, transaction_type
StripeSubscriptionCreated	สร้างการสมัครสมาชิกแล้ว	__amount, __currency, interval, journey_uuids, product_id, product_name, status, stripe_customer_id, subscription_id

7. หากต้องการเพิ่ม event เพิ่มเติม ให้เพิ่มตัวกรอง Event อีกตัวและเลือกตัวดำเนินการ (AND หรือ OR) ระหว่างเงื่อนไข

เรียนรู้เพิ่มเติมเกี่ยวกับการสร้างกลุ่มผู้ใช้

ผู้ช่วย ManyMoney AI

หลังจากการผสานรวม Stripe สำเร็จ ผู้ช่วย AI ManyMoney จะสามารถเข้าถึงสถิติการชำระเงินและการสมัครสมาชิกได้โดยอัตโนมัติ

ManyMoney มีให้บริการในอินเทอร์เฟซ Dashboard หลังจากที่คุณเชื่อมต่อ Stripe ข้อมูลการชำระเงินจะพร้อมสำหรับการวิเคราะห์โดยอัตโนมัติ ไม่จำเป็นต้องมีการกำหนดค่าเพิ่มเติม

สิ่งที่ ManyMoney สามารถทำได้

• วิเคราะห์รายได้: ตอบคำถามเกี่ยวกับรายได้, conversion และประสิทธิภาพของแคมเปญ
• เปรียบเทียบช่วงเวลา: แสดงพลวัตของการชำระเงินและการสมัครสมาชิกในช่วงเวลาต่างๆ
• ระบุแนวโน้ม: ตรวจจับผลิตภัณฑ์และกลุ่มผู้ชมที่กำลังเติบโตและลดลง
• ให้คำแนะนำ: แนะนำการปรับปรุงโดยอิงจากข้อมูลการชำระเงิน

ตัวอย่าง Prompt

• แคมเปญสร้างรายได้เท่าไหร่ในเดือนที่แล้ว
• เปรียบเทียบอัตรา conversion ของการสมัครสมาชิกระหว่างเดือนมกราคมและกุมภาพันธ์
• แสดงสถิติการคืนเงิน