ผสานรวมรางวัลพิเศษ

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

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

สร้างหรือนำเข้าความสำเร็จใหม่

หากต้องการใช้ความสำเร็จตั้งแต่ต้น ให้ทำตามขั้นตอนต่อไปนี้

เพิ่มรางวัลพิเศษ

คุณสร้างรางวัลพิเศษเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้

  • สร้างรางวัลพิเศษ: เพิ่มคำจำกัดความและข้อมูลเมตาสำหรับรางวัลพิเศษแต่ละรายการทีละรายการ
  • นำเข้ารางวัลพิเศษ: นำเข้าคำจำกัดความและข้อมูลเมตาอื่นๆ สำหรับรางวัลพิเศษหลายรายการพร้อมกันในขั้นตอนเดียว

สร้างรางวัลพิเศษ

หากต้องการสร้างรางวัลพิเศษสำหรับเกมใหม่และเกมที่ยังไม่ได้เผยแพร่ ให้ทำตามขั้นตอนต่อไปนี้

  1. เลือกเกมใน Google Play Console
  2. ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกสร้างรางวัลพิเศษ
  3. กรอกแบบฟอร์มในหน้าเพิ่มรางวัลพิเศษ
  4. คลิกบันทึกเป็นฉบับร่าง
  5. หลังจากสร้างรางวัลพิเศษแล้ว คุณต้องเผยแพร่รางวัลพิเศษ
นําเข้ารางวัลพิเศษ

หากต้องการเพิ่มรางวัลพิเศษหลายรายการในเกมพร้อมกัน ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างไฟล์ ZIP ที่มีรางวัลพิเศษของคุณ
  2. อัปโหลดไฟล์

ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ ZIP ได้ที่หลักเกณฑ์สำหรับไฟล์ ZIP

วิธีนำเข้ารางวัลพิเศษ

  1. เลือกเกมใน Google Play Console
  2. ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกนำเข้ารางวัลพิเศษ
  3. ในหน้านำเข้ารางวัลพิเศษ ให้คลิกอัปโหลด
  4. เลือกไฟล์ ZIP เพื่ออัปโหลด
  5. คลิกบันทึกเป็นฉบับร่าง
  6. หลังจากนำเข้ารางวัลพิเศษแล้ว คุณต้อง เผยแพร่เกม

หลักเกณฑ์เกี่ยวกับไฟล์ 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

เพิ่มรางวัลพิเศษ

หากคุณมีรางวัลพิเศษอยู่แล้วและต้องการเพิ่มรางวัลพิเศษอื่น ให้ทำดังนี้

  1. ใน Google Play Console เลือกเกม
  2. ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้เลือกเพิ่มรางวัลพิเศษ
แก้ไขรางวัลพิเศษ

หากคุณมีรางวัลพิเศษอยู่แล้วและต้องการแก้ไข ให้ทำดังนี้

  1. ใน Google Play Console เลือกเกม
  2. ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) เลือกระดับความสำเร็จ
  3. คุณแก้ไขช่องใดก็ได้
  4. คลิกบันทึกเป็นฉบับร่าง
  5. ในหน้าบริการเกมของ Play - รางวัลพิเศษ รางวัลพิเศษที่แก้ไขแล้วจะมีสถานะ "พร้อมใช้งานสำหรับผู้ทดสอบ"
  6. หลังจากทดสอบรางวัลพิเศษแล้ว ให้คลิกตรวจสอบและเผยแพร่

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

ลบรางวัลพิเศษ

เมื่อเผยแพร่รางวัลพิเศษแล้ว คุณจะลบรางวัลพิเศษนั้นไม่ได้ คุณสามารถลบเฉพาะรางวัลพิเศษที่อยู่ในสถานะ "เผยแพร่ก่อนเปิดตัว"

  1. ในหน้าบริการเกมของ Play - รางวัลพิเศษ ให้เลือกรางวัลพิเศษ
  2. หากต้องการลบรางวัลพิเศษ ให้คลิกลบรางวัลพิเศษ
รีเซ็ตรางวัลพิเศษ

