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

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

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

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

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

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

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

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

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

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

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

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

Stripe	Pushwoosh
ลูกค้า	user_id (จำเป็น), device_id (ไม่บังคับ) ในข้อมูลเมตา
การชำระเงิน / การเรียกเก็บเงิน	เหตุการณ์ StripePaymentSucceeded (charge.succeeded)
ใบแจ้งหนี้ (ชำระแล้ว)	เหตุการณ์ StripeInvoicePaid (invoice.paid)
การสมัครสมาชิก	StripeSubscriptionCreated + แอตทริบิวต์ใน StripeInvoicePaid
ผลิตภัณฑ์ / ราคา	product_id, product_name ในข้อมูลเมตาและแอตทริบิวต์ของเหตุการณ์
แคมเปญ (journey)	journey_uuids ในข้อมูลเมตา

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

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

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

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

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

โฟลว์ข้อมูล

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

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

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

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

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

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

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

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

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

สร้างเซกเมนต์ ตามเหตุการณ์การชำระเงิน

การวิเคราะห์ด้วย 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 ส่งเหตุการณ์การชำระเงินไปยัง Pushwoosh แต่หากไม่มีข้อมูลเพิ่มเติม Pushwoosh จะไม่สามารถบอกได้ว่าการชำระเงินนั้นเป็นของแคมเปญใดหรือผู้ใช้คนใด เมื่อคุณส่งผ่านข้อมูลเมตา ณ เวลาที่สร้าง Checkout Session (รหัสแคมเปญ, รหัสผู้ใช้หรืออุปกรณ์, ผลิตภัณฑ์) การชำระเงินแต่ละครั้งจะถูกระบุแหล่งที่มาไปยัง Journey และผู้ใช้ที่ถูกต้อง

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

ฟิลด์ Metadata ที่มีอยู่

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

สำคัญ

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

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

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

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

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

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

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

สำหรับการสมัครสมาชิก (เหตุการณ์ invoice.paid):

Invoice metadata → if empty → Subscription metadata

สำหรับการชำระเงินครั้งเดียว (เหตุการณ์ 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 ที่นั่นคุณสามารถดูสถิติรายได้รวมและการสมัครสมาชิกใหม่ที่แบ่งตามแคมเปญ (journey)

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

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

ใช้เหตุการณ์ Stripe เพื่อสร้างเซกเมนต์ผู้ใช้:

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

หมายเหตุ

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

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

เหตุการณ์	คำอธิบาย	แอตทริบิวต์
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. หากต้องการเพิ่มเหตุการณ์เพิ่มเติม ให้เพิ่มตัวกรองเหตุการณ์อีกตัวหนึ่งและเลือกตัวดำเนินการ (AND หรือ OR) ระหว่างเงื่อนไข

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

เคล็ดลับ

คุณยังสามารถจับคู่ StripePaymentSucceeded (__amount, __currency, product_id) หรือ StripeInvoicePaid (__amount, __currency, transaction_id, product_id) เป็นแหล่งที่มาสำหรับ เหตุการณ์ Conversion เพื่อนำรายได้จาก Stripe เข้าสู่การแบ่งกลุ่ม RFM, การระบุแหล่งที่มาของ Journey และ ManyMoney AI ควบคู่ไปกับแหล่งรายได้อื่นๆ ของคุณ

ผู้ช่วย ManyMoney AI

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

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

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

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

ตัวอย่าง Prompt

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