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