คุณจะรีเซ็ตข้อมูลความคืบหน้าของผู้เล่นได้สำหรับรางวัลพิเศษฉบับร่างเท่านั้น

  1. ในหน้าบริการเกมของ Play - รางวัลพิเศษ ให้เลือกรางวัลพิเศษ
  2. หากต้องการรีเซ็ตความสำเร็จ ให้คลิกรีเซ็ตความคืบหน้า
  3. หากต้องการรีเซ็ตข้อมูลรางวัลพิเศษแบบเป็นโปรแกรม ให้เรียกใช้ เมธอดAchievementsของ Management API

เพิ่มคำแปลสำหรับรางวัลพิเศษ

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

คุณเพิ่มคำแปลสำหรับเกมได้ 2 วิธีดังนี้

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

  • คุณเพิ่มคำแปลสำหรับรางวัลพิเศษแต่ละรายการในเกมได้ วิธีเพิ่มคำแปลของคุณเองสำหรับรางวัลพิเศษแต่ละรายการ

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

การติดตั้งใช้งานฝั่งไคลเอ็นต์

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

การทดสอบรางวัลพิเศษ

หากต้องการยืนยันว่าความสำเร็จทำงานตามที่ต้องการ ให้ทำตามขั้นตอนเพื่อทดสอบความสำเร็จ

  • ตั้งค่าแทร็กทดสอบภายใน
  • เพิ่มบัญชีทดสอบลงในโปรเจ็กต์เกมสำหรับผู้ทดสอบ
  • สร้างโปรไฟล์บริการเกม Play สำหรับบัญชีทดสอบบัญชีใดบัญชีหนึ่งโดยใช้แอป Play Games
  • เปิดเกมโดยใช้บัญชีทดสอบเดียวกันกับที่ใช้สร้างโปรไฟล์ บริการเกมของ Play
  • ตรวจสอบว่า "ข้อความต้อนรับ" ของบริการเกมของ Play แสดงบนหน้าจอเพื่อยืนยันว่าการตรวจสอบสิทธิ์อัตโนมัติสําเร็จเมื่อเปิดเกม
  • เล่นเกมและทำตามขั้นตอนที่จำเป็นเพื่อปลดล็อกรางวัลพิเศษ
  • วิธียืนยันความสำเร็จ

    • ตรวจสอบว่าป๊อปอัป "ปลดล็อกความสำเร็จแล้ว" แสดงบนหน้าจอเมื่อทำ ความสำเร็จเสร็จสมบูรณ์

    • เปิดแอป Play Store แล้วตรวจสอบว่าส่วนรางวัลพิเศษใน แท็บบัญชีแสดงรางวัลพิเศษที่ทำสำเร็จแล้วและที่กำลังดำเนินการอยู่ (พร้อม รายละเอียดความคืบหน้า)

ติดตามประสิทธิภาพของความสำเร็จใน Play Console

ต่อไปนี้คือวิธีการค้นหาสถิติแบบด่วนสำหรับรางวัลพิเศษแต่ละรางวัล

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

นอกจากนี้ คุณยังติดตามประสิทธิภาพอนุกรมเวลาของรางวัลพิเศษได้ในหน้าขยายการมองเห็น > บริการเกมของ Play > สถิติเกม

เผยแพร่รางวัลพิเศษ

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

หากต้องการเผยแพร่ ให้ทำตามขั้นตอนต่อไปนี้

  1. ใน Google Play Console เลือกเกม
  2. ในหน้าบริการเกมของ Play - รางวัลพิเศษ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ) ให้คลิกตรวจสอบและเผยแพร่
  3. ในหน้าบริการเกมของ Play - การเผยแพร่ (ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > การเผยแพร่) ให้ตรวจสอบการดำเนินการและแก้ไขปัญหา
  4. คลิกเผยแพร่

    ระบบจะเผยแพร่รางวัลพิเศษทั้งหมดของเกม

ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

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

  • ใน Play Console ให้ไปที่ ขยายการมองเห็น > บริการเกมของ Play > การตั้งค่าและการจัดการ > รางวัลพิเศษ

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

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