ادمج Firebase مع مشروع خدمات ألعاب Play

يمكن أن يساعد Firebase في رفع مستوى لعبتك:

• سجل أحداث الألعاب باستخدام Google Analytics ، وهو حل مجاني لقياس التطبيقات يوفر نظرة ثاقبة حول استخدام التطبيق ومشاركة المستخدم.

• استخدم أيًا من منتجات Firebase التي تدعم الألعاب ، مثل Crashlytics و Remote Config والمزيد.

البدء

1. إذا لم تكن قد قمت بذلك بالفعل ، فأنشئ مشروع Firebase ، ثم أضف Firebase إلى لعبتك ( C ++ | Unity ).

2. اربط تطبيق Firebase بحسابك على Google Play Developer . سيستخدم مشروع خدمات ألعاب Play هذا الرابط نفسه.
   في وحدة تحكم Firebase ، انتقل إلى علامة التبويب "عمليات التكامل" . في بطاقة Google Play ، انقر فوق ارتباط ، ثم اتبع الإرشادات التي تظهر على الشاشة لإنشاء الارتباط.

3. تأكد من إعداد تطبيقك في Google Play لاستخدام خدمات ألعاب Play .

تسجيل أحداث الألعاب باستخدام 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 في لوحة التحكم في Analytics

• تأكد من تمكين Google Analytics لمشروع Firebase ومن دمج Google Analytics في لعبتك.

• تحقق من أن التعليمات البرمجية الخاصة بك تنفذ الأحداث لـ LOGIN أو UNLOCK_ACHIEVEMENT أو POST_SCORE .

• تحقق من أن SDK تسجل الأحداث من خلال تمكين التسجيل المطول . نظرًا لأن الأجهزة تجمع الأحداث للحفاظ على عمر البطارية ، فقد يستغرق الأمر بعض الوقت قبل أن تظهر هذه الأحداث في لوحة معلومات Analytics.

لا يمكن ربط Google Play بـ Firebase

تحتاج إلى ربط Google Play بـ Firebase باستخدام وحدة تحكم Firebase ( settings > إعدادات المشروع > عمليات التكامل > Google Play ). إذا كنت تواجه مشكلة في الربط ، فتحقق مما يلي:

• تأكد من أن تطبيقك يلبي جميع المتطلبات الأساسية للربط.

• تأكد من أن لديك حق الوصول المطلوب لإنشاء الارتباط.

لا يمكن الوصول إلى وحدة تحكم Firebase من Play Console

تأكد من أن حساب مطوّر برامج Google Play مرتبط بتطبيق Firebase. في Play Console ، يمكن لمالك حساب مطور Play أو مشرفه عرض حالة الربط ضمن settings الإعداد > الخدمات المرتبطة > Firebase .