ผสานรวมสถิติเกม

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

สร้างหรือนำเข้ากิจกรรม

คุณเพิ่มกิจกรรมเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้

สร้างกิจกรรม

หากต้องการสร้างกิจกรรมสำหรับเกม ให้ทำตามขั้นตอนต่อไปนี้

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

นำเข้ากิจกรรม

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

  1. สร้างไฟล์ CSV ของเหตุการณ์ PlayerGameEvent.csv
  2. เลือกเกมใน Google Play Console
  3. ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มเหตุการณ์ > นำเข้าผ่าน CSV
  4. ในหน้าการกำหนดค่าเหตุการณ์ ให้วางไฟล์ CSV เพื่ออัปโหลด
  5. หลังจากสร้างกิจกรรมแล้ว ให้ตั้งค่าสถิติ

สร้างหรือนำเข้าสถิติ

คุณเพิ่มสถิติเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้

สร้างสถิติ

หากต้องการสร้างสถิติสำหรับเกม ให้ทำตามขั้นตอนต่อไปนี้

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

สถิติการนำเข้า

หากต้องการนำเข้าสถิติ ให้ทำตามขั้นตอนต่อไปนี้

  1. สร้างไฟล์ ZIP ที่มีไฟล์สถิติ การแปล และไอคอน ตามหลักเกณฑ์ไฟล์ ZIP สำหรับสถิติ
  2. เลือกเกมใน Google Play Console
  3. ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มสถิติ > นำเข้าผ่าน ZIP
  4. ในหน้าการกำหนดค่าสถิติเกม ให้วางไฟล์ ZIP เพื่ออัปโหลด
  5. หลังจากอัปโหลดสถิติทั้งหมดแล้ว ให้เผยแพร่เกม

ทดสอบสถิติเกม

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

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

จัดการระดับการมองเห็นสถิติเกมในอุปกรณ์เพื่อการทดสอบ

เมื่อเกมพร้อมให้บริการแก่ผู้ทดสอบใน Play Console แล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อดูสถิติเกมในอุปกรณ์

  1. ล้างแคชของ Google Play Store โดยทำดังนี้

    1. เปิดแอปการตั้งค่าบนอุปกรณ์
    2. แตะแอป > Google Play Store
    3. แตะพื้นที่เก็บข้อมูลและแคช แล้วแตะล้างแคช

  2. เปิดแอป Google Play Store

  3. ดูสถิติเกมได้โดยใช้ส่วนติดตามเวลาเล่นหรือโปรไฟล์เกมเมอร์

วิธีที่ 1: ใช้ส่วนติดตามเวลาเล่น

ไปที่ส่วนติดตามเวลาในการเล่น แล้วแตะส่วนดังกล่าวเพื่อดูสถิติเกม

วิธีการทดสอบสถิติเกม 1 เพื่อใช้ส่วนติดตามเวลาเล่น
ส่วนติดตามเวลาในการเล่นในแท็บบัญชี

วิธีที่ 2: ใช้โปรไฟล์เกมเมอร์

  1. แตะแท็บคุณ แล้วแตะโปรไฟล์เกมเมอร์
  2. ไปที่ส่วนสถิติเกม
  3. เลือกทั้งหมดสำหรับช่วงเวลา
  4. หากเกมไม่ปรากฏ ให้แตะดูเกมทั้งหมด
  5. เลือกเกมเพื่อดูสถิติ
วิธีการทดสอบสถิติเกม 2 เพื่อใช้โปรไฟล์เกมเมอร์
ส่วนสถิติเกมในโปรไฟล์เกมเมอร์

ดูบันทึกในอุปกรณ์

หากต้องการยืนยันว่าสถิติเกมทำงานตามที่ออกแบบไว้ ให้เปิดบันทึกในอุปกรณ์โดยทำดังนี้

  1. เปิดใช้การแก้ไขข้อบกพร่องของ adb ในอุปกรณ์และเรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล 

    adb shell setprop log.tag.Games INFO
adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

  2. ตรวจสอบว่าข้อความในบันทึกที่สำเร็จปรากฏขึ้นตามที่แสดงในตัวอย่างต่อไปนี้

    Successfully uploaded batch of X events.

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

  3. หากกิจกรรมที่ส่งไม่ผ่านการตรวจสอบ คุณจะเห็นข้อความแสดงข้อผิดพลาดที่ระบุรายละเอียดความล้มเหลว

    BatchRecordEvents validation failed for X event(s): ...

เผยแพร่สถิติเกม

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

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

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

แก้ไขสถิติเกม

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

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

ลบสถิติเกม

หลังจากเผยแพร่สถิติเกมแล้ว คุณจะลบสถิติเกมไม่ได้

คุณสามารถลบเหตุการณ์หรือสถิติที่อยู่ในสถานะพร้อมให้ผู้ทดสอบใช้งานได้

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

หลักเกณฑ์ไฟล์ CSV สำหรับกิจกรรม

แถวแรกของไฟล์ CSV คือแถวส่วนหัว คุณต้องนำเข้ากิจกรรมโดยใช้ไฟล์ CSV ของกิจกรรม เช่น PlayerGameEvent.csv

รูปแบบของไฟล์ PlayerGameEvent.csv

CSV มีเหตุการณ์ที่ประกาศไว้และพร็อพเพอร์ตี้ของเหตุการณ์เป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้ 

 Event Name,Property Name,Property Type

หากคุณส่งเหตุการณ์ progressUpdate สำหรับ progressionStat ให้เพิ่มแถวสำหรับ เหตุการณ์นี้ เหตุการณ์นี้ต้องมีพร็อพเพอร์ตี้ currentProgress อย่างน้อย 1 รายการที่มี ประเภท INT หรือ STRING รวมถึงพร็อพเพอร์ตี้อื่นๆ ที่คุณต้องการส่ง

ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้

ส่วนหัวคอลัมน์ CSV จำเป็นหรือไม่บังคับ ค่าที่ยอมรับ
ชื่อเหตุการณ์ ต้องระบุ มีอักขระได้สูงสุด 50 ตัว

ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น

หากใช้ชื่อเหตุการณ์พิเศษ progressUpdate จะต้องมีพร็อพเพอร์ตี้ชื่อ currentProgress ประเภท INT64 หรือ STRING
ชื่อพร็อพเพอร์ตี้ ต้องระบุ มีอักขระได้สูงสุด 50 ตัว

ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น

ไม่ซ้ำกันต่อเหตุการณ์: ชื่อพร็อพเพอร์ตี้ต้องไม่ซ้ำกันภายในเหตุการณ์เดียวกัน

อย่าใช้คีย์เวิร์ดที่สงวนไว้ต่อไปนี้ id, count, key, value, where, from, and, or, true หรือ false
ประเภทของอสังหาริมทรัพย์ ต้องระบุ สตริง Enum ที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งตรงกับประเภทข้อมูลที่รองรับประเภทใดประเภทหนึ่งต่อไปนี้ INT64, DOUBLE, STRING, BOOL

ข้อกำหนดของไฟล์ PlayerGameEvent.csv มีดังนี้

  • ไฟล์รองรับชื่อเหตุการณ์ที่ไม่ซ้ำกันสูงสุด 20 รายการ โดยมีพร็อพเพอร์ตี้สูงสุด 20 รายการต่อเหตุการณ์
  • เนื้อหาไฟล์ต้องไม่ว่างเปล่าและต้องมีอย่างน้อย 1 แถว
ตารางตัวอย่าง
ชื่อเหตุการณ์ ชื่อพร็อพเพอร์ตี้ ประเภทของอสังหาริมทรัพย์
matchCompleted ระยะเวลา DOUBLE
matchCompleted ฆ่า INT64
matchCompleted isWinner BOOL
matchCompleted matchType สตริง
itemCollected coinsAmount INT64
itemCollected weaponType สตริง
progressUpdate currentProgress INT64

