รักษาผู้ติดตามไว้ด้วยข้อเสนอการรักษาผู้ใช้

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

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

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

ก่อนเริ่มต้น

ก่อนตั้งค่าข้อเสนอเพื่อการรักษาลูกค้า โปรดตรวจสอบว่าคุณได้ดำเนินการต่อไปนี้แล้ว

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

วิธีการทำงานของข้อเสนอเพื่อรักษาลูกค้า

ข้อเสนอเพื่อรักษาลูกค้าจะปรากฏในการจัดการการสมัครใช้บริการของ Google Play เท่านั้น ซึ่งได้แก่ แอป Google Play Store และ Google Play บนเว็บ ข้อเสนอเหล่านี้จะไม่ปรากฏในแอปของคุณ Google Play Billing Library จะไม่แสดงข้อเสนอเพื่อการรักษาลูกค้าไว้ในผลลัพธ์ queryProductDetailsAsync() จึงไม่รวมอยู่ใน ProductDetails.getSubscriptionOfferDetails() และคุณจะขายข้อเสนอเหล่านี้ผ่าน launchBillingFlow() ไม่ได้ หากแอปใช้ Deep Link เพื่อส่งสมาชิกไปยังศูนย์การสมัครใช้บริการของ Google Play หรือไปยังการสมัครใช้บริการที่เฉพาะเจาะจงเพื่อให้สมาชิกจัดการหรือยกเลิกการสมัครใช้บริการได้ สมาชิกเหล่านั้นจะเห็นข้อเสนอเพื่อการรักษาลูกค้าเมื่อเริ่มยกเลิกการสมัครใช้บริการที่นั่น

ขั้นตอนต่อไปนี้อธิบายสิ่งที่จะเกิดขึ้นเมื่อสมาชิกพยายามยกเลิก

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

  3. หากสมาชิกมีสิทธิ์ Google Play อาจแสดงข้อเสนอเพื่อการรักษาผู้ใช้เป็นทางเลือกแทนการยกเลิก การมีคุณสมบัติตรงตามเกณฑ์การมีสิทธิ์ไม่ได้เป็นการรับประกันว่าข้อเสนอจะปรากฏ เนื่องจาก Google Play ยังทำการตรวจสอบเพิ่มเติมในระดับแพลตฟอร์มด้วย เช่น ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดระดับภูมิภาค หาก Google Play แสดงข้อเสนอ สมาชิกจะดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้ได้

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

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

การเปลี่ยนแพ็กเกจตามกำหนดเวลา

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

เมื่อสมาชิกยอมรับข้อเสนอ Google Play จะดำเนินการดังนี้

  • ส่ง RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) ไปยังแบ็กเอนด์
  • เพิ่มออบเจ็กต์ planTransitionDetails ลงในช่อง autoRenewingPlan ของรายการโฆษณาที่ได้รับผลกระทบในทรัพยากร SubscriptionPurchaseV2

ดูรายละเอียดเกี่ยวกับการจัดการเหตุการณ์เหล่านี้ได้ที่จัดการเหตุการณ์ข้อเสนอการรักษาลูกค้าในแบ็กเอนด์

ข้อกำหนดของการได้รับสิทธิ์

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

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

กำหนดค่าข้อเสนอเพื่อการรักษาลูกค้า

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

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

  1. โหมดการกำหนดเป้าหมาย: ข้อเสนอที่กำหนดเป้าหมายต่อผู้ใช้ (retentionPerUserRule) จะมีผลเหนือกว่าข้อเสนอตามกฎ (retentionRule) เสมอ แม้ว่าข้อเสนอตามกฎจะมีเปอร์เซ็นต์ส่วนลดสูงกว่าก็ตาม
  2. เปอร์เซ็นต์ส่วนลด: ในบรรดาข้อเสนอที่มีสิทธิ์ซึ่งใช้โหมดการกำหนดเป้าหมายเดียวกัน Google Play จะแสดงข้อเสนอที่มีเปอร์เซ็นต์ส่วนลดที่แสดงสูงสุด
  3. ราคาที่มีส่วนลด: หากข้อเสนอมีเปอร์เซ็นต์ส่วนลดเท่ากัน Google Play จะแสดงข้อเสนอที่มีราคาที่มีส่วนลดต่ำที่สุด
  4. รหัสข้อเสนอ: หากข้อเสนอยังคงมีคะแนนเท่ากัน Google Play จะแสดงข้อเสนอที่มี offerId อยู่ท้ายสุดตามลำดับตัวอักษร

