רישום אירועים

אירועים מספקים תובנות לגבי מה שקורה באפליקציה שלכם, כמו פעולות המשתמשים, שגיאות או אירועי מערכת.

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

לפני שמתחילים

כדי להשתמש ב-Google Analytics, צריך:

• רושמים את הפרויקט ב-Unity ומגדירים אותו לשימוש ב-Firebase.

  • אם כבר משתמשים ב-Firebase בפרויקט שלכם ב-Unity, הוא כבר רשום ב-Firebase ועבר הגדרה.

  • אם אין לכם פרויקט ב-Unity, תוכלו להוריד אפליקציה לדוגמה.

• מוסיפים את Firebase Unity SDK (במיוחד FirebaseAnalytics.unitypackage) לפרויקט ב-Unity.

חשוב לזכור שהוספת Firebase לפרויקט ב-Unity כוללת משימות גם במסוף Firebase וגם בפרויקט הפתוח ב-Unity (לדוגמה, מורידים קובצי תצורה של Firebase מהמסוף ומעבירים אותם לפרויקט ב-Unity).

אירועים ביומן

אחרי שמפעילים את המודול Firebase.Analytics.FirebaseAnalytics, אפשר להשתמש בו כדי לתעד אירועים באמצעות השיטה LogEvent().

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

פרטי ההטמעה של האירועים המומלצים מופיעים במיקומים הבאים:

• אירועים מוצעים: ראו את רשימת הקבועים Event.
• פרמטרים שהוגדרו מראש: ראו את רשימת המשתנים הקבועים Parameters.

הדוגמה הבאה ממחישה איך מתעדים אירוע SELECT_CONTENT שהוצעה:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

בנוסף לפרמטרים שנקבעו מראש, אפשר להוסיף את הפרמטרים הבאים לכל אירוע:

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

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

אם לאפליקציה שלכם יש צרכים ספציפיים שלא מכוסים בסוג אירוע Analytics מוצעים, תוכלו לתעד אירועי Analytics מותאמים אישית משלכם, כפי שמתואר בדוגמה הבאה:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

הצגת אירועים בפלט היומן

הצגת אירועי ניתוח נתונים בלוח הבקרה

בלוחות הבקרה של מסוף Firebase אפשר לראות נתונים סטטיסטיים מצטברים על האירועים ב-Analytics. לוחות הבקרה האלה מתעדכנים מדי פעם במהלך היום. לבדיקה מיידית, משתמשים בפלט של logcat כפי שמתואר בקטע הקודם.

כדי לגשת לנתונים האלה במסוף Firebase:

1. פותחים את הפרויקט במסוף Firebase.
2. בתפריט, בוחרים באפשרות Analytics כדי להציג את לוח הבקרה של דוחות Analytics.

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