กิจกรรม

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

  • ผู้เล่นใช้ไอเทมหนึ่งๆ
  • ผู้เล่นถึงระดับที่เฉพาะเจาะจง
  • ผู้เล่นดำเนินการบางอย่างในเกม

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

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

ผสานรวมกิจกรรมในเกม

เวิร์กโฟลว์ต่อไปนี้อธิบายวิธีใช้เหตุการณ์ในเกม

  1. กําหนดเหตุการณ์ วิธีกําหนดเหตุการณ์ใหม่ที่จะบันทึกในเกม
    1. ไปที่หน้ากิจกรรมของเกมใน Google Play Console
    2. คลิกปุ่มเพิ่มเหตุการณ์ใหม่ แล้วกําหนดค่าพร็อพเพอร์ตี้เหตุการณ์
    3. เผยแพร่คําจํากัดความของเหตุการณ์โดยทําตามขั้นตอนที่อธิบายไว้ในการเผยแพร่การเปลี่ยนแปลงในเกม

  2. ใช้การบันทึกเหตุการณ์ในเกมโดยใช้ Events API เช่น ในโค้ด Android ให้เรียกใช้เมธอด increment ของเหตุการณ์ทุกครั้งที่เกมตรวจพบว่ามีการทริกเกอร์เหตุการณ์ที่สนใจ

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

ข้อมูลเบื้องต้นเกี่ยวกับเหตุการณ์

Events API มีวิธีกำหนดและรวบรวมเมตริกการเล่นเกมที่น่าสนใจ รวมถึงอัปโหลดเมตริกเหล่านี้ไปยัง Play Games SDK

เหตุการณ์ Play Games SDK มีพร็อพเพอร์ตี้หลักต่อไปนี้

พร็อพเพอร์ตี้ คำอธิบาย
ID สตริงที่ไม่ซ้ำกันซึ่ง Google Play Console สร้างขึ้นสําหรับกิจกรรมนี้ ใช้รหัสที่ไม่ซ้ำกันนี้เพื่ออ้างอิงเหตุการณ์ในไคลเอ็นต์เกม
ชื่อ ชื่อย่อของเหตุการณ์ ชื่อมีอักขระได้สูงสุด 100 ตัว Google Play Console จะใช้ค่านี้และสามารถแสดงในเกม

ตัวอย่าง

  • "Zombies Killed"
  • "Red Gems Collected"
คำอธิบาย คําอธิบายกิจกรรมที่ยาวขึ้น (เช่น "จํานวนครั้งที่ผู้เล่นฆ่าซอมบี้" หรือ "จํานวนเพชรแดงทั้งหมดที่ผู้เล่นได้กำจัดและจับคู่") คำอธิบายมีความยาวได้ไม่เกิน 500 อักขระ Google Play Console จะใช้ค่านี้และสามารถแสดงในเกมได้
ประเภทเหตุการณ์

ฟิลด์ที่ประกาศประเภทข้อมูลที่เหตุการณ์ติดตาม Google Play Console ใช้ค่านี้เพื่อรองรับการรายงาน Player Analytics

ระบบรองรับเหตุการณ์ 2 ประเภท ได้แก่

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

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

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

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

แก้ไขกิจกรรม

วิธีแก้ไขเหตุการณ์ที่สร้าง

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

ลบกิจกรรม

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

รีเซ็ตข้อมูลเหตุการณ์

คุณสามารถรีเซ็ตข้อมูลความคืบหน้าของผู้เล่นสำหรับผู้ทดสอบเหตุการณ์ได้

  • หากต้องการรีเซ็ตกิจกรรมฉบับร่างใน Google Play Console ให้คลิกปุ่มที่มีป้ายกำกับว่ารีเซ็ตความคืบหน้าของกิจกรรมที่ด้านล่างของแบบฟอร์มสำหรับกิจกรรมนั้น
  • หากต้องการรีเซ็ตข้อมูลเหตุการณ์โดยใช้โปรแกรม ให้เรียกใช้เมธอด Events ของ Management API

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

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