สร้างข้อเสนอเพื่อรักษาผู้ใช้เดิมใน Play Console

หากต้องการสร้างข้อเสนอเพื่อรักษาผู้ใช้เดิมใน Google Play Console ให้ทำดังนี้

  1. ไปที่สร้างรายได้ด้วย Play > ผลิตภัณฑ์ > การสมัครใช้บริการ
  2. เลือกการสมัครใช้บริการ แล้วเลือกแพ็กเกจเริ่มต้นที่ต้องการเพิ่มข้อเสนอ
  3. เพิ่มข้อเสนอสำหรับสมาชิกปัจจุบันที่พยายามยกเลิก
  4. เลือกข้อเสนอการรักษาผู้ใช้ระดับกลุ่มประชากรตามรุ่นหรือข้อเสนอการรักษาผู้ใช้ระดับผู้ใช้

สร้างข้อเสนอเพื่อรักษาลูกค้าด้วย Play Developer API

นอกจากนี้ คุณยังสร้างและอัปเดตข้อเสนอการรักษาลูกค้าแบบเป็นโปรแกรมได้ด้วย หากต้องการสร้างข้อเสนอ ให้เรียกใช้เมธอด monetization.subscriptions.basePlans.offers.create หากต้องการอัปเดตข้อเสนอที่มีอยู่ ให้เรียกใช้เมธอด monetization.subscriptions.basePlans.offers.patch หรือ monetization.subscriptions.basePlans.offers.batchUpdate ทั้ง 3 วิธีรองรับฟิลด์ retentionRule, retentionPerUserRule, startTime และ endTime ในออบเจ็กต์ SubscriptionOffer ให้ตั้งค่าช่องต่อไปนี้

  • offerId: รหัสข้อเสนอเพื่อการรักษาลูกค้าที่ไม่ซ้ำกัน
  • targeting: ตั้งค่า retentionRule เป็นออบเจ็กต์ RetentionTargetingRule ที่กำหนดผู้มีสิทธิ์รับข้อเสนอ ดูช่องที่ใช้ได้ที่หัวข้อตั้งกฎการมีสิทธิ์คงไว้ชั่วคราว หากต้องการเลือกผู้ติดตามที่มีสิทธิ์จากแบ็กเอนด์แทน ให้ตั้งค่า retentionPerUserRule ดูรายละเอียดได้ที่กำหนดเป้าหมายข้อเสนอการรักษาฐานลูกค้าไปยังสมาชิกที่เฉพาะเจาะจง
  • phases[]: ข้อเสนอเพื่อการรักษาลูกค้าสนับสนุนเฟสการกำหนดราคาเพียงเฟสเดียวเท่านั้น ในระยะนั้น ให้ตั้งค่าช่องต่อไปนี้
    • recurrenceCount: จำนวนช่วงเวลาที่เรียกเก็บเงินที่ส่วนลดมีผล ตั้งแต่ 1 ถึง 52 หาก recurrenceCount มากกว่า 1 เฟส duration ต้องเท่ากับช่วงเวลาที่เรียกเก็บเงินของแพ็กเกจเริ่มต้น
    • regionalConfigs[]: ตั้งค่า relativeDiscount เป็นส่วนลดในรูปแบบเศษส่วนที่มากกว่า 0 และน้อยกว่า 1 เช่น ใช้ 0.5 สำหรับส่วนลด 50% ข้อเสนอการคงผู้ใช้ไว้รองรับเฉพาะ relativeDiscount เท่านั้น ระบบไม่รองรับเฟสราคาคงที่ (price) ส่วนลดสุทธิ (absoluteDiscount) และฟรี (free)
  • startTime: ไม่บังคับ เวลาที่ข้อเสนอการรักษาลูกค้าพร้อมให้บริการแก่สมาชิกที่มีสิทธิ์ โดยระบุเป็นการประทับเวลา RFC 3339 การตั้งค่าช่องนี้ไม่ได้เปิดใช้งานข้อเสนอ หากคุณไม่ได้ตั้งค่าช่องนี้ ข้อเสนอจะพร้อมใช้งานตามสถานะของข้อเสนอ
  • endTime: ไม่บังคับ เวลาที่ข้อเสนอการรักษาลูกค้าหยุดให้บริการ โดยเป็นการประทับเวลา RFC 3339 ไม่ว่าข้อเสนอจะอยู่ในสถานะใดก็ตาม หากคุณไม่ตั้งค่าช่องนี้ ข้อเสนอจะไม่มีวันที่สิ้นสุด หากคุณตั้งค่าช่องนี้ วันที่ต้องเป็นวันที่ในอนาคตและหลังจาก startTime

