Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

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

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

אירועי יומן

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

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

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

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

מָהִיר

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 הוא פרמטר למטרות כללי כי הוא שימושי עבור צבירת מדד מרכזי הקשור לאירוע. דוגמאות כוללות הכנסה, מרחק, זמן ונקודות.

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

מָהִיר

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 . פרמטרי ברירת מחדל משויכים לכל האירועים העתידיים שנרשמים.

מָהִיר

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. לוח המחוונים הזה מציג את דוחות האירועים שנוצרים באופן אוטומטי עבור כל סוג אירוע מובהק שנרשם על ידי האפליקציה שלך.