คู่มือนี้แสดงวิธีใช้ API สถิติผู้เล่นสำหรับบริการเกมของ Google Play คุณสามารถ ใช้ API สถิติผู้เล่นเพื่อดึงข้อมูลเกี่ยวกับกิจกรรมในเกมของผู้เล่น
API สถิติผู้เล่น ให้คุณปรับแต่งประสบการณ์การเล่นเกม ให้เหมาะกับผู้เล่น และระยะต่างๆ ในวงจรของผู้เล่น คุณสามารถสร้าง ประสบการณ์สำหรับผู้เล่นแต่ละกลุ่ม ตามความคืบหน้า การใช้จ่าย และมีส่วนร่วม ตัวอย่างเช่น คุณใช้ API นี้เพื่อดำเนินการเชิงรุกเพื่อ จะกระตุ้นให้ผู้เล่นที่เล่นน้อยกลับมามีส่วนร่วมกับเกมอีกครั้ง เช่น แสดงและโปรโมตไอเท็มใหม่ในเกมเมื่อผู้เล่นลงชื่อเข้าใช้
API จะอยู่ใน
com.google.android.gms.games.stats
และแพ็กเกจ com.google.android.gms.games
แพ็กเกจ
ประเภทของข้อมูลผู้เล่นที่คุณสามารถเรียกดูได้มีดังนี้
ระยะเวลาเซสชันโดยเฉลี่ย: ระยะเวลาเซสชันเฉลี่ยของโปรแกรมเล่นใน นาที ระยะเวลาของเซสชันจะกำหนดโดยเวลาที่ผู้เล่นลงชื่อเข้าใช้ บริการเกมของ Google Play
จำนวนวันนับตั้งแต่ที่เล่นล่าสุด: จำนวนวันโดยประมาณนับตั้งแต่ผู้เล่น เล่นล่าสุด
จำนวนการซื้อ: จำนวนการซื้อในแอปโดยประมาณสำหรับ โปรแกรมเล่นวิดีโอ
จำนวนเซสชัน: จำนวนเซสชันโดยประมาณของโปรแกรมเล่น เซสชันจะกำหนดตามจำนวนครั้งที่ผู้เล่นลงชื่อเข้าใช้ บริการเกมของ Google Play
เปอร์เซ็นไทล์ของเซสชัน: ค่าประมาณเปอร์เซ็นต์ไทล์เซสชันสำหรับ Player ซึ่งระบุเป็นค่าทศนิยมระหว่าง 0 ถึง 1 (รวมค่าแรกและค่าสุดท้าย) ค่านี้ระบุจำนวน เซสชันที่ผู้เล่นปัจจุบันเล่นเมื่อเทียบกับคนอื่นๆ ของผู้เล่นเกมนี้ ฐาน ตัวเลขที่สูงกว่าหมายความว่าโปรแกรมเล่นนี้เล่นเซสชันมากกว่า
เปอร์เซ็นไทล์การใช้จ่าย: เปอร์เซ็นไทล์การใช้จ่ายโดยประมาณของโปรแกรมเล่น โดย เป็นค่าทศนิยมระหว่าง 0 ถึง 1 ค่านี้ระบุจำนวนเงิน ผู้เล่นปัจจุบันได้ใช้จ่ายไปเมื่อเทียบกับผู้เล่นคนอื่นๆ ในเกมนี้ ฐาน จำนวนที่สูงบ่งชี้ว่าโปรแกรมเล่นนี้ใช้จ่ายมากกว่า
ประเภทของข้อมูลผู้เล่นต่อไปนี้เลิกใช้งานแล้วและแสดงผลเป็นยกเลิกการตั้งค่าเสมอ ค่าคงที่:
- ความน่าจะเป็นของการเลิกใช้งาน: การคาดการณ์ว่าผู้เล่นจะเลิกใช้งานหรือไม่ ในวันถัดไป โดยระบุเป็นค่าทศนิยมระหว่าง 0 (ความน่าจะเป็นต่ำของ การเลิกใช้งาน) ถึง 1 (มีโอกาสสูงที่จะเลิกใช้งาน) การเลิกใช้งานคือ 7 วันที่ไม่มีการใช้งาน
- ความน่าจะเป็นของการใช้จ่าย: ความน่าจะเป็นโดยประมาณของผู้เล่น การเลือกใช้จ่ายในเกมนี้ โดยระบุเป็นค่าทศนิยมระหว่าง 0 (ต่ำ ความน่าจะเป็นของการใช้จ่าย) ถึง 1 (ความน่าจะเป็นสูงในการใช้จ่าย) รวม
- ค่าใช้จ่ายทั้งหมดใน 28 วันข้างหน้า: จำนวนผู้เล่นที่คาดไว้ทั้งหมดโดยประมาณ ใช้จ่ายไปกับเกมนี้ในอีก 28 วันข้างหน้า
- ความน่าจะเป็นของผู้ใช้จ่ายสูง: ความน่าจะเป็นโดยประมาณที่ ในอีก 28 วันข้างหน้า ผู้เล่นจะใช้เงินเป็นจำนวนอยู่ในช่วง 95 เปอร์เซ็นไทล์หรือสูงกว่าของฐานผู้เล่นของเกมนี้ ค่านี้ระบุเป็นทศนิยม ค่าระหว่าง 0 (ความน่าจะเป็นต่ำที่จะเป็นผู้ใช้จ่ายสูง) ถึง 1 (สูง ความเป็นไปได้ที่จะเป็นผู้ใช้จ่ายสูง)
ก่อนเริ่มต้น
ก่อนเริ่มใช้ API สถิติผู้เล่น ให้ทำดังนี้
- ดาวน์โหลดและตรวจสอบ ตัวอย่างโค้ด
- ทําความคุ้นเคยกับคําแนะนําที่อธิบายไว้ใน รายการตรวจสอบคุณภาพ
รับลูกค้า
ในการเริ่มใช้ API สถิติผู้เล่น เกมของคุณจะต้องสร้าง
PlayerStatsClient
โดยการเรียกใช้
Games.getPlayerStatsClient()
และการส่งผ่านกิจกรรม
PlayerStatsClient
ใช้บริการ Google Play
Task
เพื่อแสดงผลแบบไม่พร้อมกัน หากต้องการทราบข้อมูลเพิ่มเติมเกี่ยวกับ
โดยใช้ Tasks เพื่อจัดการงานแบบแยกชุดข้อความ โปรดดู
คู่มือนักพัฒนาซอฟต์แวร์ Tasks API
ดึงข้อมูล
ในการเรียกข้อมูลสถิติผู้เล่นสำหรับผู้เล่นที่ลงชื่อเข้าใช้ในปัจจุบัน ให้ทำตามดังนี้ ขั้นตอน:
เรียกใช้
PlayerStatsClient.loadPlayerStats()
หากเรียกใช้ได้สำเร็จ บริการเกมของ Google Play จะแสดงผล
Task
ที่โหลดแบบไม่พร้อมกันPlayerStats
ออบเจ็กต์ ใช้วิธีการของออบเจ็กต์นี้เพื่อดึงข้อมูลเกี่ยวกับการลงชื่อเข้าใช้ กิจกรรมของผู้เล่นในแอป
ตัวอย่างเช่น
public void checkPlayerStats() { PlayGames.getPlayerStatsClient(this) .loadPlayerStats(true) .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() { @Override public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) { if (task.isSuccessful()) { // Check for cached data. if (task.getResult().isStale()) { Log.d(TAG, "using cached data"); } PlayerStats stats = task.getResult().get(); if (stats != null) { Log.d(TAG, "Player stats loaded"); if (stats.getDaysSinceLastPlayed() > 7) { Log.d(TAG, "It's been longer than a week"); } if (stats.getNumberOfSessions() > 1000) { Log.d(TAG, "Veteran player"); } if (stats.getChurnProbability() == 1) { Log.d(TAG, "Player is at high risk of churn"); } } } else { int status = CommonStatusCodes.DEVELOPER_ERROR; if (task.getException() instanceof ApiException) { status = ((ApiException) task.getException()).getStatusCode(); } Log.d(TAG, "Failed to fetch Stats Data status: " + status + ": " + task.getException()); } } }); }
เคล็ดลับ
API สถิติของ Play ช่วยให้คุณระบุผู้เล่นประเภทต่างๆ ได้อย่างง่ายดาย โดยอิงตาม การมีส่วนร่วมและพฤติกรรมการใช้จ่ายของลูกค้า รวมถึงใช้กลยุทธ์ที่เหมาะสมเพื่อ เพื่อปรับปรุงประสบการณ์การเล่นเกม
ตารางต่อไปนี้แสดงตัวอย่างกลุ่มผู้เล่นบางส่วนและ กลยุทธ์การมีส่วนร่วม
กลุ่มผู้เล่น | กลยุทธ์การมีส่วนร่วม |
---|---|
ผู้เล่นบ่อยที่มีจำนวนเซสชันสูงและการใช้จ่ายที่ดี เปอร์เซ็นไทล์ แต่ไม่ได้เล่นในช่วงสัปดาห์ที่ผ่านมาหรือนานกว่านั้น |
|
ผู้เล่นที่มีส่วนร่วมสูงในเปอร์เซ็นไทล์การใช้จ่ายต่ำ |
|
ผู้เล่นที่มีการใช้จ่ายสูงแสดงสัญญาณการเพิ่มขึ้นสูงสุดและเริ่มต้น ให้เล่นด้วยความถี่น้อยลง |
|
ผู้เล่นที่มีโอกาสใช้จ่ายสูงมากหรือต่ำมาก |
|