เกี่ยวกับการสมัครใช้บริการ

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

หากยังไม่ได้กำหนดค่าผลิตภัณฑ์ที่ต้องสมัครใช้บริการสำหรับแอป โปรดดูหัวข้อสร้างและกำหนดค่าผลิตภัณฑ์

ภาพรวมการสมัครใช้บริการ

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

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

ดูภาพรวมโดยละเอียดของผลิตภัณฑ์ที่ต้องสมัครใช้บริการ แพ็กเกจเริ่มต้น และข้อเสนอได้ที่เอกสารประกอบในศูนย์ช่วยเหลือของ Play Console

Play Billing Library รองรับการสมัครใช้บริการประเภทต่อไปนี้

  • การสมัครใช้บริการ - ในประเภทนี้ 1 รายการจะสอดคล้องกับ 1 สิทธิ์ เช่น การสมัครใช้บริการสตรีมมิงเพลง

  • การสมัครใช้บริการพร้อมส่วนเสริม - ในประเภทนี้ การซื้อ 1 ครั้งสามารถมีสิทธิ์ที่แตกต่างกันหลายรายการรวมอยู่ในการซื้อครั้งเดียว เช่น การสมัครใช้บริการสตรีมมิงเพลงและการสมัครใช้บริการวิดีโอ ดูข้อมูลเฉพาะสำหรับการสมัครใช้บริการที่มีส่วนเสริมได้ที่การสมัครใช้บริการที่มีส่วนเสริม

การผสานรวมแพ็กเกจแบบชำระเงินล่วงหน้า

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

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

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

หลังจากเติมเงินแล้ว ระบบจะอัปเดตช่องต่อไปนี้ในออบเจ็กต์ผลลัพธ์ Purchase เพื่อแสดงการซื้อการเติมเงินล่าสุด

  • รหัสคำสั่งซื้อ
  • เวลาที่ซื้อ
  • ลายเซ็น
  • โทเค็นการซื้อ
  • รับทราบแล้ว

ฟิลด์ Purchase ต่อไปนี้จะมีข้อมูลเดียวกันกับที่พบในการซื้อครั้งแรกเสมอ

  • ชื่อแพ็กเกจ
  • สถานะการซื้อ
  • ผลิตภัณฑ์
  • การต่ออายุใหม่อัตโนมัติ

การรับทราบการซื้อแบบชำระล่วงหน้า

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

เนื่องจากแพ็กเกจแบบชำระเงินล่วงหน้าอาจมีระยะเวลาสั้น คุณจึงควรรับทราบการซื้อโดยเร็วที่สุด

แพ็กเกจแบบชำระเงินล่วงหน้าที่มีระยะเวลา 1 สัปดาห์ขึ้นไปต้องได้รับการรับทราบภายใน 3 วัน

แพ็กเกจแบบชำระเงินล่วงหน้าที่มีระยะเวลาสั้นกว่า 1 สัปดาห์ต้องได้รับการรับทราบภายในครึ่งหนึ่งของระยะเวลาของแพ็กเกจ ตัวอย่างเช่น นักพัฒนาแอปมีเวลา 1.5 วันในการรับทราบแพ็กเกจแบบชำระเงินล่วงหน้า 3 วัน

การผสานรวมการสมัครใช้บริการแบบผ่อนชำระ

การสมัครใช้บริการแบบผ่อนชำระคือการสมัครใช้บริการประเภทหนึ่งที่ผู้ใช้ชำระค่าสมัครใช้บริการเป็นงวดๆ ในช่วงระยะเวลาหนึ่ง แทนที่จะชำระค่าบริการทั้งหมดล่วงหน้า

ข้อควรพิจารณาเพิ่มเติมสำหรับการสมัครใช้บริการแบบผ่อนชำระมีดังนี้

  • ประเทศที่พร้อมให้บริการ: ฟีเจอร์การสมัครใช้บริการแบบผ่อนชำระพร้อมให้บริการในบราซิล ฝรั่งเศส อิตาลี และสเปนเท่านั้น (ตรวจสอบความพร้อมให้บริการล่าสุดได้ใน Console)
  • การกำหนดราคา: เมื่อกำหนดราคาสำหรับการสมัครใช้บริการแบบผ่อนชำระใน Console ราคาจะแสดงจำนวนเงินที่ต้องชำระรายเดือน ซึ่งเมื่อรวมกับระยะเวลาผูกมัดที่ตั้งไว้จะสร้างจำนวนเงินทั้งหมดสำหรับการสมัครใช้บริการในหน้าจอการซื้อ
  • ระยะเวลาผูกมัด: ระยะเวลาทั้งหมดของข้อผูกมัดการสมัครใช้บริการครั้งแรก ซึ่งต้องชำระเงินเป็นรายเดือน เช่น หากแพ็กเกจเริ่มต้นมีระยะเวลาผูกมัด 15 เดือน ผู้ใช้จะต้องชำระเงินรายเดือน 15 ครั้งตลอดระยะเวลานี้
  • การต่ออายุ: ในบริบทของการสมัครใช้บริการแบบผ่อนชำระ "การต่ออายุ" หมายถึงการสิ้นสุดระยะเวลาผูกมัด ไม่ว่าจะเป็นระยะเวลาผูกมัดเริ่มต้นหรือระยะเวลาผูกมัดที่ตามมา หลังจากลงชื่อสมัครใช้ครั้งแรก การต่ออายุครั้งแรกจะเกิดขึ้นเมื่อสิ้นสุดระยะเวลาผูกมัดเริ่มต้นทั้งหมด การต่ออายุครั้งต่อๆ ไปจะเกิดขึ้นหลังจากระยะเวลาผูกมัดครั้งต่อๆ ไปสิ้นสุดลง ประเภทการต่ออายุสำหรับการสมัครใช้บริการแบบผ่อนชำระอาจเป็น "ต่ออายุใหม่อัตโนมัติแบบรายเดือน" หรือ "ต่ออายุใหม่อัตโนมัติในระยะเวลาเดิม" สำหรับ "ต่ออายุใหม่อัตโนมัติรายเดือน" จะไม่มีสัญญาผูกมัดในภายหลัง และแพ็กเกจจะทำงานเหมือนกับการสมัครใช้บริการรายเดือน โดยการเรียกเก็บเงินค่าสมัครใช้บริการรายเดือนแต่ละครั้งจะถือเป็นการต่ออายุใหม่
  • ช่วงเวลาที่เรียกเก็บเงิน: ในบริบทของการสมัครใช้บริการแบบผ่อนชำระ หมายถึงช่วงเวลาที่เรียกเก็บเงินตามรอบซึ่งมีการชำระเงินแต่ละครั้งตามที่ระบุไว้ในแพ็กเกจเริ่มต้น
  • ลักษณะการทำงานของการเปลี่ยนแปลงแพ็กเกจเทียบกับการเปลี่ยนแปลงราคา: สำหรับการเปลี่ยนแปลงราคาและการยกเลิก สัญญาผูกมัดจะยังคงมีผลอยู่ ซึ่งหมายความว่าหากผู้ใช้ต้องการยกเลิกหรือนักพัฒนาแอปต้องการเปลี่ยนราคา การเปลี่ยนแปลงจะมีผลเมื่อสิ้นสุดระยะเวลาผูกมัด สำหรับการเปลี่ยนแปลงแพ็กเกจ สัญญาผูกมัดจะไม่มีผลผูกมัด ซึ่งหมายความว่าการเปลี่ยนแปลงแพ็กเกจไม่จำเป็นต้องรอจนกว่าจะสิ้นสุดระยะเวลาผูกมัด แต่จะมีผลทันทีหรือในวันที่ชำระเงินครั้งถัดไปตามโหมดการแทนที่ที่ตั้งไว้
  • การเปลี่ยนแปลงแพ็กเกจการสมัครใช้บริการเดียวกัน: ไม่อนุญาตให้เปลี่ยนแพ็กเกจจากแพ็กเกจเริ่มต้นแบบผ่อนชำระเป็นแพ็กเกจเริ่มต้นแบบไม่ผ่อนชำระของผลิตภัณฑ์ที่ต้องสมัครใช้บริการเดียวกัน
  • การแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN): ระบบจะส่ง SUBSCRIPTION_CANCELLATION_SCHEDULED RTDN ทันทีเมื่อผู้ใช้เริ่มการยกเลิกในขณะที่ยังมีการชำระเงินสำหรับระยะเวลาผูกมัด การยกเลิกอยู่ระหว่างรอดำเนินการและจะมีผลเมื่อสิ้นสุดระยะเวลาผูกมัดเท่านั้น จากนั้น หากผู้ใช้ไม่กู้คืน ระบบจะส่ง RTDN SUBSCRIPTION_CANCELED และ SUBSCRIPTION_EXPIRED เมื่อสิ้นสุดระยะเวลาผูกมัด

  • การชำระคืน/การรับรู้รายได้: การชำระคืนให้แก่นักพัฒนาแอปจะเกิดขึ้นเมื่อผู้ใช้ชำระเงินรายเดือน โดยเป็นไปตามข้อกำหนดเดียวกันกับการสมัครใช้บริการอื่นๆ ทั้งหมด นักพัฒนาแอปจะไม่ได้รับการชำระเงินล่วงหน้าเมื่อผู้ใช้ลงชื่อสมัครใช้บริการแบบผ่อนชำระ

  • การเรียกเก็บเงินที่ค้างชำระ: หากผู้ใช้ไม่ชำระเงินค่าสมัครใช้บริการแบบผ่อนชำระ ทั้ง Google และนักพัฒนาแอปจะไม่พยายามเรียกเก็บเงินที่ค้างชำระหรือการชำระเงินคงค้างดังกล่าวจากผู้ใช้ เว้นแต่ว่า Google อาจพยายามเรียกเก็บเงินเป็นระยะๆ ในช่วงระยะเวลาผ่อนผันหรือช่วงการระงับบัญชีที่เกี่ยวข้องตามแนวทางปฏิบัติในการพยายามเรียกเก็บเงินตามปกติ Google จะไม่รับผิดชอบต่อนักพัฒนาแอปสำหรับการผ่อนชำระที่ค้างชำระที่เหลืออยู่

  • ความพร้อมใช้งานของ Play Billing Library: ช่อง installmentDetails ใช้ได้กับ PBL 7 ขึ้นไปเท่านั้น สำหรับ PBL 5 ขึ้นไป ระบบจะแสดงผลการสมัครใช้บริการแบบผ่อนชำระโดยใช้ queryProductDetails() แต่การสมัครใช้บริการจะไม่มีข้อมูลการผ่อนชำระโดยละเอียด เช่น จำนวนการชำระเงินที่ผูกมัดของแพ็กเกจ

