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

במאמר הזה מוסבר איך לשלב נתונים סטטיסטיים של המשחק במשחק באמצעות Google Play Console. במאמר מוסברים הפורמטים העיקריים של קובצי CSV ו-ZIP, ומתואר איך ליצור, לייבא ולנהל אותם.

יצירה או ייבוא של אירועים

יש שתי דרכים להוסיף אירועים בפעם הראשונה באמצעות Google Play Console:

אני רוצה ליצור אירוע

כדי ליצור אירוע למשחק:

  1. ב-Google Play Console, בוחרים משחק.
  2. בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), בוחרים באפשרות הוספת אירוע > יצירת אירוע.
  3. בדף Create an event (יצירת אירוע), ממלאים את הטופס.
  4. לוחצים על שמירת השינויים.

ייבוא אירועים

כדי להוסיף כמה אירועים למשחק בבת אחת, פועלים לפי השלבים הבאים:

  1. יוצרים את קובץ ה-CSV של האירועים PlayerGameEvent.csv.
  2. ב-Google Play Console, בוחרים משחק.
  3. בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), בוחרים באפשרות הוספת אירוע > ייבוא באמצעות קובץ CSV.
  4. בדף Events configuration (הגדרת אירועים), גוררים את קובץ ה-CSV להעלאה.
  5. אחרי שיוצרים אירוע, מגדירים את הנתונים הסטטיסטיים.

יצירה או ייבוא של נתונים סטטיסטיים

יש שתי דרכים להוסיף נתונים סטטיסטיים בפעם הראשונה באמצעות Google Play Console:

יצירת נתון סטטיסטי

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

  1. ב-Google Play Console, בוחרים משחק.
  2. בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), בוחרים באפשרות הוספת נתון סטטיסטי > יצירת נתון סטטיסטי.
  3. בדף Create a stat (יצירת נתון), ממלאים את הטופס.
  4. לוחצים על שמירת השינויים.
  5. אחרי שיוצרים נתון סטטיסטי, מפרסמים את המשחק.

נתוני ייבוא

כדי לייבא נתונים סטטיסטיים:

  1. יוצרים קובץ ZIP שמכיל קובצי נתונים סטטיסטיים, גרסאות שמותאמות לשוק המקומי וסמלים, בהתאם להנחיות ליצירת קובץ ZIP של נתונים סטטיסטיים.
  2. ב-Google Play Console, בוחרים משחק.
  3. בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), בוחרים באפשרות הוספת נתון סטטיסטי > ייבוא באמצעות ZIP.
  4. בדף הגדרות נתונים סטטיסטיים של המשחק, משחררים את קובץ ה-ZIP כדי להעלות אותו.
  5. אחרי שמעלים את כל הנתונים הסטטיסטיים, מפרסמים את המשחק.

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

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

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

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

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

  1. מנקים את המטמון של חנות Google Play:

    1. פותחים את אפליקציית ההגדרות במכשיר.
    2. מקישים על אפליקציות > חנות Google Play.
    3. מקישים על אחסון ומטמון ואז על ניקוי המטמון.

  2. פותחים את האפליקציה של חנות Google Play.

  3. אפשר לראות את נתוני המשחק בקטע כמה זמן שיחקת? או בפרופיל הגיימר:

שיטה 1: שימוש בקטע 'כמה זמן שיחקת?'

עוברים לקטע מעקב אחרי זמן המשחק ומקישים עליו כדי לראות את נתוני המשחק.

שיטה 1 לבדיקת הנתונים הסטטיסטיים של המשחק היא שימוש בקטע 'מעקב אחר זמן המשחק'.
בקטע 'מעקב אחר זמן המשחק' בכרטיסייה 'הדף שלי'.

שיטה 2: שימוש בפרופיל הגיימר

  1. מקישים על הכרטיסייה אני ואז על פרופיל הגיימר.
  2. עוברים לקטע נתונים סטטיסטיים של המשחק.
  3. בקטע 'טווח זמן', בוחרים באפשרות הכול.
  4. אם המשחק לא מופיע, מקישים על הצגת כל המשחקים.
  5. בוחרים את המשחק כדי לראות את הנתונים הסטטיסטיים שלו.
שיטה 2 לבדיקת נתונים סטטיסטיים של המשחק כדי להשתמש בפרופיל הגיימר.
הקטע 'נתונים סטטיסטיים של המשחק' בפרופיל הגיימר.

הצגת היומנים במכשיר

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

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

    adb shell setprop log.tag.Games INFO
adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

  2. מוודאים שמופיעה הודעת יומן על הצלחה, כמו בדוגמה הבאה:

    Successfully uploaded batch of X events.

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

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

    BatchRecordEvents validation failed for X event(s): ...

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

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

כדי לפרסם:

  1. ב-Google Play Console, בוחרים משחק.
  2. בדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק), לוחצים על בדיקה ופרסום.
  3. בדף Play Games Services – פרסום (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > פרסום), בודקים את הפעולות ופותרים את הבעיות.
  4. לוחצים על פרסום. כל הנתונים הסטטיסטיים של המשחקים יפורסמו.

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

