การติดตามการสมัครสมาชิก App Store

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

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

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

App Store Server Notifications คือบริการแบบ server-to-server ของ Apple ที่ส่งข้อความแบบเรียลไทม์ไปยังแบ็กเอนด์ของคุณเมื่อใดก็ตามที่สถานะการสมัครสมาชิกเปลี่ยนแปลง

ด้วยการเชื่อมต่อ App Store Server Notifications กับ Pushwoosh คุณสามารถตอบสนองต่อการยกเลิกได้โดยไม่ต้องสร้างโครงสร้างพื้นฐานแบ็กเอนด์ของคุณเอง เมื่อผู้ใช้ปิดการต่ออายุอัตโนมัติสำหรับการสมัครสมาชิกในบัญชี App Store ของพวกเขา Apple จะแจ้งเตือน Pushwoosh และ Pushwoosh จะส่ง event PW_SubscriptionCancel ไปยังโปรไฟล์ผู้ใช้ที่ตรงกัน

หมายเหตุ

ปัจจุบันการผสานรวมนี้รองรับ การสมัครสมาชิก iOS (App Store Server Notifications V2)

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

แหล่งที่มา: App Store Server Notifications จะถูกส่งจาก Apple ไปยัง Pushwoosh

Event ที่ซิงโครไนซ์

ชื่อ Event	คำอธิบาย	แอตทริบิวต์
PW_SubscriptionCancel	เกิดขึ้นเมื่อผู้ใช้ปิดการต่ออายุอัตโนมัติสำหรับการสมัครสมาชิก App Store	productID — ตัวระบุผลิตภัณฑ์ของ App Store ของการสมัครสมาชิกที่ถูกยกเลิก

วิธีการทำงาน

1. ผู้ใช้ปิดการใช้งานการต่ออายุอัตโนมัติสำหรับการสมัครสมาชิกใน App Store
2. Apple ส่ง App Store Server Notification (V2) ไปยัง URL การแจ้งเตือน Pushwoosh ของคุณ
3. Pushwoosh ถอดรหัส payload ที่ลงนามแล้วและอ่าน appAccountToken จากธุรกรรม
4. Pushwoosh ค้นหาอุปกรณ์ที่มี HWID ตรงกับโทเค็นนั้น ค้นหาผู้ใช้ที่ผูกอยู่กับอุปกรณ์ และโพสต์ event PW_SubscriptionCancel สำหรับผู้ใช้นั้น

สำคัญ

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

กรณีการใช้งาน: ดึงลูกค้าที่กำลังจะเลิกใช้บริการกลับคืนมา

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

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

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

ตั้งค่า appAccountToken เป็น HWID ของ Pushwoosh ของอุปกรณ์

Pushwoosh ระบุผู้ใช้ที่ถูกต้องจาก HWID ของอุปกรณ์ ดังนั้นแอปของคุณต้องแนบ HWID ของ Pushwoosh ของอุปกรณ์เป็น appAccountToken เมื่อมีการซื้อการสมัครสมาชิกผ่าน StoreKit

โดยค่าเริ่มต้น Pushwoosh iOS SDK จะใช้ identifierForVendor (IDFV) ของอุปกรณ์เป็น HWID ซึ่ง IDFV เป็น UUID อยู่แล้ว ซึ่งเป็นรูปแบบที่ Apple ต้องการสำหรับ appAccountToken จากนั้น Pushwoosh จะแก้ไขผู้ใช้ที่ผูกอยู่กับอุปกรณ์นั้นโดยอัตโนมัติ ดังนั้นวิธีนี้จึงใช้งานได้ไม่ว่าคุณจะกำหนด User ID ของคุณเองด้วย setUserId หรือไม่ก็ตาม

StoreKit 2

// Attach the device's Pushwoosh HWID (the default IDFV) as the appAccountToken
var options: Set<Product.PurchaseOption> = []
if let hwid = UIDevice.current.identifierForVendor {
    options.insert(.appAccountToken(hwid))
}

let result = try await product.purchase(options: options)

StoreKit 1

