ادغام کردن «آمار بازی»

این سند نحوه ادغام «آمار بازی» در بازی‌تان را بااستفاده از «کنسول Google Play» توضیح می‌دهد. این راهنما قالب‌های ضروری فایل CSV و ZIP را پوشش می‌دهد و نحوه ایجاد، وارد کردن، و مدیریت آن‌ها را شرح می‌دهد.

ایجاد یا وارد کردن رویدادها

دو روش برای افزودن رویدادها برای اولین‌بار بااستفاده از «کنسول Google Play» وجود دارد:

ایجاد رویداد

برای ایجاد رویداد برای بازی، این مراحل را تکمیل کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - آمار بازی (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی)، افزودن رویداد > ایجاد رویداد را انتخاب کنید.
  3. در صفحه ایجاد رویداد، فرم را تکمیل کنید.
  4. روی ذخیره تغییرات کلیک کنید.

وارد کردن رویدادها

برای افزودن چند رویداد به‌طور هم‌زمان به بازی، از مراحل زیر استفاده کنید:

  1. فایل CSV رویدادها PlayerGameEvent.csv را ایجاد کنید.
  2. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  3. در صفحه سرویس‌های بازی‌های Play - آمار بازی (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی)، افزودن رویداد > وارد کردن ازطریق CSV را انتخاب کنید.
  4. در صفحه پیکربندی رویدادها، فایل CSV را برای بارگذاری رها کنید.
  5. پس‌از ایجاد رویداد، آمار را راه‌اندازی کنید.

ایجاد یا وارد کردن آمار

دو روش برای افزودن آمار برای اولین‌بار بااستفاده از «کنسول Google Play» وجود دارد:

ایجاد آمار

برای ایجاد آمار برای بازی، این مراحل را تکمیل کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - آمار بازی (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی)، افزودن آمار > ایجاد آمار را انتخاب کنید.
  3. در صفحه ایجاد آمار، فرم را تکمیل کنید.
  4. روی ذخیره تغییرات کلیک کنید.
  5. پس‌از ایجاد آمار، بازی‌تان را منتشر کنید.

وارد کردن آمار

برای وارد کردن آمار، این مراحل را دنبال کنید:

  1. فایل ZIP حاوی آمار، بومی‌سازی‌ها، و فایل‌های نماد را مطابق با رهنمودهای فایل ZIP برای آمار ایجاد کنید.
  2. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  3. در صفحه سرویس‌های بازی‌های Play - آمار بازی (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی)، افزودن آمار > وارد کردن ازطریق ZIP را انتخاب کنید.
  4. در صفحه پیکربندی آمار بازی، فایل ZIP را برای بارگذاری رها کنید.
  5. پس‌از بارگذاری همه آمار، بازی‌تان را منتشر کنید.

آزمایش کردن «آمار بازی»

برای تأیید اینکه «آمار بازی» طبق انتظار کار می‌کند، مراحل آزمایش آن را دنبال کنید:

  • برنامه فروشگاه Google Play را باز کنید؛
  • در برنامه فروشگاه Google Play، به سیستم نمایه «بازی‌های Play» خود وارد شوید.
  • آمار بازی خود را در نمایه بازیکن خود مشاهده کنید.

مشاهده گزارش‌ها در دستگاه

برای تأیید اینکه «آمار بازی» طبق طراحی کار می‌کند، گزارش‌ها را در دستگاهتان روشن کنید:

  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، بازی‌ای را انتخاب کنید.
  2. در صفحه سرویس‌های بازی‌های Play - آمار بازی (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی)، روی بازبینی و انتشار کلیک کنید.
  3. در صفحه سرویس‌های بازی‌های Play - انتشار (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > انتشار)، کنش‌ها را مرور کنید و مشکلات را برطرف کنید.
  4. روی منتشر کردن کلیک کنید. همه «آمار بازی» شما منتشر شده است.

ویرایش کردن «آمار بازی»

