במאמר הזה מוסבר איך לשלב נתונים סטטיסטיים של משחקים במשחק באמצעות Google Play Console. במאמר מוסבר על הפורמטים העיקריים של קובצי CSV ו-ZIP, ומתואר איך ליצור, לייבא ולנהל אותם.
יצירת אירועים
כדי ליצור אירוע למשחק חדש שלא פורסם:
- יוצרים את קובץ ה-CSV של האירועים PlayerGameEvent.csv
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), לוחצים על הגדרת אירועים.
- בדף הגדרת אירועים, משחררים את קובץ ה-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: הגודל הכולל המקסימלי של קובץ ZIP לא דחוס הוא 10MB.
- מספר הקבצים המקסימלי: אפשר לכלול בארכיון ה-ZIP עד 53 קבצים (3 קובצי CSV ו-50 סמלים).
- המגבלה המקסימלית של נתונים סטטיסטיים משולבים: מקסימום 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 | יורד | שניות |
| 2 | matchCompleted | isWinner | COUNT | משחקים שניצחו | המספר הזה מציין את מספר המשחקים שהשחקן ניצח בהם | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | גדל | |
| 3 | matchCompleted | הריגות | SUM | הריגות במשחק 1 על 1 | מספר ההריגות במשחקי 1 על 1 | matchType | = | "1-on-1" | FALSE | stat4.png | גדל | |||
| 4 | itemCollected | coinsAmount | SUM | סה"כ הזהב שנאסף | שחקן אוסף מטבעות בזמן משחק | weaponType | = | "sword" | FALSE | stat2.png | גדל |
הפורמט של הקובץ 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 תווים. תיאור מתורגם של הנתון הסטטיסטי עבור הלוקאל הנתון. |
טבלה לדוגמה
| מזהה נתון | שם התצוגה של הנתון הסטטיסטי | קוד שפה | שם הנתון הסטטיסטי שמותאם לשוק המקומי (UTF-8) | Localized Stat Description (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 | או סה"כ נאסף | 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 |
| מרחק/אורך: CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER | 15 (קילומטר) |
| מהירות: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
מאפיינים של נתונים סטטיסטיים לא מספריים (STRING, BOOL)
העמודות של היחידות צריכות להיות ריקות.