ตรวจหาและส่งมอบไอเทมแบบครั้งเดียว

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

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

1. คลิกแต้ม Play 2. คลิกแท็บใช้ เพื่อดูไอเทม 3. เลือกไอเทมแล้วคลิกใช้แต้ม เพื่อทำการซื้อให้เสร็จสมบูรณ์ 4. รับไอเทม
ภาพหน้าจอ ภาพหน้าจอ ภาพหน้าจอ ภาพหน้าจอ

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

ก่อนเริ่มต้นใช้งาน

ก่อนตรวจหาและมอบผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว คุณต้อง สร้างผลิตภัณฑ์และโปรโมชัน Play Points ก่อน

ข้อกำหนดในการนำส่ง

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

เวลาส่ง

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

ข้อความส่ง

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

รูปแบบข้อความที่จำเป็นมีดังนี้

  • ข้อความที่ชัดเจนว่าได้รับไอเทมแล้ว

  • ระบุชื่อไอเทมอย่างชัดเจนและอ้างอิงถึง "แต้ม Play" เพื่อให้ผู้ใช้แยกแยะไอเทมดังกล่าวออกจากเนื้อหาอื่นๆ ที่ได้รับ

  • ชื่อไอเทมต้องระบุสกุลเงินที่ถูกต้องของไอเทมด้วย หากมีไอเทมที่คล้ายกันแต่มีสกุลเงินหลายสกุล

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

ตัวอย่างข้อความ

"ได้รับไอเทมแล้ว! คุณเพิ่งได้รับเพชร 100 เม็ดด้วยแต้ม Play ดำเนินการต่อ"

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

ตรวจหาไอเทมที่ได้รับจากภายนอกเกม

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

แสดงการยืนยันการส่ง

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

ข้อมูลอัปเดตสำหรับเอนจินเกมบางรายการ

สิ่งที่ควรพิจารณาสำหรับเอนจินเกมบางรายการมีดังนี้

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

  • หากเกมของคุณสร้างด้วย Cocos2d-x หรือ Unreal Engine (C/C++) คุณจะต้องเขียนโค้ด JNI ที่เรียกใช้ Java API จากโค้ด C/C++

แนวทางปฏิบัติแนะนำฝั่งเซิร์ฟเวอร์

ส่วนนี้มีแนวทางปฏิบัติแนะนำฝั่งเซิร์ฟเวอร์สำหรับใช้กับโปรโมชัน Play Points

  • หากคุณเรียก Purchases.products: get ในเซิร์ฟเวอร์ ให้ตรวจสอบว่าคุณต้องจัดการไอเทมที่แลกจากรางวัล Google Play และผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวอื่นๆ แยกกันตามค่า productId หรือไม่

  • หากคุณใช้ Onetimeproducts: list ในเซิร์ฟเวอร์ ให้ตรวจสอบว่าคุณต้องแยกไอเทมที่แลกจากรางวัล Play ออกจากไอเทมแบบเรียกเก็บเงินครั้งเดียวอื่นๆ ตามค่า productId หรือไม่

  • ตรวจสอบแนวทางปฏิบัติแนะนำต่อไปนี้เพื่อดูว่าคุณต้องทำการเปลี่ยนแปลงเพิ่มเติมหรือไม่

การแก้ปัญหา

ส่วนนี้มีคำแนะนำสำหรับสถานการณ์ที่อาจทำให้เกิดการสอบถามจากลูกค้า

บัญชีผู้ใช้หลายบัญชี

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

ไอเทมล่าช้าหรือสูญหาย

หากผู้เล่นพบปัญหาไอเทมรางวัลล่าช้าหรือสูญหาย โปรดดู คู่มือการแก้ปัญหาสำหรับการซื้อในแอป ในเอกสารประกอบความช่วยเหลือของ Google Play