เอกสารนี้อธิบายวิธีผสานรวมรางวัลพิเศษเข้ากับเกมโดยใช้ Google Play Console หรือการเรียก API โดยจะครอบคลุม องค์ประกอบและสถานะที่สำคัญของความสำเร็จ รวมถึงอธิบายวิธีสร้าง นำเข้า และจัดการความสำเร็จ
ก่อนเริ่มต้น
อ่านหลักเกณฑ์ ออกแบบความสำเร็จคุณภาพสูง
ตรวจสอบคำศัพท์ในพื้นฐานของความสำเร็จ
สร้างหรือนำเข้าความสำเร็จใหม่
หากต้องการใช้ความสำเร็จตั้งแต่ต้น ให้ทำตามขั้นตอนต่อไปนี้
เพิ่มรางวัลพิเศษ
คุณสร้างรางวัลพิเศษเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้
- สร้างรางวัลพิเศษ: เพิ่มคำจำกัดความและข้อมูลเมตาสำหรับรางวัลพิเศษแต่ละรายการทีละรายการ
- นำเข้ารางวัลพิเศษ: นำเข้าคำจำกัดความและข้อมูลเมตาอื่นๆ สำหรับรางวัลพิเศษหลายรายการพร้อมกันในขั้นตอนเดียว
สร้างรางวัลพิเศษ
หากต้องการสร้างรางวัลพิเศษสำหรับเกมใหม่และเกมที่ยังไม่ได้เผยแพร่ ให้ทำตามขั้นตอนต่อไปนี้
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกสร้างรางวัลพิเศษ
- กรอกแบบฟอร์มในหน้าเพิ่มรางวัลพิเศษ
- คลิกบันทึกเป็นฉบับร่าง
- หลังจากสร้างรางวัลพิเศษแล้ว คุณต้องเผยแพร่รางวัลพิเศษ
นําเข้ารางวัลพิเศษ
หากต้องการเพิ่มรางวัลพิเศษหลายรายการในเกมพร้อมกัน ให้ทำตามขั้นตอนต่อไปนี้
- สร้างไฟล์ ZIP ที่มีรางวัลพิเศษของคุณ
- อัปโหลดไฟล์
ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ ZIP ได้ที่หลักเกณฑ์สำหรับไฟล์ ZIP
วิธีนำเข้ารางวัลพิเศษ
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกนำเข้ารางวัลพิเศษ
- ในหน้านำเข้ารางวัลพิเศษ ให้คลิกอัปโหลด
- เลือกไฟล์ ZIP เพื่ออัปโหลด
- คลิกบันทึกเป็นฉบับร่าง
- หลังจากนำเข้ารางวัลพิเศษแล้ว คุณต้อง เผยแพร่เกม
หลักเกณฑ์เกี่ยวกับไฟล์ ZIP
คุณสามารถนำเข้ารางวัลพิเศษหลายรายการพร้อมกันได้โดยใช้ไฟล์ ZIP ดูชื่อไฟล์ที่แน่นอนที่จะใช้ในไฟล์ ZIP ได้จากตารางต่อไปนี้
ชื่อไฟล์ | จำเป็นหรือไม่บังคับ | ค่าที่ยอมรับ |
---|---|---|
AchievementsMetadata.csv
|
ต้องระบุ | ข้อมูลเมตาสำหรับรางวัลพิเศษแต่ละรายการ ดูแอตทริบิวต์ |
AchievementsLocalizations.csv
|
ไม่บังคับ | ระบุคำแปลสำหรับชื่อและคำอธิบายของรางวัลพิเศษ |
AchievementsIconMappings.csv
|
ไม่บังคับ | แมปรางวัลพิเศษกับไฟล์ไอคอน |
ไฟล์ไอคอน | ไม่บังคับ | ไอคอนในรูปแบบ PNG, JPEG หรือ JPG |
ข้อกำหนดเกี่ยวกับไฟล์ ZIP มีดังนี้
- ไม่มีไดเรกทอรีย่อย
- ชื่อไฟล์ไม่ซ้ำกัน
- ไฟล์ CSV, PNG, JPEG หรือ JPG เท่านั้น
- ไฟล์ CSV ต้องไม่มีแถวส่วนหัว
- แต่ละไฟล์ต้องมีขนาดไม่เกิน 1 MB
- ไฟล์ ZIP ควรมีไฟล์ไม่เกิน 203 ไฟล์
- ขนาดไฟล์ ZIP รวมต้องไม่เกิน 200 MB
รูปแบบของไฟล์ AchievementsMetadata.csv
ไฟล์ AchievementsMetadata.csv
มีข้อมูลเมตาสำหรับรางวัลพิเศษแต่ละรายการ โดยควรระบุข้อมูลเป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้
ส่วนหัวคอลัมน์ CSV | จำเป็นหรือไม่บังคับ | ค่าที่ยอมรับ |
---|---|---|
ชื่อ | จำเป็น | มีอักขระได้สูงสุด 100 ตัว |
คำอธิบาย | ไม่บังคับ | มีอักขระได้สูงสุด 500 ตัว |
ค่าที่เพิ่มขึ้น | ไม่บังคับ | True หรือ False
|
จำนวนขั้นตอนที่ต้องทำ | ต้องระบุหาก Incremental Value เป็น True.
|
ตัวเลข (ไม่มีเศษส่วนหรือทศนิยม) |
สถานะเริ่มต้น | ต้องระบุ | Hidden หรือ Revealed
|
คะแนน | จำเป็น | ตัวเลขที่เพิ่มขึ้นทีละ 5 และค่าต้องอยู่ในช่วง 5 ถึง 200 |
ลำดับในรายการ | ไม่บังคับ | ตัวเลข (ไม่มีเศษส่วนหรือทศนิยม และมากกว่า 0) |
ข้อกำหนดของไฟล์ AchievementsMetadata.csv มีดังนี้
- แต่ละแถวต้องมี 7 ค่า หากต้องการละเว้นค่า ให้ปล่อยค่านั้นว่างไว้
- ระบบจะใช้ฟิลด์
Name
และDescription
เป็นภาษาเริ่มต้น Name
ควรไม่ซ้ำกันสำหรับรางวัลพิเศษทั้งหมด- ช่องที่ไม่ควรมีคอมมา ได้แก่
Name
และDescription
ตัวอย่างไฟล์ AchievementsMetadata.csv
Achievement1,Achievement One,True,100,Hidden,5,20 Achievement2,Achievement Two,False,,Revealed,10,30
รูปแบบของไฟล์ AchievementsLocalizations.csv
ไฟล์ AchievementsLocalizations.csv
เป็นไฟล์ที่ไม่บังคับซึ่งตั้งค่า
ข้อมูลทั้งหมดที่จำเป็นในการอธิบายรางวัลพิเศษแต่ละรายการให้แก่ผู้ใช้ใน
ภาษาต่างๆ รางวัลพิเศษจะได้รับการแปลให้สอดคล้องกับภาษาที่ระบุสำหรับเกม
โดยควรระบุข้อมูลเป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้
Name, Localized name, Localized description, locale
ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้
ส่วนหัวคอลัมน์ CSV | จำเป็นหรือไม่บังคับ | คำอธิบาย | ค่าที่ยอมรับ |
---|---|---|---|
ชื่อ | ต้องระบุ | ต้องตรงกับคอลัมน์ Name จาก AchievementsMetadata.csv
|
มีอักขระได้สูงสุด 100 ตัว |
ชื่อที่แปลแล้ว | จำเป็น | ชื่อที่แปลแล้วสำหรับรางวัลพิเศษ | มีอักขระได้สูงสุด 100 ตัว |
คำอธิบายที่แปลแล้ว | ไม่บังคับ | คำอธิบายที่แปลแล้วสำหรับรางวัลพิเศษในภาษาที่ระบุ | มีอักขระได้สูงสุด 500 ตัว |
ภาษา | ต้องระบุ | รหัสภาษา เช่น en-US
|
เพิ่มคำแปลสำหรับเกมก่อนระบุภาษา โปรดทราบว่าคุณ
ไม่สามารถระบุภาษาเริ่มต้นได้
ดูรหัสภาษาที่รองรับได้ที่รายการ ภาษาที่รองรับ |
ข้อกำหนดเกี่ยวกับไฟล์ AchievementsLocalizations.csv
- ชื่อรางวัลพิเศษภายในเกมต้องไม่ซ้ำกันในแต่ละภาษา
ตัวอย่างเช่น หากเกมรองรับทั้งภาษา en-US และ fr-FR รางวัลที่ชื่อ "Achievement1" สำหรับ en-US ก็อาจตั้งชื่อเป็น "Achievement1" สำหรับ fr-FR ได้ด้วย
- แต่ละแถวควรมี 4 ค่า หากต้องการละเว้นค่าคำอธิบายที่แปลแล้ว ให้ปล่อยค่านี้ว่างไว้
ตัวอย่างไฟล์ AchievementsLocalizations.csv
Achievement1,Achievement One,This is the description of achievement one in English.,en-US Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR Achievement2,Achievement Two,Description of achievement two.,en-US Achievement2,Logro Dos,Descripción del logro dos.,es-ES Achievement3,Achievement Three,,en-US Achievement3,Erfolg Drei,,de-DE
รูปแบบของไฟล์ AchievementsIconMappings.csv
ไฟล์ AchievementsIconMappings.csv
เป็นไฟล์ที่ไม่บังคับซึ่งใช้เพื่อแมปรางวัลพิเศษกับไอคอนที่ระบุ โดยควรระบุข้อมูลเป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้
Name, icon filename
ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้
ส่วนหัวคอลัมน์ CSV | จำเป็นหรือไม่บังคับ | คำอธิบาย |
---|---|---|
ชื่อ | ต้องระบุ | ต้องตรงกับคอลัมน์ Name จาก AchievementsMetadata.csv
|
ชื่อไฟล์ไอคอน | จำเป็น | ชื่อของไฟล์ไอคอน |
ข้อกำหนดเกี่ยวกับไฟล์ AchievementsIconMappings.csv
- แต่ละแถวควรมี 2 ค่า
- ไฟล์ไอคอนต้องเป็นรูปแบบ PNG หรือ JPEG เท่านั้น
ตัวอย่างAchievementsIconMappings.csv
ไฟล์
Valid Achievement,valid-achievement-icon.png Incremental Achievement,incremental-achievement-icon.jpeg No Description,no-description-icon.png Hidden Initial State,hidden-initial-state-icon.png Large Point Value,large-point-value-icon.jpeg
หลักเกณฑ์เกี่ยวกับไอคอน
ไอคอนควรสร้างเป็นไฟล์ PNG, JPEG หรือ JPG ขนาด 512 x 512 คุณต้องส่งเฉพาะไอคอนของรางวัลพิเศษที่ปลดล็อกแล้วให้เรา เราจะสร้างเวอร์ชัน โทนสีเทาสําหรับไอคอนที่เปิดเผยแล้วโดยอัตโนมัติ ด้วยเหตุนี้ เราจึงขอแนะนำให้ไอคอนรางวัลพิเศษมีองค์ประกอบที่มีสีสันเพื่อให้ผู้ใช้แยกความแตกต่างระหว่างรางวัลที่เปิดเผยแล้วกับรางวัลที่ปลดล็อกแล้วได้
เมื่อไอคอนรางวัลพิเศษแสดงใน[ข้อความโทสต์][a]ของ Android ไอคอนดังกล่าวจะซ้อนทับกับวงกลมและซ่อนมุมด้านนอกไว้ ตรวจสอบว่าไอคอนยังคงดูดีในสถานการณ์เหล่านี้

