ادغام Firebase با پروژه «خدمات بازی‌های Play»

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

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

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

شروع کنید

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

   این موارد را درنظر داشته باشید:

   • اگر قبلاً حساب توسعه‌دهنده Google Play خود را به پروژه Google Cloud در «کنسول» Play پیوند داده‌اید، از همان پروژه برای شروع کار با Firebase استفاده کنید. در پشت صحنه، پروژه Firebase یک پروژه Google Cloud است (بیشتر بدانید).
   • حتماً Google Analytics را درطول جریان ایجاد پروژه Firebase فعال کنید یا آن را پس‌از ایجاد پروژه در برگه ادغام‌ها در کنسول Firebase فعال کنید.

2. برنامه Firebase خود را به Google Play حساب توسعه‌دهنده پیوند دهید. پروژه Play Games services شما از همین پیوند استفاده خواهد کرد.
   در کنسول Firebase، به برگه «ادغام‌ها» بروید. در کارت Google Play، روی پیوند کلیک کنید و سپس دستورالعمل‌های روی صفحه را برای ایجاد پیوند دنبال کنید.

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

   وقتی از شما خواسته شد مشخص کنید که آیا بازی‌تان درحال‌حاضر از Google APIs استفاده می‌کند یا نه، بله، بازی من درحال‌حاضر از Google APIs استفاده می‌کند را انتخاب کنید. پروژه Firebase خود را از فهرست انتخاب کنید، سپس روی استفاده کلیک کنید.

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

1. Google Analytics را به برنامه‌تان اضافه کنید.

2. وقتی «کیت توسعه نرم‌افزار Firebase» را برای 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 مشاهده کنید.

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

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

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

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

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

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

نمی‌توان Google Play را به Firebase پیوند داد

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

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

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

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

مطمئن شوید حساب توسعه‌دهنده Google Play شما به برنامه Firebase پیوند شده باشد. در Play کنسول، «مالک» یا «سرپرست» حساب توسعه‌دهنده Play می‌تواند وضعیت پیوند را در راه‌اندازی > سرویس‌های پیوندشده > Firebase مشاهده کند.