เมธอด monetization.subscriptions.basePlans.offers.create จะสร้างข้อเสนอในสถานะ DRAFT เสมอ แม้ว่าคุณจะตั้งค่า startTime ไว้ก็ตาม หากต้องการเปิดใช้งานข้อเสนอ ให้เรียกใช้เมธอด monetization.subscriptions.basePlans.offers.activate

ตั้งกฎการมีสิทธิ์คงผู้ใช้ไว้

ออบเจ็กต์ RetentionTargetingRule มีช่องต่อไปนี้

  • scope: ต้องระบุ การสมัครใช้บริการที่กฎพิจารณา สำหรับข้อเสนอการรักษาลูกค้า ค่าเดียวที่รองรับคือ thisSubscription ซึ่งเป็นการสมัครใช้บริการที่มีการกำหนดข้อเสนอไว้ ตั้งค่าช่องนี้เป็น {"thisSubscription": {}}
  • minDuration: ต้องระบุ ระยะเวลาขั้นต่ำที่ผู้ใช้ต้องเป็นผู้สมัครใช้บริการแบบชำระเงินจึงจะมีสิทธิ์ โดยเป็นระยะเวลา ISO 8601 ในหน่วยวัน ตั้งแต่ P0D ถึง P1826D เช่น ใช้ P90D เป็นเวลา 90 วัน หากไม่ต้องการกำหนดระยะเวลาการสมัครใช้บริการแบบชำระเงินขั้นต่ำ ให้ตั้งค่าช่องนี้เป็น P0D
  • allowMultipleClaims: ไม่บังคับ สมาชิกจะแลกรับข้อเสนอได้มากกว่า 1 ครั้งหรือไม่ หากfalse สมาชิกที่เคยอ้างสิทธิ์ข้อเสนอนี้จะไม่มีสิทธิ์รับข้อเสนอนี้อีก หาก true สมาชิกจะกลับมามีสิทธิ์อีกครั้งหลังจากเวลาใน minOfferCooldownDuration ผ่านไปนับตั้งแต่สิ้นสุดระยะเวลาที่ได้รับส่วนลดของข้อเสนอเพื่อการรักษาลูกค้าก่อนหน้า ค่าเริ่มต้นคือ false
  • minOfferCooldownDuration: ต้องระบุหาก allowMultipleClaims เป็น true ระยะเวลาขั้นต่ำที่ต้องผ่านไปหลังจากระยะเวลาที่ได้รับส่วนลดของข้อเสนอการรักษาผู้ใช้ก่อนหน้าสิ้นสุดลงก่อนที่สมาชิกจะมีสิทธิ์อีกครั้ง โดยเป็นระยะเวลา ISO 8601 ในหน่วยวัน ตั้งแต่ P1D ถึง P1826D เช่น ใช้ P180D เป็นเวลา 180 วัน อย่าตั้งค่าช่องนี้หาก allowMultipleClaims เป็น false หรือไม่ได้ตั้งค่า

ตัวอย่างต่อไปนี้แสดงช่อง startTime, endTime และ targeting ของออบเจ็กต์ SubscriptionOffer สำหรับข้อเสนอการรักษาฐานลูกค้าที่พร้อมให้บริการแก่สมาชิกที่ชำระเงินมาแล้วอย่างน้อย 90 วัน และสามารถรับสิทธิ์ได้อีกครั้งหลังจากส่วนลดการรักษาฐานลูกค้าครั้งก่อนสิ้นสุดลง 180 วัน

{
  "offerId": "retention-50off-2m",
  "startTime": "2026-12-01T00:00:00Z",
  "endTime": "2027-03-01T00:00:00Z",
  "targeting": {
    "retentionRule": {
      "scope": {
        "thisSubscription": {}
      },
      "minDuration": "P90D",
      "allowMultipleClaims": true,
      "minOfferCooldownDuration": "P180D"
    }
  }
}

กำหนดเป้าหมายข้อเสนอการรักษาผู้ใช้ไปยังสมาชิกที่เฉพาะเจาะจง

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

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

