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

בחירת פלטפורמה: iOS+‎ Android אינטרנט Flutter Unity C++‎


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

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

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

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

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

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

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

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

בדוגמה הבאה מוסבר איך לתעד אירוע select_content:

Web

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

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

Web

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

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

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

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

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

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

Web

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

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

Web

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

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

במסוף Firebase, אתם יכולים לראות נתונים סטטיסטיים נצברים על האירועים שלכם בAnalytics > לוח הבקרה Events.

חשוב לדעת:

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

  • לוח הבקרה מתעדכן מדי פעם לאורך היום. כדי לבדוק את האירועים באופן מיידי, משתמשים ב-DebugView.