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


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

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

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

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

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

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

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

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

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

תוכלו להיעזר בדוגמה הבאה כדי לתעד אירוע ב-SELECT_CONTENT:

Kotlin+KTX 

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

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);
MainActivity.java

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

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

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

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

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

Kotlin+KTX 

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

Java 

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

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

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

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

Kotlin+KTX 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.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 במסוף. לוחות הבקרה האלה מתעדכנים מדי פעם במהלך היום. לבדיקה מיידית, משתמשים בפלט של logcat כפי שמתואר בקטע הקודם.

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