שילוב Firebase עם הפרויקט של שירותי Play Games

‫Firebase יכול לעזור לכם לשפר את המשחק:

• מתעדים אירועים במשחקים באמצעות Google Analytics, פתרון חינמי למדידת נתוני האינטראקציות באפליקציה שמספק תובנות לגבי השימוש באפליקציה והתעניינות המשתמשים.

• אתם יכולים להשתמש בכל אחד ממוצרי Firebase שתומכים במשחקים, כמו Crashlytics,‏ Remote Config ועוד.

שנתחיל?

1. אם עדיין לא עשיתם את זה, צרו פרויקט ב-Firebase והוסיפו את Firebase למשחק (C++‎ | Unity).

   חשוב לזכור:

   • אם בעבר קישרתם את חשבון הפיתוח ב-Google Play לפרויקט ב-Google Cloud במסוף Play, השתמשו באותו פרויקט כדי להתחיל לעבוד עם Firebase. מאחורי הקלעים, פרויקט ב-Firebase הוא פרויקט ב-Google Cloud (מידע נוסף).
   • חשוב להפעיל את Google Analytics במהלך תהליך היצירה של הפרויקט ב-Firebase, או להפעיל אותו אחרי יצירת הפרויקט בכרטיסייה Integrations (שילובים) במסוף Firebase.

2. מקשרים את אפליקציית Firebase לחשבון הפיתוח ב-Google Play. הקישור הזה ישמש גם את הפרויקט שלך ב-Play Games services.
   במסוף Firebase, נכנסים לכרטיסייה Integrations. בכרטיס Google Play, לוחצים על Link ופועלים לפי ההוראות במסך כדי ליצור את הקישור.

3. מוודאים שהאפליקציה ב-Google Play מוגדרת לשימוש ב-Play Games services.

   כשמוצגת בקשה לציין אם המשחק כבר משתמש ב-Google APIs, בוחרים באפשרות כן, המשחק שלי כבר משתמש ב-Google APIs. בוחרים את הפרויקט ב-Firebase מהרשימה ולוחצים על שימוש.

רישום אירועים של Games באמצעות Google Analytics

1. מוסיפים את Google Analytics לאפליקציה.

2. אחרי שמוסיפים לאפליקציה את Firebase SDK for 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 ( > Project settings (הגדרות הפרויקט) > Integrations (שילובים) > Google Play). אם נתקלתם בבעיות בקישור, בדקו את הדברים הבאים:

• מוודאים שהאפליקציה עומדת בכל הדרישות המוקדמות לקישור.

• חשוב לוודא שיש לכם את ההרשאות הנדרשות כדי ליצור את הקישור.

אי אפשר לגשת למסוף Firebase ממסוף Play

מוודאים שחשבון הפיתוח ב-Google Play מקושר לאפליקציית Firebase. במסוף Play, בעלים או אדמין של חשבון הפיתוח ב-Play יכולים לראות את סטטוס הקישור בקטע הגדרה > שירותים מקושרים > Firebase.