ใช้ Deep Link เพื่ออนุญาตให้ผู้ใช้จัดการการสมัครใช้บริการ

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

คุณสามารถใส่ Deep Link จากแอปไปยังศูนย์การสมัครใช้บริการของ Google Play สำหรับการสมัครใช้บริการที่ยังไม่หมดอายุ ซึ่งคุณสามารถระบุได้โดยใช้ช่อง subscriptionState ของทรัพยากรการสมัครใช้บริการ ด้วยเหตุนี้ คุณจึงทำ Deep Link ไปยังศูนย์การสมัครใช้บริการของ Play Store ได้หลายวิธี

ใช้ URL ต่อไปนี้เพื่อนำผู้ใช้ไปยังหน้าที่แสดงการสมัครใช้บริการทั้งหมด ดังที่แสดงในรูปที่ 1 และ 2

https://play.google.com/store/account/subscriptions
หน้าจอการสมัครใช้บริการใน Play Store จะแสดงสถานะการสมัครใช้บริการทั้งหมดของผู้ใช้ที่เรียกเก็บเงินผ่าน Google Play
รูปที่ 1 หน้าจอการสมัครใช้บริการใน Play Store จะแสดงสถานะการสมัครใช้บริการทั้งหมดของผู้ใช้ที่เรียกเก็บเงินผ่าน Google Play


แตะการสมัครใช้บริการเพื่อดูรายละเอียดเพิ่มเติม
รูปที่ 2 แตะการสมัครใช้บริการเพื่อดูรายละเอียดเพิ่มเติม

Deep Link นี้อาจเป็นประโยชน์ในการช่วยให้ผู้ใช้กู้คืนการสมัครใช้บริการที่ยกเลิกไปแล้วจากศูนย์การสมัครใช้บริการของ Play Store

หากต้องการลิงก์ไปยังหน้าการจัดการสำหรับการสมัครใช้บริการที่ยังไม่หมดอายุโดยตรง ให้ระบุชื่อแพ็กเกจและ productId ที่เชื่อมโยงกับการสมัครใช้บริการที่ซื้อ หากต้องการกำหนด productId สำหรับการสมัครใช้บริการที่มีอยู่แบบเป็นโปรแกรม ให้ค้นหาแบ็กเอนด์ของแอปหรือเรียกใช้ BillingClient.queryPurchasesAsync() เพื่อดูรายการการสมัครใช้บริการที่เชื่อมโยงกับผู้ใช้รายหนึ่งๆ การสมัครใช้บริการแต่ละรายการจะมี productId ที่เกี่ยวข้องเป็นส่วนหนึ่งของข้อมูลสถานะการสมัครใช้บริการ ออบเจ็กต์ SubscriptionPurchaseLineItem แต่ละรายการที่เชื่อมโยงกับการซื้อการสมัครใช้บริการจะมีค่า productId ที่เชื่อมโยงกับการสมัครใช้บริการที่ผู้ใช้ซื้อในบรรทัดรายการนั้น

ใช้ URL ต่อไปนี้เพื่อนำผู้ใช้ไปยังหน้าจอการจัดการการสมัครใช้บริการที่เฉพาะเจาะจง โดยแทนที่ "your-sub-product-id" และ "your-app-package" ด้วย productId และชื่อแพ็กเกจแอปตามลำดับ

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

จากนั้นผู้ใช้จะจัดการวิธีการชำระเงินและเข้าถึงฟีเจอร์ต่างๆ ได้ ซึ่งรวมถึงการยกเลิก การสมัครอีกครั้ง และการหยุดชั่วคราว

อนุญาตให้ผู้ใช้อัปเกรด ดาวน์เกรด หรือเปลี่ยนการสมัครใช้บริการ

คุณสามารถเสนอตัวเลือกต่างๆ ให้กับสมาชิกปัจจุบันเพื่อเปลี่ยนแพ็กเกจการสมัครใช้บริการให้ตรงกับความต้องการมากขึ้น ดังนี้

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

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

รูปที่ 3 แสดงตัวอย่างแอปที่มีแพ็กเกจ 3 แบบที่แตกต่างกัน ดังนี้

แอปนี้มีระดับการสมัครใช้บริการ 3 ระดับ
รูปที่ 3 แอปนี้มีการสมัครใช้บริการ 3 ระดับ

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

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

โหมดการเปลี่ยนทดแทน

ตารางต่อไปนี้แสดงโหมดการแทนที่ที่ใช้ได้และตัวอย่างการใช้งาน รวมถึงจำนวนการชำระเงินที่ถือว่าชำระแล้ว

โหมดการเปลี่ยนทดแทน

คำอธิบาย

ตัวอย่างการใช้

การชำระเงินตามสัญญาผูกมัดที่บันทึกว่าชำระแล้ว (สำหรับการแทนที่การสมัครใช้บริการแบบผ่อนชำระ)

WITH_TIME_PRORATION

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

อัปเกรดเป็นระดับที่แพงขึ้นโดยไม่ต้องชำระเงินเพิ่มเติมทันที

0

CHARGE_PRORATED_PRICE

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

หมายเหตุ: ตัวเลือกนี้ใช้ได้กับการอัปเกรดรายการที่สมัครใช้บริการเท่านั้น โดยราคาต่อหน่วยเวลาจะเพิ่มขึ้น

อัปเกรดเป็นระดับที่แพงขึ้นโดยไม่เปลี่ยนวันที่เรียกเก็บเงิน

1

CHARGE_FULL_PRICE

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

หมายเหตุ: หากการสมัครใช้บริการใหม่มีช่วงทดลองใช้ฟรีหรือข้อเสนอช่วงแนะนำ ระบบจะเรียกเก็บเงินจากผู้ใช้เป็นจำนวน $0 หรือราคาของข้อเสนอช่วงแนะนำ (แล้วแต่กรณี) ณ เวลาที่อัปเกรดหรือดาวน์เกรด

อัปเกรดจากช่วงเวลาที่เรียกเก็บเงินสั้นลงเป็นนานขึ้น

1 (หมายเหตุ: 0 หากการสมัครใช้บริการใหม่มีช่วงทดลองใช้ฟรี)

WITHOUT_PRORATION

ระบบจะอัปเกรดหรือดาวน์เกรดรายการที่สมัครใช้บริการทันที และจะเรียกเก็บเงินในราคาใหม่เมื่อมีการต่ออายุการสมัครใช้บริการ รอบการเรียกเก็บเงินจะยังคงเหมือนเดิม

อัปเกรดเป็นระดับการสมัครใช้บริการที่สูงขึ้นขณะที่ยังคงรักษาระยะเวลาที่เหลืออยู่ของช่วงทดลองใช้ฟรีไว้

0

DEFERRED

ระบบจะอัปเกรดหรือดาวน์เกรดรายการที่สมัครใช้บริการเมื่อมีการต่ออายุการสมัครใช้บริการเท่านั้น แต่จะออกการซื้อใหม่ทันทีพร้อมกับรายการ 2 รายการต่อไปนี้

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

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

ดาวน์เกรดเป็นระดับที่ถูกลง

1

KEEP_EXISTING

กำหนดการชำระเงินสำหรับรายการที่สมัครใช้บริการจะยังคงเหมือนเดิมในการสมัครใช้บริการทดแทน

