שילוב 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, לוחצים על קישור ופועלים לפי ההוראות במסך כדי ליצור את הקישור.

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

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

רישום אירועים של משחקים באמצעות 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.