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

בחירת פלטפורמה: ‫iOS+‎ Android Web Flutter Unity C++‎


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

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

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

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

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

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

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

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

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

Kotlin 

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

Java 

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);

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

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

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

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

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

Kotlin 

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

Java 

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

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

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

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

Kotlin 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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, אפשר לראות נתונים סטטיסטיים מצטברים על האירועים בלוח הבקרה Analytics > Events.

חשוב לדעת על מרכז הבקרה הזה:

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

  • מרכז הבקרה מתעדכן מעת לעת במהלך היום. כדי לבצע בדיקה מיידית, אפשר להשתמש בפלט של logcat כמו שמתואר בקטע הקודם במדריך הזה.