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

במדריך הזה מוסבר איך להשתמש ב-API של הנתונים הסטטיסטיים של השחקנים ב-Google Play Games Services. אפשר להשתמש ב-API של נתוני השחקן כדי לאחזר נתונים על הפעילות של שחקן בתוך המשחק.

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

תוכלו למצוא את ממשקי ה-API com.google.android.gms.games.stats ו-com.google.android.gms.games חבילות.

סוגי נתוני הנגן שניתן לאחזר כוללים:

• משך סשן ממוצע: משך הסשן הממוצע של הנגן דקות. משך הסשן נקבע לפי שעת הכניסה של השחקן שירותי Google Play Games.

• ימים מאז ההפעלה האחרונה: מספר הימים המשוער שחלפו מאז השחקן שיחקת לאחרונה.

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

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

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

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

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

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

לפני שמתחילים להשתמש ב-API של הנתונים הסטטיסטיים של הנגן:

• הורדה ובדיקה של דוגמת קוד.
• מומלץ להכיר את ההמלצות שמתוארות רשימת משימות איכות.

איתור הלקוח

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

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

אחזור הנתונים

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

1. קוראים לפונקציה PlayerStatsClient.loadPlayerStats() .

2. אם השיחה בוצעה בהצלחה, Google Play Games Services מחזיר 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 מאפשר לכם לזהות בקלות סוגים שונים של נגנים, בהתבסס על את מעורבות המשתמשים וההוצאות שלהם, וליישם אסטרטגיות מתאימות לשפר את חוויית המשחק שלהם.

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