اگر ازقبل «آمار بازی» دارید و می‌خواهید آن را ویرایش کنید:

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. به صفحه سرویس‌های بازی‌های Play - آمار بازی بروید (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی).
  3. برای ویرایش کردن رویداد:
    1. در بخش پیکربندی رویدادها، رویدادی را انتخاب کنید.
    2. می‌توانید ویژگی‌های رویداد را اضافه یا حذف کنید.
      • نمی‌توانید نام رویداد را ویرایش کنید.
    3. روی ذخیره تغییرات کلیک کنید.
  4. برای ویرایش کردن آمار:
    1. در بخش پیکربندی «آمار بازی»، آماری را انتخاب کنید.
    2. می‌توانید فیلدهای نام آمار، شرح آمار، و نام فایل نماد را ویرایش کنید.
      • نمی‌توانید شناسه آمار، جهت پیشرفت را ویرایش کنید. واحد آمار، و جزئیات رویداد منتسب.
    3. روی ذخیره تغییرات کلیک کنید.
  5. در صفحه سرویس‌های بازی‌های Play - آمار بازی، آمار ویرایش‌شده در وضعیت دردسترس برای آزمایش‌کنندگان قرار دارد.
  6. پس‌از آزمایش کردن وضعیت، روی مرور و انتشار کلیک کنید. با این کار، بازی شما به‌همراه همه آمار به‌روزشده‌تان دوباره منتشر می‌شود.

حذف آمار بازی

پس‌از انتشار «آمار بازی»، نمی‌توان آن را حذف کرد.

می‌توانید «رویداد» یا «آمار» را در وضعیت دردسترس برای آزمایش‌کنندگان حذف کنید.

  1. در کنسول Google Play، بازی‌ای را انتخاب کنید.
  2. به صفحه سرویس‌های بازی‌های Play - آمار بازی بروید (رشد دادن تعداد کاربران > سرویس‌های بازی‌های Play > راه‌اندازی و مدیریت > آمار بازی).
  3. برای حذف کردن رویداد:
    1. در بخش پیکربندی رویدادها، رویدادی را انتخاب کنید.
    2. روی حذف رویداد کلیک کنید.
  4. برای حذف کردن آمار:
    1. در پیکربندی «آمار بازی»، آماری را که می‌خواهید حذف کنید انتخاب کنید.
    2. روی حذف آمار بازی کلیک کنید.

رهنمودهای فایل CSV برای رویدادها

ردیف اول فایل CSV ردیف سرایند است. باید رویدادها را بااستفاده از فایل CSV رویدادها وارد کنید، برای مثال، PlayerGameEvent.csv.

قالب PlayerGameEvent.csv

فایل CSV حاوی رویداد اعلام‌شده و دارایی‌های آن به‌صورت مقادیر جداشده با کاما به ترتیب زیر است:

 Event Name,Property Name,Property Type

اگر رویداد progressUpdate را برای progressionStat ارسال می‌کنید، ردیفی برای این رویداد اضافه کنید. این رویداد باید حداقل حاوی یک دارایی currentProgress از نوع INT یا STRING، به‌علاوه هر دارایی دیگری که می‌خواهید ارسال کنید باشد.

این فیلدها در جدول زیر شرح داده شده‌اند:

سرستون‌های CSV الزامی یا اختیاری مقادیر قابل قبول
نام رویداد الزامی حداکثر ۵۰ نویسه

باید فقط شامل حروف، اعداد، و زیرخط باشد.

اگر از نام رویداد ویژه progressUpdate استفاده شود، باید حاوی دارایی‌ای با نام currentProgress از نوع INT64 یا STRING باشد.
نام دارایی الزامی حداکثر ۵۰ نویسه

باید فقط شامل حروف، اعداد، و زیرخط باشد.

یکتا برای هر رویداد: نام‌های دارایی باید در رویداد یکسان یکتا باشند.

از کلیدواژه‌های رزروشده زیر استفاده نکنید: id،‏ count، key،‏ value،‏ where،‏ from،‏ and،‏ or،‏ true، یا false.
نوع ملک الزامی رشته شمارشی حساس به حروف بزرگ و کوچک که با یکی از انواع داده‌های پشتیبانی‌شده مطابقت دارد: INT64، DOUBLE، STRING، BOOL