// applicationUsername must be a UUID string to populate appAccountToken
let payment = SKMutablePayment(product: product)
payment.applicationUsername = UIDevice.current.identifierForVendor?.uuidString
SKPaymentQueue.default().add(payment)

ข้อควรระวัง

หากแอปของคุณแทนที่ Pushwoosh HWID (ตัวอย่างเช่น ผ่านโมดูล HWID แบบถาวร PushwooshKeychain หรือค่าที่กำหนดเอง) ให้ตั้งค่า appAccountToken เป็น HWID เดียวกันนั้น โทเค็นต้องตรงกับ HWID ของอุปกรณ์ใน Pushwoosh มิฉะนั้นจะไม่สามารถระบุ event ได้

ค้นหา Application Code ของ Pushwoosh ของคุณ

เปิดแอปพลิเคชันของคุณใน Pushwoosh Control Panel Application Code ของคุณ (รูปแบบ XXXXX-XXXXX) จะแสดงอยู่ใต้ชื่อโปรเจกต์ในแถบด้านข้าง

คุณจะต้องใช้ Application Code เพื่อสร้าง URL การแจ้งเตือน

เพิ่ม URL การแจ้งเตือนใน App Store Connect

1. ใน App Store Connect ไปที่ Apps → แอปของคุณ → App Information (ใต้ General) และเลื่อนไปที่ App Store Server Notifications
2. เลือกการแจ้งเตือน Version 2
3. ตั้งค่าทั้ง Production Server URL และ Sandbox Server URL เป็น:

https://appstore-notifications.pushwoosh.com/appstore/YOUR_APPLICATION_CODE/

4. แทนที่ YOUR_APPLICATION_CODE ด้วย Application Code จากขั้นตอนก่อนหน้า คงเครื่องหมายทับ (slash) ต่อท้ายไว้

หมายเหตุ

หากบัญชีของคุณโฮสต์อยู่ใน ศูนย์ข้อมูลของสหรัฐอเมริกา (US data center) ให้ใช้ https://appstore-notifications.pushwoosh.us/appstore/YOUR_APPLICATION_CODE/ แทน หากคุณไม่แน่ใจว่าบัญชีของคุณใช้ศูนย์ข้อมูลใด โปรดติดต่อผู้จัดการความสำเร็จของลูกค้า (Customer Success Manager) หรือ ฝ่ายสนับสนุนของ Pushwoosh

ยืนยัน event ใน Pushwoosh

เมื่อ Pushwoosh ประมวลผลการแจ้งเตือนแรกของ App Store ระบบจะลงทะเบียน PW_SubscriptionCancel ในโปรเจกต์ของคุณพร้อมกับแอตทริบิวต์สตริง productID หลังจากการทดสอบใน sandbox ให้เปิด Audience → Events เพื่อตรวจสอบว่า event ปรากฏขึ้นหรือไม่ จากนั้นจะพร้อมสำหรับการแบ่งกลุ่ม (segmentation) สถิติ และ Customer Journeys

สร้างแคมเปญดึงลูกค้ากลับคืน

สร้าง Customer Journey ด้วย entry ตามทริกเกอร์ บน event PW_SubscriptionCancel และเพิ่มข้อความที่คุณต้องการส่งไปยังผู้ใช้ที่กำลังจะเลิกใช้บริการ

การทดสอบ

App Store Server Notifications สามารถทริกเกอร์ได้ในสภาพแวดล้อม Sandbox ของ Apple ในการตรวจสอบการผสานรวม:

1. ทำการซื้อการสมัครสมาชิกใน sandbox โดยตั้งค่า appAccountToken ตามที่อธิบายไว้ข้างต้น
2. ปิดการใช้งานการต่ออายุอัตโนมัติจากหน้าจอการจัดการการสมัครสมาชิกของอุปกรณ์
3. ใน Pushwoosh Control Panel เปิดโปรไฟล์ผู้ใช้และไปที่ ประวัติ Events
4. ยืนยันว่า PW_SubscriptionCancel ปรากฏขึ้นภายในไม่กี่นาที