รางวัลจากการทดสอบ

Play Billing Lab เป็นแอปที่ใช้ร่วมกันซึ่งช่วยให้คุณทดสอบการผสานรวมกับระบบการเรียกเก็บเงินของ Google Play ได้ คุณสามารถใช้การทดสอบเวอร์ชันตัวอย่างสำหรับการซื้อนอกแอป (OOAP) ของ Play Billing Lab เพื่อตรวจสอบว่าแบ็กเอนด์ได้รับการกำหนดค่าอย่างเหมาะสมเพื่อจัดการไอเทมที่ได้รับนอกแอป ซึ่งรวมถึงรางวัล Play Games

ฟีเจอร์เวอร์ชันตัวอย่างของ OOAP ช่วยให้คุณเลือกผลิตภัณฑ์หรือข้อเสนอที่เฉพาะเจาะจงเพื่อแสดงในแพลตฟอร์มนอกแอป เช่น หน้ารายละเอียดแอปใน Google Play และยืนยันขั้นตอนการซื้อและการให้สิทธิ์ตั้งแต่ต้นจนจบได้

สิ่งที่ต้องมีก่อน

ก่อนใช้ Play Billing Lab เพื่อทดสอบขั้นตอนการซื้อนอกแอป (OOAP) เพื่อตรวจสอบการตั้งค่าสำหรับรางวัล Play Games โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้

  1. ลงทะเบียนเข้าร่วมโปรแกรมรางวัล Play Games EAP
  2. สถานะผู้ทดสอบที่ได้รับอนุญาต: บัญชีทดสอบต้องลงทะเบียนเป็นผู้ทดสอบที่ได้รับอนุญาตสำหรับเกม ดูรายละเอียดได้ที่เอกสารประกอบสำหรับผู้ทดสอบที่ได้รับอนุญาตของ Google Play

    หมายเหตุ: แม้ว่าผู้ใช้ทุกคนจะดูแอป Play Billing Lab ได้ แต่เฉพาะผู้ทดสอบที่ได้รับอนุญาตของนักพัฒนาแอป EAP ในรายการที่อนุญาตเท่านั้นที่สามารถกำหนดค่าและทริกเกอร์การลบล้าง OOAP ได้

  3. ความสอดคล้องกันของบัญชีในแพลตฟอร์มต่างๆ: คุณต้องลงชื่อเข้าใช้ Play Billing Lab และ Google Play Store โดยใช้บัญชีผู้ทดสอบที่ได้รับอนุญาตบัญชีเดียวกัน หากบัญชีไม่ตรงกัน Play Store อาจไม่แสดงผลิตภัณฑ์หรือข้อเสนอทดสอบที่ลบล้าง หรือดำเนินการซื้อทดสอบให้เสร็จสมบูรณ์

ดาวน์โหลดและติดตั้ง

คุณดาวน์โหลดและติดตั้ง Play Billing Lab ได้จาก Google Play โดยทำดังนี้

คู่มือการผสานรวมและการทดสอบ EAP แบบทีละขั้นตอน

ขั้นตอนต่อไปนี้จะอธิบายวิธีผสานรวมและทดสอบรางวัล Play Games โดยใช้ Play Billing Lab

ขั้นตอนที่ 1: เปิด Play Billing Lab และลงชื่อเข้าใช้

เมื่อเปิด Play Billing Lab เป็นครั้งแรกหลังการติดตั้ง ให้ทำดังนี้

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

ขั้นตอนที่ 3: ระบุชื่อแพ็กเกจแอปและรหัสสินค้า

ในหน้าจอการตั้งค่า OOAP ให้ป้อนตัวระบุแอปที่จำเป็นดังนี้

  1. ชื่อแพ็กเกจ: ชื่อแพ็กเกจ Android ที่ถูกต้องทุกประการของแอป (เช่น com.example.app)
  2. ประเภทสินค้า: ใช้เมนูแบบเลื่อนลงเพื่อเลือกผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว (ไอเทมที่ซื้อในแอป) หรือการสมัครใช้บริการ
  3. รหัสสินค้า (SKU): รหัสสินค้าของไอเทมที่ซื้อในแอปหรือการสมัครใช้บริการที่ต้องการทดสอบ
ระบุชื่อแพ็กเกจแอปและรหัสสินค้า
ระบุชื่อแพ็กเกจแอปและรหัสสินค้า

ขั้นตอนที่ 4: เลือกข้อเสนอที่มีสิทธิ์

หลังจากที่คุณป้อนชื่อแพ็กเกจ รหัสสินค้า และประเภทสินค้าแล้ว Play Billing Lab จะค้นหาแบ็กเอนด์และแสดงรายการข้อเสนอที่ใช้ได้สำหรับสินค้านั้น

  • สำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว: เลือกตัวเลือกการซื้อหรือข้อเสนอที่เกี่ยวข้อง

    เลือกข้อเสนอที่มีสิทธิ์
    เลือกข้อเสนอที่มีสิทธิ์

