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

במדריך הזה מוסבר איך לתעד אירועים באפליקציה.

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

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

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

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

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

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

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

פרטים על הטמעה של סוגי אירועים מומלצים זמינים במקומות הבאים:

• אירועים מומלצים: אפשר לעיין במקור המידע לגבי המחלקה com.google.firebase.analytics.FirebaseAnalytics.Event.
• פרמטרים שהוגדרו מראש: אפשר לעיין במפרט של השיטה ב-com.google.firebase.analytics.FirebaseAnalytics.Param.

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

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

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

• פרמטרים מותאמים אישית: אפשר להשתמש בפרמטרים מותאמים אישית כמאפיינים או כמדדים בדוחות של Analytics. אפשר להשתמש במאפיינים מותאמים אישית לנתונים של פרמטרים של אירועים שאינם מספריים, ובמדדים מותאמים אישית לנתונים של פרמטרים שמוצגים בצורה טובה יותר כמספרים. אחרי שמתעדים פרמטר מותאם אישית באמצעות ה-SDK, צריך לרשום את המאפיין או המדד כדי לוודא שהפרמטרים המותאמים אישית האלה יופיעו בדוחות של Analytics. כדי לעשות זאת, משתמשים באפשרות Analytics > Events > Manage Custom Definitions > Create Custom Dimensions

  אפשר להשתמש בפרמטרים מותאמים אישית בהגדרות של קהלים שאפשר להחיל על כל דוח. פרמטרים מותאמים אישית כלולים גם בנתונים שמיוצאים ל-BigQuery אם האפליקציה מקושרת לפרויקט ב-BigQuery. אפשר למצוא שאילתות לדוגמה ועוד הרבה מידע במאמר BigQuery Export ב-Google Analytics 4.

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

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

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

הגדרת פרמטרים של אירוע כברירת מחדל

אפשר לרשום פרמטרים באירועים באמצעות setDefaultEventParameters. פרמטרים שמוגדרים כברירת מחדל משויכים לכל האירועים העתידיים שמתועדים.

בדומה לפרמטרים מותאמים אישית, צריך לרשום את פרמטרים ברירת המחדל של האירועים כדי לוודא שהם יופיעו בדוחות של Analytics.

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

אם מציינים פרמטר בשיטה logEvent(), המערכת משתמשת בערך הזה במקום בערך ברירת המחדל.

כדי למחוק פרמטר שמוגדר כברירת מחדל, צריך לבצע קריאה ל-method‏ setDefaultEventParameters עם הפרמטר שמוגדר ל-null.

הצגת אירועים ביומן ניפוי הבאגים של 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, ועוזרת לכם לוודא באופן מיידי שהאירועים נשלחים.

צפייה באירועים בלוח הבקרה

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

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