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

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

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

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

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

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

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

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

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

הוראות מפורטות לביצוע משימות ההגדרה הראשוניות האלה מופיעות במאמר הוספת Firebase לפרויקט Unity.

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

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

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

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

הערה: כדי לקבל את הפירוט המרבי בדוחות, כדאי לתעד את האירועים המומלצים 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);

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

Android

אתם יכולים להפעיל רישום מפורט ביומן ניפוי הבאגים של Android Studio כדי לוודא שהאירועים מתועדים כראוי על ידי ה-SDK. הנתונים כוללים אירועים שתועדו באופן אוטומטי ואירועים שתועדו באופן ידני.

אפשר להפעיל רישום מפורט ביומן באמצעות סדרה של פקודות adb:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

הפקודה הזו מציגה את האירועים ב-logcat של Android Studio, ועוזרת לכם לוודא באופן מיידי שהאירועים נשלחים.

‫iOS+‎

האירועים נרשמים במסוף, ואפשר לראות אותם בזמן שהאפליקציה פועלת דרך XCode.

צפייה באירועים של ניתוח נתונים במרכז הבקרה

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

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

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

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