سرویس رویدادهای بازیهای گوگل پلی به شما امکان میدهد دادههای تجمعی تولید شده توسط بازیکنان خود را در طول بازی جمعآوری کرده و آنها را برای تجزیه و تحلیل بازی در سرورهای گوگل ذخیره کنید. میتوانید به طور انعطافپذیر تعریف کنید که بازی شما باید چه دادههایی از بازیکنان را جمعآوری کند؛ این ممکن است شامل معیارهایی مانند تعداد دفعات موارد زیر باشد:
- بازیکنان از یک آیتم خاص استفاده میکنند
- بازیکنان به سطح خاصی میرسند
- بازیکنان برخی از اقدامات خاص بازی را انجام میدهند
شما میتوانید از دادههای رویدادها به عنوان بازخورد در مورد چگونگی بهبود بازی خود استفاده کنید. به عنوان مثال، میتوانید سطح دشواری مراحل خاصی از بازی خود را که بازیکنان برای تکمیل آن بسیار دشوار میدانند، تنظیم کنید.
برای یادگیری نحوه پیادهسازی رویدادها برای پلتفرم خود، به پیادهسازیهای کلاینت مراجعه کنید.
رویدادها را در بازی خود ادغام کنید
گردش کار زیر نحوه اعمال رویدادها در بازی شما را شرح میدهد:
- تعریف رویدادها . برای تعریف رویدادهای جدید جهت ثبت در بازی خود:
- به صفحه «رویدادها» برای بازی خود در کنسول گوگل پلی بروید.
- روی دکمهی «افزودن رویداد جدید» کلیک کنید و ویژگیهای رویداد را پیکربندی کنید.
- با دنبال کردن مراحل شرح داده شده در «انتشار تغییرات بازی»، تعاریف رویداد خود را منتشر کنید.
با استفاده از APIهای رویدادها، ثبت رویداد را در بازی خود پیادهسازی کنید . برای مثال، در کد اندروید خود، هر زمان که بازی تشخیص داد رویدادی که برایش مهم است، فعال شده است، متد events
incrementرا فراخوانی کنید.مشاهده دادههای رویدادها . برای مشاهده آمار رویدادهای ثبتشده، به صفحه رویدادهای بازی خود در کنسول گوگل پلی بروید.
اصول اولیه رویداد
APIهای رویدادها روشی را برای تعریف و جمعآوری معیارهای جالب گیمپلی و آپلود این معیارها در کیت توسعه نرمافزار Play Games در اختیار شما قرار میدهند.
یک رویداد SDK بازیهای Play شامل این ویژگیهای کلیدی است:
| ملک | توضیحات |
|---|---|
| شناسه | یک رشته منحصر به فرد که توسط کنسول گوگل پلی برای این رویداد ایجاد شده است. از این شناسه منحصر به فرد برای ارجاع به رویداد در کلاینتهای بازی خود استفاده کنید. |
| نام | نام کوتاه رویداد. این نام میتواند تا ۱۰۰ کاراکتر باشد. این مقدار توسط کنسول گوگل پلی استفاده میشود و میتواند در بازی شما نمایش داده شود. مثالها:
|
| توضیحات | توضیح طولانیتری از رویداد (برای مثال، «تعداد دفعاتی که یک بازیکن یک زامبی را کشته است» یا «تعداد کل جواهرات قرمزی که بازیکن حذف و مطابقت داده است»). این توضیح میتواند تا ۵۰۰ کاراکتر باشد. این مقدار توسط کنسول گوگل پلی استفاده میشود و میتواند در بازی شما نمایش داده شود. |
| نوع رویداد | فیلدی که نوع دادهای را که رویداد ردیابی میکند، اعلام میکند. این مقدار توسط کنسول Google Play برای پشتیبانی از گزارشهای Player Analytics استفاده میشود. دو نوع رویداد پشتیبانی میشوند:
|
| آیکون | یک آیکون مربعی که با رویداد شما مرتبط خواهد بود. |
ایجاد یک رویداد
برای ایجاد یک رویداد جدید برای بازی خود، مراحل زیر را دنبال کنید:
- در کنسول گوگل پلی ، روی آیکون خدمات بازی در سمت چپ کلیک کنید و ورودی مربوط به بازی خود را انتخاب کنید.
- برگه رویدادها را در سمت چپ انتخاب کنید و روی دکمه افزودن رویداد کلیک کنید.
- جزئیات رویدادی را که میخواهید ایجاد کنید، پر کنید.
- روی ذخیره کلیک کنید. اگر خطایی وجود نداشته باشد، رویداد شما در حالت "آماده انتشار" قرار میگیرد. اکنون میتوانید تغییرات بازی خود را منتشر کنید .
ویرایش یک رویداد
برای ویرایش رویدادی که ایجاد کردهاید:
- در کنسول گوگل پلی ، تب رویدادها را باز کنید و ورودی رویدادی را که میخواهید ویرایش کنید انتخاب کنید. باید همان فرمی را که هنگام ایجاد رویداد استفاده کردید، ببینید.
- تغییرات ویرایشی خود را اعمال کنید.
- وقتی ویرایش رویداد را تمام کردید، روی دکمه ذخیره کلیک کنید.
- بازی خود را آزمایش کنید تا از صحت رویداد اصلاحشده مطمئن شوید. اگر به درستی کار میکند، تغییرات بازی خود را دوباره منتشر کنید .
حذف یک رویداد
میتوانید رویدادهایی را که در حالت پیشنویس هستند یا منتشر شدهاند، حذف کنید. برای حذف یک رویداد در کنسول گوگل پلی، روی دکمهای با عنوان «حذف» در پایین فرم مربوط به آن رویداد کلیک کنید.
بازنشانی دادههای رویداد
میتوانید دادههای پیشرفت بازیکن را برای آزمایشکنندگان رویدادهایتان بازنشانی کنید.
- برای بازنشانی رویدادهای پیشنویس در کنسول گوگل پلی، روی دکمهای با عنوان «بازنشانی پیشرفت رویداد» در پایین فرم مربوط به آن رویداد کلیک کنید.
- برای بازنشانی دادههای رویداد به صورت برنامهنویسیشده، متدهای
EventsAPI مدیریت را فراخوانی کنید.
پیادهسازیهای کلاینت
برای یادگیری نحوه پیادهسازی رویدادها برای پلتفرم خود، به منابع زیر مراجعه کنید: