เพิ่มสถิติของผู้เล่นในเกม

เราจะนำ SDK เวอร์ชัน 1 ของเกมออกในปี 2026 ตามการเลิกใช้งาน Google Sign-In API หลังจากเดือนกุมภาพันธ์ 2025 คุณจะไม่สามารถเผยแพร่เกมที่ผสานรวมกับ SDK เวอร์ชัน 1 ของเกมใหม่ใน Google Play เราขอแนะนําให้ใช้ SDK ของ Google Play Games v2 แทน
แม้ว่าเกมที่มีอยู่ซึ่งผสานรวมกับเกมเวอร์ชัน 1 ก่อนหน้านี้จะยังคงใช้งานได้อีก 2-3 ปี แต่เราขอแนะนำให้คุณย้ายข้อมูลไปยัง v2 ตั้งแต่วันที่ 1 มิถุนายน 2025 เป็นต้นไป
คู่มือนี้มีไว้สำหรับการใช้ SDK บริการเกมของ Play เวอร์ชัน 1 SDK สำหรับ C++ ของบริการเกมของ Play เวอร์ชัน 2 ยังไม่พร้อมใช้งาน

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

คู่มือนี้จะแสดงวิธีใช้ Player Stats API ในแอปพลิเคชัน C++ หรือ Objective-C ดั้งเดิม

ข้อมูลเบื้องต้นเกี่ยวกับสถิติผู้เล่น

คุณสามารถใช้ Player Stats API เพื่อดึงข้อมูลเกี่ยวกับกิจกรรมในเกมของผู้เล่น ประเภทข้อมูลผู้เล่นที่คุณดึงมาได้มีดังนี้

  • ระยะเวลาเซสชันเฉลี่ย: ระยะเวลาเซสชันเฉลี่ยของผู้เล่นเป็นนาที ระยะเวลาของเซสชันจะขึ้นอยู่กับเวลาที่ผู้เล่นลงชื่อเข้าใช้บริการ Google Play Games
  • ความน่าจะเป็นของการเลิกใช้งาน: การคาดการณ์ว่าผู้เล่นจะเลิกใช้งานในวันถัดไปหรือไม่ โดยค่าที่ได้คือ 0 (มีโอกาสต่ำที่จะเลิกใช้งาน) หรือ 1 (มีโอกาสสูงที่จะเลิกใช้งาน) เรากำหนดว่าการเลิกใช้งานคือการไม่มีการใช้งานเป็นเวลา 7 วัน
  • จำนวนวันนับตั้งแต่เล่นครั้งล่าสุด: จำนวนวันที่ประมาณนับตั้งแต่ผู้เล่นเล่นครั้งล่าสุด
  • จํานวนการซื้อ: จํานวนการซื้อในแอปโดยประมาณของผู้เล่น
  • จำนวนเซสชัน: จำนวนเซสชันโดยประมาณของผู้เล่น เซสชันจะกำหนดโดยจํานวนครั้งที่ผู้เล่นลงชื่อเข้าใช้บริการ Google Play Games
  • เปอร์เซ็นต์เซสชัน: ค่าประมาณของเปอร์เซ็นต์เซสชันสําหรับผู้เล่น ซึ่งแสดงเป็นค่าทศนิยมระหว่าง 0 ถึง 1 (รวม) ค่านี้ระบุจํานวนเซสชันที่ผู้เล่นปัจจุบันเล่นเทียบกับฐานผู้เล่นที่เหลือของเกมนี้ ตัวเลขที่สูงขึ้นบ่งชี้ว่าผู้เล่นรายนี้เล่นเซสชันมากกว่า
  • เปอร์เซ็นต์การใช้จ่าย: เปอร์เซ็นต์การใช้จ่ายโดยประมาณของผู้เล่น ซึ่งแสดงเป็นค่าทศนิยมระหว่าง 0 ถึง 1 (รวม) ค่านี้แสดงจํานวนเงินที่ผู้เล่นปัจจุบันใช้จ่ายเมื่อเทียบกับฐานผู้เล่นที่เหลือของเกมนี้ ตัวเลขที่สูงขึ้นบ่งชี้ว่าผู้เล่นรายนี้ใช้จ่ายมากกว่า

รับสถิติของผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ด้วย C++

// Create the callback for our asynchronous fetch call.  This callback will
// log either an error or the average session length for the currently
// signed-in player.
gpg::StatsManager::FetchForPlayerCallback callback = [](gpg::StatsManager::FetchForPlayerResponse const &response) {
  if (IsError(response.status)) {
    LogE("An error occurred fetching player stats.");
  } else {
  gpg::PlayerStats const & player_stats = response.data;
    if (player_stats.HasAverageSessionLength()) {
      LogI("Average session length: %f", player_stats.AverageSessionLength());
    } else {
      LogW("Currently signed-in player had no associated average session length stats.");
    }
  }
};
// Asynchronously fetch the Player Stats.  When the fetch is finished it
// will call our callback. game_services_ is the std::unique_ptr<GameServices>
// returned by gpg::GameServices::Builder.Create()
game_services_->Stats().FetchForPlayer(callback);

รับสถิติของผู้เล่นที่ลงชื่อเข้าใช้อยู่ในปัจจุบันด้วย Objective-C

// Asynchronously fetches the Player Stats and then logs either a
// description of them or an error
[GPGPlayerStats playerStatsWithCompletionHandler:^(GPGPlayerStats *playerStats, NSError *error) {
  if (error) {
    NSLog(@"Error fetching player stats: %@", error);
  } else {
    NSLog(@"Description of stats for the currently signed-in player: %@", playerStats);
  }
}];

เคล็ดลับในการใช้ข้อมูลสถิติผู้เล่น

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

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

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