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


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

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

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

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

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

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

אחרי שמגדירים את המכונה firebase.analytics(), אפשר להתחיל לתעד אירועים באמצעות השיטה logEvent(). אם אתם כבר מכירים את Google Analytics, השיטה הזו זהה לשימוש בפקודה event ב-gtag.js.

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

הערה: כדי לקבל את מירב הפרטים בדוחות, כדאי לתעד את האירועים המומלצים שמתאימים לאפליקציה שלכם ואת הפרמטרים שהוגדרו להם מראש. כך תוכלו גם ליהנות מהתכונות העדכניות של Google Analytics, ברגע שיהיו זמינות.

פרטים על ההטמעה של מספר אירועים ושל הפרמטרים שלהם מופיעים בחומר העזר בנושא אירועים ב-gtag.js.

הדוגמה הבאה ממחישה איך מתעדים ביומן אירוע select_content:

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});
analytics_log_event_params.js

Web

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});
index.js

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

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

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

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

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

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
analytics_log_event_custom_params.js

Web

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
index.js

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

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

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