هنگامی که 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);
بررسی کنید که کد شما رویدادها را برای LOGIN ، UNLOCK_ACHIEVEMENT ، یا POST_SCORE اجرا می کند.
با فعال کردن گزارش گیری پرمخاطب، بررسی کنید که SDK رویدادها را ثبت می کند. از آنجایی که دستگاه‌ها برای حفظ عمر باتری رویدادها را دسته‌بندی می‌کنند، ممکن است مدتی طول بکشد تا این رویدادها در داشبورد Analytics قابل مشاهده باشند.
نمی توان Google Play به Firebase پیوند داد
باید Google Play با استفاده از کنسول Firebase به Firebase پیوند دهید ( settings > تنظیمات پروژه > ادغام > Google Play ). اگر در پیوند دادن مشکل دارید، موارد زیر را بررسی کنید:
اطمینان حاصل کنید که برنامه شما تمام پیش نیازهای پیوند را برآورده می کند.
اطمینان حاصل کنید که دسترسی لازم برای ایجاد پیوند را دارید.
دسترسی به کنسول Firebase از کنسول Play امکان پذیر نیست
مطمئن شوید که حساب توسعه دهنده Google Play شما به یک برنامه Firebase مرتبط است. در کنسول Play ، مالک یا سرپرست حساب برنامه‌نویس Play می‌تواند وضعیت پیوند را در settingsSetup > Linked Services > Firebase مشاهده کند.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Integrate Firebase with your Play Games services project\n\n\u003cbr /\u003e\n\nFirebase can help level up your game:\n\n- Log Games events with Google Analytics, a free app measurement solution\n that provides insight on app usage and user engagement.\n\n- Use any of the [Firebase products that support games](/games), like\n Crashlytics, Remote Config, and more.\n\nGet started\n-----------\n\n1. If you haven't already, create a Firebase project, and then add Firebase to\n your game ([C++](/docs/cpp/setup) \\| [Unity](/docs/unity/setup)).\n\n | Note the following:\n | - If you've previously linked your Google Play developer account to a Google Cloud project in the Play Console, use that same project for getting started with Firebase. Behind the scenes, a Firebase project is a Google Cloud project ([learn\n | more](/docs/projects/learn-more#firebase-cloud-relationship)).\n | - Make sure to enable Google Analytics during the Firebase project creation flow or enable it after project creation in the [*Integrations* tab](//console.firebase.google.com/project/_/settings/integrations/) of the Firebase console.\n2. [Link your Firebase app to your\n Google Play developer account](https://support.google.com/firebase/answer/6392038).\n This same link will be used by your Play Games services project.\n\n\n In the Firebase console, go to the\n [*Integrations* tab](https://console.firebase.google.com/project/_/settings/integrations).\n On the *Google Play* card, click **Link**, and then follow the on-screen\n instructions to create the link.\n\n3. Make sure that your app in Google Play is [set up to use\n Play Games services](https://developers.google.com/games/services/console/enabling).\n\n | When you're asked to specify whether your game already uses Google APIs, choose **Yes, my game already uses Google APIs**. Select your Firebase project from the list, and then click **Use**.\n\nLog Games events using Google Analytics\n---------------------------------------\n\n1. [Add Google Analytics to your app.](/docs/analytics/get-started?platform=android)\n\n2. Once you've added the Firebase SDK for Google Analytics to your app,\n you can begin logging Play Games events. Here are some sample\n events you can log:\n\n - Login events\n\n Bundle bundle = new Bundle();\n mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.LOGIN, bundle);\n\n - Unlock achievements\n\n Bundle bundle = new Bundle();\n bundle.putString(FirebaseAnalytics.Param.ACHIEVEMENT_ID, achievementId);\n mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.UNLOCK_ACHIEVEMENT, bundle);\n\n - Scores on a leaderboard\n\n Bundle bundle = new Bundle();\n bundle.putLong(FirebaseAnalytics.Param.SCORE, score);\n bundle.putString(\"leaderboard_id\", leaderboardId);\n mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.POST_SCORE, bundle);\n\n3. You can view the logged events in the\n [Analytics dashboard](https://console.firebase.google.com/project/_/analytics/app/_/overview)\n of the Firebase console.\n\n You can also access the Firebase console from the\n [Play Console](//play.google.com/apps/publish/)\n by clicking the Firebase icon next to your app's icon in the Game details\n page.\n\nTroubleshooting common errors\n-----------------------------\n\n### Cannot view Play Games events in the Analytics dashboard\n\n- Check that you've [enabled Google Analytics for your Firebase\n project](https://support.google.com/firebase/answer/9289399#linkga)\n and that you've\n [integrated Google Analytics](/docs/analytics/get-started?platform=android)\n into your game.\n\n- Verify that your code implements events for `LOGIN`, `UNLOCK_ACHIEVEMENT`, or\n `POST_SCORE`.\n\n- Verify the SDK is logging events by enabling\n [verbose logging](/docs/analytics/events?platform=android#view_events_in_the_android_studio_debug_log).\n Because devices batch events to preserve battery life, it can take some time\n before these events are visible in the Analytics dashboard.\n\n### Cannot link Google Play to Firebase\n\nYou need to [link Google Play to Firebase](https://support.google.com/firebase/answer/6392038)\nusing the Firebase console\n(settings \\\u003e *Project settings* \\\u003e\n*Integrations* \\\u003e *Google Play*). If you're having trouble linking, check the\nfollowing:\n\n- Make sure that your app meets all the\n [prerequisites](https://support.google.com/firebase/answer/6392038#prerequisites)\n for linking.\n\n- Make sure that you have the\n [required access](https://support.google.com/firebase/answer/6392038#permissions-and-roles)\n for creating the link.\n\n### Cannot access the Firebase console from the Play Console\n\nMake sure that your Google Play developer account is linked to a Firebase app. In the\n[Play Console](https://play.google.com/apps/publish/), an Owner or\nAdmin of the Play developer account can view the linking status under\nsettings*Setup* \\\u003e *Linked Services* \\\u003e *Firebase*."]]