الزامات فایل PlayerGameEvent.csv:

  • فایل حداکثر از ۲۰ نام رویداد یکتا با حداکثر ۲۰ دارایی برای هر رویداد پشتیبانی می‌کند.
  • محتوای فایل نمی‌تواند خالی باشد و باید حداقل ۱ ردیف داشته باشد.
جدول نمونه
نام رویداد نام دارایی نوع ملک
matchCompleted مدت زمان دوبرابر
matchCompleted کشته‌ها INT64
matchCompleted isWinner مقدار منطقی
matchCompleted matchType رشته
itemCollected coinsAmount INT64
itemCollected weaponType رشته
progressUpdate currentProgress INT64

رهنمودهای فایل ZIP برای آمار

می‌توانید آمار را یک‌باره بااستفاده از فایل ZIP وارد کنید. برای اطلاع از نام دقیق فایل‌هایی که باید در فایل ZIP استفاده کنید، به جدول مراجعه کنید:

نام فایل الزامی یا اختیاری مقادیر قابل قبول
RepetitiveStatsConfig.csv الزامی آمار تکرارشونده نشان‌دهنده کنش‌های درون‌بازی است که به‌طور منظم توسط بازیکنان انجام می‌شود.
ProgressionStatConfig.csv الزامی آمار پیشرفت نشان‌دهنده پیشرفت بازیکن در بازی است.
StatLocalizations.csv اختیاری ترجمه نام‌ها و شرح‌های «آمار بازی» را ارائه می‌دهد.
فایل‌های نماد الزامی نمادها در قالب PNG،‏ JPEG، یا JPG با ابعاد ۵۱۲ در ۵۱۲.

فایل ZIP باید الزامات زیر را برآورده کند:

  • حد اندازه فایل ZIP: حداکثر اندازه کل فشرده‌نشده ۱۰ مگابایت است.
  • حداکثر تعداد فایل: حداکثر ۵۳ فایل (۳ فایل CSV و ۵۰ نماد) در کل فایل بایگانی ZIP.
  • حداکثر حد آمار ترکیبی: حداکثر ۵۰ آمار کل در 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 الزامی یا اختیاری مقادیر قابل قبول
شناسه آمار الزامی حداکثر ۱۰۰ نویسه

باید فقط شامل حروف، اعداد، و زیرخط باشد. باید در بین همه آمار بازی یکتا باشد.
نام رویداد الزامی حداکثر ۵۰ نویسه

باید به «نام رویداد» تعریف‌شده در قالب PlayerGameEvent.csv ارجاع دهد.
نام خصوصیت رویداد الزامی حداکثر ۵۰ نویسه داشته باشد
نام نمایشی آمار الزامی حداکثر ۵۰ نویسه
نام نمایشی پیش‌فرض برای آمار (محل پیش‌فرض). باید در آمارها یکتا باشد.
شرح آمار الزامی حداکثر ۵۰۰ نویسه
شرح پیش‌فرض برای آمار.
نوع انبوهش الزامی حداکثر ۵۰ نویسه
SUM،‏ MAX،‏ MIN،‏ COUNT.
خصوصیت فیلتر اختیاری حداکثر ۵۰ نویسه
باید «نام دارایی» تعریف‌شده در PlayerGameEvent.csv باشد.
اپراتور فیلتر اختیاری =, !=, >, <, >=, <=
اپراتورهای مقایسه فیلتر.
مقدار فیلتر اختیاری درمقایسه با «خصوصیت فیلتر». مقدار فیلتر باید INT64, DOUBLE, BOOL, STRING باشد.
رقابتی است الزامی true, false
حد کمینه وقتی «رقابتی است» درست باشد، الزامی است حداقل امتیاز مجاز برای آمار رقابتی.
حد بیشینه وقتی «رقابتی است» درست باشد، الزامی است حداکثر امتیاز مجاز برای آمار رقابتی.
نام فایل نماد الزامی نام فایل تصویر نماد که در ریشه فایل ZIP قرار دارد. نباید با نام فایل‌های نماد استفاده‌شده در آمار تکراری تعارض داشته باشد.
جهت ارزش خوب الزامی مشخص می‌کند که آیا مقادیر بالاتر INCREASING بهتر است یا مقادیر پایین‌تر DECREASING.
واحد اختیاری واحد اندازه‌گیری برای مقادیر عددی یا مدت‌زمان خام. برای مثال، KILOMETER (کیلومتر)، SECOND (ثانیه)، PERCENTAGE (درصد)، UNITLESS (بدون واحد).

