สถิติผู้เล่นสำหรับเกม Android

คู่มือนี้แสดงวิธีใช้ 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

ดึงข้อมูล

ในการเรียกข้อมูลสถิติผู้เล่นสำหรับผู้เล่นที่ลงชื่อเข้าใช้ในปัจจุบัน ให้ทำตามดังนี้ ขั้นตอน:

  1. เรียกใช้ PlayerStatsClient.loadPlayerStats()

  2. หากเรียกใช้ได้สำเร็จ บริการเกมของ 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 ช่วยให้คุณระบุผู้เล่นประเภทต่างๆ ได้อย่างง่ายดาย โดยอิงตาม การมีส่วนร่วมและพฤติกรรมการใช้จ่ายของลูกค้า รวมถึงใช้กลยุทธ์ที่เหมาะสมเพื่อ เพื่อปรับปรุงประสบการณ์การเล่นเกม

ตารางต่อไปนี้แสดงตัวอย่างกลุ่มผู้เล่นบางส่วนและ กลยุทธ์การมีส่วนร่วม

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