หากต้องการกำหนดเป้าหมายข้อเสนอเพื่อการรักษาลูกค้าไปยังสมาชิกที่เฉพาะเจาะจง ให้ทำดังนี้

  1. สร้างข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้ 1 คน เมื่อเรียกใช้เมธอด monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch หรือ monetization.subscriptions.basePlans.offers.batchUpdate ให้ตั้งค่า targeting เป็นออบเจ็กต์ retentionPerUserRule แทนออบเจ็กต์ retentionRule ออบเจ็กต์ RetentionPerUserTargetingRule ไม่มีฟิลด์ ข้อเสนอสามารถใช้ retentionRule หรือ retentionPerUserRule ได้ แต่จะใช้ทั้ง 2 อย่างไม่ได้

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

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

  2. กำหนดเป้าหมายข้อเสนอไปที่การสมัครใช้บริการ เรียกใช้เมธอด purchases.subscriptionsv2.activateOfferTargeting ด้วยชื่อแพ็กเกจของแอป, purchaseToken ของการสมัครใช้บริการ และ offerId ของข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    การเรียกที่สำเร็จจะแสดงรหัสสถานะ HTTP 204 No Content โดยไม่มีเนื้อหาการตอบกลับ Google Play Store จะจัดเก็บการกำหนดเป้าหมายไว้กับการสมัครใช้บริการ ดังนั้นคุณจึงไม่จำเป็นต้องเรียกใช้ API ในขณะที่สมาชิกยกเลิก ครั้งถัดไปที่สมาชิกเริ่มยกเลิกใน Google Play ทาง Google Play จะแสดงข้อเสนอได้ ตราบใดที่การสมัครใช้บริการเป็นไปตามข้อกำหนดของการได้รับสิทธิ์ การกำหนดเป้าหมายต่อผู้ใช้จะแทนที่เฉพาะกฎการมีสิทธิ์ที่ retentionRule กำหนดไว้เท่านั้น ข้อกำหนดของการได้รับสิทธิ์อื่นๆ ทั้งหมดและการตรวจสอบระดับแพลตฟอร์มที่ Google Play ดำเนินการ เช่น ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดระดับภูมิภาค จะยังคงมีผลบังคับใช้

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

    เมธอด activateOfferTargeting เป็นแบบ Idempotent หากคุณเรียกใช้เมธอดนี้สำหรับข้อเสนอที่กำหนดเป้าหมายไปยังการสมัครใช้บริการอยู่แล้ว การเรียกใช้จะสำเร็จและ Google Play จะอัปเดต activateTime ของข้อเสนอเป็นเวลาของคำขอล่าสุด

  3. นำการกำหนดเป้าหมายออกเมื่อจำเป็น หากไม่ต้องการให้สมาชิกได้รับข้อเสนออีกต่อไป เช่น เนื่องจากความเสี่ยงในการเลิกใช้งานมีการเปลี่ยนแปลง ให้เรียกใช้เมธอด purchases.subscriptionsv2.deactivateOfferTargeting โดยใช้ชื่อแพ็กเกจ, purchaseToken และ offerId เดียวกัน การเรียกที่สำเร็จจะแสดงรหัสสถานะ HTTP 204 No Content โดยไม่มีเนื้อหาการตอบกลับ

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

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

หากต้องการตรวจสอบว่าข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้รายการใดกำหนดเป้าหมายไปยังการสมัครใช้บริการ ให้เรียกใช้เมธอด purchases.subscriptionsv2.get ช่อง developerTargetedOffers ของรายการโฆษณาแต่ละรายการจะแสดงข้อเสนอที่กำหนดเป้าหมาย แต่ละรายการจะมี offerId และ activateTime เมื่อคุณเปิดใช้งานการกำหนดเป้าหมาย ดังนี้

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

จัดการข้อผิดพลาดในการกำหนดเป้าหมาย

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

รหัสสถานะ HTTP สถานะข้อผิดพลาด เมธอด สาเหตุ
404 Not Found NOT_FOUND ทั้งคู่ ไม่มี purchaseToken
400 Bad Request INVALID_ARGUMENT activateOfferTargeting offerId ไม่มีอยู่ในแพ็กเกจเริ่มต้นปัจจุบันของการสมัครใช้บริการ หรือข้อเสนอยังอยู่ในสถานะฉบับร่างและไม่เคยเปิดใช้งาน
400 Bad Request FAILED_PRECONDITION activateOfferTargeting ไม่ได้ตั้งค่า targeting ของข้อเสนอเป็น retentionPerUserRule
400 Bad Request FAILED_PRECONDITION activateOfferTargeting การสมัครใช้บริการหมดอายุแล้ว

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