หลักเกณฑ์สำหรับไฟล์ ZIP ของสถิติ

คุณสามารถนำเข้าสถิติพร้อมกันได้โดยใช้ไฟล์ ZIP ดูชื่อไฟล์ที่แน่นอนที่จะใช้ในไฟล์ ZIP ได้จากตารางต่อไปนี้

ชื่อไฟล์ จำเป็นหรือไม่บังคับ ค่าที่ยอมรับ
RepetitiveStatsConfig.csv ต้องระบุ สถิติที่ซ้ำกันแสดงถึงการกระทำในเกมที่เกิดขึ้นเป็นประจำ ซึ่งผู้เล่นเป็นผู้ดำเนินการ
ProgressionStatConfig.csv ต้องระบุ สถิติความคืบหน้าแสดงถึงความก้าวหน้าของผู้เล่นในเกม
StatLocalizations.csv ไม่บังคับ ระบุคำแปลสำหรับชื่อและคำอธิบายของสถิติเกม
ไฟล์ไอคอน ต้องระบุ ไอคอนในรูปแบบ PNG, JPEG หรือ JPG ขนาด 512 x 512

ไฟล์ ZIP ต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ขีดจำกัดขนาดไฟล์ ZIP: ขนาดรวมสูงสุดที่ไม่มีการบีบอัดคือ 10 MB
  • ไฟล์สูงสุด: ไฟล์ทั้งหมดในไฟล์เก็บถาวรแบบ ZIP ต้องมีไม่เกิน 53 ไฟล์ (CSV 3 ไฟล์และไอคอน 50 ไฟล์)
  • ขีดจำกัดสถิติรวมสูงสุด: สถิติทั้งหมดสูงสุด 50 รายการใน ProgressionStatConfig.csv และ RepetitiveStatsConfig.csv
  • ไฟล์ CSV ที่รองรับ: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv และ StatLocalizations.csv (ไม่บังคับ) หากต้องการอัปโหลดเฉพาะสถิติความคืบหน้า อย่าใส่ไฟล์ CSV ของสถิติที่ทำซ้ำใน ZIP ไม่เช่นนั้นคอนโซลจะแสดงข้อผิดพลาด และจะเหมือนกันหากคุณต้องการอัปโหลดเฉพาะสถิติที่ซ้ำกัน
  • ไฟล์รูปภาพไอคอน: PNG (.png) หรือ JPEG (.jpg, .jpeg)
    • ไอคอนทั้งหมดที่อ้างอิงใน CSV ต้องอยู่ในรูทของไฟล์ ZIP
    • ไฟล์รูปภาพทั้งหมดที่อยู่ใน ZIP ต้องอ้างอิงโดยสถิติอย่างน้อย 1 รายการ
  • โครงสร้างไดเรกทอรี: ไฟล์ทั้งหมดต้องอยู่ในรูทของไฟล์ ZIP ไม่อนุญาตให้ใช้ไดเรกทอรีย่อย

รูปแบบของไฟล์ RepetitiveStatsConfig.csv

CSV มีเหตุการณ์ที่ประกาศไว้และพร็อพเพอร์ตี้ของเหตุการณ์เป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้ 

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้

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

ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น ต้องไม่ซ้ำกันใน สถิติทั้งหมดในเกม
ชื่อเหตุการณ์ ต้องระบุ มีอักขระได้สูงสุด 50 ตัว