เพิ่มหรือนำรายการที่สมัครใช้ออกจากแพ็กเกจที่มีส่วนเสริมเมื่อไม่ควรเปลี่ยนแปลงรายการที่เฉพาะเจาะจง

ไม่มี

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ข้อเสนอการอัปเกรดหรือดาวน์เกรดเพื่อขายอัปเซลและดึงลูกค้ากลับมาได้ที่คู่มือข้อเสนอและโปรโมชัน

ตั้งค่าโหมดการแทนที่สำหรับการซื้อ

คุณสามารถใช้โหมดการแทนที่ที่แตกต่างกันสำหรับการเปลี่ยนการสมัครใช้บริการประเภทต่างๆ ตามความต้องการและตรรกะทางธุรกิจของคุณ ส่วนนี้จะอธิบายวิธีตั้งค่าโหมดการแทนที่สำหรับการเปลี่ยนแปลงในการสมัครใช้บริการและข้อจำกัดที่มีผล

สมัครอีกครั้งหรือเปลี่ยนแพ็กเกจภายในการสมัครใช้บริการเดียวกัน

คุณระบุโหมดการแทนที่เริ่มต้นได้ใน Google Play Console การตั้งค่านี้ช่วยให้คุณเลือกเวลาที่จะเรียกเก็บเงินจากสมาชิกปัจจุบันได้หากสมาชิกซื้อแพ็กเกจเริ่มต้นหรือข้อเสนออื่นสำหรับการสมัครใช้บริการเดียวกัน หรือสมัครใช้บริการอีกครั้งหลังจากยกเลิกไปแล้ว ตัวเลือกที่ใช้ได้คือเรียกเก็บเงินทันที ซึ่งเทียบเท่ากับ CHARGE_FULL_PRICE และเรียกเก็บเงินในวันที่เรียกเก็บเงินครั้งถัดไป ซึ่งเทียบเท่ากับ WITHOUT_PRORATION โหมดการแทนที่เหล่านี้เป็นโหมดเดียวที่เกี่ยวข้องเมื่อเปลี่ยนแพ็กเกจเริ่มต้นภายในการสมัครใช้บริการเดียวกัน

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

เปลี่ยนแพ็กเกจในการสมัครใช้บริการ หรือลบล้างโหมดการแทนที่เริ่มต้น

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

หากต้องการระบุ ReplacementMode ใน SubscriptionProductReplacementParams หรือ SubscriptionUpdateParams อย่างถูกต้องโดยเป็นส่วนหนึ่งของการกำหนดค่าขั้นตอนการซื้อขณะรันไทม์ โปรดคำนึงถึงข้อจำกัดต่อไปนี้

  • เมื่ออัปเกรด ดาวน์เกรด หรือเริ่มเปลี่ยนการสมัครใช้บริการเดียวกันเป็นแพ็กเกจแบบชำระเงินล่วงหน้าจากแพ็กเกจแบบชำระเงินล่วงหน้า แพ็กเกจต่ออายุใหม่อัตโนมัติ หรือแพ็กเกจแบบผ่อนชำระ โหมดการแทนที่ที่อนุญาตมีเพียง CHARGE_FULL_PRICE เท่านั้น หากคุณระบุโหมดการแทนที่อื่นๆ การซื้อจะล้มเหลวและระบบจะแสดงข้อผิดพลาดต่อผู้ใช้
  • เมื่อเปลี่ยนแพ็กเกจภายในการสมัครใช้บริการเดียวกันเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติจากแพ็กเกจแบบชำระเงินล่วงหน้าหรือแพ็กเกจต่ออายุใหม่อัตโนมัติ โหมดการคำนวณตามสัดส่วนที่ใช้ได้คือ CHARGE_FULL_PRICE และ WITHOUT_PRORATION หากคุณระบุโหมดการสัดส่วนอื่นๆ การซื้อจะล้มเหลวและระบบจะแสดงข้อผิดพลาดต่อผู้ใช้
  • ไม่อนุญาตให้เปลี่ยนแพ็กเกจภายในผลิตภัณฑ์ที่ต้องสมัครใช้บริการเดียวกันจากแพ็กเกจเริ่มต้นแบบผ่อนชำระเป็นแพ็กเกจเริ่มต้นแบบไม่ผ่อนชำระ
  • เมื่อใช้โหมดการแทนที่ KEEP_EXISTING ใน SubscriptionProductReplacementParams เพื่อให้การชำระเงินของรายการไม่มีการเปลี่ยนแปลงระหว่างการแทนที่ รหัสสินค้าเก่าควรเหมือนกับรหัสสินค้าของสินค้าใหม่ SubscriptionUpdateParams ไม่รองรับโหมด KEEP_EXISTING

ตัวอย่างและลักษณะการทำงานของการแทนที่

โปรดพิจารณาสถานการณ์ต่อไปนี้เพื่อทำความเข้าใจวิธีการทำงานของโหมดการคิดตามสัดส่วนแต่ละโหมด

สมชายสมัครใช้บริการเนื้อหาออนไลน์จากแอป Country Gardener โดยมีการสมัครใช้บริการรายเดือนสำหรับเนื้อหาเวอร์ชันระดับ 1 ซึ่งเป็นแบบข้อความเท่านั้น การสมัครใช้บริการนี้มีค่าใช้จ่าย $2 ต่อเดือน และจะต่ออายุในวันที่ 1 ของเดือน

ในวันที่ 15 เมษายน สมชายเลือกอัปเกรดเป็นการสมัครใช้บริการระดับ 2 แบบรายปี ซึ่งรวมถึงการอัปเดตวิดีโอและมีค่าใช้จ่าย $36 ต่อปี

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

WITH_TIME_PRORATION

การสมัครใช้บริการระดับ 1 ของสมชายจะสิ้นสุดทันที เนื่องจากเขาชำระเงินสำหรับทั้งเดือน (1-30 เมษายน) แต่อัปเกรดในช่วงกลางระยะเวลาการสมัครใช้บริการ ระบบจะนำค่าสมัครใช้บริการครึ่งเดือน ($1) ไปใช้กับการสมัครใช้บริการใหม่ อย่างไรก็ตาม เนื่องจากการสมัครใช้บริการใหม่มีค่าใช้จ่าย $36 ต่อปี ยอดเครดิตคงเหลือ $1 จึงจ่ายได้เพียง 10 วัน (16-25 เมษายน) ดังนั้นในวันที่ 26 เมษายน ระบบจะเรียกเก็บเงินจากเขา $36 สำหรับการสมัครใช้บริการใหม่ และอีก $36 ในวันที่ 26 เมษายนของแต่ละปีต่อจากนั้น

คุณควรเรียกใช้ PurchasesUpdatedListener ของแอปทันทีที่การซื้อสำเร็จ และคุณจะเรียกข้อมูลการซื้อใหม่ได้โดยเป็นส่วนหนึ่งของการเรียกใช้ queryPurchasesAsync() แบ็กเอนด์ของคุณจะได้รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป SUBSCRIPTION_PURCHASED ทันที

CHARGE_PRORATED_PRICE

คุณใช้โหมดนี้ได้เนื่องจากราคาการสมัครใช้บริการระดับ 2 ต่อหน่วยเวลา ($36/ปี = $3/เดือน) สูงกว่าราคาการสมัครใช้บริการระดับ 1 ต่อหน่วยเวลา ($2/เดือน) การสมัครใช้บริการระดับ 1 ของสมชายจะสิ้นสุดทันที เนื่องจากเขาจ่ายเงินสำหรับทั้งเดือนแต่ใช้บริการเพียงครึ่งเดือน ระบบจึงนำค่าสมัครใช้บริการครึ่งเดือน ($1) ไปใช้กับการสมัครใช้บริการใหม่ อย่างไรก็ตาม เนื่องจากค่าสมัครใช้บริการใหม่มีราคา $36/ปี ค่าบริการสำหรับ 15 วันที่เหลือจึงเท่ากับ $1.50 ดังนั้นระบบจะเรียกเก็บเงินจากเขาเป็นจำนวน $0.50 ซึ่งเป็นส่วนต่างสำหรับการสมัครใช้บริการใหม่ ในวันที่ 1 พฤษภาคม ระบบจะเรียกเก็บเงินจากสมชายเป็นจำนวน 1,080 บาทสำหรับการสมัครใช้บริการระดับใหม่ และจะเรียกเก็บเงินอีก 1,080 บาทในวันที่ 1 พฤษภาคมของปีต่อๆ ไป

คุณควรเรียกใช้ PurchasesUpdatedListener ของแอปทันทีที่การซื้อสำเร็จ และคุณจะเรียกข้อมูลการซื้อใหม่ได้โดยเป็นส่วนหนึ่งของการเรียกใช้ queryPurchasesAsync() แบ็กเอนด์ของคุณจะได้รับSUBSCRIPTION_PURCHASEDการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปทันที

WITHOUT_PRORATION