จัดการเหตุการณ์ข้อเสนอเพื่อการรักษาลูกค้าในแบ็กเอนด์

เมื่อสมาชิกยอมรับข้อเสนอเพื่อการรักษาผู้ใช้ และเมื่อมีการต่ออายุแบบมีส่วนลดในภายหลัง Google Play จะส่ง RTDN ไปยังแบ็กเอนด์ของคุณ หลังจากได้รับการแจ้งเตือนแต่ละรายการแล้ว ให้เรียกใช้เมธอด purchases.subscriptionsv2.get ด้วย purchaseToken จากการแจ้งเตือนเพื่อรับสถานะการสมัครใช้บริการล่าสุด

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

ประเภทการแจ้งเตือน กรณีที่ส่ง สิ่งที่ต้องทำ
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) เมื่อสมาชิกยอมรับข้อเสนอเพื่อการรักษาลูกค้าในขั้นตอนการยกเลิก เรียกใช้เมธอด purchases.subscriptionsv2.get และตรวจสอบ planTransitionDetails transitionState มีค่าเป็น IN_PROGRESS การสมัครใช้บริการจะยังคงใช้งานได้และต่ออายุใหม่อัตโนมัติ ดังนั้นโปรดให้สิทธิ์เข้าถึงต่อไป
SUBSCRIPTION_RENEWED (2) เมื่อช่วงเวลาที่เรียกเก็บเงินปัจจุบันสิ้นสุดลงและการสมัครใช้บริการต่ออายุในราคาข้อเสนอเพื่อการรักษาลูกค้าที่ลดแล้ว เรียกใช้เมธอด purchases.subscriptionsv2.get, ยืนยันว่า offerDetails.offerId เป็นรหัสข้อเสนอเพื่อการรักษาผู้ใช้ไว้และ planTransitionDetails ไม่ปรากฏอีกต่อไป และขยายเวลาการเข้าถึงของผู้สมัครใช้บริการเป็น expiryTime ใหม่

ออบเจ็กต์ planTransitionDetails มีช่องต่อไปนี้

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

Google Play จะรวม planTransitionDetails ไว้เฉพาะในระหว่างที่รอดำเนินการเปลี่ยนเท่านั้น เมื่อการสมัครใช้บริการต่ออายุในราคาข้อเสนอเพื่อการรักษาลูกค้าที่ลดแล้ว การเปลี่ยนจะเสร็จสมบูรณ์และ Google Play จะนำ planTransitionDetails ออกจากการตอบกลับ purchases.subscriptionsv2.get จากนั้นรายการโฆษณาจะแสดงส่วนลดเพื่อรักษาลูกค้าที่ใช้งานอยู่

  • offerDetails.offerId คือรหัสของข้อเสนอการรักษาลูกค้าที่ยอมรับ
  • offerPhase จะมีราคา {"introductoryPrice": {}} ในช่วงเวลาที่เรียกเก็บเงินที่มีส่วนลด หลังจากช่วงเวลาที่เรียกเก็บเงินแบบมีส่วนลดสิ้นสุดลงและการสมัครใช้บริการต่ออายุในราคาแพ็กเกจเริ่มต้นแบบปกติ offerPhase จะเปลี่ยนเป็น {"basePrice": {}}

การตอบกลับหลังจากที่ผู้ติดตามยอมรับข้อเสนอ

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

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2026-12-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base"
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "planTransitionDetails": {
          "productId": "premium_monthly_sub",
          "basePlanId": "monthly-base",
          "offerId": "retention-50off-2m",
          "transitionInfo": {
            "transitionState": "IN_PROGRESS",
            "expectedTransitionTime": "2026-12-15T10:00:00Z"
          }
        }
      }
    }
  ]
}

การตอบกลับหลังจากการต่ออายุแบบมีส่วนลด

หลังจากวันที่ต่ออายุผ่านไปและระบบเรียกเก็บเงินจากสมาชิกในราคาที่มีส่วนลดแล้ว offerDetails.offerId จะแสดงข้อเสนอเพื่อการรักษาลูกค้า offerPhase จะแสดง introductoryPrice และการตอบกลับจะไม่รวม planTransitionDetails อีกต่อไป ดังนี้

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2027-01-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base",
        "offerId": "retention-50off-2m"
      },
      "offerPhase": {
        "introductoryPrice": {}
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      }
    }
  ]
}

การโต้ตอบในวงจรลูกค้า

