במאמר הזה מוסבר איך לשלב את נתוני הגיימינג שלך במשחק באמצעות Google Play Console. במאמר מוסברים הפורמטים החיוניים של קובצי CSV ו-ZIP, ומתואר איך ליצור, לייבא ולנהל אותם.
יצירה או ייבוא של אירועים
יש שתי דרכים להוסיף אירועים בפעם הראשונה באמצעות Google Play Console:
- יצירת אירוע: הוספת אירוע אחד בכל פעם.
- ייבוא אירועים: ייבוא של כמה אירועים.
אני רוצה ליצור אירוע
כדי ליצור אירוע למשחק:
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך), לוחצים על הוספת אירוע > יצירת אירוע.
- בדף יצירת אירוע, ממלאים את הטופס.
- לוחצים על שמירת השינויים.
ייבוא אירועים
כדי להוסיף כמה אירועים למשחק בבת אחת, פועלים לפי השלבים הבאים:
- יוצרים את קובץ ה-CSV של האירועים PlayerGameEvent.csv.
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך), לוחצים על הוספת אירוע > ייבוא באמצעות קובץ CSV.
- בדף הגדרת אירועים, גוררים את קובץ ה-CSV כדי להעלות אותו.
- אחרי שיוצרים אירוע, מגדירים נתונים סטטיסטיים.
יצירה או ייבוא של נתונים סטטיסטיים
יש שתי דרכים להוסיף נתונים סטטיסטיים בפעם הראשונה באמצעות Google Play Console:
- יצירת נתון סטטיסטי: מוסיפים נתון סטטיסטי אחד בכל פעם.
- ייבוא נתונים סטטיסטיים: ייבוא של כמה נתונים סטטיסטיים.
יצירת נתון סטטיסטי
כדי ליצור נתון סטטיסטי למשחק:
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך), לוחצים על הוספת נתון > יצירת נתון.
- בדף יצירת נתון סטטיסטי, ממלאים את הטופס.
- לוחצים על שמירת השינויים.
- אחרי שיוצרים נתון, מפרסמים את המשחק.
ייבוא נתונים סטטיסטיים
כדי לייבא נתונים סטטיסטיים, פועלים לפי השלבים הבאים:
- יוצרים את קובץ ה-ZIP שמכיל קובצי נתונים סטטיסטיים, גרסאות שמותאמות לשוק המקומי וסמלים, בהתאם להנחיות ליצירת קובץ ZIP של נתונים סטטיסטיים.
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך), לוחצים על הוספת נתון > ייבוא באמצעות קובץ ZIP.
- בדף הגדרת נתוני הגיימינג שלך, גוררים את קובץ ה-ZIP כדי להעלות אותו.
- אחרי שמעלים את כל הנתונים הסטטיסטיים, מפרסמים את המשחק.
בדיקת נתוני הגיימינג שלך
כדי לוודא שנתוני הגיימינג שלך פועלים כמצופה, פועלים לפי השלבים הבאים:
- פותחים את האפליקציה של חנות Google Play.
- נכנסים לפרופיל ב-Play Games באפליקציית חנות Google Play.
- לצפות בנתוני הגיימינג בפרופיל הגיימר שלכם.
איך רואים את היומנים במכשיר
כדי לוודא שנתוני הגיימינג שלך פועלים כמו שצריך, מפעילים את היומנים במכשיר:
מפעילים ניפוי באגים של adb במכשיר ומריצים את הפקודות הבאות בטרמינל:
adb shell setprop log.tag.Games INFO adb logcat -s "PlayGamesServices[GameStatsAgent]:I"
מוודאים שמופיעה הודעת יומן על הצלחה, כמו בדוגמה הבאה:
Successfully uploaded batch of X events.
הערה: ה-API תומך בהעלאות חלקיות, ולכן יומן המידע הזה מציין שהקבוצה עובדה. אם אירועים ספציפיים בקבוצה נכשלו באימות הסכימה, יומן שגיאות יופיע לפני ההודעה הזו.
אם אירועים שנשלחו נכשלו באימות, תופיע הודעת שגיאה עם פירוט על הכישלון:
BatchRecordEvents validation failed for X event(s): ...
פרסום נתוני הגיימינג שלך
אחרי שתסיימו את הבדיקה, תצטרכו לפרסם את המשחק. כל האירועים והנתונים הסטטיסטיים של המשחק יפורסמו יחד איתו.
כדי לפרסם:
- ב-Google Play Console, בוחרים משחק.
- בדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך), לוחצים על בדיקה ופרסום.
- בדף Play Games Services – פרסום (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > פרסום), בודקים את הפעולות ופותרים את הבעיות.
- לוחצים על פרסום. כל נתוני הגיימינג שלך יפורסמו.
עריכת נתוני הגיימינג שלך
אם כבר יש לכם נתוני הגיימינג שלכם ואתם רוצים לערוך אותם:
- ב-Google Play Console, בוחרים משחק.
- עוברים לדף Play Games Services – נתוני הגיימינג שלך (הגדלת מספר המשתמשים > Play Games Services > הגדרה וניהול > נתוני הגיימינג שלך).
- כדי לערוך אירוע:
- בקטע הגדרת אירועים, בוחרים אירוע.
- אפשר להוסיף או למחוק מאפייני אירועים.
- אי אפשר לערוך את שם האירוע.
- לוחצים על שמירת השינויים.
- כדי לערוך נתון:
- בקטע הגדרת נתוני הגיימינג שלך, בוחרים נתון.
- אתם יכולים לערוך את השדות שם הנתון הסטטיסטי, תיאור הנתון הסטטיסטי ושם קובץ הסמל.
- אי אפשר לערוך את מזהה הנתון הסטטיסטי ואת כיוון ההתקדמות. יחידת סטטיסטיקה ופרטי האירוע המשויך.
- לוחצים על שמירת השינויים.
- בדף Play Games Services – נתוני הגיימינג שלך, הנתון הסטטיסטי שנערך נמצא בסטטוס זמין לבודקים.
- אחרי שבודקים את הנתון הסטטיסטי, לוחצים על בדיקה ופרסום. המשחק יפורסם מחדש, יחד עם כל הנתונים הסטטיסטיים המעודכנים.
מחיקת נתוני הגיימינג שלך
אחרי שמפרסמים את נתוני הגיימינג שלך, אי אפשר למחוק אותם.
אפשר למחוק אירוע או נתון סטטיסטי בסטטוס זמין לבודקים.
- ב-Google Play Console, בוחרים משחק.
- עוברים לדף 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 | מחרוזת (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.
- מספר הקבצים המקסימלי: עד 53 קבצים בסך הכול (3 קובצי CSV ו-50 סמלים) בארכיון ה-ZIP.
- מגבלת הנתונים הסטטיסטיים המשולבים: עד 50 נתונים סטטיסטיים בסך הכול ב-
ProgressionStatConfig.csvוב-RepetitiveStatsConfig.csv. - קובצי CSV נתמכים:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvו-StatLocalizations.csv(אופציונלי). אם אתם רוצים להעלות רק נתונים סטטיסטיים של התקדמות, אל תכללו את קובץ ה-CSV של הנתונים הסטטיסטיים החוזרים בקובץ ה-ZIP. אחרת, תוצג שגיאה ב-Play Console. אותו דבר נכון גם אם אתם רוצים להעלות רק נתונים סטטיסטיים שחוזרים על עצמם. - קובצי תמונות של סמלים: 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 תווים השם המוצג שמוגדר כברירת מחדל לנתון הסטטיסטי (הלוקאל שמוגדר כברירת מחדל). חייב להיות ייחודי בכל הנתונים הסטטיסטיים. |
| תיאור הנתון הסטטיסטי | חובה | עד 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. |
אם אתם לא רוצים להשתמש בתנאי הסינון, השאירו את התא ריק.
טבלה לדוגמה
| מזהה הנתון הסטטיסטי | שם האירוע | שם הנכס | צבירה | השם המוצג של הנתון הסטטיסטי | תיאור הנתון הסטטיסטי | מאפיין המסנן (אופציונלי) | אופרטור המסנן (אופציונלי) | ערך המסנן (אופציונלי) | תחרותי | 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 | חיסולים במשחק אחד על אחד | מספר ההריגות במשחקי אחד על אחד | matchType | = | "אחד על אחד" | FALSE | stat4.png | גדל | |||
| 4 | itemCollected | coinsAmount | SUM | סה"כ זהב שנאסף | שחקן אוסף מטבעות במהלך משחק | weaponType | = | "חרב" | FALSE | stat2.png | גדל |
הפורמט של ProgressionStatConfig.csv
קובץ ה-CSV מכיל אירוע מוצהר ואת המאפיינים שלו כערכים מופרדים בפסיקים בסדר הבא:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
הנתון הסטטיסטי של ההתקדמות יוצג כנתון הסטטיסטי הראשון לשחקן בפרופיל שלו ב-Play Games.
השדות האלה מתוארים בטבלה הבאה:
| כותרות העמודות בקובץ CSV | חובה או אופציונלי | ערכים קבילים |
|---|---|---|
| מזהה הנתון הסטטיסטי | חובה | עד 100 תווים השם יכול להכיל רק אותיות, מספרים וקווים תחתונים. המזהה חייב להיות ייחודי בכל הנתונים הסטטיסטיים במשחק. |
| שם המאפיין של האירוע | חובה | עד 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) | תיאור הנתון הסטטיסטי שמותאם לשוק המקומי (UTF-8) |
|---|---|---|---|---|
| 1 | ההתאמה הארוכה ביותר – הישרדות | es | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. |
| 1 | ההתאמה הארוכה ביותר – הישרדות | fr | הישרדות במשחק הארוך ביותר | Cela indique la durée de survie d'un joueur dans n'importe quel match. |
| 4 | סה"כ זהב שנאסף | es | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido |
| 4 | סה"כ זהב שנאסף | fr | Or total 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. |
| בדיקה של קובץ עזר | כל שמות הקבצים של הסמלים שצוינו בעמודות "שם קובץ הסמל" חייבים להיות קיימים בקובץ ה-ZIP. |
| בדיקת קבצים ללא בעלים | כל קובצי התמונות ב-ZIP צריכים להיות מקושרים לפחות לנתון סטטיסטי אחד. |
| בדיקת התנגשויות | שמות הקבצים של הסמלים ב-ProgressionStatConfig.csv לא יכולים להתנגש עם RepetitiveStatsConfig.csv.
|
| כפילויות ויזואליות | סמלים כפולים מסומנים. |
הנחיות לגבי סמלים
הסמלים צריכים להיות בפורמט PNG, JPEG או JPG, בגודל 512 x 512 פיקסלים ועם רקע שקוף.
אותו סמל משמש בכל הלוקאלים, ולכן לא מומלץ לכלול בסמל טקסט או תוכן שמותאם לשווקים מקומיים ספציפיים.
מפרט היחידה
העמודות של היחידות קובעות את הפורמט של ערכי הנתונים הסטטיסטיים הגולמיים ואת הלוקליזציה שלהם לשחקנים.
מאפיינים של נתונים סטטיסטיים מספריים (INT64, DOUBLE)
| ערך יחידה מותר | ערך גולמי לדוגמה |
| (ריק) / ללא יחידות / ללא | 1234567 |
| % / PERCENTAGE / PERCENT | 0.857 |
| מרחק/אורך: סנטימטר, מטר, קילומטר, רגל, אינץ', מייל, יארד, מילימטר, ננומטר | 15 (KILOMETER) |
| מהירות: 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)
צריך להשאיר את עמודות היחידות ריקות.