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

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

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 מהמסוף ומעבירים אותם לפרויקט ב-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

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

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

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

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

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

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

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