การสมัครใช้บริการระดับ 1 ของสมชายจะได้รับการอัปเกรดเป็นระดับ 2 ทันทีโดยไม่มีค่าใช้จ่ายเพิ่มเติม และในวันที่ 1 พฤษภาคม ระบบจะเรียกเก็บเงินจากสมชาย $36 สำหรับการสมัครใช้บริการระดับใหม่ และอีก $36 ในวันที่ 1 พฤษภาคมของแต่ละปีต่อจากนั้น

คุณควรเรียกใช้ PurchasesUpdatedListener ของแอปทันทีที่การซื้อสำเร็จ และคุณจะเรียกข้อมูลการซื้อใหม่ได้โดยเป็นส่วนหนึ่งของการเรียกใช้ queryPurchasesAsync() แบ็กเอนด์ของคุณจะได้รับSUBSCRIPTION_PURCHASEDการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอปทันที

DEFERRED

การสมัครใช้บริการระดับ 1 ของสมชายจะดำเนินต่อไปจนกว่าจะหมดอายุในวันที่ 30 เมษายน ในวันที่ 1 พฤษภาคม การสมัครใช้บริการระดับ 2 จะมีผล และระบบจะเรียกเก็บเงินจากสมชายเป็นจำนวน $36 สำหรับการสมัครใช้บริการระดับใหม่

คุณควรเรียกใช้ PurchasesUpdatedListener ของแอปทันทีที่การซื้อสำเร็จ และคุณจะเรียกข้อมูลการซื้อใหม่ได้โดยเป็นส่วนหนึ่งของการเรียกใช้ queryPurchasesAsync() แบ็กเอนด์ของคุณจะได้รับการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป SUBSCRIPTION_PURCHASED ทันที คุณควรประมวลผลการซื้อในลักษณะเดียวกับที่ประมวลผลการซื้อใหม่อื่นๆ ณ จุดนั้น โดยเฉพาะอย่างยิ่ง โปรดตรวจสอบว่าคุณรับทราบการซื้อใหม่แล้ว โปรดทราบว่าระบบจะป้อนข้อมูล startTime ของการสมัครใช้บริการใหม่เมื่อการแทนที่มีผล ซึ่งจะเกิดขึ้นเมื่อการสมัครใช้บริการเดิมหมดอายุ เมื่อถึงจุดนั้น คุณจะได้รับ RTDN SUBSCRIPTION_RENEWED สำหรับแพ็กเกจการสมัครใช้บริการใหม่ อ่านข้อมูลเพิ่มเติมเกี่ยวกับลักษณะการทำงานของ ReplacementMode.DEFERRED ได้ในจัดการการเปลี่ยนทดแทนที่เลื่อนเวลาออกไป

CHARGE_FULL_PRICE

การสมัครใช้บริการระดับ 1 ของสมชายจะสิ้นสุดทันที การสมัครใช้บริการระดับ 2 ของลูกค้าจะเริ่มวันนี้และระบบจะเรียกเก็บเงิน $36 เนื่องจากเขาชำระเงินสำหรับทั้งเดือนแต่ใช้บริการเพียงครึ่งเดือน ระบบจึงนำค่าสมัครใช้บริการครึ่งเดือน ($1) ไปใช้กับการสมัครใช้บริการใหม่ เนื่องจากค่าสมัครใช้บริการใหม่มีค่าใช้จ่าย $36/ปี เขาจะได้รับระยะเวลาการสมัครใช้บริการเพิ่มขึ้น 1/36 ของปี (~10 วัน) ดังนั้น การเรียกเก็บเงินครั้งถัดไปของ Samwise จะเกิดขึ้นในอีก 1 ปีกับ 10 วันนับจากวันนี้เป็นจำนวน $36 หลังจากนั้น ระบบจะเรียกเก็บเงินจากเขา $36 ในแต่ละปีถัดไป

เมื่อเลือกโหมดการคิดตามสัดส่วน โปรดอ่านคำแนะนำในการเปลี่ยนทดแทน

KEEP_EXISTING

สมชายสมัครใช้บริการเนื้อหาออนไลน์จากแอป Country Gardener โดยสมัครใช้บริการแพ็กเกจ 1 รายเดือนสำหรับเนื้อหาพื้นฐาน การสมัครใช้บริการนี้มีราคาช่วงแนะนำอยู่ที่ $2 ต่อเดือนเป็นเวลา 3 เดือน จากนั้นจะอยู่ที่ $4 ต่อเดือน Samwise ซื้อรายการนี้เมื่อวันที่ 1 เมษายน แอป Country Gardener มีแพ็กเกจ 2 เป็นเนื้อหาพิเศษแบบส่วนเสริมในราคา $3 ต่อเดือน ในวันที่ 15 เมษายน สมชายได้เพิ่มแพ็กเกจ 2 ลงในการสมัครใช้บริการแอป Country Gardener โดยยังคงใช้แพ็กเกจ 1 ที่มีอยู่ กำหนดการชำระเงินของ Samwise มีดังนี้

  • ราคาตามสัดส่วน $1.50 สำหรับแพ็กเกจ 2 ซึ่งครบกำหนดชำระในวันที่ 15 เมษายน
  • ราคา $5.00 ต่อเดือนสำหรับ 2 เดือนถัดไป ซึ่งครอบคลุมทั้งราคาช่วงแนะนำสำหรับแพ็กเกจ 1 และราคาปกติสำหรับแพ็กเกจ 2
  • หลังจากนั้นจะมีการเรียกเก็บเงิน $7.00 เป็นรายเดือนอย่างสม่ำเสมอ

ทริกเกอร์การเปลี่ยนแปลงการสมัครใช้บริการในแอป

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

ใช้ SubscriptionProductReplacementParams สำหรับการแทนที่ (แนะนำ)

ตัวอย่างต่อไปนี้แสดงวิธีอัปเดตการสมัครใช้บริการโดยใช้ SubscriptionProductReplacementParams

  • ตอนนี้ออบเจ็กต์ BillingFlowParams.ProductDetailsParams มีเมธอด setSubscriptionProductReplacementParams() เพื่อระบุข้อมูลการแทนที่ระดับสินค้าแล้ว

  • SubscriptionProductReplacementParams มีเมธอด Setter 2 รายการ ได้แก่

    • setOldProductId:นี่คือผลิตภัณฑ์เก่าที่จะถูกแทนที่ด้วยผลิตภัณฑ์ใน ProductDetails. ปัจจุบัน
    • setReplacementMode:นี่คือโหมดการแทนที่ระดับสินค้า โหมด ต่างๆ จะเหมือนกับ SubscriptionUpdateParams แต่ มีการอัปเดตการแมปค่า
  • ควรสร้างพารามิเตอร์การอัปเดตระดับการซื้อ BillingFlowParams.setSubscriptionUpdateParams() ที่มีอยู่ด้วย setOldPurchaseToken()

  • เมื่อเรียกใช้ setSubscriptionProductReplacementParams() สำหรับ ProductDetailsParams ใดๆ แล้ว SubscriptionUpdateParams.setSubscriptionReplacementMode() จะไม่มีผล

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเปลี่ยนแพ็กเกจการสมัครใช้บริการจาก (old_product_1, old_product_2) เป็น (product_1, product_2, product_3) ในสถานการณ์นี้ product_1 จะแทนที่ old_product_1, product_2 จะแทนที่ old_product_2 และระบบจะเพิ่ม product_3 ลงในการสมัครใช้บริการทันที

Kotlin

val billingClient: BillingClient = this.billingClient
val replacementModeForBasePlan: Int = SubscriptionProductReplacementParams.ReplacementMode.KEEP_EXISTING
val replacementModeForAddon: Int = SubscriptionProductReplacementParams.ReplacementMode.CHARGE_PRORATED_PRICE

val purchaseTokenOfExistingSubscription: String = "your_old_purchase_token"

// ProductDetails instances obtained from queryProductDetailsAsync();

val productDetailsParams1 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails1) // Required: Set the ProductDetails object
        .setSubscriptionProductReplacementParams(
            SubscriptionProductReplacementParams.newBuilder()
                .setOldProductId("old_product_id_1")
                .setReplacementMode(replacementModeForBasePlan)
                .build()
        )
        .build()

val productDetailsParams2 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails2) // Required: Set the ProductDetails object
        .setSubscriptionProductReplacementParams(
            SubscriptionProductReplacementParams.newBuilder()
                .setOldProductId("old_product_id_2")
                .setReplacementMode(replacementModeForAddon)
                .build()
        )
        .build()

// Example for a third item without replacement params
val productDetailsParams3 =
    ProductDetailsParams.newBuilder()
        .setProductDetails(productDetails3) // Required: Set the ProductDetails object
        .build()

val newProductDetailsList = listOf(
    productDetailsParams1,
    productDetailsParams2,
    productDetailsParams3
)

val billingFlowParams =
    BillingFlowParams.newBuilder()
        .setSubscriptionUpdateParams(
            SubscriptionUpdateParams.newBuilder()
                .setOldPurchaseToken(purchaseTokenOfExistingSubscription)
                .build()
        )
        .setProductDetailsParamsList(newProductDetailsList)
        .build()

