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

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

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

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

شروع کنید

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

   به موارد زیر توجه کنید:

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

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

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

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

ثبت رویدادهای بازی با استفاده از 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 به کنسول Firebase دسترسی پیدا کنید.

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

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

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

• بررسی کنید که کد شما رویدادها را برای LOGIN ، UNLOCK_ACHIEVEMENT ، یا POST_SCORE اجرا می کند.

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

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

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

• اطمینان حاصل کنید که برنامه شما تمام پیش نیازهای پیوند را برآورده می کند.

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

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

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