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

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

คุณจะต้องได้รับความช่วยเหลือจากทีมพัฒนาของคุณเพื่อตั้งค่าการผสานรวมนี้ โปรดแชร์คู่มือนี้กับพวกเขา

RevenueCat เป็นแพลตฟอร์มการจัดการการสมัครสมาชิกที่ช่วยให้การซื้อในแอปและการสมัครสมาชิกสำหรับธุรกิจบนแพลตฟอร์ม iOS, Android และเว็บเป็นเรื่องง่าย โดยมีเครื่องมือที่ครอบคลุมสำหรับการสร้าง วิเคราะห์ และปรับปรุงการสมัครสมาชิกในแอป

ด้วยการผสานรวม Pushwoosh กับ RevenueCat ธุรกิจสามารถส่งการแจ้งเตือนแบบพุชที่ตรงเป้าหมาย ข้อความแจ้งเตือนในแอป และข้อความอื่นๆ ไปยังผู้ใช้ตามอีเวนต์การสมัครสมาชิกที่ส่งจาก RevenueCat ไปยัง Pushwoosh ซึ่งสามารถกระตุ้นให้ผู้ใช้ต่ออายุการสมัครสมาชิก อัปเกรดเป็นระดับที่สูงขึ้น หรือใช้ประโยชน์จากข้อเสนอพิเศษ ซึ่งจะช่วยเพิ่มการมีส่วนร่วม เพิ่มรายได้สูงสุด และทำให้การจัดการการสมัครสมาชิกง่ายขึ้น

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

การสื่อสารส่วนบุคคล

ธุรกิจสามารถใช้การผสานรวมนี้เพื่อปรับแต่งการสื่อสารกับลูกค้าให้เป็นแบบส่วนตัว ตัวอย่างเช่น แพลตฟอร์ม e-learning สามารถเพิ่มการมีส่วนร่วมของผู้ใช้โดยการส่งการแจ้งเตือนแบบพุชส่วนบุคคลเมื่อตรวจพบการเปลี่ยนแปลงแผนการสมัครสมาชิก การแจ้งเตือนเหล่านี้จะให้คำแนะนำในการเปลี่ยนแปลง แนะนำหลักสูตรที่เกี่ยวข้องตามแผนใหม่ และมอบสิทธิประโยชน์พิเศษที่สอดคล้องกับการอัปเดต

การแจ้งเตือนปปัญหาการเรียกเก็บเงิน

เมื่อการสมัครสมาชิกของผู้ใช้ประสบปัญหาการเรียกเก็บเงิน ธุรกิจสามารถใช้การผสานรวม RevenueCat กับ Pushwoosh เพื่อส่งการแจ้งเตือนที่ตรงเป้าหมายได้อย่างรวดเร็ว ตัวอย่างเช่น บริการสตรีมมิ่งสามารถแจ้งให้ผู้ใช้ทราบเกี่ยวกับปัญหาการเรียกเก็บเงินและให้คำแนะนำในการแก้ไข เช่น การอัปเดตข้อมูลการชำระเงิน

การแจ้งเตือนการซื้อที่ไม่ต่ออายุ

ธุรกิจสามารถใช้ประโยชน์จากการผสานรวม RevenueCat กับ Pushwoosh เพื่อเปลี่ยนการซื้อครั้งเดียวให้เป็นความสัมพันธ์กับลูกค้าที่ยั่งยืน ตัวอย่างเช่น บริการจัดส่งอาหารสามารถส่งการแจ้งเตือนแบบพุชหลังการซื้อเพื่อขอบคุณลูกค้าและแนะนำผลิตภัณฑ์ที่เกี่ยวข้องหรือโปรโมตแผนการสมัครสมาชิกเพื่อความสะดวกอย่างต่อเนื่อง ซึ่งจะช่วยสร้างความภักดีของลูกค้า เพิ่มโอกาสในการขายเพิ่ม และอาจเปลี่ยนผู้ซื้อครั้งเดียวให้เป็นผู้สมัครสมาชิก

โปรโมชันการอัปเกรดระดับ

แอปที่มีระดับการสมัครสมาชิกหลายระดับสามารถใช้การผสานรวมนี้เพื่อติดตามการสมัครสมาชิกของผู้ใช้และส่งข้อความแจ้งเตือนการอัปเกรดที่ปรับให้เหมาะสม ตัวอย่างเช่น แอปเกมสามารถใช้การแจ้งเตือนแบบพุชเพื่อเน้นย้ำถึงประโยชน์ของระดับพรีเมียม เช่น เนื้อหาพิเศษหรือส่วนลด เพื่อกระตุ้นให้ผู้ใช้อัปเกรดการสมัครสมาชิกของตน

อีเวนต์

ทุก webhook ที่ RevenueCat ส่งมาจะกลายเป็นอีเวนต์ของ Pushwoosh ที่มีชื่อเป็น RC_ ตามด้วยประเภทอีเวนต์ของ RevenueCat เช่น RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE หรือ RC_EXPIRATION Pushwoosh จะสร้างอีเวนต์เมื่อ webhook ประเภทนั้นมาถึงเป็นครั้งแรก ดังนั้นประเภทอีเวนต์ใหม่ของ RevenueCat จะปรากฏในแอปของคุณเองโดยอัตโนมัติ ดูรายการทั้งหมดได้ที่ ประเภทอีเวนต์ ในเอกสารของ RevenueCat

แต่ละอีเวนต์จะมีฟิลด์ของ webhook จาก RevenueCat เป็นคุณลักษณะของอีเวนต์ เช่น price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code และ entitlement_ids:

• ฟิลด์ที่เก็บเวลาเป็นมิลลิวินาทีจะกลายเป็นวันที่โดยไม่มีคำต่อท้าย _ms เช่น purchased_at และ expiration_at วันที่ส่ง webhook คือคุณลักษณะ timestamp
• วันที่เหล่านี้เป็นเวลา UTC และอยู่ในรูปแบบ YYYY-MM-DD โดยไม่มีเวลาของวัน
• คุณลักษณะของลูกค้า ที่คุณตั้งค่าใน RevenueCat จะกลายเป็นคุณลักษณะของอีเวนต์ด้วย คุณลักษณะที่ระบุตัวบุคคลหรืออุปกรณ์ เช่น อีเมล หมายเลขโทรศัพท์ ชื่อที่แสดง ที่อยู่ IP รหัสโฆษณา และ push token จะไม่ถูกส่งไปยัง Pushwoosh
• อีเวนต์หนึ่งรายการเก็บคุณลักษณะได้สูงสุด 100 รายการ

การซื้อจาก App Store, Google Play, Mac App Store และ Amazon จะถูกบันทึกบนแพลตฟอร์ม iOS, Android, macOS และ Amazon ส่วนการซื้อจากสโตร์อื่น เช่น Stripe, RevenueCat Billing หรือสิทธิ์ส่งเสริมการขาย (promotional grants) จะถูกบันทึกโดยไม่มีแพลตฟอร์ม

คุณสามารถใช้อีเวนต์เหล่านี้ใน Customer Journeys ของคุณได้ อีเวนต์ที่มีคุณลักษณะ price สามารถใช้กับ การแบ่งกลุ่มแบบ RFM ได้

เคล็ดลับ

คุณยังสามารถติดตามรายได้ของอีเวนต์ เช่น RC_INITIAL_PURCHASE, RC_RENEWAL หรือ RC_NON_RENEWING_PURCHASE (โดยใช้คุณลักษณะ price และ currency ของอีเวนต์เหล่านั้น) เป็น อีเวนต์ Conversion ได้ หลีกเลี่ยงการติดตามรายได้ของ RC_CANCELLATION หรือ RC_EXPIRATION อีเวนต์ Conversion ไม่รองรับการคืนเงินหรือการยกเลิกรายการ ดังนั้นอีเวนต์เหล่านั้นจะยังคงถูกนับเป็นรายได้

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

การผสานรวมทำงานผ่าน webhook ของ RevenueCat ซึ่งใช้ได้ในแพ็กเกจ Pro ของ RevenueCat

จับคู่ลูกค้า RevenueCat กับผู้ใช้ Pushwoosh

Pushwoosh จะบันทึก webhook ให้กับผู้ใช้ Pushwoosh ที่ webhook ระบุ และจะข้าม webhook ที่ไม่ได้ระบุผู้ใช้เลย เลือกวิธีที่ RevenueCat จะระบุผู้ใช้:

