הוספת נתונים סטטיסטיים של שחקנים למשחק שלך

בעקבות הוצאה משימוש של Google Sign-In API, אנחנו מסירים את ה-SDK בגרסה Games v1 בשנת 2026. אחרי פברואר 2025, לא תהיה לך אפשרות לפרסם ב-Google Play משחקים ששולבו לאחרונה עם ה-SDK בגרסה Games v1. מומלץ להשתמש ב-SDK בגרסה Games v2.
משחקים קיימים עם שילובים קודמים של Games v1 ימשיכו לפעול למשך כמה שנים, אבל מומלץ לעבור לגרסה 2 החל מיוני 2025.
המדריך הזה מיועד לשימוש ב-Play Games Services SDK בגרסה 1. ‫C++ SDK for Play Games Services v2 עדיין לא זמין.

ה-API של נתוני השחקנים מאפשר לכם להתאים את חוויית המשחק לפלחים ספציפיים של שחקנים ולשלבים שונים במחזור החיים של השחקן. אתם יכולים ליצור חוויות מותאמות אישית לכל פלח של שחקנים, על סמך ההתקדמות, ההוצאות והמעורבות שלהם. לדוגמה, אפשר להשתמש ב-API הזה כדי לנקוט פעולות יזומות לעידוד שחקן פחות פעיל לחזור לשחק במשחק, למשל על ידי הצגה וקידום של פריטים חדשים במשחק כשהשחקן נכנס לחשבון.

במדריך הזה מוסבר איך להשתמש ב-Player Stats API באפליקציית C++‎ או Objective-C מקורית.

הסבר בסיסי על נתונים סטטיסטיים של שחקנים

אתם יכולים להשתמש בממשקי Player Stats API כדי לאחזר נתונים על הפעילות של שחקן במשחק. סוגי נתוני השחקנים שאפשר לאחזר כוללים:

• משך סשן ממוצע: משך הסשן הממוצע של הצופה בדקות. אורך הסשן נקבע לפי הזמן שבו שחקן מחובר ל-Google Play Games Services.
• סבירות לנטישה: התחזית לגבי הסבירות ששחקן ינטוש את המשחק ביום הבא. הערך שמוצג הוא 0 (סבירות נמוכה לנטישה) או 1 (סבירות גבוהה לנטישה). ההגדרה של נטישה היא 7 ימים של חוסר פעילות.
• ימים מאז המשחק האחרון: מספר הימים המשוער שעברו מאז שהשחקן שיחק לאחרונה.
• מספר הרכישות: המספר המשוער של רכישות מתוך האפליקציה שבוצעו על ידי השחקן.
• מספר הסשנים: המספר המשוער של סשנים של הנגן. החישוב של סשנים מתבסס על מספר הפעמים ששחקן מתחבר ל-Google Play Games Services.
• Session percentile: The approximation of sessions percentile for the player, given as a decimal value between 0 and 1 (inclusive). הערך הזה מציין כמה סשנים השחקן הנוכחי שיחק בהשוואה לשאר בסיס השחקנים של המשחק. מספרים גבוהים יותר מציינים שהשחקן הזה שיחק ביותר סשנים.
• Spend percentile: The approximate spend percentile of the player, given as a decimal value between 0 and 1 (inclusive). הערך הזה מציין כמה כסף השחקן הנוכחי הוציא בהשוואה לשאר השחקנים במשחק. מספרים גבוהים יותר מציינים שהשחקן הזה הוציא יותר כסף.

קבלת נתונים סטטיסטיים של שחקן שמחובר כרגע באמצעות 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);
  }
}];

טיפים לשימוש בנתוני סטטיסטיקה של שחקנים

ה-API של נתוני Play מאפשר לכם לזהות בקלות סוגים שונים של שחקנים על סמך רמת המעורבות שלהם וההתנהגות שלהם בכל הנוגע להוצאות, ולהחיל אסטרטגיות מתאימות כדי לשפר את חוויית המשחק שלהם.

בטבלה הבאה מפורטים כמה פלחי צופים לדוגמה ואסטרטגיות מומלצות לעידוד מעורבות:

פלח של נגן	אסטרטגיית מעורבות
שחקנים קבועים עם מספר גבוה של סשנים ודירוג טוב באחוזון ההוצאות, שלא שיחקו בשבוע האחרון או יותר.	שליחת התראה על הנחה או על בונוס מיוחד שזמינים אם הם יחזרו לשחק. הצגת הודעת חזרה למשחק שכוללת הכרה בהישגים מרשימים, ומתן תג שנועד לעודד חזרה למשחק.
שחקנים עם רמת מעורבות גבוהה באחוזון הוצאות נמוך.	התאמת הבונוסים כדי לעודד אותם להזמין את החברים שלהם להתקין את המשחק ולהצטרף אליו. הגישה הזו מתבססת על ההנאה שהשחקן חווה מהמשחק, כדי לגייס שחקנים חדשים.
שחקנים עם הוצאות גבוהות שמראים סימנים של מיצוי הפוטנציאל ומתחילים לשחק בתדירות נמוכה יותר.	כדי לעורר עניין, כדאי להתאים את הבונוסים, למשל על ידי הצעת כלים, כלי נשק או הנחות שווים לזמן קצר. בפעם הבאה שהשחקן יתחבר, יוצג לו סרטון שמפנה אותו לתכונות של הקהילה, כמו התקפות של שבטים, שמעודדות מעורבות תכופה וארוכה יותר.