אם כבר יש לכם נתונים סטטיסטיים של משחקים ואתם רוצים לערוך אותם:

  1. ב-Google Play Console, בוחרים משחק.
  2. עוברים לדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק).
  3. כדי לערוך אירוע:
    1. בקטע Events configuration (הגדרת אירועים), בוחרים אירוע.
    2. אפשר להוסיף או למחוק מאפייני אירוע.
      • אי אפשר לערוך את שם האירוע.
    3. לוחצים על שמירת השינויים.
  4. כדי לערוך נתון סטטיסטי:
    1. בקטע Game Stats configuration (הגדרת נתונים סטטיסטיים של המשחק), בוחרים נתון.
    2. אפשר לערוך את השדות שם הנתון הסטטיסטי, תיאור הנתון הסטטיסטי ושם קובץ הסמל.
      • אי אפשר לערוך את מזהה הנתון הסטטיסטי או את כיוון ההתקדמות. יחידה סטטיסטית ופרטי האירוע המשויך.
    3. לוחצים על שמירת השינויים.
  5. בדף Play Games Services - נתונים סטטיסטיים של המשחק, הנתון הסטטיסטי שעורכים נמצא בסטטוס זמין לבודקים.
  6. אחרי שבודקים את הנתון, לוחצים על בדיקה ופרסום. המשחק יפורסם מחדש, יחד עם כל הנתונים הסטטיסטיים המעודכנים.

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

אחרי פרסום נתונים סטטיסטיים של המשחק, אי אפשר למחוק אותם.

אפשר למחוק אירוע או נתון סטטיסטי בסטטוס זמין לבודקים.

  1. ב-Google Play Console, בוחרים משחק.
  2. עוברים לדף Play Games Services – נתונים סטטיסטיים של המשחק (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתונים סטטיסטיים של המשחק).
  3. כדי למחוק אירוע:
    1. בקטע Events configuration (הגדרת אירועים), בוחרים אירוע.
    2. לוחצים על מחיקת האירוע.
  4. כדי למחוק סטטיסטיקה:
    1. בקטע Game Stats configuration (הגדרת נתונים סטטיסטיים של המשחק), בוחרים את הנתון שרוצים למחוק.
    2. לוחצים על מחיקת נתון סטטיסטי של משחק.

הנחיות לגבי קובצי CSV של אירועים

השורה הראשונה בקובץ ה-CSV היא שורת כותרת. חובה לייבא אירועים באמצעות קובץ CSV של אירועים, למשל, PlayerGameEvent.csv.

הפורמט של PlayerGameEvent.csv

קובץ ה-CSV מכיל אירוע מוצהר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:

 Event Name,Property Name,Property Type

אם שולחים את האירוע progressUpdate עבור progressionStat, מוסיפים שורה לאירוע הזה. האירוע הזה חייב לכלול לפחות מאפיין currentProgress מסוג INT או STRING, בנוסף לכל מאפיין אחר שרוצים לשלוח.

השדות האלה מתוארים בטבלה הבאה:

כותרות של עמודות בקובץ CSV חובה או אופציונלי ערכים מותרים
שם האירוע חובה עד 50 תווים

השם חייב לכלול רק אותיות, מספרים וקווים תחתונים.

אם משתמשים בשם האירוע המיוחד progressUpdate, צריך לכלול בו מאפיין בשם currentProgress מסוג INT64 או STRING.
שם הנכס חובה עד 50 תווים

השם חייב לכלול רק אותיות, מספרים וקווים תחתונים.

ייחודי לכל אירוע: שמות המאפיינים צריכים להיות ייחודיים בתוך אותו אירוע.

אין להשתמש במילות המפתח השמורות הבאות: id,‏ count,‏ key,‏ value,‏ where,‏ from,‏ and,‏ or,‏ true או false.
סוג הנכס חובה מחרוזת enum שרגישה לאותיות רישיות, שתואמת לאחד מסוגי הנתונים הנתמכים: INT64, DOUBLE, STRING, BOOL

דרישות לגבי קובץ PlayerGameEvent.csv:

  • הקובץ יכול להכיל עד 20 שמות אירועים ייחודיים, ועד 20 מאפיינים לכל אירוע.
  • התוכן של הקובץ לא יכול להיות ריק, והוא צריך לכלול לפחות שורה אחת.
טבלה לדוגמה
שם האירוע שם הנכס סוג הנכס
matchCompleted משך DOUBLE
matchCompleted הריגות INT64
matchCompleted isWinner BOOL
matchCompleted matchType מחרוזת (String)
itemCollected coinsAmount INT64
itemCollected weaponType מחרוזת (String)
progressUpdate currentProgress INT64

הנחיות לגבי קובץ ZIP של נתונים סטטיסטיים