• หากแอปของคุณระบุตัวผู้ใช้ด้วย ID ของตัวเองและส่ง ID นั้นไปยัง RevenueCat เป็น App User ID ให้ใช้ App User ID เป็น Pushwoosh User ID
• หาก App User ID ต่างจาก Pushwoosh User ID เช่น เมื่อ RevenueCat ใช้ ID แบบไม่ระบุตัวตนอย่าง $RCAnonymousID:… ให้ส่ง ID ของ Pushwoosh เป็นคุณลักษณะของ RevenueCat หากไม่มี ID เหล่านี้ อีเวนต์จะไปยัง User ID ที่ไม่มีอยู่ใน Pushwoosh

ใช้ RevenueCat App User ID เป็น Pushwoosh User ID

ตั้งค่า App User ID ที่คุณส่งไปยัง RevenueCat เป็น Pushwoosh User ID (setUserId)

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

ส่ง ID ของ Pushwoosh เป็นคุณลักษณะของ RevenueCat

ตั้งค่าคุณลักษณะ pushwooshUserId และ pushwooshHwid ใน RevenueCat Pushwoosh จะใช้คุณลักษณะเหล่านี้แทน App User ID:

• pushwooshUserId: Pushwoosh User ID ของลูกค้า
• pushwooshHwid: Hardware ID (HWID) ของ Pushwoosh สำหรับอุปกรณ์ของลูกค้า ไม่บังคับ หากไม่มี Pushwoosh จะใช้ User ID เป็น HWID

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

ส่ง webhook ของ RevenueCat ไปยัง Pushwoosh

ในแดชบอร์ด RevenueCat ของคุณ:

1. เปิดโปรเจกต์ของคุณ ค้นหาการ์ด Integrations ในเมนูด้านซ้าย แล้วคลิก + New

2. เลือก Webhooks

3. หาก RevenueCat แสดงรายการ webhook ของคุณ ให้คลิก Add new configuration
4. ตั้งชื่อการผสานรวมให้ตรงไปตรงมา เช่น Pushwoosh เพื่อให้ง่ายต่อการระบุ
5. ป้อน URL ต่อไปนี้เป็น URL ของ webhook:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

ใน URL ให้แทนที่ APP_CODE ด้วยรหัสแอปพลิเคชัน Pushwoosh ที่มีอยู่ของคุณ ซึ่งอยู่ใต้ชื่อแอปพลิเคชันของคุณในบัญชี Pushwoosh

6. ในช่อง Authorization header value ให้ใส่ Pushwoosh API token ของคุณ คุณสามารถค้นหาโทเค็นนี้ได้ที่ Settings > API Access ใน Pushwoosh

7. ตัดสินใจว่าคุณต้องการส่งอีเวนต์สำหรับการซื้อใน production (ใช้งานจริง), sandbox (ทดสอบ) หรือทั้งสองอย่าง
8. ในเมนูแบบเลื่อนลง App ให้ระบุว่าควรส่งอีเวนต์ webhook สำหรับแอปเดียวหรือทุกแอปภายในโปรเจกต์
9. ในเมนูแบบเลื่อนลง Event Type ให้เลือกว่าจะส่งอีเวนต์ทั้งหมดหรือระบุว่าจะส่งอีเวนต์ใดไปยัง Pushwoosh

10. เลือกว่าจะแสดงอีเวนต์ทั้งหมด, เฉพาะอีเวนต์ที่สำเร็จ หรือเฉพาะอีเวนต์ที่ล้มเหลว

หากต้องการตรวจสอบการเชื่อมต่อ ให้ส่ง webhook ทดสอบจาก RevenueCat การส่งที่สำเร็จหมายความว่า Pushwoosh ยอมรับ URL และ API token แล้ว ตัว webhook ทดสอบเองจะไม่ถูกบันทึกเป็นอีเวนต์: อีเวนต์ RC_ แต่ละรายการจะปรากฏภายใต้ กลุ่มเป้าหมาย → อีเวนต์ ในแอป Pushwoosh ของคุณเมื่อ webhook จริงรายการแรกของประเภทนั้นมาถึง