בעזרת ה-API של הנתונים הסטטיסטיים של השחקנים, אפשר להתאים את חוויות המשחק לפלחים ספציפיים של שחקנים ולשלבים שונים במחזור החיים של השחקן. ניתן ליצור חוויות מותאמות אישית לכל פלח שחקנים, על סמך ההתקדמות, ההוצאה והמעורבות של השחקנים. לדוגמה, אפשר להשתמש ב-API הזה כדי לבצע פעולות יזומות כדי לעודד שחקנים עם רמת פעילות נמוכה יותר ליצור עניין מחודש במשחק, למשל על ידי הצגת פריטים חדשים במשחקים וקידום שלהם בזמן הכניסה.
במדריך הזה מוסבר איך משתמשים ב-API של סטטיסטיקות הנגן במשחקים באמצעות שירותי המשחקים של Google Play. ממשקי ה-API נמצאים בחבילות com.google.android.gms.games.stats
ו-com.google.android.gms.games
.
לפני שמתחילים
לפני שמתחילים להשתמש ב-API של נגן הנתונים:
- מורידים את הקוד לדוגמה ובודקים אותו.
- עליכם להכיר את ההמלצות שמתוארות ברשימת המשימות לשיפור האיכות.
קבלת לקוח הנתונים הסטטיסטיים של הנגן
כדי להתחיל להשתמש ב-API לנתונים סטטיסטיים של הנגן, המשחק צריך תחילה לקבל אובייקט PlayerStatsClient
. תוכלו לעשות זאת על ידי קריאה לשיטה Games.getPlayerStatsClient()
והעברת הפעילות.
נתונים סטטיסטיים בסיסיים של הנגן
תוכלו להשתמש ב-API של הנתונים הסטטיסטיים של השחקנים כדי לאחזר נתונים על הפעילות של השחקן בתוך המשחק. סוגי נתוני הנגן שניתן לאחזר כוללים:
משך סשן ממוצע: משך הסשן הממוצע של השחקן בדקות. משך הסשן נקבע לפי השעה שבה השחקן מחובר לשירותי Google Play Games.
ימים מאז ההפעלה האחרונה: המספר המשוער של ימים מאז ההפעלה האחרונה של השחקן.
מספר הרכישות: המספר המשוער של רכישות מתוך הנגן.
מספר סשנים: המספר המשוער של סשנים של הנגן. הסשנים נקבעים לפי מספר הפעמים ששחקן נכנס לשירותים של Google Play Games.
האחוזון של ביקורים: הערכה של אחוזון הביקורים של השחקן, בהינתן ערך עשרוני בין 0 ל-1, כולל. הערך הזה מציין כמה סשנים השחקן הנוכחי שיחק בהשוואה לשאר השחקנים במשחק הזה. ככל שהמספר גבוה יותר, סימן שלנגן הזה יש יותר ביקורים.
אחוזון ההוצאה: אחוז ההוצאה המשוער של השחקן, בהינתן ערך עשרוני בין 0 ל-1, כולל. הערך הזה מראה כמה הוציא השחקן הנוכחי בהשוואה לשאר בסיס השחקנים של המשחק. מספרים גבוהים יותר מציינים שהנגן הזה הוציא יותר כסף.
הסוגים הבאים של נתוני הנגן יצאו משימוש ויחזירו קבוע ערך לא מוגדר:
- סבירות נטישה: התחזית של האפשרות שנגן יעזוב ביום הבא, בהינתן ערך עשרוני בין 0 (הסתברות נמוכה לנטישה) עד 1 (הסתברות גבוהה לנטישה) כולל. 'נטישה' מוגדרת כ-7 של חוסר פעילות.
- הסתברות להוצאה: ההסתברות המשוערת של השחקן לבחור להוציא את המשחק הזה, כשהוא מוצג כערך עשרוני בין 0 (הסתברות הוצאה נמוכה) ל-1 (הסתברות גבוהה להוצאה) כולל.
- ההוצאה הכוללת ב-28 הימים הבאים: ההוצאה הכוללת הצפויה לשחקנים במהלך 28 הימים הבאים במשחק הזה.
- סבירות גבוהה להוצאה גבוהה: ההסתברות המשוערת שבמהלך 28 הימים הבאים, השחקן יוציא סכום שהוא באחוזון ה-95 או יותר מבסיס השחקנים במשחק הזה. הנתון הזה מצוין כערך עשרוני בין 0 (הסתברות נמוכה להפוך להוצאה גבוהה) ל-1 (הסתברות גבוהה להפוך להוצאה גבוהה).
מתבצע אחזור נתונים סטטיסטיים של הנגן
כדי לאחזר נתונים סטטיסטיים של הנגן עבור הנגן המחובר כעת, בצע את הפעולות הבאות:
- כדאי להפעיל את השיטה
PlayerStatsClient.loadPlayerStats()
. - אם השיחה הושלמה בהצלחה, שירות המשחקים של Google Play 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()); } } }); }
טיפים לשימוש בנתונים הסטטיסטיים של הנגן
Play API API מאפשר לזהות בקלות סוגים שונים של שחקנים, על סמך המעורבות שלהם וההוצאות שלהם, וליישם אסטרטגיות מתאימות כדי לשפר את חוויית המשחק שלהם.
בטבלה הבאה מפורטים כמה דוגמאות לפלחי שחקנים ולאסטרטגיות מומלצות ליצירת מעורבות:
פלח שחקנים | אסטרטגיית מעורבות |
---|---|
שחקנים פופולריים שיש להם מספר גדול של סשנים ואחוז הוצאה גבוה, אבל לא שיחקו בשבוע האחרון או יותר. |
|
שחקנים עם רמת מעורבות גבוהה באחוזון ההוצאות הנמוך. |
|
שחקנים שמוציאים את דרכם הרבה פעמים, מראים שיאים ומתחילים לשחק בתדירות נמוכה יותר. |
|
שחקנים עם הסתברות הוצאה גבוהה או נמוכה מאוד. |
|