// To launch the billing flow:
billingClient.launchBillingFlow(activity, billingFlowParams)

Java

BillingClient billingClient = …;

int replacementModeForBasePlan =…;
int replacementModeForAddon =…;
// ProductDetails obtained from queryProductDetailsAsync().
ProductDetailsParams productDetails1 =
  ProductDetailsParams.newBuilder()
      .setSubscriptionProductReplacementParams(
           SubscriptionProductReplacementParams.newBuilder()
               .setOldProductId("old_product_id_1")
               .setReplacementMode(replacementModeForBasePlan))
               .build();
ProductDetailsParams productDetails2 =
  ProductDetailsParams.newBuilder()
      .setSubscriptionProductReplacementParams(
           SubscriptionProductReplacementParams.newBuilder()
               .setOldProductId("old_product_id_2")
               .setReplacementMode(replacementModeForAddon))
               .build();
ProductDetailsParams productDetails3 = ...;

ArrayList newProductDetailsList = new ArrayList<>();
newProductDetailsList.add(productDetails1);
newProductDetailsList.add(productDetails2);
newProductDetailsList.add(productDetails3);

BillingFlowParams billingFlowParams =
    BillingFlowParams.newBuilder()
        .setSubscriptionUpdateParams(
          SubscriptionUpdateParams.newBuilder()
              .setOldPurchaseToken(purchaseTokenOfExistingSubscription)
             .build())
        .setProductDetailsParamsList(productDetailsList)
        .build();

billingClient.launchBillingFlow(billingFlowParams);

ตั้งค่า SubscriptionUpdateParams สำหรับการแทนที่ (เลิกใช้งานแล้ว)

ตัวอย่างต่อไปนี้แสดงวิธีอัปเดตการสมัครใช้บริการโดยใช้ SubscriptionUpdateParams

Kotlin

val offerToken = productDetails
        .getSubscriptionOfferDetails(selectedOfferIndex)
        .getOfferToken()

val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList(
       listOf(
           BillingFlowParams.ProductDetailsParams.newBuilder()
               .setProductDetails(productDetails)
               .setOfferToken(offerToken)
               .build()
       )
       ).setSubscriptionUpdateParams(
           BillingFlowParams.SubscriptionUpdateParams.newBuilder()
               .setOldPurchaseToken("old_purchase_token")
               .setSubscriptionReplacementMode(
                 BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE
               )
               .build()
       ).build()

billingClient.launchBillingFlow(
    activity,
    billingParams
   )
// ...

Java

String offerToken = productDetails
    .getSubscriptionOfferDetails(selectedOfferIndex)
    .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched using queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldPurchaseToken("old_purchase_token")
            .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// ...

คำแนะนำในการเปลี่ยนทดแทน

ตารางต่อไปนี้แสดงสถานการณ์การคิดตามสัดส่วนที่แตกต่างกัน พร้อมกับสิ่งที่เราแนะนำสำหรับแต่ละสถานการณ์

สถานการณ์ โหมดการเปลี่ยนที่แนะนำ ผลลัพธ์
การอัปเกรดเป็นระดับที่แพงขึ้น CHARGE_PRORATED_PRICE ผู้ใช้จะได้รับสิทธิ์เข้าถึงทันทีโดยยังคงใช้ช่วงเวลาที่เรียกเก็บเงินเดิม
การดาวน์เกรดเป็นระดับที่ถูกลง DEFERRED ผู้ใช้ได้ชำระเงินสำหรับระดับที่มีราคาแพงกว่าแล้ว จึงยังคงมีสิทธิ์เข้าถึงจนถึงวันที่เรียกเก็บเงินครั้งถัดไป
การอัปเกรดขณะอยู่ในช่วงทดลองใช้ฟรี โดยยังคงใช้ช่วงทดลองใช้ต่อไป WITHOUT_PRORATION ผู้ใช้จะอัปเกรดเป็นระดับที่สูงขึ้นในช่วงระยะทดลองที่เหลืออยู่โดยไม่มีค่าใช้จ่ายเพิ่มเติม
การอัปเกรดขณะอยู่ในช่วงทดลองใช้ฟรี - การสิ้นสุดสิทธิ์เข้าถึงช่วงทดลองใช้ฟรี CHARGE_PRORATED_PRICE ผู้ใช้จะได้รับสิทธิ์เข้าถึงระดับใหม่ทันที และมูลค่าที่เหลือของช่วงทดลองใช้ฟรีจะยกยอดไป ระบบจะคำนวณมูลค่าที่ยกยอดมาตามราคาของแพ็กเกจเริ่มต้น
การคงกำหนดการชำระเงินของรายการที่สมัครใช้บริการบางรายการไว้โดยไม่มีการเปลี่ยนแปลงขณะเพิ่มหรือนำรายการที่สมัครใช้บริการอื่นๆ ออกจากการสมัครใช้บริการที่มีส่วนเสริม KEEP_EXISTING ผู้ใช้จะยังคงจ่ายราคาเดิมสำหรับรายการที่ไม่มีการเปลี่ยนแปลง ระบบจะเพิ่มรายการใหม่ทันที คุณสามารถแทนที่รายการเก่าอื่นๆ ได้โดยระบุโหมดการแทนที่หรือนำออก

จัดการการซื้อการเปลี่ยนแปลงการสมัครใช้บริการ

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

ลักษณะการทำงานในแอปจะเหมือนกับการซื้อใหม่ แอปของคุณจะได้รับผลลัพธ์ของการซื้อใหม่ใน PurchasesUpdatedListener และการซื้อใหม่จะพร้อมใช้งานใน queryPurchasesAsync

Google Play Developer API จะแสดงผล linkedPurchaseToken ในทรัพยากรการสมัครใช้บริการเมื่อการซื้อแทนที่การซื้อที่มีอยู่ คุณสามารถตรวจสอบ itemReplacement ในส่วน SubscriptionPurchaseLineItem ในการซื้อใหม่เพื่อทำความเข้าใจรายละเอียดการเปลี่ยนทดแทนระดับรายการ นอกจากนี้ คุณยังใช้ช่อง offerPhase เพื่อระบุเฟสของข้อเสนอปัจจุบัน (เช่น ระยะเวลาตามสัดส่วนหรือช่วงทดลองใช้ฟรี) สำหรับการสมัครใช้บริการใหม่เพื่อมอบประสบการณ์การใช้งานที่ปรับแต่งให้เหมาะกับผู้ใช้ได้ โปรดตรวจสอบว่าได้ทำให้โทเค็นที่ระบุใน linkedPurchaseToken ไม่ถูกต้อง เพื่อให้แน่ใจว่าไม่มีการใช้โทเค็นเก่าเพื่อเข้าถึงบริการของคุณ ดูข้อมูลเกี่ยวกับการจัดการการซื้อการอัปเกรดและการดาวน์เกรดได้ที่การอัปเกรด การดาวน์เกรด และการลงชื่อสมัครใช้อีกครั้ง

เมื่อได้รับโทเค็นการซื้อใหม่ ให้ทำตามกระบวนการยืนยันตัวตนแบบเดียวกับการยืนยันโทเค็นการซื้อใหม่ อย่าลืมรับทราบการซื้อเหล่านี้ด้วย BillingClient.acknowledgePurchase() จาก Google Play Billing Library หรือ Purchases.subscriptions:acknowledge จาก Google Play Developer API

จัดการการเปลี่ยนทดแทนที่เลื่อนออกไป

โหมดการแทนที่แบบเลื่อนเวลาช่วยให้คุณอนุญาตให้ผู้ใช้ใช้สิทธิ์ที่เหลือในแพ็กเกจเดิมจนหมดก่อนที่จะเริ่มใช้แพ็กเกจใหม่

เมื่อคุณใช้ ReplacementMode.DEFERRED สำหรับการซื้อใหม่ queryPurchasesAsync() จะแสดงผลโทเค็นการซื้อใหม่หลังจากขั้นตอนการซื้อที่ยังคงเชื่อมโยงกับผลิตภัณฑ์เดิมจนกว่าจะมีการแทนที่แบบเลื่อนเวลาในวันที่ต่ออายุครั้งถัดไป หลังจากนั้นระบบจะแสดงผลผลิตภัณฑ์ใหม่

ในอดีต คุณสามารถมอบประสบการณ์ของผู้ใช้เช่นนี้ได้ด้วย ProrationMode.DEFERRED ที่เลิกใช้งานแล้ว แต่ ProrationMode.DEFERRED เลิกใช้งานไปพร้อมกับ Play Billing Library 6 ดูตารางต่อไปนี้เพื่อทำความเข้าใจว่าลักษณะการทำงานแตกต่างกันอย่างไร

เวลา

ProrationMode.DEFERRED (เลิกใช้งานแล้ว)

ReplacementMode.DEFERRED

ทันทีหลังจากขั้นตอนการซื้อสำเร็จ (แอป)

ระบบจะเรียกใช้ PurchasesUpdatedListener หลังจากการซื้อพร้อมสถานะที่ระบุว่าการอัปเกรดหรือดาวน์เกรดสำเร็จหรือไม่

