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

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

• تسجيل أحداث الألعاب باستخدام "إحصاءات Google"، وهو حل مجاني لقياس أداء التطبيقات التي توفّر إحصاءات حول استخدام التطبيق وتفاعل المستخدمين.

• استخدِم أيًا من منتجات Firebase التي تتوافق مع الألعاب، مثل Crashlytics والإعداد عن بُعد والمزيد

البدء

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

   يُرجى مراعاة ما يلي:

   • إذا سبق لك ربط حساب المطوِّر على Google Play بخدمة Google Cloud مشروعك في Play Console، استخدِم المشروع نفسه لبدء استخدام Firebase. وراء الكواليس، مشروع في Firebase هو مشروع على Google Cloud (مزيد من المعلومات المزيد).
   • تأكَّد من تفعيل "إحصاءات Google" أثناء استخدام Firebase. إنشاء مشروع جديد أو تمكينه بعد إنشاء المشروع في علامة التبويب عمليات الدمج بوحدة تحكم Firebase.

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

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

   عندما يُطلب منك تحديد ما إذا كانت لعبتك Google APIs، فاختر نعم، لعبتي تستخدم Google APIs. اختَر مشروع Firebase من القائمة، ثم انقر على استخدام.

تسجيل أحداث الألعاب باستخدام "إحصاءات Google"

1. أضِف "إحصاءات Google" إلى تطبيقك.

2. بعد إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" إلى تطبيقك يمكنك بدء تسجيل أحداث "ألعاب Play". إليك بعض النماذج الأحداث التي يمكنك تسجيلها:

   • أحداث تسجيل الدخول

     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. يمكنك عرض الأحداث التي تم تسجيلها في لوحة بيانات "إحصاءات Google" بوحدة تحكم Firebase.

   يمكنك أيضًا الوصول إلى "وحدة تحكُّم Firebase" من Play Console من خلال النقر على رمز Firebase بجانب رمز التطبيق في صفحة "تفاصيل اللعبة" .

تحديد الأخطاء الشائعة وحلّها

تعذّر عرض أحداث "ألعاب Play" في لوحة بيانات "إحصاءات Google".

• التأكّد من أنك مكَّنت "إحصاءات Google" لبرنامج Firebase المشروع وأنك دمج "إحصاءات Google" في لعبتك.

• التحقّق من أنّ الرمز ينفّذ الأحداث على LOGIN أو UNLOCK_ACHIEVEMENT POST_SCORE

• التأكّد من أنّ حزمة تطوير البرامج (SDK) تسجِّل الأحداث من خلال تفعيل التسجيل المطوَّل: قد تستغرق الأجهزة بعض الوقت لأنّ الأجهزة تجمَع الأحداث للحفاظ على عمر البطارية. قبل ظهور هذه الأحداث في لوحة بيانات "إحصاءات Google".

تعذّر ربط Google Play بمنصّة Firebase

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

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

• تأكَّد من حصولك على إذن الوصول مطلوب لإنشاء الرابط.

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

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