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

ต้องการความช่วยเหลือจากนักพัฒนา

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

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

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

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

Source: 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)

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

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

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

สร้าง segment ตาม 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, สร้าง segment ตามผู้ชำระเงิน, และใช้ ManyMoney พร้อมการระบุแหล่งที่มาที่ถูกต้อง

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

ฟิลด์	คำอธิบาย	จำเป็น	ตัวอย่าง
journey_uuids	ID แคมเปญ (journey) คั่นด้วยเครื่องหมายอัฒภาค	ไม่	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 ของคุณ

สร้าง Segment ตามการชำระเงิน

ใช้ Stripe event เพื่อสร้าง segment ผู้ใช้:

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

หมายเหตุ

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

5. ตั้งเงื่อนไข: จำนวนครั้งที่ event เกิดขึ้นและกรอบเวลา (เช่น ในช่วง 30 วันที่ผ่านมา, ระหว่างวันที่)
6. เลือกที่จะจำกัด segment ให้แคบลงโดยใช้ 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) ระหว่างเงื่อนไข

เรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง segment

ผู้ช่วย AI ManyMoney

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

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

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

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

ตัวอย่าง Prompt

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