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


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

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

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

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

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

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

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

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

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

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