Firebase را با پروژه خدمات Play Games خود ادغام کنید

فایربیس می‌تواند به ارتقای سطح بازی شما کمک کند:

• رویدادهای بازی را با Google Analytics ثبت کنید، یک راهکار رایگان برای سنجش برنامه که بینشی در مورد استفاده از برنامه و تعامل کاربر ارائه می‌دهد.

• از هر یک از محصولات Firebase که از بازی‌ها پشتیبانی می‌کنند ، مانند Crashlytics ، Remote Config و موارد دیگر، استفاده کنید.

شروع کنید

1. اگر هنوز این کار را نکرده‌اید، یک پروژه Firebase ایجاد کنید و سپس Firebase را به بازی خود اضافه کنید ( C++ | Unity ).

2. برنامه Firebase خود را به حساب توسعه‌دهنده Google Play خود پیوند دهید . همین پیوند توسط پروژه Play Games services شما استفاده خواهد شد.
   در کنسول Firebase ، به تب Integrations بروید. در کارت Google Play ، روی Link کلیک کنید و سپس دستورالعمل‌های روی صفحه را برای ایجاد لینک دنبال کنید.

3. مطمئن شوید که برنامه شما در Google Play برای استفاده Play Games services تنظیم شده است.

ثبت رویدادهای بازی با استفاده از Google Analytics

1. Google Analytics به برنامه خود اضافه کنید.

2. پس از افزودن Firebase SDK برای Google Analytics به برنامه خود، می‌توانید شروع به ثبت رویدادهای Play Games کنید. در اینجا چند نمونه از رویدادهایی که می‌توانید ثبت کنید، آورده شده است:

   • رویدادهای ورود

     Bundle bundle = new Bundle();
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.LOGIN, bundle);
     

   • دستاوردها را باز کنید

     Bundle bundle = new Bundle();
     bundle.putString(FirebaseAnalytics.Param.ACHIEVEMENT_ID, achievementId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.UNLOCK_ACHIEVEMENT, bundle);
     

   • امتیازات در جدول امتیازات

     Bundle bundle = new Bundle();
     bundle.putLong(FirebaseAnalytics.Param.SCORE, score);
     bundle.putString("leaderboard_id", leaderboardId);
     mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.POST_SCORE, bundle);
     

3. شما می‌توانید رویدادهای ثبت‌شده را در داشبورد Analytics کنسول Firebase مشاهده کنید.

   همچنین می‌توانید با کلیک روی آیکون Firebase در کنار آیکون برنامه خود در صفحه جزئیات بازی، از طریق Play Console به کنسول Firebase دسترسی پیدا کنید.

عیب‌یابی خطاهای رایج

نمی‌توانم رویدادهای Play Games را در داشبورد Analytics مشاهده کنم

• بررسی کنید که Google Analytics برای پروژه فایربیس خود فعال کرده باشید و Google Analytics در بازی خود ادغام کرده باشید.

• تأیید کنید که کد شما رویدادهای LOGIN ، UNLOCK_ACHIEVEMENT یا POST_SCORE را پیاده‌سازی می‌کند.

• با فعال کردن قابلیت Verbose logging، مطمئن شوید که SDK رویدادها را ثبت می‌کند. از آنجایی که دستگاه‌ها برای حفظ عمر باتری، رویدادها را دسته‌بندی می‌کنند، ممکن است مدتی طول بکشد تا این رویدادها در داشبورد Analytics قابل مشاهده باشند.

نمی‌توانم Google Play به فایربیس متصل کنم

شما باید با استفاده از کنسول Firebase ( settings > تنظیمات پروژه > ادغام‌ها > Google Play ) Google Play را به فایربیس متصل کنید . اگر در اتصال مشکل دارید، موارد زیر را بررسی کنید:

• مطمئن شوید که برنامه شما تمام پیش‌نیازهای لازم برای لینک‌سازی را دارد.

• مطمئن شوید که دسترسی لازم برای ایجاد لینک را دارید.

نمی‌توانم از طریق کنسول Play به کنسول Firebase دسترسی پیدا کنم

مطمئن شوید که حساب توسعه‌دهنده Google Play شما به یک برنامه Firebase متصل است. در کنسول Play ، مالک یا مدیر حساب توسعه‌دهنده Play می‌تواند وضعیت اتصال را در settings Setup > Linked Services > Firebase مشاهده کند.