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

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


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

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

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

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

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

אחרי שמגדירים את המופע של firebase.analytics(), אפשר להתחיל לתעד אירועים באמצעות ה-method‏ 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.