สิทธิ์ในแพ็กเกจเดิมจะยังคงอยู่จนกว่าจะถึงวันที่ต่ออายุครั้งถัดไป เพื่อให้แน่ใจว่าแอปให้สิทธิ์ที่ถูกต้อง queryPurchasesAsync() จะแสดงผลออบเจ็กต์ Purchase พร้อมโทเค็นการซื้อเดิมและสิทธิ์เดิมจนกว่าจะมีการแทนที่

โทเค็นการซื้อใหม่ไม่แสดงขึ้นมา จึงไม่สามารถประมวลผลได้ในขณะนี้

ระบบจะเรียกใช้ PurchasesUpdatedListener หลังจากการซื้อพร้อมสถานะที่ระบุว่าการอัปเกรดหรือดาวน์เกรดสำเร็จหรือไม่

queryPurchasesAsync() จะแสดงผลการซื้อพร้อมโทเค็นการซื้อใหม่ทันที และการให้สิทธิ์เดิมที่เชื่อมโยงกับการซื้อนั้น

โทเค็นการซื้อใหม่จะแสดงขึ้น ดังนั้นควรประมวลผลโทเค็นดังกล่าว ณ จุดนี้โดยพิจารณาว่าการเปลี่ยนทดแทนจะเกิดขึ้นเมื่อใด

ทันทีหลังจากขั้นตอนการซื้อสำเร็จ (แบ็กเอนด์)

ระบบจะไม่ส่ง RTDN ของ SUBSCRIPTION_PURCHASED หลังจากขั้นตอนการซื้อ แบ็กเอนด์ยังไม่ทราบเกี่ยวกับการซื้อใหม่

ระบบจะส่ง SUBSCRIPTION_PURCHASED RTDN ที่มี product_id เดิมทันทีหลังจากขั้นตอนการซื้อสำหรับโทเค็นการซื้อใหม่

การเรียกใช้เมธอด purchases.subscriptionsv2.get ด้วยโทเค็นการซื้อใหม่จะแสดงผลการซื้อที่มี "startTime" ซึ่งระบุเวลาที่ซื้อพร้อมรายการโฆษณา 2 รายการ ดังนี้

  • รายการหนึ่งแสดงถึงสิทธิ์เก่าและมี "expiryTime" ในอนาคต สิทธิ์เดิมจะไม่ได้รับการต่ออายุและมี DeferredItemReplacement ที่มีผลิตภัณฑ์ของสิทธิ์ใหม่ ซึ่งบ่งบอกถึงการแทนที่สิทธิ์เดิมที่รอดำเนินการเมื่อสิทธิ์เดิมหมดอายุ
  • รายการแรกแสดงถึงสิทธิ์ที่ซื้อใหม่ ไม่มีการตั้งค่าสำหรับ "expiryTime"

ระบบจะส่ง SUBSCRIPTION_EXPIRED สำหรับโทเค็นการซื้อเก่า เมื่อเรียกใช้เมธอด purchases.subscriptionsv2.get ด้วยโทเค็นการซื้อเก่า ระบบจะแสดงว่าโทเค็นหมดอายุ (สิทธิ์สำหรับแพ็กเกจเก่าจะโอนไปยังการซื้อใหม่ตามเวลาที่เหลืออยู่)

เมื่อเปลี่ยน - การต่ออายุครั้งแรกหลังจากขั้นตอนการซื้อ (แอป)

queryPurchasesAsync() จะแสดงผลออบเจ็กต์ Purchase ใหม่พร้อมโทเค็นการซื้อและสิทธิ์ใหม่

ตอนนี้โทเค็นการซื้อใหม่จะแสดงขึ้นแล้ว คุณจึงควรประมวลผลโทเค็นดังกล่าว

queryPurchasesAsync() จะแสดงผลการซื้อพร้อมโทเค็นการซื้อใหม่ทันที และการให้สิทธิ์ใหม่ที่เชื่อมโยงกับโทเค็นดังกล่าว

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

On replacement - first renewal after the purchase flow (backend)

ตอนนี้ระบบจะประมวลผลและรับทราบการซื้อใหม่ได้เมื่อมีการส่ง SUBSCRIPTION_RENEWED RTDN รายการแรก

คุณสามารถใช้ linkedPurchaseToken ในทรัพยากรการสมัครใช้บริการเพื่อระบุว่าผู้ใช้รายใดในแบ็กเอนด์การสมัครใช้บริการ (หากมี) ควรได้รับการอัปเดตด้วยสิทธิ์ใหม่

ระบบประมวลผลและรับทราบการซื้อใหม่เมื่อมีการส่ง SUBSCRIPTION_PURCHASED RTDN สำหรับโทเค็นการซื้อใหม่และบันทึกเป็น "startTime"

เมื่อใช้ ReplacementMode.DEFERRED การต่ออายุครั้งแรกจะเป็นไปตามลักษณะการทำงานมาตรฐานของการต่ออายุอื่นๆ และคุณไม่จำเป็นต้องจัดการตรรกะพิเศษสำหรับการแทนที่เมื่อเกิดเหตุการณ์นี้

เมื่อเรียกใช้เมธอด purchases.subscriptionsv2.get ด้วยโทเค็นการซื้อใหม่ ระบบจะแสดงผลการซื้อที่มีบรรทัดรายการ 2 รายการ ดังนี้

  • รายการแรกแสดงถึงสิทธิ์เดิม โดยมี `expiryTime` ในอดีตและไม่มีค่าที่ตั้งไว้สำหรับ DeferredItemReplacement
  • รายการแรกแสดงถึงสิทธิ์ใหม่ โดยมี `expiryTime` ในอนาคตและเปิดแฟล็ก auto_renewing_enabled ไว้

คุณควรใช้ ReplacementMode.DEFERRED แทน ProrationMode.DEFERRED ที่เลิกใช้งานแล้ว เนื่องจากมีลักษณะการทำงานเหมือนกันเกี่ยวกับการเปลี่ยนแปลงการให้สิทธิ์ แต่นำเสนอวิธีจัดการการซื้อที่สอดคล้องกับลักษณะการทำงานของการซื้อใหม่อื่นๆ มากกว่า

การจัดการลูกค้า

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

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

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

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

แอปที่ไม่มี Billing Library 2.0 ขึ้นไป: ไม่

แอปที่มี Billing Library 2.0 ขึ้นไป: ใช่ นักพัฒนาแอปสามารถเลือกไม่ใช้ได้ใน Console

เมื่อมีการเรียกเก็บเงินจากผู้ใช้

หากใช้ SKU เดียวกัน: สิ้นสุดช่วงเวลาที่เรียกเก็บเงินปัจจุบัน

หากใช้ SKU อื่น: ขึ้นอยู่กับโหมดการคิดตามสัดส่วน

สิ้นสุดช่วงเวลาที่เรียกเก็บเงินปัจจุบัน ทันที ทันที
ต้องติดตั้งใช้งาน ระบุ UI การลงชื่อสมัครใช้อีกครั้งในแอป

ตรวจหาการเปลี่ยนแปลงสถานะการสมัครใช้บริการ

Deep Link ไปยัง Play Store

ระบุ UI การลงชื่อสมัครใช้อีกครั้งในแอป จัดการการซื้อนอกแอป

ก่อนการสมัครใช้บริการหมดอายุ - ในแอป

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

โดยส่วนใหญ่แล้ว คุณจะต้องการเสนอราคาและ SKU เดียวกันกับที่ผู้ใช้สมัครใช้บริการอยู่แล้ว ดังนี้

  • เริ่มการสมัครใช้บริการใหม่ด้วย SKU เดียวกัน
  • การสมัครใช้บริการใหม่จะแทนที่การสมัครใช้บริการเดิมและต่ออายุในวันที่หมดอายุเดิม ระบบจะทำเครื่องหมายการสมัครใช้บริการเดิมว่าหมดอายุทันที
  • ตัวอย่างเช่น Achilles สมัครใช้บริการแอปเพลงตัวอย่าง และการสมัครใช้บริการจะหมดอายุในวันที่ 1 สิงหาคม ในวันที่ 10 กรกฎาคม เขาสมัครใช้บริการแบบ 1 เดือนอีกครั้งในราคาเดิมต่อเดือน การสมัครใช้บริการใหม่จะคิดตามสัดส่วนโดยใช้เครดิตที่เหลืออยู่ โดยจะเริ่มใช้งานได้ทันทีและยังคงต่ออายุในวันที่ 1 สิงหาคม

