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

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

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

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

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

ตั้งค่าสถิติ

หลังจากสร้างกิจกรรมแล้ว คุณต้องตั้งค่าสถิติดังนี้

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

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

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

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

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

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

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

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

ลบสถิติเกม

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

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

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

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

รูปแบบของไฟล์ 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 ตัว

ต้องเป็นชื่อพร็อพเพอร์ตี้ที่กำหนดไว้ใน 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 หรือ 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)

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

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