دمج 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 Play" باستخدام Google Analytics

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

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

   يمكنك أيضًا الوصول إلى وحدة تحكّم 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.