במאמר הזה מוסבר איך לשלב נתונים סטטיסטיים של משחקים במשחק באמצעות Google Play Console. במאמר מוסבר על הפורמטים העיקריים של קובצי CSV ו-ZIP, ומתואר איך ליצור, לייבא ולנהל אותם.
יצירת אירועים
כדי ליצור אירוע למשחק חדש שלא פורסם:
- יוצרים את קובץ ה-CSV של האירועים PlayerGameEvent.csv
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), לוחצים על הגדרת אירועים.
- בדף Events configuration (הגדרת אירועים), גוררים את קובץ ה-CSV להעלאה.
- אחרי שיוצרים אירוע, צריך להגדיר נתונים סטטיסטיים
הגדרת נתונים סטטיסטיים
אחרי שיוצרים אירוע, צריך להגדיר את הנתונים הסטטיסטיים:
- יוצרים את קובץ ה-ZIP שמכיל את הנתונים הסטטיסטיים, הלוקליזציות וקובצי הסמלים הנחיות ליצירת קובץ ZIP עם נתונים סטטיסטיים.
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), לוחצים על הגדרת נתונים סטטיסטיים.
- בדף הגדרות נתונים סטטיסטיים של המשחק, משחררים את קובץ ה-ZIP כדי להעלות אותו.
- אחרי שמעלים את כל הנתונים הסטטיסטיים, אפשר לפרסם את המשחק.
נתונים סטטיסטיים של המשחק לבדיקה
כדי לוודא שהנתונים הסטטיסטיים של המשחק פועלים כמצופה, פועלים לפי השלבים הבאים:
- מגדירים מסלול לבדיקה פנימית.
- מוסיפים חשבונות בדיקה לפרויקט המשחק בשביל הבודקים.
- יוצרים פרופיל ב-Play Games Services לאחד מחשבונות הבדיקה באמצעות אפליקציית Play Games.
- פותחים את המשחק באמצעות אותו חשבון בדיקה שדרכו נוצר הפרופיל.
- מוודאים שההודעה הקופצת "ברוכים הבאים" של Play Games Services מוצגת במסך כשהמשחק מופעל כדי לדעת שהאימות האוטומטי הצליח.
- המשתמש בחשבון הבדיקה יכול לשחק במשחק כדי להפעיל את האירועים. בודקים את תגובת ה-API כדי לדעת אם האירועים נרשמו.
פרסום נתונים סטטיסטיים של המשחק
אחרי שמסיימים את הבדיקה, צריך לפרסם את המשחק. כל האירועים והנתונים הסטטיסטיים של המשחק יפורסמו יחד איתו.
כדי לפרסם:
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), לוחצים על בדיקה ופרסום.
- בדף Play Games Services – פרסום (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > פרסום), בודקים את הפעולות ופותרים את הבעיות.
- לוחצים על פרסום. כל הנתונים הסטטיסטיים של המשחקים יפורסמו.
מחיקת נתונים סטטיסטיים של משחקים
לאחר פרסום נתונים סטטיסטיים של המשחק, לא ניתן למחוק אותם.
הנחיות לגבי קובצי CSV של אירועים
השורה הראשונה בקובץ ה-CSV היא שורת כותרת. חובה לייבא אירועים באמצעות קובץ CSV של אירועים, לדוגמה, PlayerGameEvent.csv.
פורמט PlayerGameEvent.csv
קובץ ה-CSV מכיל את האירוע שהוגדר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:
Event Name,Property Name,Property Type
אם שולחים את האירוע progressUpdate עבור progressionStat, מוסיפים שורה לאירוע הזה. האירוע הזה צריך לכלול לפחות את המאפיין currentProgress מסוג INT או STRING, וגם מאפיינים אחרים שרוצים לשלוח.
השדות האלה מתוארים בטבלה הבאה:
| כותרות עמודות ב-CSV | חובה או אופציונלי | ערכים מותרים |
|---|---|---|
| שם האירוע | חובה | עד 50 תווים השם חייב להכיל רק אותיות, מספרים וקווים תחתונים. אם משתמשים בשם האירוע המיוחד |
| שם המאפיין | חובה | עד 50 תווים השם חייב להכיל רק אותיות, מספרים וקווים תחתונים. ייחודי לכל אירוע: שמות המאפיינים חייבים להיות ייחודיים בתוך אותו אירוע. אין להשתמש במילות המפתח השמורות הבאות: |
| סוג הנכס | חובה | מחרוזת enum שרגישה לאותיות רישיות, שתואמת לאחד מסוגי הנתונים הנתמכים:
INT64, DOUBLE, STRING, BOOL
|
הדרישות לקובץ PlayerGameEvent.csv:
- הקובץ יכול להכיל עד 20 שמות אירועים ייחודיים, ועד 20 מאפיינים לכל אירוע.
- התוכן של הקובץ לא יכול להיות ריק וצריך לכלול לפחות שורה אחת.
טבלה לדוגמה
| שם האירוע | שם המאפיין | סוג הנכס |
|---|---|---|
| matchCompleted | משך | DOUBLE |
| matchCompleted | הריגות | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | מחרוזת |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | מחרוזת |
| progressUpdate | currentProgress | INT64 |
הנחיות לגבי קובצי ZIP של נתונים סטטיסטיים
אפשר לייבא את הנתונים הסטטיסטיים בבת אחת באמצעות קובץ ZIP. בטבלה הבאה מפורטים שמות הקבצים המדויקים שצריך להשתמש בהם בקובץ ה-ZIP:
| שם קובץ | חובה או אופציונלי | ערכים מותרים |
|---|---|---|
RepetitiveStatsConfig.csv
|
חובה | נתון חוזר מייצג פעולות שמתבצעות במשחק באופן קבוע על ידי השחקנים. |
ProgressionStatConfig.csv
|
חובה | נתון התקדמות מייצג את ההתקדמות של שחקן במשחק. |
StatLocalizations.csv
|
אופציונלי | מספק תרגומים לשמות ולתיאורים של נתונים סטטיסטיים של משחקים. |
| קבצי סמלים | חובה | סמלים בפורמט PNG, JPEG או JPG בגודל 512 x 512 פיקסלים. |
קובץ ה-ZIP צריך לעמוד בדרישות הבאות:
- מגבלת גודל של קובץ ZIP: הגודל הכולל המקסימלי של קובץ לא דחוס הוא 10MB.
- מספר הקבצים המקסימלי: עד 53 קבצים (3 קובצי CSV ו-50 סמלים) בסך הכול בארכיון ה-ZIP.
- מגבלת נתונים סטטיסטיים משולבים: מקסימום 50 נתונים סטטיסטיים בסך הכול בטבלאות
ProgressionStatConfig.csvו-RepetitiveStatsConfig.csv. - קובצי CSV נתמכים:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvו-StatLocalizations.csv(אופציונלי). אם רוצים להעלות רק את נתוני ההתקדמות, לא כוללים את קובץ ה-CSV של הנתונים הסטטיסטיים החוזרים ב-ZIP. אחרת, תופיע שגיאה במסוף. אותו הדבר נכון אם רוצים להעלות רק נתונים סטטיסטיים חוזרים. - קובצי תמונות של סמלים: PNG (.png) או JPEG (.jpg, .jpeg).
- כל הסמלים שמופיעה אליהם הפניה בקובצי ה-CSV צריכים להימצא בתיקיית הבסיס של קובץ ה-ZIP.
- כל קובצי התמונות שקיימים בקובץ ה-ZIP חייבים להיות מוזכרים לפחות בנתון אחד.
- מבנה הספריות: כל הקבצים צריכים להיות בבסיס קובץ ה-ZIP. אסור להשתמש בספריות משנה.
הפורמט של RepetitiveStatsConfig.csv
קובץ ה-CSV מכיל את האירוע שהוגדר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:
Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit
השדות האלה מתוארים בטבלה הבאה:
| כותרות עמודות ב-CSV | חובה או אופציונלי | ערכים מותרים |
|---|---|---|
| מזהה נתון סטטיסטי | חובה | עד 100 תווים השם חייב להכיל רק אותיות, מספרים וקווים תחתונים. הערך חייב להיות ייחודי לכל הנתונים הסטטיסטיים במשחק. |
| שם מאפיין האירוע | חובה | עד 50 תווים |
| שם התצוגה של הנתון | חובה | שם התצוגה של הנתון (לוקאל ברירת המחדל) יכול להכיל עד 50 תווים חייב להיות ייחודי בקרב הנתונים הסטטיסטיים. |
| תיאור הנתון הסטטיסטי | חובה | עד 500 תווים תיאור ברירת המחדל של הנתון. |
| סוג צבירה | חובה | עד 50 תווים SUM, MAX, MIN, COUNT. |
| סינון מאפיינים | אופציונלי | עד 50 תווים חייב להיות שם מאפיין שמוגדר ב-PlayerGameEvent.csv. |
| אופרטור סינון | אופציונלי | =, !=, >, <, >=, <=אופרטורים להשוואה של מסננים. |
| ערך המסנן | אופציונלי | בהשוואה למאפיין המסנן.
ערך המסנן חייב להיות INT64, DOUBLE, BOOL, STRING.
|
| תחרותי | חובה | true, false
|
| מכסה מינימלית | חובה כשהערך של המאפיין 'האם המחיר תחרותי' הוא true | הניקוד המינימלי שמאפשר לראות נתונים סטטיסטיים של המתחרים. |
| מגבלה מקסימלית | חובה כשהערך של המאפיין 'האם המחיר תחרותי' הוא true | הניקוד המקסימלי האפשרי לסטטיסטיקות השוואתיות. |
| שם קובץ הסמל | חובה | שם הקובץ של תמונת הסמל שכלולה בתיקיית הבסיס של קובץ ה-ZIP. השם לא יכול להיות זהה לשמות של קבצי סמלים שמשמשים בנתונים סטטיסטיים חוזרים. |
| כיוון תמורה טובה | חובה | מציינים אם ערכים גבוהים יותר INCREASING או ערכים נמוכים יותר DECREASING הם טובים יותר.
|
| יחידה | אופציונלי | יחידת המידה של ערכים מספריים או של משך זמן. לדוגמה, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
אם לא רוצים להשתמש בתנאי המסנן, משאירים את התא ריק.
טבלה לדוגמה
| מזהה נתון | שם האירוע | שם המאפיין | צבירה | שם התצוגה של הנתון | תיאור הנתון הסטטיסטי | מסנן מאפיינים (אופציונלי) | אופרטור סינון (אופציונלי) | ערך המסנן (אופציונלי) | תחרותי | minLimit | maxLimit | שם הקובץ של הסמל | מספר סידורי | כיוון תמורה טובה | יחידה |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | משך | מקסימום | הישרדות במשחק הכי ארוך | הערך הזה מציין את משך הזמן ששחקן שרד בכל משחק | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | 1 | יורד | שניות |
| 2 | matchCompleted | isWinner | COUNT | משחקים שניצחו | המספר הזה מציין את מספר המשחקים ששחקן ניצח בהם | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | 2 | גדל | |
| 3 | matchCompleted | הריגות | SUM | הריגות במשחק 1 על 1 | מספר ההריגות במשחקי 1 על 1 | matchType | = | "1-on-1" | FALSE | stat4.png | 4 | גדל | |||
| 4 | itemCollected | coinsAmount | SUM | סה"כ הזהב שנאסף | שחקן אוסף מטבעות בזמן משחק | weaponType | = | "sword" | FALSE | stat2.png | 3 | גדל |
פורמט ProgressionStatConfig.csv
קובץ ה-CSV מכיל את האירוע המוצהר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
נתון ההתקדמות יוצג כשחקן יפתח את פרופיל הגיימר שלו.
השדות האלה מתוארים בטבלה הבאה:
| כותרות עמודות ב-CSV | חובה או אופציונלי | ערכים מותרים |
|---|---|---|
| מזהה נתון סטטיסטי | חובה | עד 100 תווים השם חייב להכיל רק אותיות, מספרים וקווים תחתונים. הערך חייב להיות ייחודי לכל הנתונים הסטטיסטיים במשחק. |
| שם האירוע | חובה | עד 50 תווים חייבת להיות הפניה לשם האירוע שמוגדר בפורמט PlayerGameEvent.csv. |
| שם מאפיין האירוע | חובה | עד 50 תווים חייב להיות שם מאפיין שהוגדר בקובץ PlayerGameEvent.csv. |
| שם התצוגה של הנתון | חובה | השם חייב להיות ייחודי. |
| תיאור הנתון הסטטיסטי | חובה | התיאור המוגדר כברירת מחדל לנתון יכול להכיל עד 50 תווים. |
| שם קובץ הסמל | חובה | שם הקובץ של תמונת הסמל שכלולה בתיקיית הבסיס של קובץ ה-ZIP. השם לא יכול להיות זהה לשמות של קבצי סמלים שמשמשים בנתונים סטטיסטיים חוזרים. |
| כיוון תמורה טובה | חובה | מציינים אם ערכים גבוהים יותר INCREASING או ערכים נמוכים יותר DECREASING הם טובים יותר.
|
| יחידה | אופציונלי | יחידת המידה של ערכים מספריים או של משך זמן. לדוגמה, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
טבלה לדוגמה
| מזהה נתון | שם מאפיין האירוע | שם התצוגה של הנתון הסטטיסטי | תיאור הנתון | שם קובץ הסמל | כיוון טוב של ערך |
|---|---|---|---|---|---|
| 5 | currentProgress | רמה | השחקנים צוברים נקודות XP כשהם משחקים במשחקים ועולים ברמה. | Level.png | עלייה |
פורמט StatLocalizations.csv
קובץ ה-CSV מכיל את האירוע המוצהר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
השדות האלה מתוארים בטבלה הבאה:
| כותרות עמודות ב-CSV | חובה או אופציונלי | ערכים מותרים |
|---|---|---|
| מזהה נתון סטטיסטי | חובה | עד 100 תווים השם חייב להכיל רק אותיות, מספרים וקווים תחתונים. הערך חייב להיות ייחודי לכל הנתונים הסטטיסטיים במשחק. |
| שם התצוגה של הנתון | חובה | השם חייב להיות ייחודי. |
| לוקאל | חובה | קוד הלוקאל, למשל en-US. מוסיפים תרגומים למשחק לפני שמציינים את הלוקאל. שימו לב: אי אפשר לציין את הלוקאל שמוגדר כברירת מחדל. רשימת הקודים הנתמכים לשפות ואזורים מופיעה ב רשימת השפות הנתמכות. |
| השם המוצג של הנתון הסטטיסטי בהתאמה לשוק המקומי | אופציונלי | עד 50 תווים. שם התצוגה המתורגם של הנתון עבור הלוקאל הנתון. |
| תיאור מדד מותאם לשוק המקומי | אופציונלי | עד 500 תווים. תיאור מתורגם של הנתון עבור הלוקאל שצוין. |
טבלה לדוגמה
| מזהה נתון | שם התצוגה של הנתון הסטטיסטי | קוד שפה | Localized Stat Name (UTF-8) | תיאור מקומי של נתון (UTF-8) | 1 | הישרדות במשחק הכי ארוך | es | Supervivencia más larga en partidos | זה מציין את משך הזמן ששחקנית שורדת בכל משחק. | 1 | הישרדות במשחק הכי ארוך | fr | Survie du match le plus long | הערך הזה מציין את משך הזמן שבו שחקן שורד בכל משחק. | 4 | סה"כ הזהב שנאסף | es | סה"כ זהב שנאסף | La jugadora recoge monedas mientras juega en un partido | 4 | סה"כ הזהב שנאסף | fr | או סה"כ collecté | Le joueur collecte des pièces en jouant un match |
קובצי סמלים
הסמלים שמופיעים בקובץ .csv צריכים להיות בארכיון ה-ZIP הנוכחי שמייבאים.
כללי האימות של הסמלים הם:
| מאפיין אימות | מגבלה או כלל שנאכפים |
|---|---|
| גודל קובץ מקסימלי | גודל מקסימלי של 1MB (1,048,576 בייט) לכל קובץ סמל. |
| מידות | בדיוק 512 × 512 פיקסלים (רוחב = 512, גובה = 512) |
| יחס גובה-רוחב | 1:1 בדיוק (יחס גובה-רוחב ריבועי) |
| פורמטים מותרים | PNG (.png) ו-JPEG (.jpg, .jpeg) |
| מיקום בקובץ ZIP | הקובץ חייב להיות בתיקיית הבסיס בקובץ ה-ZIP. |
| בדיקה שאליה יש הפניה | כל שמות הקבצים של הסמלים שמצוינים בעמודות Icon File Name (שם קובץ הסמל) חייבים להיות קיימים בקובץ ה-ZIP. |
| בדיקת יתומים | כל קובצי התמונות בתוך קובץ ה-ZIP חייבים להיות מוזכרים לפחות בסטטיסטיקה אחת. |
| בדיקת התנגשויות | שמות הקבצים של הסמלים ב-ProgressionStatConfig.csv לא יכולים להיות זהים לשמות הקבצים ב-RepetitiveStatsConfig.csv.
|
| כפילויות ויזואליות | סמלים כפולים מסומנים. |
הנחיות לגבי סמלים
הסמלים צריכים להיות בפורמט PNG, JPEG או JPG ובגודל 512 x 512 פיקסלים.
אותו סמל משמש בכל הלוקאלים, ולכן לא מומלץ לכלול בסמל טקסט או תוכן שמותאם לשווקים מקומיים ספציפיים.
מפרט היחידה
העמודות Unit (יחידה) קובעות את הפורמט של ערכי הנתונים הסטטיסטיים הגולמיים ואת הלוקליזציה שלהם עבור השחקנים.
מאפייני נתונים מספריים (INT64, DOUBLE)
| ערך היחידה המותר | ערך גולמי לדוגמה |
| (Empty) / UNITLESS / NONE | 1234567 |
| % / PERCENTAGE / PERCENT | 0.857 |
| מרחק/אורך: סנטימטר, מטר, קילומטר, רגל, אינץ', מייל, יארד, מילימטר, ננומטר | 15 (קילומטר) |
| מהירות: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
מאפייני נתונים סטטיסטיים לא מספריים (STRING, BOOL)
העמודות של היחידות צריכות להיות ריקות.