โปรดคำนึงถึงลักษณะการทำงานต่อไปนี้เมื่อจัดการข้อเสนอเพื่อการรักษาลูกค้า

  • สิ้นสุดส่วนลด: หลังจากช่วงเวลาที่เรียกเก็บเงินที่ได้รับส่วนลดสิ้นสุดลง การสมัครใช้บริการจะต่ออายุโดยอัตโนมัติในราคาแพ็กเกจเริ่มต้นแบบปกติ คุณจะได้รับการแจ้งเตือนSUBSCRIPTION_RENEWEDเช่นเดียวกับการต่ออายุอื่นๆ และofferPhaseของรายการโฆษณาจะเปลี่ยนเป็น{"basePrice": {}} ผู้สมัครใช้บริการไม่จำเป็นต้องดำเนินการใดๆ
  • การกู้คืนการชำระเงินหลังจากส่วนลด: หากการต่ออายุในราคาแพ็กเกจเริ่มต้นแบบปกติหลังจากส่วนลดสิ้นสุดลงถูกปฏิเสธ และการสมัครใช้บริการเข้าสู่ระยะเวลาผ่อนผันหรือการระงับบัญชี การกู้คืนการชำระเงินจะเรียกเก็บเงินในราคาแพ็กเกจเริ่มต้นแบบปกติ Google Play จะไม่ใช้ส่วนลดของข้อเสนอการรักษาลูกค้าที่เสร็จสมบูรณ์ หากการชำระเงินสำหรับการต่ออายุที่มีส่วนลดครั้งแรกถูกปฏิเสธ ระบบจะเก็บการเปลี่ยนที่รอดำเนินการไว้ และจะใช้ราคาข้อเสนอการรักษาผู้ใช้เดิมเมื่อการชำระเงินได้รับการกู้คืน
  • การเรียกเก็บเงินแบบเลื่อนเวลา: หากคุณเรียกใช้เมธอด purchases.subscriptionsv2.defer ขณะที่การเปลี่ยนข้อเสนอเพื่อการรักษาลูกค้าอยู่ในสถานะ IN_PROGRESS ระบบจะคงการเปลี่ยนที่รอดำเนินการไว้และใช้กับการต่ออายุแบบเลื่อนเวลา หากต้องการดูวันที่ต่ออายุใหม่ ให้ตรวจสอบexpiryTimeของรายการโฆษณา
  • การเปลี่ยนแปลงแพ็กเกจก่อนการเปลี่ยนรุ่น: ข้อเสนอเพื่อการรักษาลูกค้าจะมีผลกับ purchaseToken ของการสมัครใช้บริการที่สมาชิกยอมรับเท่านั้น หากผู้สมัครใช้บริการเปลี่ยนไปใช้แพ็กเกจเริ่มต้นหรือการสมัครใช้บริการอื่นก่อนวันที่ expectedTransitionTime Google Play จะสร้างโทเค็นการซื้อใหม่ ยกเลิกการเปลี่ยนที่กำหนดเวลาไว้ และล้าง planTransitionDetails ข้อเสนอการรักษาลูกค้าที่รอดำเนินการจะไม่มีผลกับแพ็กเกจใหม่
  • การยกเลิกและการกู้คืน: หากผู้ใช้ยกเลิกการสมัครใช้บริการหลังจากยอมรับข้อเสนอเพื่อรักษาลูกค้า การเปลี่ยนแพ็กเกจที่กำหนดเวลาไว้จะยังคงรอดำเนินการ และ transitionState จะยังคงเป็น IN_PROGRESS หากผู้สมัครใช้บริการกู้คืนการสมัครใช้บริการก่อนหมดอายุ ส่วนลดของข้อเสนอการรักษาผู้ใช้จะยังคงมีผลเมื่อต่ออายุ
  • การหมดอายุและการสมัครอีกครั้ง: หากการสมัครใช้บริการหมดอายุโดยไม่มีการกู้คืน Google Play จะยกเลิกการเปลี่ยนที่รอดำเนินการ หากผู้ใช้สมัครใช้บริการอีกครั้งหรือลงชื่อสมัครใช้อีกครั้งในภายหลัง Google Play จะสร้างการซื้อการสมัครใช้บริการใหม่ และข้อเสนอการรักษาผู้ใช้ที่ยอมรับก่อนหน้านี้จะไม่มีผล
  • การเปลี่ยนแปลงข้อเสนอ: หากคุณเปลี่ยนส่วนลดหรือช่วงเวลาที่เรียกเก็บเงินของข้อเสนอเพื่อการรักษาลูกค้า การเปลี่ยนแปลงจะมีผลกับการแลกสิทธิ์ในอนาคตเท่านั้น สมาชิกที่ยอมรับข้อเสนอแล้วจะยังคงใช้ข้อกำหนดเดิม
  • การปิดใช้งานข้อเสนอ: หากคุณปิดใช้งานข้อเสนอเพื่อการรักษาผู้ใช้ไว้ หรือข้อเสนอถึงวันที่สิ้นสุดแล้ว สมาชิกที่ยอมรับข้อเสนอไปแล้วจะยังคงได้รับข้อกำหนดตามที่ตกลงไว้ สมาชิกที่เปลี่ยนไปใช้ IN_PROGRESS จะยังคงได้รับส่วนลดในการต่ออายุครั้งถัดไป และสมาชิกที่อยู่ในช่วงเวลาที่เรียกเก็บเงินที่มีส่วนลดอยู่แล้วจะยังคงได้รับส่วนลดตามระยะเวลาที่ตกลงกันไว้ทั้งหมด
  • การเปลี่ยนแปลงราคา: การเปลี่ยนแปลงราคาแพ็กเกจเริ่มต้นจะยังคงมีผลอยู่ Google Play จะย้ายข้อมูลสมาชิกไปยังราคาใหม่ก็ต่อเมื่อสมาชิกชำระเงินในราคาปกติและไม่มีการเปลี่ยนข้อเสนอการรักษาผู้ใช้ที่รอดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่เปลี่ยนราคาการสมัครใช้บริการ
  • การคืนเงิน: คุณคืนเงินให้แก่สมาชิกได้ด้วย API การคืนเงินและการเพิกถอนมาตรฐาน เช่น เมธอด purchases.subscriptionsv2.revoke การดำเนินการนี้จะคืนเงินสำหรับการชำระเงินครั้งล่าสุดและสิ้นสุดสิทธิ์เข้าถึงของผู้สมัครใช้บริการ

