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

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


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

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

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

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

כדי לאסוף נתונים של ייבוא נתוני הקמפיין, צריך להוסיף את AdSupport framework לפרויקט.

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

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

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

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

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

אפשר לתעד פרמטרים באירועים באמצעות 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. בתפריט הימני, לוחצים על Run (הפעלה).
  3. בוחרים בכרטיסייה Arguments (ארגומנטים).
  4. בקטע Arguments Passed On Launch (ארגומנטים שהערך שלהם נקבע בהפעלה) מוסיפים את הערך -FIRAnalyticsVerboseLoggingEnabled.

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

צפייה באירועים במרכז הבקרה

במסוף Firebase, אתם יכולים לראות נתונים סטטיסטיים נצברים על האירועים שלכם במרכז הבקרה של Analytics > Events.

כמה נקודות חשובות לגבי מרכז הבקרה הזה:

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

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