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


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

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

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

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

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

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

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

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

פרטים על ההטמעה מופיעים בחומר העזר של הקבועים ל-Swift ול-Objective-C.

הדוגמה הבאה מראה איך מתעדים ביומן אירוע kFIRSelectContent מומלץ:

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])
PatternTabBarController.swift

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
PatternTabBarController.m

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

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

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

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

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

הצגת אירועים במסוף ניפוי הבאגים של Xcode

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

אפשר להפעיל רישום מפורט ביומן באופן הבא:

  1. ב-Xcode, בוחרים באפשרות Product (מוצר) > Scheme (תוכנית) > Edit scheme… (עריכת התוכנית).
  2. בתפריט הימני, בוחרים באפשרות הפעלה.
  3. בוחרים את הכרטיסייה ארגומנטים.
  4. בקטע Arguments Passed On Launch, מוסיפים את -FIRAnalyticsVerboseLoggingEnabled.

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

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

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

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