ต้องอ้างอิงชื่อเหตุการณ์ที่กําหนดไว้ในรูปแบบ PlayerGameEvent.csv
ชื่อพร็อพเพอร์ตี้เหตุการณ์ ต้องระบุ มีอักขระได้สูงสุด 50 ตัว
ชื่อที่แสดงของสถิติ ต้องระบุ อักขระสูงสุด 50 ตัว
ชื่อที่แสดงเริ่มต้นสำหรับสถิติ (ภาษาเริ่มต้น) ต้องไม่ซ้ำกันในสถิติ
คำอธิบายสถิติ ต้องระบุ สูงสุด 500 อักขระ
คำอธิบายเริ่มต้นสำหรับสถิติ
ประเภทการรวม ต้องระบุ สูงสุด 50 อักขระ
SUM, MAX, MIN, COUNT
กรองพร็อพเพอร์ตี้ ไม่บังคับ อักขระสูงสุด 50 ตัว
ต้องเป็นชื่อพร็อพเพอร์ตี้ที่กำหนดไว้ใน PlayerGameEvent.csv
ตัวดำเนินการตัวกรอง ไม่บังคับ =, !=, >, <, >=, <=
โอเปอเรเตอร์การเปรียบเทียบตัวกรอง
ค่าตัวกรอง ไม่บังคับ เปรียบเทียบกับพร็อพเพอร์ตี้ตัวกรอง ค่าตัวกรองต้องเป็น INT64, DOUBLE, BOOL, STRING
มีการแข่งขัน ต้องระบุ true, false
ขีดจำกัดต่ำสุด ต้องระบุเมื่อ Is Competitive เป็นจริง คะแนนขั้นต่ำที่อนุญาตสำหรับสถิติการแข่งขัน
มีขีดจำกัดสูงสุด ต้องระบุเมื่อ Is Competitive เป็นจริง คะแนนสูงสุดที่อนุญาตสำหรับสถิติการแข่งขัน
ชื่อไฟล์ไอคอน ต้องระบุ ชื่อไฟล์ของรูปภาพไอคอนที่รวมอยู่ในรูทของไฟล์ ZIP ต้องไม่ขัดแย้งกับชื่อไฟล์ไอคอนที่ใช้ในสถิติที่ซ้ำกัน
ทิศทางของมูลค่าที่ดี ต้องระบุ ระบุว่าค่าที่สูงกว่า INCREASING หรือค่าที่ต่ำกว่า DECREASING ดีกว่า
หน่วย ไม่บังคับ หน่วยวัดสำหรับค่าตัวเลขหรือระยะเวลาดิบ เช่น KILOMETER, SECOND, PERCENTAGE, UNITLESS

หากไม่ต้องการใช้เงื่อนไขตัวกรอง ให้ปล่อยเซลล์ว่างไว้

ตารางตัวอย่าง
รหัสสถิติ ชื่อเหตุการณ์ ชื่อพร็อพเพอร์ตี้ การรวม ชื่อที่แสดงของสถิติ คำอธิบายสถิติ กรองพร็อพเพอร์ตี้ (ไม่บังคับ) ตัวดำเนินการตัวกรอง (ไม่บังคับ) ค่าตัวกรอง (ไม่บังคับ) มีการแข่งขัน minLimit maxLimit ชื่อไฟล์ไอคอน ทิศทางของมูลค่าที่ดี หน่วย
1 matchCompleted ระยะเวลา MAX การอยู่รอดที่ยาวนานที่สุด ซึ่งแสดงถึงเวลาที่ผู้เล่นเอาชีวิตรอดได้ในการแข่งขัน isWinner = จริง จริง 0 50 stat1.png ลด วินาที
2 matchCompleted isWinner COUNT การแข่งขันที่ชนะ ซึ่งแสดงถึงจำนวนการแข่งขันที่ผู้เล่นชนะ isWinner = จริง จริง 0 50 stat3.png เพิ่ม
3 matchCompleted ฆ่า SUM การสังหารในการดวลตัวต่อตัว จำนวนการสังหารที่ทำได้ในการแข่งขันแบบ 1 ต่อ 1 matchType = "การประชุมแบบตัวต่อตัว" เท็จ stat4.png เพิ่ม
4 itemCollected coinsAmount SUM ทองคำทั้งหมดที่เก็บรวบรวม ผู้เล่นเก็บเหรียญขณะเล่นในการแข่งขัน weaponType = "ดาบ" เท็จ stat2.png เพิ่ม

รูปแบบของไฟล์ ProgressionStatConfig.csv