หากต้องการเสนอราคาอื่น เช่น ช่วงทดลองใช้ฟรีใหม่หรือส่วนลดเพื่อดึงดูดผู้ใช้ให้กลับมาสมัครใช้บริการ คุณสามารถเสนอ SKU อื่นให้แก่ผู้ใช้แทนได้ ดังนี้

  • เริ่มอัปเกรดหรือดาวน์เกรดด้วย SKU อื่นโดยใช้โหมดการแทนที่ WITHOUT_PRORATION
  • การสมัครใช้บริการใหม่จะแทนที่การสมัครใช้บริการเดิมและต่ออายุในวันที่หมดอายุเดิม ระบบจะเรียกเก็บเงินจากผู้ใช้ในราคาของ SKU ใหม่ ซึ่งรวมถึงราคาช่วงแนะนำในวันที่หมดอายุเดิม หากการสมัครใช้บริการเดิมสร้างขึ้นโดยใช้รหัสบัญชีที่สร้างความสับสน คุณควรส่งรหัสเดียวกันนั้นไปยัง BillingFlowParams เพื่ออัปเกรดและดาวน์เกรด
  • ตัวอย่างเช่น Achilles สมัครใช้บริการแอปเพลงตัวอย่าง และการสมัครใช้บริการจะหมดอายุในวันที่ 1 สิงหาคม ในวันที่ 10 กรกฎาคม เขาสมัครใช้บริการรายปีอีกครั้งในราคาช่วงแนะนำ การสมัครใช้บริการใหม่จะเริ่มทำงานทันที และระบบจะเรียกเก็บเงินจากผู้ใช้ในราคาช่วงแนะนำในวันที่ 1 สิงหาคม
  • หากคุณตัดสินใจที่จะรวมช่วงทดลองใช้ฟรีหรือราคาช่วงแนะนำไว้ใน SKU สำหรับการดึงดูดผู้ใช้ให้กลับมาสมัครใช้บริการ ให้ตรวจสอบว่าผู้ใช้มีสิทธิ์โดยยกเลิกการเลือกช่องอนุญาตช่วงทดลองใช้ฟรี 1 ครั้งต่อแอปใน Google Play Console ซึ่งจะจำกัดให้ผู้ใช้ได้รับช่วงทดลองใช้ฟรี 1 ครั้งต่อแอป

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

ก่อนการสมัครใช้บริการหมดอายุ - ใน Play Store

แม้ว่าจะยกเลิกการสมัครใช้บริการแล้วแต่ยังใช้งานได้อยู่ ผู้ใช้สามารถกู้คืนการสมัครใช้บริการในศูนย์การสมัครใช้บริการของ Google Play ได้โดยคลิกสมัครอีกครั้ง (ก่อนหน้านี้คือกู้คืน) ซึ่งจะใช้การสมัครใช้บริการและโทเค็นการซื้อเดิม

ส่วนการสมัครใช้บริการในแอป Google Play Store ที่แสดงการสมัครใช้บริการที่ยกเลิกแล้วพร้อมปุ่มสมัครอีกครั้ง
รูปที่ 8 ส่วนบัญชี > การสมัครใช้บริการในแอป Google Play Store แสดงการสมัครใช้บริการที่ยกเลิกแล้วพร้อมปุ่มสมัครอีกครั้ง

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกู้คืนการสมัครใช้บริการได้ที่การกู้คืน

After subscription expiration - in-app

คุณอนุญาตให้สมาชิกที่หมดอายุสมัครใช้บริการอีกครั้งภายในแอปได้โดยใช้ขั้นตอนการซื้อไอเทมที่ซื้อในแอปแบบเดียวกับสมาชิกใหม่ ข้อควรทราบ

  • หากต้องการเสนอส่วนลดให้แก่ผู้ใช้ คุณอาจต้องเสนอ รหัสสินค้า ที่มีราคาพิเศษสำหรับการสมัครใช้บริการ ซึ่งเรียกว่า SKU สำหรับการดึงผู้ใช้กลับมา คุณสามารถแสดงข้อเสนอในแอปหรือแจ้งให้ผู้ใช้ทราบเกี่ยวกับข้อเสนอนอกแอป เช่น ทางอีเมล
  • หากต้องการเริ่มการสมัครใช้บริการเพื่อดึงดูดลูกค้าให้กลับมา ให้เปิดขั้นตอนการซื้อในแอป Android โดยใช้ Google Play Billing Library ซึ่งเป็นกระบวนการเดียวกับการสมัครใช้บริการใหม่ แต่คุณสามารถกำหนด SKU ที่ผู้ใช้จะใช้ได้
  • หากคุณตัดสินใจที่จะรวมช่วงทดลองใช้ฟรีหรือราคาช่วงแนะนำไว้ใน SKU สำหรับการดึงดูดผู้ใช้ให้กลับมาสมัครใช้บริการ ให้ตรวจสอบว่าผู้ใช้มีสิทธิ์โดยยกเลิกการเลือกช่องอนุญาตช่วงทดลองใช้ฟรี 1 ครั้งต่อแอปใน Google Play Console ซึ่งจะจำกัดให้ผู้ใช้ได้รับช่วงทดลองใช้ฟรี 1 ครั้งต่อแอป
  • หากผู้ใช้สมัครใช้บริการ SKU เดิมอีกครั้ง ผู้ใช้จะไม่มีสิทธิ์รับช่วงทดลองใช้ฟรีหรือราคาช่วงแนะนำอีกต่อไป ตรวจสอบว่า UI ของคุณแสดงข้อมูลนี้

เมื่อได้รับโทเค็นการซื้อ ให้ประมวลผลการซื้อเช่นเดียวกับการสมัครใช้บริการใหม่ คุณจะไม่ได้รับ linkedPurchaseToken ในทรัพยากรการสมัครใช้บริการ

After subscription expiration - in Play Store

หากเปิดใช้ ผู้ใช้จะสมัครใช้บริการ SKU เดิมอีกครั้งได้นานสูงสุด 1 ปีหลังจากหมดอายุโดยคลิกสมัครอีกครั้งในศูนย์การสมัครใช้บริการของ Google Play ซึ่งจะสร้างโทเค็นการสมัครใช้บริการและการซื้อใหม่

ส่วนการสมัครใช้บริการในแอป Google Play Store ที่แสดงการสมัครใช้บริการที่ยกเลิกและหมดอายุแล้ว พร้อมปุ่มสมัครอีกครั้งและปุ่มนำออก
รูปที่ 9 ส่วนบัญชี > การสมัครใช้บริการในแอป Google Play Store แสดงการสมัครใช้บริการที่ยกเลิกและหมดอายุแล้วพร้อมปุ่มสมัครอีกครั้งและนำออก

การสมัครอีกครั้งถือเป็นการซื้อนอกแอป ดังนั้นโปรดทำตามแนวทางปฏิบัติแนะนำเพื่อรับทราบการซื้ออย่างถูกต้องจากแบ็กเอนด์

โปรโมตการสมัครสมาชิก

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

สำหรับช่วงทดลองใช้ฟรี Google Play จะยืนยันว่าผู้ใช้มีวิธีการชำระเงินที่ถูกต้องก่อนเริ่มช่วงทดลองใช้ฟรี ผู้ใช้บางรายอาจเห็นการยืนยันนี้เป็นการกันวงเงินหรือการเรียกเก็บเงินในวิธีการชำระเงิน การกันวงเงินหรือการเรียกเก็บเงินนี้เป็นแบบชั่วคราว และจะมีการยกเลิกหรือคืนเงินในภายหลัง

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

หากผู้ใช้ยกเลิกการสมัครใช้บริการเมื่อใดก็ตามในช่วงทดลองใช้ฟรี การสมัครใช้บริการจะยังคงใช้งานได้จนกว่าจะสิ้นสุดระยะทดลอง และระบบจะไม่เรียกเก็บเงินเมื่อสิ้นสุดช่วงทดลองใช้ฟรี

เลื่อนการเรียกเก็บเงินสำหรับสมาชิก

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

สำหรับแพ็กเกจแบบชำระเงินล่วงหน้า คุณสามารถใช้ API การเลื่อนการเรียกเก็บเงินเพื่อเลื่อนเวลาหมดอายุได้

การเรียกเก็บเงินแบบเลื่อนเวลาช่วยให้คุณทำสิ่งต่อไปนี้ได้

  • ให้สิทธิ์เข้าถึงฟรีแก่ผู้ใช้เป็นข้อเสนอพิเศษ เช่น ให้สิทธิ์เข้าถึงฟรี 1 สัปดาห์เมื่อซื้อภาพยนตร์
  • ให้สิทธิ์เข้าถึงฟรีแก่ลูกค้าเพื่อแสดงความปรารถนาดี

คุณสามารถเลื่อนการเรียกเก็บเงินได้ตั้งแต่ 1 วันไปจนถึง 1 ปีต่อการเรียก API 1 ครั้ง หากต้องการเลื่อนการเรียกเก็บเงินออกไปอีก คุณสามารถเรียกใช้ API อีกครั้งก่อนถึงวันที่เรียกเก็บเงินใหม่