ขั้นตอนที่ 5: เริ่มการทดสอบ OOAP

หลังจากเลือกข้อเสนอแล้ว ให้แตะเริ่มการทดสอบ ระบบจะบันทึกการกำหนดค่าและซิงค์กับเซิร์ฟเวอร์แบ็กเอนด์ของ Google Play

หลังจากเปิดใช้งาน แดชบอร์ดจะแสดงป้ายใช้งานอยู่ในการ์ดการซื้อนอกแอป ซึ่งแสดงชื่อแพ็กเกจ รหัสสินค้า (SKU) และระยะเวลาที่เหลือที่กำหนดค่าไว้

  • กรอบเวลาการทดสอบ: การกำหนดค่าการทดสอบ OOAP ที่ทำงานอยู่จะยังคงทำงานเป็นเวลา 2 ชั่วโมงโดยค่าเริ่มต้นก่อนที่จะหมดอายุโดยอัตโนมัติ
  • การลบล้างแบ็กเอนด์: ขณะที่ใช้งานอยู่ การกำหนดค่าจะแสดงเป็นลำดับความสำคัญสูงสุดในแพลตฟอร์ม OOAP ต่างๆ (เช่น หน้ารายละเอียดแอปใน Play Store)

    เริ่มการทดสอบ OOAP
    เริ่มการทดสอบ OOAP

ขั้นตอนที่ 6: ทดสอบขั้นตอนการได้ผู้ใช้ใหม่ตั้งแต่ต้นจนจบสำหรับข้อเสนอนอกแอป

ขณะที่การทดสอบ OOAP ทำงานอยู่ใน Play Billing Lab ให้เปิดแอป Google Play Store ที่ลงชื่อเข้าใช้ด้วยบัญชีผู้ทดสอบที่ได้รับอนุญาตบัญชีเดียวกัน โดยทำดังนี้

  1. ล้างแคชของ Google Play Store
    1. เปิดแอปการตั้งค่าบนอุปกรณ์
    2. แตะแอป > Google Play Store
    3. แตะพื้นที่เก็บข้อมูลและแคช จากนั้นแตะล้างแคชและล้างพื้นที่เก็บข้อมูล
  2. เปิดแอป Google Play Store
  3. ไปที่หน้ารายละเอียดแอป
  4. ทำการซื้อทดสอบให้เสร็จสมบูรณ์ (การวางซ้อน Play Express): แตะการ์ดสำหรับรายการนั้นๆ ภาพซ้อนทับ Bottom Sheet ของ Google Play Express Checkout แบบเนทีฟใน Play Store

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

    • หลังจากซื้อสำเร็จแล้ว ให้ตรวจสอบว่า Google Play ส่งการแจ้งเตือนแบบเรียลไทม์สำหรับนักพัฒนาแอป (RTDN) ไปยังเซิร์ฟเวอร์แบ็กเอนด์ของคุณ
      • หมายเหตุ: Rewards จะส่ง RTDN ด้วย
    • ตรวจสอบว่าเซิร์ฟเวอร์เรียกใช้ Google Play Developer API เพื่อรับทราบการซื้อและให้สิทธิ์แก่ผู้ใช้
    • ตรวจสอบประวัติการซื้อของผู้ใช้ในแอป Play Store เพื่อยืนยันว่าระบบบันทึกคำสั่งซื้อทดสอบแล้ว

ขั้นตอนที่ 7: หยุดและล้างการทดสอบ OOAP

หลังจากทดสอบเสร็จแล้ว ให้ทำดังนี้

  1. ไปที่หน้าการซื้อนอกแอป
  2. แตะล้างการทดสอบเพื่อหยุดการทดสอบ OOAP และล้างการตั้งค่าการทดสอบ OOAP
หยุดและล้างการทดสอบ OOAP
ผ่านการทดสอบ OOAP

การแก้ไขการกำหนดค่าการทดสอบ

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

ซึ่งจะต้องหยุดและล้างการทดสอบ OOAP ปัจจุบัน

วิธีแก้ไขผลิตภัณฑ์หรือข้อเสนอ

หากคุณกำลังทำการทดสอบ OOAP และต้องการทดสอบผลิตภัณฑ์หรือข้อเสนออื่น ให้ทำดังนี้

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

วิธีทดสอบการกำหนดราคาในร้านด้วยการลบล้างประเทศ