CSV มีเหตุการณ์ที่ประกาศไว้และพร็อพเพอร์ตี้ของเหตุการณ์เป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้ 

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

สถิติความคืบหน้าจะแสดงเป็นสถิติแรกแก่ผู้เล่นในโปรไฟล์เกมเมอร์

ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้

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

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

ต้องเป็นชื่อพร็อพเพอร์ตี้ที่กำหนดไว้ใน PlayerGameEvent.csv
ชื่อที่แสดงของสถิติ ต้องระบุ ต้องเป็นชื่อที่ไม่ซ้ำกัน
คำอธิบายสถิติ ต้องระบุ สูงสุด 50 อักขระ
คำอธิบายเริ่มต้นสำหรับสถิติ
ชื่อไฟล์ไอคอน ต้องระบุ ชื่อไฟล์ของรูปภาพไอคอนที่รวมอยู่ในรูทของไฟล์ ZIP ต้องไม่ขัดแย้งกับชื่อไฟล์ไอคอนที่ใช้ในสถิติที่ซ้ำกัน
ทิศทางของมูลค่าที่ดี ต้องระบุ ระบุว่าค่าที่สูงกว่า INCREASING หรือค่าที่ต่ำกว่า DECREASING ดีกว่า
หน่วย ไม่บังคับ หน่วยวัดสำหรับค่าตัวเลขหรือระยะเวลาดิบ เช่น KILOMETER, SECOND, PERCENTAGE, UNITLESS
ตารางตัวอย่าง
รหัสสถิติ ชื่อพร็อพเพอร์ตี้เหตุการณ์ ชื่อที่แสดงของสถิติ คำอธิบายสถิติ ชื่อไฟล์ไอคอน ทิศทางค่าที่ดี
5 currentProgress ระดับ ผู้เล่นจะสะสม XP ได้โดยการเล่นแมตช์และเลื่อนระดับ Level.png เพิ่มขึ้น

รูปแบบของไฟล์ StatLocalizations.csv

CSV มีเหตุการณ์ที่ประกาศไว้และพร็อพเพอร์ตี้ของเหตุการณ์เป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้ 

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้

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

ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น ต้องไม่ซ้ำกันใน สถิติทั้งหมดในเกม
ชื่อที่แสดงของสถิติ ต้องระบุ ต้องเป็นชื่อที่ไม่ซ้ำกัน
ภาษา จำเป็น รหัสภาษา เช่น en-US
เพิ่มคำแปลสำหรับเกมก่อนระบุภาษา โปรดทราบว่าคุณ ไม่สามารถระบุภาษาเริ่มต้นได้

ดูรหัสภาษาที่รองรับได้ที่รายการ ภาษาที่รองรับ
ชื่อที่แสดงของสถิติที่แปลแล้ว ไม่บังคับ สูงสุด 50 อักขระ ชื่อที่แสดงของสถิติที่แปลแล้วสำหรับภาษาที่ระบุ
คำอธิบายสถิติที่แปลแล้ว ไม่บังคับ สูงสุด 500 อักขระ คำอธิบายสถิติที่แปลแล้วสำหรับภาษาที่ระบุ
ตารางตัวอย่าง
รหัสสถิติ ชื่อที่แสดงของสถิติ รหัสภาษา ชื่อสถิติที่แปลแล้ว (UTF-8) คำอธิบายสถิติที่แปลแล้ว (UTF-8)
1 การอยู่รอดที่ยาวนานที่สุด es Supervivencia más larga en partidos Esto denota el tiempo de supervivencia de una jugadora en cualquier partido.
1 การอยู่รอดที่ยาวนานที่สุด fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match.
4 ทองคำทั้งหมดที่เก็บรวบรวม es Oro total recolectado La jugadora recoge monedas mientras juega en un partido
4 ทองคำทั้งหมดที่เก็บรวบรวม fr Or total collecté Le joueur collecte des pièces en jouant un match

ไฟล์ไอคอน

