این سند نحوه ادغام آمار بازی (Game Stats) در بازی شما با استفاده از کنسول گوگل پلی (Google Play Console) را توضیح میدهد. این سند فرمتهای ضروری فایلهای CSV و ZIP را پوشش میدهد و نحوه ایجاد، وارد کردن و مدیریت آنها را شرح میدهد.
ایجاد رویدادها
برای ایجاد رویداد برای یک بازی جدید و منتشر نشده، این مراحل را انجام دهید:
- فایل CSV رویدادها با نام PlayerGameEvent.csv را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «رویدادهای راهاندازی» را انتخاب کنید.
- در صفحه پیکربندی رویدادها ، فایل CSV را برای آپلود رها کنید.
- بعد از اینکه یک رویداد ایجاد کردید، باید آمار را تنظیم کنید
آمار را تنظیم کنید
پس از ایجاد یک رویداد، باید آمار را تنظیم کنید:
- فایل زیپ حاوی آمار، محلیسازیها و فایلهای آیکون را ایجاد کنید . دستورالعملهای فایل زیپ برای آمار .
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «تنظیم آمار» را انتخاب کنید.
- در صفحه پیکربندی آمار بازی ، فایل زیپ را برای آپلود رها کنید.
- بعد از اینکه تمام آمارها را آپلود کردید، میتوانید بازی خود را منتشر کنید.
آمار بازی آزمایشی
برای تأیید اینکه آمار بازی طبق برنامه کار میکند، مراحل آزمایش آنها را دنبال کنید:
- یک مسیر آزمایشی داخلی راهاندازی کنید.
- حسابهای آزمایشی را برای آزمایشکنندگان به پروژه بازی خود اضافه کنید .
- با استفاده از برنامه Play Games، برای یکی از حسابهای آزمایشی، پروفایل Play Games Services ایجاد کنید.
- بازی را با استفاده از همان حساب آزمایشی که نمایه خدمات بازیهای Play را برای آن ایجاد کردهاید، باز کنید.
- مطمئن شوید که پیام «خوش آمدید» سرویسهای بازیهای Play روی صفحه نمایش داده میشود که نشاندهندهی تأیید موفقیتآمیز احراز هویت خودکار در هنگام اجرای بازی است.
- کاربر حساب آزمایشی میتواند بازی را انجام دهد تا رویدادها را فعال کند. پاسخ API را بررسی کنید تا ببینید آیا رویدادها ثبت شدهاند یا خیر.
آمار بازی را منتشر کنید
پس از اتمام آزمایش، باید بازی خود را منتشر کنید. تمام رویدادها و آمار بازی شما به همراه آن منتشر میشوند.
برای انتشار، مراحل زیر را دنبال کنید:
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، روی «بررسی و انتشار» کلیک کنید.
- در صفحه خدمات بازیهای Play - انتشار ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > انتشار )، اقدامات را بررسی کرده و مشکلات را برطرف کنید.
- روی انتشار کلیک کنید. تمام آمار بازی شما منتشر میشود.
آمار بازی را حذف کنید
پس از انتشار آمار بازی، دیگر نمیتوان آن را حذف کرد.
دستورالعملهای فایل CSV برای رویدادها
ردیف اول فایل CSV، ردیف هدر است. شما باید رویدادها را با استفاده از فایل CSV رویدادها، مثلاً PlayerGameEvent.csv ، وارد کنید.
فرمت PlayerGameEvent.csv
فایل CSV شامل رویداد اعلامشده و ویژگیهای آن است که به ترتیب زیر با کاما از هم جدا شدهاند:
Event Name,Property Name,Property Type
اگر رویداد progressUpdate را برای progressionStat ارسال میکنید، یک ردیف برای این رویداد اضافه کنید. این رویداد باید حداقل شامل یک ویژگی currentProgress از نوع INT یا STRING، به علاوه هر ویژگی دیگری که میخواهید ارسال کنید، باشد.
این فیلدها در جدول زیر شرح داده شدهاند:
| سرستونهای CSV | الزامی یا اختیاری | مقادیر پذیرفته شده |
|---|---|---|
| نام رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر فقط باید شامل حروف، اعداد و زیرخط (_) باشد. اگر از نام رویداد ویژه |
| نام ملک | مورد نیاز | حداکثر ۵۰ کاراکتر فقط باید شامل حروف، اعداد و زیرخط (_) باشد. منحصر به فرد در هر رویداد: نامهای ویژگی باید در همان رویداد منحصر به فرد باشند. از کلمات کلیدی رزرو شده زیر استفاده نکنید: |
| نوع ملک | مورد نیاز | رشته شمارشی حساس به حروف بزرگ و کوچک که با یکی از انواع داده پشتیبانی شده مطابقت دارد: INT64 ، DOUBLE ، STRING ، BOOL |
الزامات فایل PlayerGameEvent.csv:
- این فایل حداکثر از ۲۰ نام رویداد منحصر به فرد، با حداکثر ۲۰ ویژگی برای هر رویداد، پشتیبانی میکند.
- محتوای فایل نمیتواند خالی باشد و باید حداقل ۱ ردیف داشته باشد.
جدول نمونه
| نام رویداد | نام ملک | نوع ملک |
|---|---|---|
| مسابقهتکمیل شد | مدت زمان | دو برابر |
| مسابقهتکمیل شد | می کشد | INT64 |
| مسابقهتکمیل شد | برنده است | بول |
| مسابقهتکمیل شد | نوع تطابق | رشته |
| موردجمع آوری شده | سکههامقدار | INT64 |
| موردجمع آوری شده | نوع سلاح | رشته |
| پیشرفتبهروزرسانی | پیشرفت فعلی | INT64 |
دستورالعملهای فایل زیپ برای آمار
شما میتوانید آمار را به طور همزمان با استفاده از یک فایل 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 آمار تکراری را در فایل زیپ قرار ندهید؛ در غیر این صورت، کنسول خطایی صادر میکند. اگر میخواهید فقط آمار تکراری را آپلود کنید، همین امر صدق میکند. - فایلهای تصویر آیکون: PNG (.png) یا JPEG (.jpg، .jpeg).
- تمام آیکونهای ارجاعشده در فایلهای CSV باید در ریشه فایل ZIP وجود داشته باشند.
- تمام فایلهای تصویری موجود در فایل زیپ باید حداقل توسط یک stat ارجاع داده شوند.
- ساختار دایرکتوری: همه فایلها باید در ریشه فایل 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 تعریف شده است. |
| عملگر فیلتر | اختیاری | =, !=, >, <, >=, <=عملگرهای مقایسه فیلتر. |
| مقدار فیلتر | اختیاری | در مقایسه با ویژگی فیلتر، مقدار فیلتر باید INT64, DOUBLE, BOOL, STRING باشد. |
| رقابتی است | مورد نیاز | true, false |
| حداقل محدودیت | وقتی Is Competitive درست باشد، لازم است. | حداقل امتیاز مجاز برای آمار رقابتی. |
| حداکثر حد | وقتی Is Competitive درست باشد، لازم است. | حداکثر امتیاز مجاز برای آمار رقابتی. |
| نام فایل آیکون | مورد نیاز | نام فایل تصویر آیکون موجود در ریشه فایل زیپ. نمیتواند با نام فایلهای آیکون استفاده شده در آمار تکراری تداخل داشته باشد. |
| جهت گیری با ارزش خوب | مورد نیاز | مشخص میکند که آیا مقادیر بالاتر INCREASING بهتر هستند یا مقادیر پایینتر DECREASING . |
| واحد | اختیاری | واحد اندازهگیری برای مقادیر عددی خام یا مقادیر زمانی. برای مثال، کیلومتر، ثانیه، درصد، بدون واحد. |
در صورتی که نمیخواهید از شرط فیلتر استفاده کنید، سلول را خالی نگه دارید.
جدول نمونه
| شناسه آمار | نام رویداد | نام ملک | تجمیع | نام نمایشی آمار | توضیحات آمار | فیلتر ویژگی (اختیاری) | عملگر فیلتر (اختیاری) | مقدار فیلتر (اختیاری) | رقابتی است | حداقل محدودیت | حداکثر محدودیت | نام فایل آیکون | شماره توالی | جهت گیری با ارزش خوب | واحد |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ۱ | مسابقهتکمیل شد | مدت زمان | مکس | طولانیترین زمان بقا در مسابقه | این نشان دهنده زمان بقای یک بازیکن در هر مسابقه است | برنده است | = | درست | درست | 0 | ۵۰ | آمار1.png | ۱ | کاهشی | ثانیهها |
| ۲ | مسابقهتکمیل شد | برنده است | شمارش | مسابقات برنده شده | این نشان دهنده تعداد مسابقاتی است که یک بازیکن برنده شده است | برنده است | = | درست | درست | 0 | ۵۰ | stat3.png | ۲ | افزایش | |
| ۳ | مسابقهتکمیل شد | می کشد | جمع | کشتههای مسابقه تک به تک | تعداد کشتههای انجام شده در مسابقات تک به تک | نوع تطابق | = | «یک به یک» | نادرست | stat4.png | ۴ | افزایش | |||
| ۴ | موردجمع آوری شده | سکههامقدار | جمع | کل طلای جمعآوریشده | بازیکن هنگام بازی در یک مسابقه سکه جمع میکند | نوع سلاح | = | «شمشیر» | نادرست | آمار۲.png | ۳ | افزایش |
فرمت ProgressionStatConfig.csv
فایل csv شامل رویداد اعلام شده و ویژگیهای آن به صورت مقادیر جدا شده با کاما به ترتیب زیر است:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
آمار پیشرفت به عنوان اولین آمار به یک بازیکن در پروفایل گیمر او نشان داده خواهد شد.
این فیلدها در جدول زیر شرح داده شدهاند:
| سرستونهای CSV | الزامی یا اختیاری | مقادیر پذیرفته شده |
|---|---|---|
| شناسه آمار | مورد نیاز | حداکثر ۱۰۰ کاراکتر باید فقط از حروف، اعداد و زیرخط تشکیل شده باشد. باید در تمام آمار بازی منحصر به فرد باشد. |
| نام رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر باید به نام رویداد تعریف شده در قالب PlayerGameEvent.csv اشاره کند. |
| نام ویژگی رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر باید نام یک ویژگی باشد که در فایل PlayerGameEvent.csv تعریف شده است. |
| نام نمایشی آمار | مورد نیاز | باید یک اسم منحصر به فرد باشد. |
| توضیحات آمار | مورد نیاز | حداکثر ۵۰ کاراکتر توضیحات پیشفرض برای آمار. |
| نام فایل آیکون | مورد نیاز | نام فایل تصویر آیکون موجود در ریشه فایل زیپ. نمیتواند با نام فایلهای آیکون استفاده شده در آمار تکراری تداخل داشته باشد. |
| جهت گیری با ارزش خوب | مورد نیاز | مشخص میکند که آیا مقادیر بالاتر INCREASING بهتر هستند یا مقادیر پایینتر DECREASING . |
| واحد | اختیاری | واحد اندازهگیری برای مقادیر عددی خام یا مقادیر زمانی. برای مثال، کیلومتر، ثانیه، درصد، بدون واحد. |
جدول نمونه
| شناسه آمار | نام ویژگی رویداد | نام نمایشی آمار | توضیحات آمار | نام فایل آیکون | جهت گیری با ارزش خوب |
|---|---|---|---|---|---|
| ۵ | پیشرفت فعلی | سطح | بازیکنان با انجام مسابقات امتیاز تجربه (xp) جمع میکنند و سطح خود را ارتقا میدهند. | سطح.png | افزایش |
قالب StatLocalizations.csv
فایل csv شامل رویداد اعلام شده و ویژگیهای آن به صورت مقادیر جدا شده با کاما به ترتیب زیر است:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
این فیلدها در جدول زیر شرح داده شدهاند:
| سرستونهای CSV | الزامی یا اختیاری | مقادیر پذیرفته شده |
|---|---|---|
| شناسه آمار | مورد نیاز | حداکثر ۱۰۰ کاراکتر باید فقط از حروف، اعداد و زیرخط تشکیل شده باشد. باید در تمام آمار بازی منحصر به فرد باشد. |
| نام نمایشی آمار | مورد نیاز | باید یک اسم منحصر به فرد باشد. |
| محلی | مورد نیاز | کد محلی مانند en-US. قبل از مشخص کردن زبان ، ترجمههای بازی خود را اضافه کنید . توجه داشته باشید که نمیتوانید زبان پیشفرض را مشخص کنید. کدهای محلی پشتیبانیشده را میتوانید در فهرست زبانهای پشتیبانیشده بیابید. |
| نام نمایش آمار محلی | اختیاری | حداکثر ۵۰ کاراکتر. نام نمایشی آمار ترجمه شده برای زبان داده شده. |
| توضیحات آمار محلی | اختیاری | حداکثر ۵۰۰ کاراکتر. توضیحات آمار ترجمه شده برای زبان داده شده. |
جدول نمونه
| شناسه آمار | نام نمایشی آمار | کد زبان | نام آماری محلی (UTF-8) | توضیحات آمار محلی (UTF-8) | ۱ | طولانیترین زمان بقا در مسابقه | ها | Supervivencia más large en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. | ۱ | طولانیترین زمان بقا در مسابقه | فر | نجات از مسابقه به مدت طولانی | Cela indique la durée de survie d'un joueur dans n'importe quel match. | ۴ | کل طلای جمعآوریشده | ها | اورو کل ریکلکتادو | La jugadora recoge monedas mientras juega en un partido | ۴ | کل طلای جمعآوریشده | فر | یا کل مجموعه | Le joueur collecte des pièces en jouant un match |
فایلهای آیکون
آیکونهایی که در فایل .csv به آنها ارجاع میدهید باید در فایل فشردهی فعلی که وارد میکنید، وجود داشته باشند.
قوانین اعتبارسنجی آیکون عبارتند از:
| ویژگی اعتبارسنجی | محدودیت/قانون اجباری |
|---|---|
| حداکثر اندازه فایل | حداکثر ۱ مگابایت (۱,۰۴۸,۵۷۶ بایت) برای هر فایل آیکون. |
| ابعاد | دقیقاً ۵۱۲ × ۵۱۲ پیکسل (عرض = ۵۱۲، ارتفاع = ۵۱۲) |
| نسبت ابعاد | کاملاً ۱:۱ (نسبت ابعاد مربع) |
| قالبهای مجاز | PNG (.png) و JPEG (.jpg، .jpeg) |
| قرار دادن در کد پستی | باید در دایرکتوری ریشه در فایل ZIP قرار داشته باشد. |
| چک ارجاع شده | تمام نام فایلهای آیکون مشخص شده در ستونهای Icon File Name باید در فایل زیپ وجود داشته باشند. |
| چک یتیم | تمام فایلهای تصویری داخل فایل زیپ باید حداقل توسط یک stat ارجاع داده شوند. |
| بررسی تعارض | نام فایلهای آیکون در ProgressionStatConfig.csv نباید با RepetitiveStatsConfig.csv تداخل داشته باشد. |
| کپیهای بصری | آیکونهای تکراری علامتگذاری میشوند. |
دستورالعملهای آیکون
آیکونها باید در قالب فایلهای PNG، JPEG یا JPG با ابعاد ۵۱۲ در ۵۱۲ پیکسل ایجاد شوند.
از یک آیکون در همه زبانها استفاده میشود، بنابراین توصیه میکنیم از قرار دادن هرگونه متن یا محتوای بومیسازیشده در یک آیکون خودداری کنید.
مشخصات واحد
ستونهای واحد، نحوه قالببندی و بومیسازی مقادیر خام آمار را برای بازیکنان کنترل میکنند.
ویژگیهای آمار عددی (INT64، DOUBLE)
| مقدار واحد مجاز | مثال مقدار خام |
| (خالی) / بدون واحد / هیچکدام | ۱۲۳۴۵۶۷ |
| ٪ / درصد / درصد | ۰.۸۵۷ |
| فاصله/طول : سانتیمتر، متر، کیلومتر، فوت، اینچ، مایل، یارد، میلیمتر، نانومتر | ۱۵ (کیلومتر) |
| سرعت : کیلومتر در ساعت، متر در ثانیه، مایل در ساعت | ۶۰ (مایل در ساعت) |
ویژگیهای آماری غیر عددی (STRING، BOOL)
ستونهای واحد باید خالی بمانند.