ระบบจะใช้ไอคอนเดียวกันในทุกภาษา เราจึงขอแนะนำให้คุณไม่ใส่ข้อความหรือเนื้อหาที่แปลแล้วไว้ในไอคอน
ไฟล์ไอคอน
ไอคอนที่คุณอ้างอิงในไฟล์ AchievementsIconMappings.csv
ต้องมีอยู่ในไฟล์เก็บถาวรแบบ Zip ที่คุณนำเข้าในปัจจุบัน
อัปเดตเกมด้วยความสำเร็จที่มีอยู่
คุณเพิ่มรางวัลพิเศษลงในเกมและอัปเดตรางวัลพิเศษที่มีอยู่ได้ใน Google Play Console
เพิ่มรางวัลพิเศษ
หากคุณมีรางวัลพิเศษอยู่แล้วและต้องการเพิ่มรางวัลพิเศษอื่น ให้ทำดังนี้
- ใน Google Play Console เลือกเกม
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกเพิ่มรางวัลพิเศษ
แก้ไขรางวัลพิเศษ
หากคุณมีรางวัลพิเศษอยู่แล้วและต้องการแก้ไข ให้ทำดังนี้
- ใน Google Play Console เลือกเกม
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) เลือกระดับความสำเร็จ
- คุณแก้ไขช่องใดก็ได้
- คลิกบันทึกเป็นฉบับร่าง
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ รางวัลพิเศษที่แก้ไขแล้วจะมีสถานะ "พร้อมใช้งานสำหรับผู้ทดสอบ"
- หลังจากทดสอบรางวัลพิเศษแล้ว ให้คลิกตรวจสอบและเผยแพร่
ซึ่งจะเป็นการเผยแพร่เกมของคุณต่อสาธารณะอีกครั้งพร้อมกับรางวัลพิเศษทั้งหมดที่อัปเดตแล้ว
ลบรางวัลพิเศษ
เมื่อเผยแพร่รางวัลพิเศษแล้ว คุณจะลบรางวัลพิเศษนั้นไม่ได้ คุณสามารถลบเฉพาะรางวัลพิเศษที่อยู่ในสถานะ "เผยแพร่ก่อนเปิดตัว"
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ ให้เลือกรางวัลพิเศษ
- หากต้องการลบรางวัลพิเศษ ให้คลิกลบรางวัลพิเศษ
รีเซ็ตรางวัลพิเศษ
คุณจะรีเซ็ตข้อมูลความคืบหน้าของผู้เล่นได้สำหรับรางวัลพิเศษฉบับร่างเท่านั้น
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ ให้เลือกรางวัลพิเศษ
- หากต้องการรีเซ็ตความสำเร็จ ให้คลิกรีเซ็ตความคืบหน้า
- หากต้องการรีเซ็ตข้อมูลรางวัลพิเศษแบบเป็นโปรแกรม ให้เรียกใช้
เมธอด
Achievements
ของ Management API
เพิ่มคำแปลสำหรับรางวัลพิเศษ
คุณระบุคำแปลของคุณเองสำหรับรางวัลพิเศษที่เชื่อมโยงกับ เกมได้ ก่อนดำเนินการดังกล่าว โปรดทำตามขั้นตอนที่อธิบายไว้ใน การเพิ่มคำแปลสำหรับเกม
คุณเพิ่มคำแปลสำหรับเกมได้ 2 วิธีดังนี้
คุณสามารถใช้ตัวเลือกนำเข้ารางวัลพิเศษเพื่ออัปโหลด คำแปลของรางวัลพิเศษใหม่หลายรายการพร้อมกัน คุณใช้ตัวเลือกนี้เพื่อ อัปโหลดคำแปลสำหรับรางวัลพิเศษที่มีอยู่แล้วไม่ได้
คุณเพิ่มคำแปลสำหรับรางวัลพิเศษแต่ละรายการในเกมได้ วิธีเพิ่มคำแปลของคุณเองสำหรับรางวัลพิเศษแต่ละรายการ
- ใน Google Play Console ให้เปิดแท็บรางวัลพิเศษสำหรับเกมของคุณ แล้วเลือกรางวัลพิเศษที่มีอยู่
- ในหน้ารายละเอียดของรางวัลพิเศษ ให้เลือกแท็บสำหรับภาษาที่คุณเพิ่มไว้ก่อนหน้านี้ในแท็บรายละเอียดเกม
- ในหน้ารายละเอียดของรางวัลพิเศษสำหรับภาษานั้น ให้แก้ไขแบบฟอร์มด้วยคำแปลสำหรับรางวัลพิเศษนั้น
- คลิกบันทึกเพื่อจัดเก็บรายละเอียดของรางวัลพิเศษที่แปลแล้ว
การติดตั้งใช้งานฝั่งไคลเอ็นต์
ดูแหล่งข้อมูลต่อไปนี้เพื่อดูวิธีใช้รางวัลสำหรับแพลตฟอร์มของคุณ
การทดสอบรางวัลพิเศษ
หากต้องการยืนยันว่าความสำเร็จทำงานตามที่ต้องการ ให้ทำตามขั้นตอนเพื่อทดสอบความสำเร็จ
- ตั้งค่าแทร็กทดสอบภายใน
- เพิ่มบัญชีทดสอบลงในโปรเจ็กต์เกมสำหรับผู้ทดสอบ
- สร้างโปรไฟล์บริการเกม Play สำหรับบัญชีทดสอบบัญชีใดบัญชีหนึ่งโดยใช้แอป Play Games
- เปิดเกมโดยใช้บัญชีทดสอบเดียวกันกับที่ใช้สร้างโปรไฟล์ บริการเกมของ Play
- ตรวจสอบว่า "ข้อความต้อนรับ" ของบริการเกมของ Play แสดงบนหน้าจอเพื่อยืนยันว่าการตรวจสอบสิทธิ์อัตโนมัติสําเร็จเมื่อเปิดเกม
- เล่นเกมและทำตามขั้นตอนที่จำเป็นเพื่อปลดล็อกรางวัลพิเศษ
วิธียืนยันความสำเร็จ
ตรวจสอบว่าป๊อปอัป "ปลดล็อกความสำเร็จแล้ว" แสดงบนหน้าจอเมื่อทำ ความสำเร็จเสร็จสมบูรณ์
เปิดแอป Play Store แล้วตรวจสอบว่าส่วนรางวัลพิเศษใน แท็บบัญชีแสดงรางวัลพิเศษที่ทำสำเร็จแล้วและที่กำลังดำเนินการอยู่ (พร้อม รายละเอียดความคืบหน้า)
ติดตามประสิทธิภาพของความสำเร็จใน Play Console
ต่อไปนี้คือวิธีการค้นหาสถิติแบบด่วนสำหรับรางวัลพิเศษแต่ละรางวัล
- ใน Google Play Console
- ไปที่การตั้งค่า> โปรเจ็กต์เกม
- เลือกเกม
- คลิกรางวัลพิเศษในเมนูด้านซ้าย
- ในหน้ารางวัลพิเศษ คุณสามารถค้นหาสถิติเพื่อทำความเข้าใจว่า ผู้เล่นปลดล็อกรางวัลพิเศษหรือไม่ สำหรับผู้ที่ไม่ได้ซ่อนความสำเร็จ คุณจะเห็นเปอร์เซ็นต์ของผู้ที่ปลดล็อกความสำเร็จ สำหรับรางวัลพิเศษในระยะแรก เปอร์เซ็นต์การปลดล็อกมักจะใกล้เคียง 100%
นอกจากนี้ คุณยังติดตามประสิทธิภาพอนุกรมเวลาของรางวัลพิเศษได้ในหน้าขยายการมองเห็น > บริการเกมของ Play > สถิติเกม
เผยแพร่รางวัลพิเศษ
เมื่อทดสอบเสร็จแล้ว คุณต้องเผยแพร่เกม ระบบจะเผยแพร่รางวัลพิเศษทั้งหมดของเกมไปด้วย การเผยแพร่ความสำเร็จ เป็นขั้นตอนที่จำเป็นเพื่อให้ความสำเร็จทำงานได้อย่างถูกต้อง
หากต้องการเผยแพร่ ให้ทำตามขั้นตอนต่อไปนี้
- ใน Google Play Console เลือกเกม
- ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้คลิกตรวจสอบและเผยแพร่
- ในหน้าบริการเกมของ Play - การเผยแพร่ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > การเผยแพร่) ให้ตรวจสอบการดำเนินการและแก้ไขปัญหา
- คลิกเผยแพร่
ระบบจะเผยแพร่รางวัลพิเศษทั้งหมดของเกม
ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง
ประเด็นเหล่านี้เน้นข้อผิดพลาดที่พบบ่อยซึ่งควรหลีกเลี่ยงเมื่อใช้ความสำเร็จ ในเกม โดยเน้นความสำคัญของสิ่งต่อไปนี้
ใน Play Console ให้ไปที่ ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ
- ก่อนเผยแพร่ ให้ตรวจสอบว่าความสำเร็จที่กำหนดค่าใน Play Console ไม่อยู่ในสถานะ "ฉบับร่าง"
- อย่าเพิ่มค่ารหัสความสำเร็จจาก Play Console ลงในโค้ดเกม ให้ใช้การติดตั้งใช้งานฝั่งไคลเอ็นต์แทน
ตรวจสอบว่าคุณได้ใช้ตรรกะการปลดล็อกในไคลเอ็นต์ด้วย
- ผู้เล่นจะข้ามขั้นตอนทริกเกอร์ที่เรียกใช้ Unlock API ไม่ได้ เช่น การดูบทแนะนำจนจบถือเป็นความสำเร็จ แต่ผู้เล่นสามารถ ข้ามบทแนะนำได้