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


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

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

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

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

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

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

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

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

כדי להפעיל את הרישום המפורט (verbose) ביומן:

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

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

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

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

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