ไอคอนที่คุณอ้างอิงในไฟล์ CSV ต้องมีอยู่ในไฟล์เก็บถาวรแบบ ZIP ที่คุณนำเข้าในปัจจุบัน

กฎการตรวจสอบไอคอนมีดังนี้

พร็อพเพอร์ตี้การตรวจสอบ ข้อจำกัด / กฎที่บังคับใช้
ขนาดไฟล์สูงสุด สูงสุด 1 MB (1,048,576 ไบต์) ต่อไฟล์ไอคอน
ขนาด 512 × 512 พิกเซล (กว้าง = 512, สูง = 512)
อัตราส่วน 1:1 เท่านั้น (สัดส่วนภาพสี่เหลี่ยมจัตุรัส)
รูปแบบที่อนุญาต PNG (.png) และ JPEG (.jpg, .jpeg)
ตำแหน่งใน ZIP ต้องอยู่ในไดเรกทอรีรากในไฟล์ ZIP
การตรวจสอบที่อ้างอิง ชื่อไฟล์ไอคอนทั้งหมดที่ระบุในคอลัมน์ชื่อไฟล์ไอคอนต้องมีอยู่ในไฟล์ ZIP
การตรวจสอบออร์แฟน ไฟล์รูปภาพทั้งหมดภายใน ZIP ต้องอ้างอิงโดยสถิติอย่างน้อย 1 รายการ
การตรวจสอบความขัดแย้ง ชื่อไฟล์ไอคอนใน ProgressionStatConfig.csv ต้องไม่ ขัดแย้งกับ RepetitiveStatsConfig.csv
ภาพที่ซ้ำกัน ระบบจะแจ้งว่ามีไอคอนซ้ำกัน

หลักเกณฑ์เกี่ยวกับไอคอน

ไอคอนควรสร้างเป็นไฟล์ PNG, JPEG หรือ JPG ขนาด 512 x 512 ที่มีพื้นหลังโปร่งใส

ระบบจะใช้ไอคอนเดียวกันในทุกภาษา เราจึงขอแนะนำให้คุณไม่ใส่ข้อความหรือเนื้อหาที่แปลแล้วไว้ในไอคอน

ข้อกำหนดเฉพาะของหน่วย

คอลัมน์หน่วยจะควบคุมวิธีจัดรูปแบบและ แปลค่าสถิติดิบสำหรับผู้เล่น

พร็อพเพอร์ตี้สถิติที่เป็นตัวเลข (INT64, DOUBLE)

ค่าหน่วยที่อนุญาต ค่าดิบตัวอย่าง
(ว่าง) / UNITLESS / NONE 1234567
% / PERCENTAGE / PERCENT 0.857
ระยะทาง/ความยาว: เซนติเมตร, เมตร, กิโลเมตร, ฟุต, นิ้ว, ไมล์, หลา, มิลลิเมตร, นาโนเมตร 15 (กิโลเมตร)
ความเร็ว: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

พร็อพเพอร์ตี้สถิติระยะเวลา (DURATION)

ค่าหมวดหมู่รูปแบบ ค่าหน่วยที่อนุญาต ค่าดิบตัวอย่าง ตัวอย่างเอาต์พุตที่จัดรูปแบบ
UNIT_BASED / DURATION ต้องระบุ: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR 5400 วินาที (ชั่วโมง) 1.5 ชั่วโมง
COMPONENT_NUMERIC / HH:MM:SS / CLOCK ความละเอียด (ไม่บังคับ ค่าเริ่มต้นคือ WHOLE_SECONDS) WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS 3661 วินาที 01:01:01
COMPONENT_TEXT / TEXT หน่วยที่เล็กที่สุด (ไม่บังคับ ค่าเริ่มต้นคือ SECONDS): SECONDS, MINUTES, HOURS, DAYS, MONTHS, YEARS 90000 วินาที 1 วัน 1 ชั่วโมง

พร็อพเพอร์ตี้สถิติที่ไม่ใช่ตัวเลข (STRING, BOOL)

คอลัมน์หน่วยต้องว่างเปล่า