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

يمكن أن تساعدك Firebase في تحسين لعبتك:

• سجِّل أحداث "ألعاب Google Play" باستخدام 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 Play" باستخدام Google Analytics

1. أضِف Google Analytics إلى تطبيقك.

2. بعد إضافة حزمة تطوير البرامج (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 الاطّلاع على حالة الربط ضمن الإعداد > الخدمات المرتبطة > Firebase.