ทดสอบข้อเสนอการรักษาผู้ใช้เดิม

Google Play จะแสดงเฉพาะข้อเสนอการรักษาผู้ใช้ที่ใช้งานอยู่ในขั้นตอนการยกเลิก และจะประเมินกฎการมีสิทธิ์ตามเวลาจริงในปฏิทิน หากต้องการทดสอบข้อเสนอการรักษาลูกค้าด้วยบัญชีผู้ทดสอบที่ได้รับอนุญาต ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้

ก่อนใช้วิธีใดวิธีหนึ่ง ให้ไปที่การตั้งค่า > การทดสอบใบอนุญาตใน Google Play Console แล้วเพิ่มบัญชี Google ทดสอบเป็นผู้ทดสอบใบอนุญาต

ทดสอบข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้

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

  1. สร้างข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้ภายใต้แพ็กเกจเริ่มต้น แล้วเปิดใช้งาน ใน Google Play Console ให้เลือกข้อเสนอเพื่อรักษาผู้ใช้ในระดับผู้ใช้ เมื่อใช้ Google Play Developer API ให้ตั้งค่า targeting เป็นออบเจ็กต์ retentionPerUserRule ดูรายละเอียดได้ที่กำหนดเป้าหมายข้อเสนอเพื่อการรักษาผู้ใช้ไว้สำหรับสมาชิกที่เฉพาะเจาะจง
  2. หากเพิ่งเปิดใช้งานข้อเสนอ ให้รอ 10-15 นาทีเพื่อให้การเปลี่ยนแปลงมีผล แล้วจึงล้างแคชของแอป Google Play Store
  3. ในอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบใบอนุญาต แล้วซื้อแพ็กเกจเริ่มต้นในแอป
  4. จากแบ็กเอนด์ ให้เรียกใช้เมธอด purchases.subscriptionsv2.activateOfferTargeting พร้อมชื่อแพ็กเกจของแอป, purchaseToken ของผู้ทดสอบที่ได้รับอนุญาต และ offerId ของข้อเสนอเพื่อการรักษาลูกค้า
  5. ในแอป Google Play Store ให้ไปที่การชำระเงินและการสมัครใช้บริการ > การสมัครใช้บริการ เลือกการสมัครใช้บริการที่ต้องการ แล้วแตะยกเลิกการสมัครใช้บริการ ข้อเสนอเพื่อรักษาผู้ใช้จะปรากฏในขั้นตอนการยกเลิก
  6. ยอมรับข้อเสนอ แล้วยืนยันว่าแบ็กเอนด์ของคุณได้รับ RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED และจัดการการต่ออายุที่มีส่วนลด

