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

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


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

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

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

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

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

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

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

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

בדוגמה הבאה מוסבר איך לתעד אירוע 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. במאמר Google Analytics 4 BigQuery Export אפשר למצוא שאילתות לדוגמה ומידע נוסף.

  • הפרמטר 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);

אם מציינים פרמטר ב-method‏ 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 כפי שמתואר בקטע הקודם במדריך הזה.