Play Billing Lab ช่วยให้คุณลบล้างประเทศใน Google Play Store เพื่อทดสอบการกำหนดราคาตามภูมิภาคและรูปแบบสกุลเงินได้ อย่างไรก็ตาม การเปลี่ยนแปลงประเทศต้องซิงค์กับการทดสอบ OOAP อย่างสมบูรณ์ ดังนี้

  1. หยุดการทดสอบ OOAP ที่ใช้งานอยู่: หากคุณพยายามแก้ไขการลบล้างประเทศขณะที่การทดสอบ OOAP ทำงานอยู่ ไม่ว่าจะจากแดชบอร์ดหรือหน้าการซื้อนอกแอป Play Billing Lab จะแสดงคำเตือนที่แจ้งให้คุณหยุดการทดสอบก่อน การยืนยันโดยแตะหยุดการทดสอบจะหยุดการทดสอบ OOAP ปัจจุบันและล้างข้อมูลทดสอบ

  2. ตั้งค่าการลบล้างประเทศ: หลังจากหยุดการทดสอบ OOAP แล้ว คุณจะแก้ไขการตั้งค่าประเทศได้ในหน้าการตั้งค่าการกำหนดค่า เลือกประเทศเป้าหมาย (เช่น ญี่ปุ่น สหราชอาณาจักร) แล้วแตะใช้

  3. เริ่มการทดสอบ OOAP อีกครั้ง: เมื่อการลบล้างประเทศทำงานแล้ว ให้กลับไปที่การ์ดการซื้อนอกแอป เลือกไอเทมและข้อเสนอ แล้วแตะเริ่มการทดสอบ

    ตอนนี้แดชบอร์ดจะแสดงทั้งการลบล้างประเทศที่ใช้งานอยู่และการทดสอบ OOAP ที่ใช้งานอยู่

  4. ยืนยันราคาในร้านใน Play Store: เปิด Play Store และไปที่หน้ารายละเอียดของแอป ตอนนี้การ์ด UI ที่แสดงและ Bottom Sheet ของ Play Express จะแสดงราคาผลิตภัณฑ์ที่จัดรูปแบบเป็นสกุลเงินท้องถิ่นของประเทศที่คุณลบล้าง

ทดสอบการกำหนดราคาในร้านด้วยการลบล้างระดับประเทศ
ทดสอบการกำหนดราคาในร้านที่แปลแล้วด้วยการลบล้างระดับประเทศ

การแก้ปัญหาและคำถามที่พบบ่อย

ทำไมข้อเสนอทดสอบที่ฉันกำหนดค่าไว้จึงไม่ปรากฏในหน้ารายละเอียดแอปใน Play Store

  • ความสอดคล้องกันของบัญชี: ตรวจสอบว่าบัญชีที่ลงชื่อเข้าใช้แอป Play Store เป็นบัญชีเดียวกับที่ลงชื่อเข้าใช้ Play Billing Lab
  • รายการที่อนุญาตของ EAP และสถานะผู้ทดสอบที่ได้รับอนุญาต: ตรวจสอบว่าบัญชีนักพัฒนาแอปของคุณอยู่ในรายการที่อนุญาตสำหรับ EAP เวอร์ชันตัวอย่างของ OOAP ใน Play Billing Lab และบัญชีของคุณแสดงเป็นผู้ทดสอบที่ได้รับอนุญาตซึ่งใช้งานอยู่ใน Play Console
  • การหมดอายุ: การทดสอบ OOAP ที่ใช้งานอยู่จะหมดอายุหลังจากผ่านไป 2 ชั่วโมง เปิด Play Billing Lab เพื่อตรวจสอบว่าแท็กทดสอบเปลี่ยนเป็นหมดอายุแล้วหรือยัง หากเป็นเช่นนั้น ให้เริ่มการทดสอบใหม่

ทำไมฉันจึงเลือกหรือดูข้อเสนอไม่ได้เมื่อตั้งค่าผลิตภัณฑ์ใน Play Billing Lab

  • การมีสิทธิ์รับข้อเสนอ: Play Billing Lab จะแสดงเฉพาะข้อเสนอที่บัญชีผู้ทดสอบที่เฉพาะเจาะจงของคุณมีสิทธิ์ซื้อในปัจจุบัน

เหตุใดการซื้อทดสอบจึงไม่สำเร็จในหน้าต่างวางซ้อน Play Express

  • ตรวจสอบว่าอุปกรณ์ทดสอบใช้ Android 12 (ระดับ API 31) ขึ้นไปและติดตั้ง Google Play Store เวอร์ชันล่าสุดไว้
  • ตรวจสอบเว็บฮุค RTDN ของแบ็กเอนด์แอปและการผสานรวม API เมื่อทดสอบผ่าน Play Store การซื้อจะเกิดขึ้นนอก UI มาตรฐานของแอป เซิร์ฟเวอร์แบ็กเอนด์ของคุณต้องรับข้อความ RTDN จาก Google Play ได้อย่างน่าเชื่อถือและรับทราบการซื้อแบบอะซิงโครนัส

ฉันจะหยุดหรือล้างการทดสอบที่ดำเนินอยู่ก่อนที่ตัวจับเวลา 2 ชั่วโมงจะหมดอายุได้อย่างไร

  • เปิด Play Billing Lab ค้นหาการ์ดที่ใช้งานอยู่ (การซื้อนอกแอปหรือการตั้งค่าการกำหนดค่า) แล้วแตะหยุดหรือลบ เมื่อได้รับข้อความแจ้ง ให้ยืนยันตัวเลือกของคุณ ระบบจะนำการลบล้างออกจากเซิร์ฟเวอร์ Google Play ทันที