ทดสอบข้อเสนอการรักษาผู้ใช้ตามกฎ

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

  1. ในแอปทดสอบหรือในแพ็กเกจเริ่มต้นทดสอบ ให้สร้างข้อเสนอการรักษาผู้ใช้ตามกฎ และตั้งค่า minDuration เป็น P0D (0 วัน) ใน Google Play Console ให้เลือกข้อเสนอการรักษาผู้ใช้ระดับกลุ่มประชากรตามรุ่น เมื่อใช้ Google Play Developer API ให้ตั้งค่า targeting เป็นออบเจ็กต์ retentionRule โปรดดูรายละเอียดที่หัวข้อตั้งค่ากฎการมีสิทธิ์คงรักษาไว้
  2. เปิดใช้งานข้อเสนอ รอ 10-15 นาทีเพื่อให้การเปลี่ยนแปลงมีผล แล้วล้างแคชของแอป Google Play Store
  3. ในอุปกรณ์ทดสอบ ให้ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบใบอนุญาต แล้วซื้อแพ็กเกจเริ่มต้นแบบทดสอบ
  4. ในแอป Google Play Store ให้ไปที่การชำระเงินและการสมัครใช้บริการ > การสมัครใช้บริการ เลือกการสมัครใช้บริการที่ต้องการ แล้วแตะยกเลิกการสมัครใช้บริการ เนื่องจากข้อเสนอไม่ได้กำหนดระยะเวลาการสมัครใช้บริการแบบชำระเงินขั้นต่ำ คุณจึงเริ่มขั้นตอนการยกเลิกได้ทันทีหลังจากซื้อ ข้อเสนอเพื่อรักษาผู้ใช้จะปรากฏในขั้นตอนการยกเลิก
  5. ยอมรับข้อเสนอ แล้วยืนยันว่าแบ็กเอนด์ของคุณได้รับ RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED และจัดการการต่ออายุที่มีส่วนลด

หลังจากยืนยันการผสานรวมแล้ว ให้สร้างและเปิดใช้งานข้อเสนอการรักษาผู้ใช้ตามกฎในแพ็กเกจเริ่มต้นเวอร์ชันที่ใช้งานจริง

แก้ปัญหาการทดสอบข้อเสนอการรักษาผู้ใช้

หากข้อเสนอการรักษาลูกค้าไม่ปรากฏขึ้น ให้ตรวจสอบสิ่งต่อไปนี้

  • ข้อเสนอเพื่อการรักษาลูกค้าใช้งานอยู่ และเวลาปัจจุบันอยู่ระหว่างstartTimeและendTimeของข้อเสนอ หากคุณตั้งค่าไว้
  • สำหรับข้อเสนอการคงผู้ใช้ไว้ต่อผู้ใช้ ช่อง developerTargetedOffers ในการตอบกลับ purchases.subscriptionsv2.get สำหรับ purchaseToken ของผู้ทดสอบใบอนุญาตจะมีข้อเสนออยู่
  • การสมัครใช้บริการเป็นการสมัครใช้บริการรายการเดียว ไม่ใช่การสมัครใช้บริการที่มีส่วนเสริม
  • การสมัครใช้บริการไม่ได้อยู่ในระยะเวลาผ่อนผัน ไม่ได้อยู่ระหว่างการระงับบัญชี หรือไม่ได้หยุดชั่วคราว
  • การสมัครใช้บริการไม่มีการเปลี่ยนแปลงแพ็กเกจหรือการเปลี่ยนแปลงราคาที่รอดำเนินการ
  • การต่ออายุครั้งถัดไปจะเป็นราคาแพ็กเกจเริ่มต้นแบบปกติ สำหรับช่วงทดลองใช้ฟรีและข้อเสนอช่วงแนะนำ ข้อเสนอการรักษาลูกค้าจะใช้ได้เฉพาะในช่วงเวลาที่เรียกเก็บเงินสุดท้ายของช่วงทดลองใช้หรือช่วงแนะนำเท่านั้น
  • คุณรอเป็นเวลา 10-15 นาทีหลังจากเปิดใช้งานหรือเปลี่ยนข้อเสนอ และล้างแคชของแอป Play Store แล้ว