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

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

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

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

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

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

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

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

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