این سند نحوه ادغام آمار بازی (Game Stats) در بازی شما با استفاده از کنسول گوگل پلی (Google Play Console) را توضیح میدهد. این سند فرمتهای ضروری فایلهای CSV و ZIP را پوشش میدهد و نحوه ایجاد، وارد کردن و مدیریت آنها را شرح میدهد.
ایجاد رویدادها
برای ایجاد رویداد برای یک بازی جدید و منتشر نشده، این مراحل را انجام دهید:
- فایل CSV مربوط به رویدادها به نام PlayerGameEvent.csv را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «رویدادهای راهاندازی» را انتخاب کنید.
- در صفحه پیکربندی رویدادها ، فایل CSV را برای آپلود رها کنید.
- پس از ایجاد رویداد، آمار را تنظیم کنید .
آمار را تنظیم کنید
پس از ایجاد یک رویداد، باید آمار را تنظیم کنید:
- طبق دستورالعملهای مربوط به فایل زیپ برای آمار، فایل زیپ حاوی آمار، محلیسازیها و فایلهای آیکون را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «تنظیم آمار» را انتخاب کنید.
- در صفحه پیکربندی آمار بازی ، فایل زیپ را برای آپلود رها کنید.
- بعد از اینکه تمام آمارها را آپلود کردید، بازی خود را منتشر کنید.
آمار بازی آزمایشی
برای تأیید اینکه آمار بازی طبق برنامه کار میکند، مراحل آزمایش آنها را دنبال کنید:
- در کنسول Play، یک مسیر آزمایشی داخلی تنظیم کنید.
- حسابهای آزمایشی را برای آزمایشکنندگان به پروژه بازی خود اضافه کنید .
- با استفاده از برنامه Play Games، برای یکی از حسابهای آزمایشی، پروفایل Play Games Services ایجاد کنید.
- بازی را با استفاده از همان حساب آزمایشی که نمایه خدمات بازیهای Play را برای آن ایجاد کردهاید، باز کنید.
- مطمئن شوید که پیام «خوش آمدید» سرویسهای بازیهای Play روی صفحه نمایش داده میشود که نشاندهندهی تأیید موفقیتآمیز احراز هویت خودکار در هنگام اجرای بازی است.
- کاربر حساب آزمایشی میتواند بازی را انجام دهد تا رویدادها را فعال کند. پاسخ API را بررسی کنید تا ببینید آیا رویدادها ثبت شدهاند یا خیر.
مدیریت آمار بازی (Game Stats) برای مشاهده در دستگاه شما جهت آزمایش
وقتی بازی در کنسول پلی برای آزمایشکنندگان شما در دسترس قرار گرفت، برای مشاهده آمار بازی در دستگاه خود، این مراحل را دنبال کنید:
پاک کردن حافظه پنهان (cache) فروشگاه گوگل پلی:
- برنامه تنظیمات (Settings ) را در دستگاه خود باز کنید.
- روی برنامهها > فروشگاه گوگل پلی بزنید.
- روی فضای ذخیرهسازی و حافظه پنهان (storage and cache) و سپس روی پاک کردن حافظه پنهان (clear cache) ضربه بزنید.
برنامه فروشگاه گوگل پلی را باز کنید.
آمار بازی خود را با استفاده از بخش پیگیری زمان بازی یا نمایه بازیکن خود مشاهده کنید:
روش ۱: از بخش پیگیری زمان پخش خود استفاده کنید
به بخش «پیگیری زمان بازی» بروید و سپس روی آن ضربه بزنید تا آمار بازی خود را مشاهده کنید.
روش دوم: از پروفایل گیمر خود استفاده کنید
- روی برگه «شما» و سپس روی نمایه بازیکن خود ضربه بزنید.
- به بخش آمار بازی بروید.
- برای محدوده زمانی، همه را انتخاب کنید.
- اگر بازی شما نمایش داده نمیشود، روی «مشاهده همه بازیها» ضربه بزنید.
- برای مشاهده آمار بازی خود، آن را انتخاب کنید.
مشاهده گزارشهای دستگاه شما
برای تأیید اینکه آمار بازی طبق طراحی کار میکند، گزارشها را در دستگاه خود روشن کنید:
اشکالزدایی 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): ...
آمار بازی را منتشر کنید
پس از اتمام آزمایش، باید بازی خود را منتشر کنید. تمام رویدادها و آمار بازی شما به همراه آن منتشر میشوند.
برای انتشار، مراحل زیر را دنبال کنید:
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای 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 اشاره کند. |
| نام ویژگی رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر |
| نام نمایشی آمار | مورد نیاز | حداکثر ۵۰ کاراکتر نام نمایشی پیشفرض برای آمار (زبان پیشفرض). باید در بین آمارها منحصر به فرد باشد. |
| توضیحات آمار | مورد نیاز | حداکثر ۵۰۰ کاراکتر توضیحات پیشفرض برای آمار. |
| نوع تجمیع | مورد نیاز | حداکثر ۵۰ کاراکتر جمع، حداکثر، حداقل، تعداد. |
| فیلتر کردن ملک | اختیاری | حداکثر ۵۰ کاراکتر باید نام یک ویژگی باشد که در فایل 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 تعریف شده است. |
| نام نمایشی آمار | مورد نیاز | باید یک اسم منحصر به فرد باشد. |
| توضیحات آمار | مورد نیاز | حداکثر ۵۰ کاراکتر توضیحات پیشفرض برای آمار. |
| نام فایل آیکون | مورد نیاز | نام فایل تصویر آیکون موجود در ریشه فایل زیپ. نمیتواند با نام فایلهای آیکون استفاده شده در آمار تکراری تداخل داشته باشد. |
| جهت گیری با ارزش خوب | مورد نیاز | مشخص میکند که آیا مقادیر بالاتر 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)
ستونهای واحد باید خالی بمانند.
،این سند نحوه ادغام آمار بازی (Game Stats) در بازی شما با استفاده از کنسول گوگل پلی (Google Play Console) را توضیح میدهد. این سند فرمتهای ضروری فایلهای CSV و ZIP را پوشش میدهد و نحوه ایجاد، وارد کردن و مدیریت آنها را شرح میدهد.
ایجاد رویدادها
برای ایجاد رویداد برای یک بازی جدید و منتشر نشده، این مراحل را انجام دهید:
- فایل CSV مربوط به رویدادها به نام PlayerGameEvent.csv را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «رویدادهای راهاندازی» را انتخاب کنید.
- در صفحه پیکربندی رویدادها ، فایل CSV را برای آپلود رها کنید.
- پس از ایجاد رویداد، آمار را تنظیم کنید .
آمار را تنظیم کنید
پس از ایجاد یک رویداد، باید آمار را تنظیم کنید:
- طبق دستورالعملهای مربوط به فایل زیپ برای آمار، فایل زیپ حاوی آمار، محلیسازیها و فایلهای آیکون را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «تنظیم آمار» را انتخاب کنید.
- در صفحه پیکربندی آمار بازی ، فایل زیپ را برای آپلود رها کنید.
- بعد از اینکه تمام آمارها را آپلود کردید، بازی خود را منتشر کنید.
آمار بازی آزمایشی
برای تأیید اینکه آمار بازی طبق برنامه کار میکند، مراحل آزمایش آنها را دنبال کنید:
- در کنسول Play، یک مسیر آزمایشی داخلی تنظیم کنید.
- حسابهای آزمایشی را برای آزمایشکنندگان به پروژه بازی خود اضافه کنید .
- با استفاده از برنامه Play Games، برای یکی از حسابهای آزمایشی، پروفایل Play Games Services ایجاد کنید.
- بازی را با استفاده از همان حساب آزمایشی که نمایه خدمات بازیهای Play را برای آن ایجاد کردهاید، باز کنید.
- مطمئن شوید که پیام «خوش آمدید» سرویسهای بازیهای Play روی صفحه نمایش داده میشود که نشاندهندهی تأیید موفقیتآمیز احراز هویت خودکار در هنگام اجرای بازی است.
- کاربر حساب آزمایشی میتواند بازی را انجام دهد تا رویدادها را فعال کند. پاسخ API را بررسی کنید تا ببینید آیا رویدادها ثبت شدهاند یا خیر.
مدیریت آمار بازی (Game Stats) برای مشاهده در دستگاه شما جهت آزمایش
وقتی بازی در کنسول پلی برای آزمایشکنندگان شما در دسترس قرار گرفت، برای مشاهده آمار بازی در دستگاه خود، این مراحل را دنبال کنید:
پاک کردن حافظه پنهان (cache) فروشگاه گوگل پلی:
- برنامه تنظیمات (Settings ) را در دستگاه خود باز کنید.
- روی برنامهها > فروشگاه گوگل پلی بزنید.
- روی فضای ذخیرهسازی و حافظه پنهان (storage and cache) و سپس روی پاک کردن حافظه پنهان (clear cache) ضربه بزنید.
برنامه فروشگاه گوگل پلی را باز کنید.
آمار بازی خود را با استفاده از بخش پیگیری زمان بازی یا نمایه بازیکن خود مشاهده کنید:
روش ۱: از بخش پیگیری زمان پخش خود استفاده کنید
به بخش «پیگیری زمان بازی» بروید و سپس روی آن ضربه بزنید تا آمار بازی خود را مشاهده کنید.
روش دوم: از پروفایل گیمر خود استفاده کنید
- روی برگه «شما» و سپس روی نمایه بازیکن خود ضربه بزنید.
- به بخش آمار بازی بروید.
- برای محدوده زمانی، همه را انتخاب کنید.
- اگر بازی شما نمایش داده نمیشود، روی «مشاهده همه بازیها» ضربه بزنید.
- برای مشاهده آمار بازی خود، آن را انتخاب کنید.
مشاهده گزارشهای دستگاه شما
برای تأیید اینکه آمار بازی طبق طراحی کار میکند، گزارشها را در دستگاه خود روشن کنید:
اشکالزدایی 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): ...
آمار بازی را منتشر کنید
پس از اتمام آزمایش، باید بازی خود را منتشر کنید. تمام رویدادها و آمار بازی شما به همراه آن منتشر میشوند.
برای انتشار، مراحل زیر را دنبال کنید:
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای 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 اشاره کند. |
| نام ویژگی رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر |
| نام نمایشی آمار | مورد نیاز | حداکثر ۵۰ کاراکتر نام نمایشی پیشفرض برای آمار (زبان پیشفرض). باید در بین آمارها منحصر به فرد باشد. |
| توضیحات آمار | مورد نیاز | حداکثر ۵۰۰ کاراکتر توضیحات پیشفرض برای آمار. |
| نوع تجمیع | مورد نیاز | حداکثر ۵۰ کاراکتر جمع، حداکثر، حداقل، تعداد. |
| فیلتر کردن ملک | اختیاری | حداکثر ۵۰ کاراکتر باید نام یک ویژگی باشد که در فایل 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 تعریف شده است. |
| نام نمایشی آمار | مورد نیاز | باید یک اسم منحصر به فرد باشد. |
| توضیحات آمار | مورد نیاز | حداکثر ۵۰ کاراکتر توضیحات پیشفرض برای آمار. |
| نام فایل آیکون | مورد نیاز | نام فایل تصویر آیکون موجود در ریشه فایل زیپ. نمیتواند با نام فایلهای آیکون استفاده شده در آمار تکراری تداخل داشته باشد. |
| جهت گیری با ارزش خوب | مورد نیاز | مشخص میکند که آیا مقادیر بالاتر 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)
ستونهای واحد باید خالی بمانند.
،این سند نحوه ادغام آمار بازی (Game Stats) در بازی شما با استفاده از کنسول گوگل پلی (Google Play Console) را توضیح میدهد. این سند فرمتهای ضروری فایلهای CSV و ZIP را پوشش میدهد و نحوه ایجاد، وارد کردن و مدیریت آنها را شرح میدهد.
ایجاد رویدادها
برای ایجاد رویداد برای یک بازی جدید و منتشر نشده، این مراحل را انجام دهید:
- فایل CSV مربوط به رویدادها به نام PlayerGameEvent.csv را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «رویدادهای راهاندازی» را انتخاب کنید.
- در صفحه پیکربندی رویدادها ، فایل CSV را برای آپلود رها کنید.
- پس از ایجاد رویداد، آمار را تنظیم کنید .
آمار را تنظیم کنید
پس از ایجاد یک رویداد، باید آمار را تنظیم کنید:
- طبق دستورالعملهای مربوط به فایل زیپ برای آمار، فایل زیپ حاوی آمار، محلیسازیها و فایلهای آیکون را ایجاد کنید.
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، «تنظیم آمار» را انتخاب کنید.
- در صفحه پیکربندی آمار بازی ، فایل زیپ را برای آپلود رها کنید.
- بعد از اینکه تمام آمارها را آپلود کردید، بازی خود را منتشر کنید.
آمار بازی آزمایشی
برای تأیید اینکه آمار بازی طبق برنامه کار میکند، مراحل آزمایش آنها را دنبال کنید:
- در کنسول Play، یک مسیر آزمایشی داخلی تنظیم کنید.
- حسابهای آزمایشی را برای آزمایشکنندگان به پروژه بازی خود اضافه کنید .
- با استفاده از برنامه Play Games، برای یکی از حسابهای آزمایشی، پروفایل Play Games Services ایجاد کنید.
- بازی را با استفاده از همان حساب آزمایشی که نمایه خدمات بازیهای Play را برای آن ایجاد کردهاید، باز کنید.
- مطمئن شوید که پیام «خوش آمدید» سرویسهای بازیهای Play روی صفحه نمایش داده میشود که نشاندهندهی تأیید موفقیتآمیز احراز هویت خودکار در هنگام اجرای بازی است.
- کاربر حساب آزمایشی میتواند بازی را انجام دهد تا رویدادها را فعال کند. پاسخ API را بررسی کنید تا ببینید آیا رویدادها ثبت شدهاند یا خیر.
مدیریت آمار بازی (Game Stats) برای مشاهده در دستگاه شما جهت آزمایش
وقتی بازی در کنسول پلی برای آزمایشکنندگان شما در دسترس قرار گرفت، برای مشاهده آمار بازی در دستگاه خود، این مراحل را دنبال کنید:
پاک کردن حافظه پنهان (cache) فروشگاه گوگل پلی:
- برنامه تنظیمات (Settings ) را در دستگاه خود باز کنید.
- روی برنامهها > فروشگاه گوگل پلی بزنید.
- روی فضای ذخیرهسازی و حافظه پنهان (storage and cache) و سپس روی پاک کردن حافظه پنهان (clear cache) ضربه بزنید.
برنامه فروشگاه گوگل پلی را باز کنید.
آمار بازی خود را با استفاده از بخش پیگیری زمان بازی یا نمایه بازیکن خود مشاهده کنید:
روش ۱: از بخش پیگیری زمان پخش خود استفاده کنید
به بخش «پیگیری زمان بازی» بروید و سپس روی آن ضربه بزنید تا آمار بازی خود را مشاهده کنید.
روش دوم: از پروفایل گیمر خود استفاده کنید
- روی برگه «شما» و سپس روی نمایه بازیکن خود ضربه بزنید.
- به بخش آمار بازی بروید.
- برای محدوده زمانی، همه را انتخاب کنید.
- اگر بازی شما نمایش داده نمیشود، روی «مشاهده همه بازیها» ضربه بزنید.
- برای مشاهده آمار بازی خود، آن را انتخاب کنید.
مشاهده گزارشهای دستگاه شما
برای تأیید اینکه آمار بازی طبق طراحی کار میکند، گزارشها را در دستگاه خود روشن کنید:
اشکالزدایی 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): ...
آمار بازی را منتشر کنید
پس از اتمام آزمایش، باید بازی خود را منتشر کنید. تمام رویدادها و آمار بازی شما به همراه آن منتشر میشوند.
برای انتشار، مراحل زیر را دنبال کنید:
- در کنسول گوگل پلی ، یک بازی را انتخاب کنید.
- در صفحه «خدمات بازیهای Play - آمار بازی» ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > آمار بازی )، روی «بررسی و انتشار» کلیک کنید.
- در صفحه خدمات بازیهای Play - انتشار ( افزایش کاربران > خدمات بازیهای Play > راهاندازی و مدیریت > انتشار )، اقدامات را بررسی کرده و مشکلات را برطرف کنید.
- روی انتشار کلیک کنید. تمام آمار بازی شما منتشر میشود.
آمار بازی را حذف کنید
پس از انتشار آمار بازی، دیگر نمیتوان آن را حذف کرد.
دستورالعملهای فایل CSV برای رویدادها
ردیف اول فایل CSV، ردیف هدر است. شما باید رویدادها را با استفاده از فایل CSV رویدادها، مثلاً PlayerGameEvent.csv ، وارد کنید.
فرمت PlayerGameEvent.csv
فایل CSV شامل رویداد اعلامشده و ویژگیهای آن است که به ترتیب زیر با کاما از هم جدا شدهاند:
Event Name,Property Name,Property Type
اگر رویداد progressUpdate را برای progressionStat ارسال میکنید، یک ردیف برای این رویداد اضافه کنید. این رویداد باید حداقل شامل یک ویژگی currentProgress از نوع INT یا STRING، به علاوه هر ویژگی دیگری که میخواهید ارسال کنید، باشد.
این فیلدها در جدول زیر شرح داده شدهاند:
| سرستونهای CSV | الزامی یا اختیاری | مقادیر پذیرفته شده |
|---|---|---|
| نام رویداد | مورد نیاز | حداکثر ۵۰ کاراکتر فقط باید شامل حروف، اعداد و زیرخط (_) باشد. If the special event name |
| نام ملک | مورد نیاز | حداکثر ۵۰ کاراکتر Must consist only of letters, numbers, and underscores. Unique per Event: Property names must be unique within the same event. Don't use the following reserved keywords: |
| نوع ملک | مورد نیاز | Case-sensitive enum string matching one of the supported data types: INT64 , DOUBLE , STRING , BOOL |
PlayerGameEvent.csv file requirements:
- The file supports a maximum of 20 unique event name, with up to 20 properties per event.
- The file content can't be empty and must have at least 1 row.
جدول نمونه
| Event Name | نام ملک | نوع ملک |
|---|---|---|
| matchCompleted | مدت زمان | دو برابر |
| matchCompleted | می کشد | INT64 |
| matchCompleted | isWinner | بول |
| matchCompleted | matchType | رشته |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | رشته |
| progressUpdate | currentProgress | INT64 |
ZIP file guidelines for stats
You can import stats at once using a ZIP file. Refer to the table for the precise filenames to use in your ZIP file:
| نام فایل | Required or Optional | Accepted values |
|---|---|---|
RepetitiveStatsConfig.csv | مورد نیاز | A repetitive stat represents regularly occurring in-game actions performed by players. |
ProgressionStatConfig.csv | مورد نیاز | A progression stat represents a player's progress in a game. |
StatLocalizations.csv | اختیاری | Provides translations for Game Stats names and descriptions. |
| Icon files | مورد نیاز | Icons in 512 x 512 PNG, JPEG, or JPG format. |
The ZIP file must meet the following requirements:
- ZIP file size limit: Maximum total uncompressed size is 10 MB.
- Max files: Maximum 53 (3 CSV and 50 icons) total files inside the ZIP archive.
- Max combined stats limit: Maximum 50 total stats across
ProgressionStatConfig.csvandRepetitiveStatsConfig.csv. - Supported CSV files:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csv, andStatLocalizations.csv(optional). If you want to upload only progression stat, don't include the repetitive stats CSV file in the ZIP; otherwise, the console emits an error. The same applies if you want to upload only repetitive stats. - Icon image files: PNG (.png) or JPEG (.jpg, .jpeg).
- All icons referenced in the CSVs must exist in the root of the ZIP file.
- All image files present in the ZIP must be referenced by at least one stat.
- Directory structure: All files must reside at the root of the ZIP file. Subdirectories aren't allowed.
RepetitiveStatsConfig.csv format
The CSV contains declared event and its properties as comma separated values in the following order:
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
These fields are described in the following table:
| CSV column headers | Required or Optional | Accepted values |
|---|---|---|
| Stat Id | مورد نیاز | Maximum of 100 characters Must consist only of letters, numbers, and underscores. Must be unique across all stats in the game. |
| Event Name | مورد نیاز | حداکثر ۵۰ کاراکتر Must reference the Event Name defined in the PlayerGameEvent.csv format . |
| Event Property Name | مورد نیاز | حداکثر ۵۰ کاراکتر |
| Stat Display Name | مورد نیاز | حداکثر ۵۰ کاراکتر Default display name for the stat (default locale). Must be unique across stats. |
| Stat Description | مورد نیاز | حداکثر ۵۰۰ کاراکتر Default description for the stat. |
| Aggregation Type | مورد نیاز | حداکثر ۵۰ کاراکتر SUM, MAX, MIN, COUNT. |
| Filter Property | اختیاری | حداکثر ۵۰ کاراکتر Must be a Property Name defined in the PlayerGameEvent.csv . |
| Filter Operator | اختیاری | =, !=, >, <, >=, <=Filter comparison operators. |
| مقدار فیلتر | اختیاری | Compared with the Filter Property. Filter value must be INT64, DOUBLE, BOOL, STRING . |
| Is Competitive | مورد نیاز | true, false |
| Min limit | Required when Is Competitive is true | Minimum allowable score for competitive stats. |
| حداکثر حد | Required when Is Competitive is true | Maximum allowable score for competitive stats. |
| Icon File Name | مورد نیاز | Filename of the icon image included in the root of the ZIP file. Can't conflict with icon file names used in repetitive stats. |
| Good value direction | مورد نیاز | Specifies whether higher values INCREASING or lower values DECREASING are better. |
| واحد | اختیاری | Unit of measurement for raw numerical or duration values. For example, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
In case you don't want to use the filter condition, keep the cell as blank.
جدول نمونه
| Stat ID | Event Name | نام ملک | تجمیع | Stat Display Name | Stat Description | Filter Property (optional) | Filter Operator (optional) | Filter Value (optional) | Is Competitive | minLimit | maxLimit | Icon filename | Good value direction | واحد |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ۱ | matchCompleted | مدت زمان | مکس | Longest Match Survival | This denotes the survival time of a player in any match | isWinner | = | درست | درست | 0 | ۵۰ | stat1.png | کاهشی | ثانیهها |
| ۲ | matchCompleted | isWinner | شمارش | مسابقات برنده شده | This denotes the number of matches a player has won | isWinner | = | درست | درست | 0 | ۵۰ | stat3.png | افزایش | |
| ۳ | matchCompleted | می کشد | جمع | 1-on-1 match kills | Number of kills made across 1-on-1 matches | matchType | = | "1-on-1" | نادرست | stat4.png | افزایش | |||
| ۴ | itemCollected | coinsAmount | جمع | Total Gold Collected | Player collects coins while playing in a match | weaponType | = | "sword" | نادرست | stat2.png | افزایش |
ProgressionStatConfig.csv format
The csv contains declared event and its properties as comma separated values in the following order:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
The progression stat will be shown as the first stat to a player in their Gamer Profile.
These fields are described in the following table:
| CSV column headers | Required or Optional | Accepted values |
|---|---|---|
| Stat Id | مورد نیاز | Maximum of 100 characters Must consist only of letters, numbers, and underscores. Must be unique across all stats in the game. |
| Event Property Name | مورد نیاز | حداکثر ۵۰ کاراکتر Must be a Property Name defined in the PlayerGameEvent.csv . |
| Stat Display Name | مورد نیاز | Must be a unique name. |
| Stat Description | مورد نیاز | حداکثر ۵۰ کاراکتر Default description for the stat. |
| Icon File Name | مورد نیاز | Filename of the icon image included in the root of the ZIP file. Can't conflict with icon file names used in repetitive stats. |
| Good value direction | مورد نیاز | Specifies whether higher values INCREASING or lower values DECREASING are better. |
| واحد | اختیاری | Unit of measurement for raw numerical or duration values. For example, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
جدول نمونه
| Stat ID | Event Property Name | Stat Display Name | Stat Description | Icon File Name | Good value direction |
|---|---|---|---|---|---|
| ۵ | currentProgress | سطح | Players accumulate xp by playing matches and level up. | Level.png | افزایش |
StatLocalizations.csv format
The csv contains declared event and its properties as comma separated values in the following order:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
These fields are described in the following table:
| CSV column headers | Required or Optional | Accepted values |
|---|---|---|
| Stat Id | مورد نیاز | Maximum of 100 characters Must consist only of letters, numbers, and underscores. Must be unique across all stats in the game. |
| Stat Display Name | مورد نیاز | Must be a unique name. |
| محلی | مورد نیاز | The locale code such as en-US. Add translations for your game before specifying a locale. Note that you can't specify the default locale. Supported locale codes can be found in the list of supported languages . |
| Localized Stat Display Name | اختیاری | Maximum 50 characters. Translated stat display name for the given locale. |
| Localized Stat Description | اختیاری | Maximum 500 characters. Translated stat description for the given locale. |
جدول نمونه
| Stat ID | Stat Display Name | کد زبان | Localized Stat Name (UTF-8) | Localized Stat Description (UTF-8) |
|---|---|---|---|---|
| ۱ | Longest Match Survival | ها | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. |
| ۱ | Longest Match Survival | فر | Survie du match le plus long | Cela indique la durée de survie d'un joueur dans n'importe quel match. |
| ۴ | Total Gold Collected | ها | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido |
| ۴ | Total Gold Collected | فر | Or total collecté | Le joueur collecte des pièces en jouant un match |
Icon files
Icons you reference in CSV file must exist in the current ZIP archive you import.
Icon validation rules are:
| Validation property | Enforced constraint / rule |
|---|---|
| حداکثر اندازه فایل | 1 MB (1,048,576 bytes) maximum per icon file. |
| ابعاد | Exactly 512 × 512 pixels (width = 512, height = 512) |
| نسبت ابعاد | Strictly 1:1 (Square aspect ratio) |
| Allowed Formats | PNG (.png) and JPEG (.jpg, .jpeg) |
| Placement in ZIP | Must be located in the root directory in the ZIP file. |
| Referenced Check | All icon filenames specified in Icon File Name columns must exist in the ZIP. |
| Orphan Check | All image files inside the ZIP must be referenced by at least one stat. |
| Conflict Check | Icon filenames in ProgressionStatConfig.csv can't conflict with RepetitiveStatsConfig.csv . |
| Visual Duplicates | Duplicate icons are flagged. |
Icon guidelines
Icons should be created as 512 x 512 PNG, JPEG, or JPG files.
The same icon is used in all locales, so we recommend against including any text or localized content in an icon.
Unit specification
The Unit columns control how raw stat values are formatted and localized for players.
Numeric stat properties (INT64, DOUBLE)
| Allowed Unit Value | Example Raw Value |
| (Empty) / UNITLESS / NONE | ۱۲۳۴۵۶۷ |
| % / PERCENTAGE / PERCENT | ۰.۸۵۷ |
| Distance/Length : CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER | 15 (KILOMETER) |
| Speed : KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
Non-Numeric Stat Properties (STRING, BOOL)
Unit columns must be left empty.