اگر نمی‌خواهید از شرط فیلتر استفاده کنید، سلول را خالی بگذارید.

جدول نمونه
شناسه آمار نام رویداد نام دارایی انبوهش نام نمایشی آمار شرح آمار خصوصیت فیلتر (اختیاری) اپراتور فیلتر (اختیاری) مقدار فیلتر (اختیاری) رقابتی است minLimit maxLimit نام فایل نماد جهت ارزش خوب واحد
1 matchCompleted مدت زمان حداکثر بقا در طولانی‌ترین موارد منطبق این نشان‌دهنده زمان بقای بازیکن در هر مسابقه است isWinner = درست درست 0 50 stat1.png کاهشی ثانیه
2 matchCompleted isWinner COUNT مسابقات برده‌شده این نشان‌دهنده تعداد مسابقاتی است که بازیکن برنده شده است isWinner = درست درست 0 50 stat3.png افزایشی
3 matchCompleted کشته‌ها SUM کشته‌ها در مسابقه تک‌به‌تک تعداد کشتن‌ها در مسابقات تک‌به‌تک matchType = «تک‌به‌تک» نادرست stat4.png افزایشی
4 itemCollected coinsAmount SUM کل طلای جمع‌آوری‌شده بازیکن درحین بازی در مسابقه سکه جمع می‌کند weaponType = «شمشیر» نادرست stat2.png افزایشی

قالب ProgressionStatConfig.csv

فایل csv حاوی رویداد اعلام‌شده و دارایی‌های آن به‌صورت مقادیر جداشده با کاما به ترتیب زیر است:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

آمار پیشرفت به‌عنوان اولین آمار به بازیکن در «نمایه بازیکن» او نشان داده خواهد شد.

این فیلدها در جدول زیر شرح داده شده‌اند:

سرستون‌های CSV الزامی یا اختیاری مقادیر قابل قبول
شناسه آمار الزامی حداکثر ۱۰۰ نویسه

باید فقط شامل حروف، اعداد، و زیرخط باشد. باید در بین همه آمار بازی یکتا باشد.
نام خصوصیت رویداد الزامی حداکثر ۵۰ نویسه

باید «نام دارایی» تعریف‌شده در PlayerGameEvent.csv باشد.
نام نمایشی آمار الزامی باید نامی منحصربه‌فرد باشد.
شرح آمار الزامی حداکثر ۵۰ نویسه
شرح پیش‌فرض برای آمار.
نام فایل نماد الزامی نام فایل تصویر نماد که در ریشه فایل 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 الزامی یا اختیاری مقادیر قابل قبول
شناسه آمار الزامی حداکثر ۱۰۰ نویسه

باید فقط شامل حروف، اعداد، و زیرخط باشد. باید در بین همه آمار بازی یکتا باشد.
نام نمایشی آمار الزامی باید نامی منحصربه‌فرد باشد.
منطقه زبانی الزامی کد منطقه زبانی، مثل en-US.
پیش‌از مشخص کردن منطقه زبان، ترجمه‌ها را برای بازی‌تان اضافه کنید. توجه داشته باشید که نمی‌توانید منطقه زبانی پیش‌فرض را مشخص کنید.

