יומן אירועים

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

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

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

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

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

יומן אירועים

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

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

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

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

  • פרמטר 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.

מָהִיר

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. בקטע הטיעונים שהועברו בעת ההשקה , הוסף -FIRAnalyticsVerboseLoggingEnabled .

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

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

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

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