אפשר לייבא את הנתונים הסטטיסטיים בבת אחת באמצעות קובץ ZIP. בטבלה הבאה מפורטים שמות הקבצים המדויקים שצריך להשתמש בהם בקובץ ה-ZIP:

שם קובץ חובה או אופציונלי ערכים מותרים
RepetitiveStatsConfig.csv חובה נתון סטטיסטי חוזר מייצג פעולות שמתרחשות במשחק באופן קבוע ומבוצעות על ידי השחקנים.
ProgressionStatConfig.csv חובה נתון סטטיסטי של התקדמות מייצג את ההתקדמות של השחקן במשחק.
StatLocalizations.csv אופציונלי השירות הזה מספק תרגומים לשמות ולתיאורים של נתונים סטטיסטיים של משחקים.
קבצי סמלים חובה סמלים בפורמט PNG,‏ JPEG או JPG בגודל ‎512 x 512 פיקסלים.

קובץ ה-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 תווים

חובה להפנות לשם האירוע שמוגדר בפורמט PlayerGameEvent.csv.
שם מאפיין האירוע חובה עד 50 תווים
השם המוצג של הנתון הסטטיסטי חובה עד 50 תווים
שם התצוגה שמוגדר כברירת מחדל לנתון הסטטיסטי (הלוקאל שמוגדר כברירת מחדל). הערך חייב להיות ייחודי בין הנתונים הסטטיסטיים.
Stat Description חובה עד 500 תווים
תיאור ברירת המחדל של הנתון.
סוג הצבירה חובה עד 50 תווים
SUM, MAX, MIN, COUNT.
מאפיין סינון אופציונלי עד 50 תווים
חייב להיות שם מאפיין שמוגדר ב-PlayerGameEvent.csv.
אופרטור סינון אופציונלי =, !=, >, <, >=, <=
אופרטורים להשוואה של מסננים.
ערך המסנן אופציונלי בהשוואה למאפיין המסנן. ערך המסנן חייב להיות INT64, DOUBLE, BOOL, STRING.
האם התחרותיות גבוהה חובה true, false
מכסה מינימלית חובה לציין ערך כשהשדה Is Competitive מוגדר ל-true הציון המינימלי המותר לנתונים סטטיסטיים תחרותיים.
מגבלה מקסימלית חובה לציין ערך כשהשדה Is Competitive מוגדר ל-true הציון המקסימלי המותר לנתונים סטטיסטיים של תחרותיות.
שם קובץ הסמל חובה שם הקובץ של תמונת הסמל שכלול בשורש של קובץ ה-ZIP. לא יכול להיות שיהיה קונפליקט עם שמות של קובצי סמלים שמשמשים לנתונים סטטיסטיים חוזרים.
כיוון טוב של תמורה חובה מציינים אם ערכים גבוהים יותר INCREASING או ערכים נמוכים יותר DECREASING הם טובים יותר.
יחידה אופציונלי יחידת המידה של ערכים מספריים או ערכי משך גולמיים. לדוגמה, KILOMETER, ‏ SECOND, ‏ PERCENTAGE, ‏ UNITLESS.

אם לא רוצים להשתמש בתנאי המסנן, משאירים את התא ריק.

טבלה לדוגמה
מזהה הנתון הסטטיסטי שם האירוע שם הנכס צבירה השם המוצג של הנתון הסטטיסטי Stat Description מסנן נכס (אופציונלי) אופרטור המסנן (אופציונלי) ערך המסנן (אופציונלי) האם התחרותיות גבוהה 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.
השם המוצג של הנתון הסטטיסטי חובה השם חייב להיות ייחודי.
Stat Description חובה תיאור ברירת המחדל של הנתון. יכול להכיל עד 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 תווים. השם המוצג המתורגם של הנתון הסטטיסטי עבור הלוקאל הנתון.
Localized Stat Description אופציונלי מקסימום 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 כמות הזהב הכוללת שנאספה שחקנית אוספת מטבעות במהלך משחק
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 specification

העמודות 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)

מאפייני נתון משך הזמן (DURATION)

ערך קטגוריית הפורמט ערכי יחידה מותרים ערך גולמי לדוגמה דוגמה לפלט מעוצב
UNIT_BASED / DURATION מאפייני חובה: SECOND, ‏ MINUTE, ‏ HOUR, ‏ DAY, ‏ WEEK, ‏ MONTH, ‏ YEAR ‫5,400 שניות (שעה) שעה וחצי
COMPONENT_NUMERIC / HH:MM:SS / CLOCK רמת הפירוט (אופציונלי, ברירת המחדל היא WHOLE_SECONDS): WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS ‫3,661 שניות 01:01:01
COMPONENT_TEXT / TEXT היחידה הקטנה ביותר (אופציונלי, ברירת המחדל היא SECONDS): SECONDS, MINUTES, HOURS, DAYS, MONTHS, YEARS ‫90,000 שניות יום אחד ושעה

מאפיינים של נתונים סטטיסטיים לא מספריים (STRING, ‏ BOOL)

צריך להשאיר את עמודות היחידות ריקות.