ตัวอย่างเช่น ดารณีสมัครใช้บริการรายเดือนเพื่อเข้าถึงเนื้อหาออนไลน์ของแอป Fishing Quarterly โดยปกติแล้วระบบจะเรียกเก็บเงินจากเธอ £1.25 ในวันที่ 1 ของทุกเดือน ในเดือนมีนาคม เธอได้เข้าร่วมการสำรวจออนไลน์สำหรับผู้เผยแพร่แอป ผู้เผยแพร่เนื้อหาจึงให้รางวัลแก่เธอด้วยการให้สิทธิ์อ่านฟรี 6 สัปดาห์โดยเลื่อนการชำระเงินครั้งถัดไปเป็นวันที่ 15 พฤษภาคม ซึ่งเป็นเวลา 6 สัปดาห์หลังจากวันที่เรียกเก็บเงินที่กำหนดไว้ก่อนหน้านี้คือวันที่ 3 เมษายน

  1. ระบบจะไม่เรียกเก็บเงินจากดาร์ซีสำหรับเดือนเมษายนหรือต้นเดือนพฤษภาคม และดาร์ซียังคงเข้าถึงเนื้อหาได้ ในวันที่ 15 พฤษภาคม ระบบจะเรียกเก็บค่าบริการตามปกติจำนวน £1.25 สำหรับเดือนนั้น วันที่ต่ออายุครั้งถัดไปของเธอคือวันที่ 15 มิถุนายน

เมื่อเลื่อนการเรียกเก็บเงิน คุณอาจต้องแจ้งให้ผู้ใช้ทราบทางอีเมลหรือภายในแอปเพื่อแจ้งให้ทราบว่าวันที่เรียกเก็บเงินมีการเปลี่ยนแปลง

จัดการการปฏิเสธการชำระเงิน

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

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

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

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

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

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

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

การรับส่งข้อความในแอป

หากคุณเปิดใช้การรับส่งข้อความในแอปด้วย InAppMessageCategoryId.TRANSACTIONAL Google Play จะแสดงข้อความแก่ผู้ใช้เมื่อมีปัญหาเกี่ยวกับการชำระเงินหรือการขึ้นราคาแบบขอให้ผู้ใช้ยินยอมที่ค้างอยู่

แถบแสดงข้อความแจ้งเตือนให้ผู้ใช้แก้ไขการชำระเงิน
รูปที่ 20 แถบแสดงข้อความแจ้งเตือนให้ผู้ใช้แก้ไขการชำระเงิน

เราขอแนะนำให้เรียกใช้ API นี้ทุกครั้งที่ผู้ใช้เปิดแอปเพื่อพิจารณาว่าควรแสดงข้อความหรือไม่

หากผู้ใช้กู้คืนการสมัครใช้บริการหรือยืนยันการขึ้นราคาสำเร็จ คุณจะได้รับโค้ดตอบกลับ SUBSCRIPTION_STATUS_UPDATED พร้อมโทเค็นการซื้อ จากนั้นคุณควรใช้โทเค็นการซื้อนี้เพื่อเรียกใช้ Google Play Developer API และรีเฟรชสถานะการสมัครใช้บริการในแอป

ผสานรวมการรับส่งข้อความในแอป

หากต้องการแสดงการรับส่งข้อความในแอปต่อผู้ใช้ ให้ใช้ BillingClient.showInAppMessages()

ตัวอย่างการทริกเกอร์ขั้นตอนการรับส่งข้อความในแอปมีดังนี้

Kotlin

val inAppMessageParams = InAppMessageParams.newBuilder()
    .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
    .build()

// Note: To display the in-app message, PBL requires an activity instance that
// can provide a valid window token. This token is necessary for the Play Store
// to display the message overlay correctly on top of the application's window.
// The passed Activity must be in a state where its window is created and
// attached to the WindowManager.
billingClient.showInAppMessages(
    activity,
    inAppMessageParams,
    object : InAppMessageResponseListener {
        override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
            if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                // The flow has finished and there is no action needed from developers.
            } else if (inAppMessageResult.responseCode
                == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED
            ) {
                // The subscription status changed. For example, a subscription
                // is recovered from a suspended state, or a user confirms a
                // price increase. Developers should expect the purchase
                // token to be returned with this response code and use
                // the purchase token with the Google Play Developer API.
            }
        }
    }
)

Java

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

// Note: To display the in-app message, PBL requires an activity instance that
// can provide a valid window token. This token is necessary for the Play Store
// to display the message overlay correctly on top of the application's window.
// The passed Activity must be in a state where its window is created and
// attached to the WindowManager.
billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // is recovered from a suspended state, or a user confirms a
                    // price increase. Developers should expect the purchase
                    // token to be returned with this response code and use
                    // the purchase token with the Google Play Developer API.
                }
            }
        });

จัดการการยกเลิกและสถานะรอดำเนินการ

ส่วนนี้จะอธิบายวิธีจัดการการสมัครใช้บริการที่ถูกยกเลิกหรือเพิกถอน รวมถึงวิธีจัดการการสมัครใช้บริการที่เข้าสู่สถานะรอดำเนินการในระหว่างกระบวนการซื้อ

ยกเลิกหรือเพิกถอน

คุณใช้ Google Play Developer API เพื่อยกเลิกหรือเพิกถอนการสมัครใช้บริการได้ ฟังก์ชันนี้ยังมีให้บริการใน Google Play Console ด้วย

  • ยกเลิก: ผู้ใช้ยกเลิกการสมัครใช้บริการใน Google Play ได้ นอกจากนี้ คุณยังสามารถระบุตัวเลือกให้ผู้ใช้ยกเลิกในแอปหรือในเว็บไซต์ของคุณได้ด้วย แอปของคุณควรจัดการการยกเลิกเหล่านี้ตามที่อธิบายไว้ในการยกเลิก

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

ล่าสุด

ตารางต่อไปนี้แสดงความแตกต่างระหว่างการยกเลิกและการเพิกถอน

หยุดต่ออายุ เพิกถอนสิทธิ์เข้าถึง
ยกเลิก ใช่ ไม่
เพิกถอน ใช่ ใช่

จัดการธุรกรรมที่รอดำเนินการของการสมัครใช้บริการ

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

การเปลี่ยนแปลงสถานะการสมัครใช้บริการสำหรับการซื้อครั้งแรกที่มีธุรกรรมที่รอดำเนินการนั้นตรงไปตรงมา แอปของคุณจะได้รับ Purchase ที่มีสถานะ PENDING เมื่อผู้ใช้เริ่มธุรกรรมที่รอดำเนินการ เมื่อธุรกรรมเสร็จสมบูรณ์ แอปของคุณจะได้รับ Purchase อีกครั้งพร้อมสถานะที่อัปเดตเป็น PURCHASED ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PURCHASED ไปยังไคลเอ็นต์ RTDN ของคุณ ทำตามขั้นตอนปกติเพื่อยืนยันการซื้อ ให้สิทธิ์ผู้ใช้เข้าถึงเนื้อหา และรับทราบการซื้อ หากธุรกรรมหมดอายุหรือถูกยกเลิก ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PENDING_PURCHASE_CANCELED ไปยังไคลเอ็นต์ RTDN ของคุณ ในกรณีเช่นนี้ ผู้ใช้ไม่ควรได้รับสิทธิ์เข้าถึงเนื้อหา

การเติมเงิน การอัปเกรด หรือการดาวน์เกรดที่มีธุรกรรมที่รอดำเนินการเกี่ยวข้องกับการเปลี่ยนแปลงสถานะของการสมัครใช้บริการทั้งแบบเก่าและแบบใหม่ เมื่อผู้ใช้เริ่มธุรกรรมการเติมเงิน การอัปเกรด หรือการดาวน์เกรดที่รอดำเนินการ แอปของคุณจะได้รับ Purchase สำหรับการสมัครใช้บริการเดิมที่มีออบเจ็กต์ PendingPurchaseUpdate ในตอนนี้ ผู้ใช้ยังคงเป็นเจ้าของการสมัครใช้บริการเดิมและยังไม่ได้รับการสมัครใช้บริการใหม่ การเรียกใช้ getProducts() และ getPurchaseToken() ในออบเจ็กต์ PendingPurchaseUpdate จะแสดงรหัสผลิตภัณฑ์และโทเค็นการซื้อของการสมัครใช้บริการใหม่ เมื่อธุรกรรมเสร็จสมบูรณ์ แอปของคุณจะได้รับ Purchase พร้อมชุดโทเค็นการซื้อระดับบนสุดสำหรับการสมัครใช้บริการใหม่และสถานะที่ตั้งค่าเป็น PURCHASED ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PURCHASED ไปยังไคลเอ็นต์ RTDN ของคุณ ในกรณีนี้เท่านั้น คุณควรแทนที่โทเค็นการซื้อเดิมด้วยโทเค็นการซื้อใหม่และอัปเดตสิทธิ์เข้าถึงเนื้อหาของผู้ใช้ หากธุรกรรมหมดอายุหรือถูกยกเลิก ระบบจะส่งข้อความ SubscriptionNotification ที่มีประเภท SUBSCRIPTION_PENDING_PURCHASE_CANCELED ไปยังไคลเอ็นต์ RTDN ในกรณีเช่นนี้ ผู้ใช้ควรยังคงเข้าถึงเนื้อหาของการสมัครใช้บริการเดิมได้อยู่