مناسبت ها

سرویس رویدادهای «بازی‌های Google Play» به شما این امکان را می‌دهد که داده‌های انباشته‌ای را که توسط بازیکنانتان در طول بازی تولید می‌شود جمع‌آوری کنید و آنها را برای تجزیه و تحلیل بازی در سرورهای Google ذخیره کنید. شما می توانید به طور انعطاف پذیر تعریف کنید که بازی شما چه داده هایی را باید جمع آوری کند. این ممکن است شامل معیارهایی مانند چند وقت یکبار باشد:

  • بازیکنان از یک آیتم خاص استفاده می کنند
  • بازیکنان به سطح خاصی می رسند
  • بازیکنان برخی از اقدامات بازی خاص را انجام می دهند

می‌توانید از داده‌های رویدادها به عنوان بازخورد در مورد چگونگی بهبود بازی خود استفاده کنید. به عنوان مثال، می توانید سطح دشواری سطوح خاصی را در بازی خود تنظیم کنید که بازیکنان برای تکمیل آنها بسیار سخت هستند.

برای آشنایی با نحوه پیاده‌سازی رویدادها برای پلتفرم خود، به اجرای Client مراجعه کنید.

ادغام رویدادها در بازی شما

گردش کار زیر نحوه اعمال رویدادها را در بازی خود توضیح می دهد:

  1. رویدادها را تعریف کنید . برای تعریف رویدادهای جدید برای ثبت در بازی خود:
    1. به صفحه رویدادهای بازی خود در کنسول Google Play بروید.
    2. روی دکمه افزودن رویداد جدید کلیک کنید و ویژگی های رویداد را پیکربندی کنید.
    3. با دنبال کردن مراحل توضیح داده شده در انتشار تغییرات بازی، تعاریف رویداد خود را منتشر کنید.

  2. با استفاده از API رویدادها، ضبط رویداد را در بازی خود پیاده کنید . به عنوان مثال، در کد اندروید خود، هر زمان که بازی شما تشخیص داد که رویدادی که برایش اهمیت دارد، راه اندازی شده است، روش increment رویدادها را فراخوانی کنید.

  3. مشاهده داده های رویدادها برای مشاهده آمار رویدادهای ثبت شده، به صفحه رویدادهای بازی خود در کنسول Google Play بروید.

اصول اولیه رویداد

رویدادهای API راهی برای تعریف و جمع‌آوری معیارهای جالب بازی و آپلود این معیارها در خدمات بازی‌های Google Play در اختیار شما قرار می‌دهند.

رویداد خدمات بازی‌های Google Play حاوی این ویژگی‌های کلیدی است:

ویژگی شرح
شناسه یک رشته منحصر به فرد ایجاد شده توسط کنسول Google Play برای این رویداد. از این شناسه منحصر به فرد برای اشاره به رویداد در مشتریان بازی خود استفاده کنید.
نام نام کوتاه رویداد نام می تواند تا 100 کاراکتر باشد. این مقدار توسط کنسول Google Play استفاده می شود و می تواند در بازی شما نمایش داده شود.

مثال ها:

  • "زامبی ها کشته شدند"
  • "جمع آوری جواهرات قرمز"
شرح شرح طولانی تر رویداد (به عنوان مثال، "تعداد دفعاتی که بازیکن یک زامبی را کشته است" یا "تعداد کل جواهرات قرمزی که بازیکن حذف کرده و مطابقت داده است"). توضیحات می تواند تا 500 کاراکتر باشد. این مقدار توسط کنسول Google Play استفاده می شود و می تواند در بازی شما نمایش داده شود.
نوع رویداد

فیلدی که نوع داده ای را که رویداد ردیابی می کند، اعلام می کند. این مقدار توسط Google Play Console برای پشتیبانی از گزارش Player Analytics استفاده می‌شود.

دو نوع رویداد پشتیبانی می شود:

منبع ارز ممتاز
این نوع را برای رویدادهایی که منابع یک ارز ممتاز را ردیابی می کنند، انتخاب کنید. مثلا:
  • "سکه های طلا به دست آمده"
  • “زمرد خریداری شده”
سینک ارز ممتاز
این نوع را برای رویدادهایی که کاهش یا مصرف یک ارز ممتاز را دنبال می‌کنند، انتخاب کنید. مثلا:
  • “سکه های طلا خرج شده”
  • زمرد استفاده شده

آیکون نماد مربعی که با رویداد شما مرتبط می شود.

ایجاد یک رویداد

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

  1. اگر قبلاً این کار را نکرده‌اید، بازی خود را به کنسول Google Play اضافه کنید .
  2. در کنسول Google Play، روی نماد خدمات بازی در سمت چپ کلیک کنید و ورودی بازی خود را انتخاب کنید.
  3. تب رویدادها را در سمت چپ انتخاب کرده و روی دکمه افزودن رویداد کلیک کنید.
  4. جزئیات رویدادی را که می خواهید ایجاد کنید پر کنید.
  5. روی ذخیره کلیک کنید. اگر خطایی وجود نداشته باشد، رویداد شما در وضعیت "آماده انتشار" قرار می گیرد. اکنون می توانید به انتشار تغییرات بازی خود ادامه دهید.

ویرایش یک رویداد

برای ویرایش رویدادی که ایجاد کرده‌اید:

  1. در کنسول Google Play، تب رویدادها را باز کنید و ورودی رویدادی را که می‌خواهید ویرایش کنید انتخاب کنید. شما باید همان فرمی را ببینید که هنگام ایجاد رویداد استفاده کرده اید.
  2. تغییرات ویرایشی خود را انجام دهید.
  3. پس از اتمام ویرایش رویداد، روی دکمه ذخیره کلیک کنید.
  4. بازی خود را برای تأیید رویداد تغییر یافته آزمایش کنید. اگر درست کار می کند، تغییرات بازی خود را دوباره منتشر کنید .

حذف یک رویداد

می توانید رویدادهایی را که در حالت پیش نویس هستند یا منتشر شده اند حذف کنید. برای حذف یک رویداد در کنسول Google Play، روی دکمه حذف در پایین فرم مربوط به آن رویداد کلیک کنید.

بازنشانی داده های رویداد

می‌توانید داده‌های پیشرفت پخش‌کننده را برای آزمایش‌کنندگان رویدادهایتان بازنشانی کنید.

  • برای بازنشانی رویدادهای پیش‌نویس در کنسول Google Play، روی دکمه بازنشانی پیشرفت رویداد در پایین فرم مربوط به آن رویداد کلیک کنید.
  • برای بازنشانی داده‌های رویداد از طریق برنامه‌ریزی، روش‌های Events مدیریت API را فراخوانی کنید.

پیاده سازی های مشتری

برای یادگیری نحوه اجرای رویدادها برای پلتفرم خود، به منابع زیر مراجعه کنید: