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

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

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

  • استخدِم أيًا من منتجات Firebase التي تتوافق مع الألعاب، مثل Crashlytics وRemote Config وغير ذلك.

البدء

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

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

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

تسجيل أحداث الألعاب باستخدام 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 Console من Play Console من خلال النقر على رمز Firebase بجانب رمز تطبيقك في صفحة "تفاصيل اللعبة".

تحديد المشاكل الشائعة وحلّها

لا يمكن عرض أحداث Play Games في لوحة بيانات Analytics

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

  • تأكَّد من أنّ الرمز البرمجي ينفّذ أحداثًا لـ LOGIN أو UNLOCK_ACHIEVEMENT أو POST_SCORE.

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

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

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

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