נתונים סטטיסטיים של שחקנים במשחקים ל-Android

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

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

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

במדריך הזה נסביר איך להשתמש ב-Player Stats API במשחקים באמצעות שירותי Google Play Games. ממשקי ה-API נמצאים בחבילות com.google.android.gms.games.stats ו-com.google.android.gms.games.

לפני שמתחילים

לפני שמתחילים להשתמש ב-Player Stats API:

• מורידים את דוגמת הקוד ובודקים אותה.
• כדאי לעיין בהמלצות שמפורטות ברשימת המשימות לבדיקת איכות.

אחזור הלקוח של נתוני הסטטיסטיקה של השחקנים

כדי להתחיל להשתמש ב-Player Stats API, המשחק שלכם צריך לקבל קודם אובייקט PlayerStatsClient. כדי לעשות זאת, צריך להפעיל את ה-method‏ Games.getPlayerStatsClient() ולהעביר את הפעילות ואת GoogleSignInAccount של הנגן הנוכחי. במאמר כניסה למשחקים ב-Android מוסבר איך לאחזר את פרטי חשבון השחקן.

הערה: הכיתה PlayerStatsClient משתמשת בכיתה Task של שירותי Google Play כדי להחזיר תוצאות באופן אסינכרוני. מידע נוסף על השימוש במשימות לניהול עבודה בשרשור זמין במדריך למפתחים של Tasks API.

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

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

• משך סשן ממוצע: משך הסשן הממוצע של הצופה, בזמן אורך הסשן נקבע לפי משך הזמן שבו השחקן מחובר ל-Google Play Games Services.

• Days since last played: מספר הימים המשוער מאז שהמשתמש שיחק בפעם האחרונה.

• מספר הרכישות: המספר המשוער של רכישות מתוך האפליקציה של השחקן.

• מספר הסשנים: המספר המשוער של הסשנים של הנגן. הסשנים נקבעים לפי מספר הפעמים שהשחקן נכנס לחשבון ב-Google Play Games Services.

• אחוזון סשנים: הערך המשוער של אחוזון הסשנים של הצופה, שמוצג כערך עשרוני בין 0 ל-1. הערך הזה מציין כמה סשנים השחקן הנוכחי שיחק בהשוואה לשאר בסיס השחקנים של המשחק. מספרים גבוהים יותר מציינים שהנגן הזה שיחק יותר סשנים.

• אחוזון ההוצאות: אחוזון ההוצאות המשוער של הצופה, שמוצג כערך עשרוני בין 0 ל-1. הערך הזה מציין את הסכום שהשחקן הנוכחי הוציא בהשוואה לשאר בסיס השחקנים של המשחק. מספרים גבוהים יותר מציינים שהשחקן הזה הוצא יותר כסף.

סוגי נתוני הנגן הבאים הוצאו משימוש ותמיד מחזירים ערך קבוע לא מוגדר:

• סבירות לנטישה: התחזית לגבי הנטישה של שחקן ביום הבא, שמוצגת כערך עשרוני בין 0 (סבירות נמוכה לנטישה) ל-1 (סבירות גבוהה לנטישה), כולל. נטישה מוגדרת כ-7 ימים של חוסר פעילות.
• Spend probability: ההסתברות המשוערת שהשחקן יבחר להוציא כסף במשחק הזה, שמוצגת כערך עשרוני בין 0 (הסתברות נמוכה להוצאה) ל-1 (הסתברות גבוהה להוצאה).
• סה"כ הוצאות ב-28 הימים הבאים: הסכום הכולל המשוער שהשחקנים יוציאו במשחק הזה ב-28 הימים הבאים.
• סבירות גבוהה להוצאה: הסבירות המשוערת שלפיה שחקן יבלה ב-28 הימים הבאים סכום שנמצא ב-95% העליונים או יותר מתוך כלל השחקנים של המשחק. הערך הזה מוצג כערך עשרוני בין 0 (הסתברות נמוכה להפוך למשתמש שמבצע הוצאות גבוהות) ל-1 (הסתברות גבוהה להפוך למשתמש שמבצע הוצאות גבוהות).

אחזור נתונים של סטטיסטיקות של שחקנים

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

1. קוראים ל-method‏ PlayerStatsClient.loadPlayerStats().
2. אם הקריאה תתבצע בהצלחה, שירותי Google Play Games יחזירו אובייקט Task שיטוען אובייקט PlayerStats באופן אסינכרוני. אפשר להשתמש בשיטות של האובייקט הזה כדי לאחזר נתונים על הפעילויות של השחקן המחובר באפליקציה.

הנה דוגמה:

public void checkPlayerStats() {
  Games.getPlayerStatsClient(this, GoogleSignIn.getLastSignedInAccount(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());
          }
        }
      });
}

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

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

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

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