کدهای منطقه زبانی پشتیبانی‌شده را می‌توانید در فهرست زبان‌های پشتیبانی‌شده پیدا کنید.
نام نمایشی آمار بومی‌سازی‌شده اختیاری حداکثر ۵۰ نویسه. نام نمایشی آمار ترجمه‌شده برای منطقه زبانی ارائه‌شده.
شرح آمار بومی‌سازی‌شده اختیاری حداکثر ۵۰۰ نویسه. شرح آمار ترجمه‌شده برای منطقه زبانی ارائه‌شده.
جدول نمونه
شناسه آمار نام نمایشی آمار کد زبان نام آمار بومی‌سازی‌شده (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 Survie du match le plus long 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 فعلی که وارد می‌کنید وجود داشته باشند.

قوانین اعتبارسنجی نماد عبارت‌اند از:

دارایی اعتبارسنجی محدودیت / قانون اعمال‌شده
حداکثر اندازه فایل حداکثر ۱ مگابایت (۱٬۰۴۸٬۵۷۶ بایت) برای هر فایل نماد.
ابعاد دقیقاً ۵۱۲ × ۵۱۲ پیکسل (عرض = ۵۱۲، ارتفاع = ۵۱۲)
نسبت ابعادی دقیقاً ۱:۱ (نسبت ابعادی مربعی)
قالب‌های مجاز PNG ‏(png.) و JPEG ‏(jpg.،‏ jpeg.)
جای‌گذاری در ZIP باید در دایرکتوری ریشه در فایل ZIP قرار داشته باشد.
بررسی ارجاع‌شده همه نام فایل‌های نماد مشخص‌شده در ستون‌های «نام فایل نماد» باید در فایل ZIP وجود داشته باشند.
بررسی یتیم همه فایل‌های تصویری درون فایل ZIP باید حداقل با یک آمار ارجاع داده شوند.
بررسی تداخل نام فایل‌های نماد در ProgressionStatConfig.csv نباید با RepetitiveStatsConfig.csv تداخل داشته باشد.
موارد تکراری تصویری نمادهای تکراری پرچم‌گذاری شده‌اند.

رهنمودهای نماد

نمادها باید به‌صورت فایل‌های PNG،‏ JPEG، یا JPG با اندازه ۵۱۲ × ۵۱۲ و پس‌زمینه شفاف ایجاد شوند.

از یک نماد در همه زبان‌ها استفاده می‌شود، بنابراین توصیه می‌کنیم هیچ نوشتار یا محتوای بومی‌سازی‌شده‌ای را در نماد قرار ندهید.

مشخصات واحد

ستون‌های «واحد» نحوه قالب‌بندی و بومی‌سازی مقادیر آماری خام را برای بازیکنان کنترل می‌کنند.

خصوصیات آمار عددی (INT64،‏ DOUBLE)

مقدار واحد مجاز نمونه مقدار خام
(خالی) / UNITLESS / NONE 1234567
٪ / درصد / درصد ۰٫۸۵۷
مسافت/طول: سانتی‌متر، متر، کیلومتر، فوت، اینچ، مایل، یارد، میلی‌متر، نانومتر ۱۵ (کیلومتر)
سرعت: KILOMETER_PER_HOUR،‏ METER_PER_SECOND،‏ MILE_PER_HOUR ۶۰ (مایل در ساعت)

ویژگی‌های آمار مدت‌زمان (DURATION)

مقدار دسته قالب مقادیر واحد مجاز نمونه مقدار خام نمونه خروجی قالب‌بندی‌شده
UNIT_BASED / DURATION الزامی: SECOND،‏ MINUTE،‏ HOUR،‏ DAY،‏ WEEK،‏ MONTH،‏ YEAR ۵۴۰۰ ثانیه (ساعت) ‫۱٫۵ ساعت
COMPONENT_NUMERIC / HH:MM:SS / CLOCK دقت (اختیاری، پیش‌فرض WHOLE_SECONDS): WHOLE_MINUTES،‏ WHOLE_SECONDS،‏ MILLISECONDS_ONE_DIGIT،‏ MILLISECONDS_TWO_DIGITS،‏ MILLISECONDS_THREE_DIGITS ‫۳۶۶۱ ثانیه 01:01:01
COMPONENT_TEXT / TEXT کوچک‌ترین واحد (اختیاری، پیش‌فرض «ثانیه»): ثانیه، دقیقه، ساعت، روز، ماه، سال ‫۹۰۰۰۰ ثانیه ‫۱ روز ۱ ساعت

ویژگی‌های آمار غیرعددی (رشته، بولی)

ستون‌های واحد باید خالی گذاشته شود.