Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

לפני שאתה מתחיל

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

יומן אירועים

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

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

ניתן למצוא פרטי יישום בהפניה קבוע עבור סוויפט ו Objective-C .

הדוגמה הבאה ממחישה כיצד לתעד הציע kFIRSelectContent האירוע:

מָהִיר

הערה: מוצר Firebase זו אינו זמין על יעד MacOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

Objective-C

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

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

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

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

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

מָהִיר

הערה: מוצר Firebase זו אינו זמין על יעד MacOS.
Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

Objective-C

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

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

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

מָהִיר

הערה: מוצר Firebase זו איננו זמין על יעד MacOS.
Analytics.setDefaultEventParameters([ "level_name": "Caverns01", "level_difficulty": 4 ])

Objective-C

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

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

כדי לנקות פרמטר ברירת מחדל, קורא setDefaultEventParameters שיטה עם סט הפרמטר nil .

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

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

אתה יכול לאפשר רישום מילולי באופן הבא:

  1. בשנת Xcode, בחר מוצר> תוכנית> ערכה ערוך ...
  2. בחר הפעלה מהתפריט השמאלי.
  3. בחר את כרטיסיית הטיעונים.
  4. בטיעונים עברו על סעיף הפעלה, תוספת -FIRAnalyticsDebugEnabled .

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

הצג אירועים בלוח המחוונים

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

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