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

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

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

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

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

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

אחרי שיוצרים מכונה של FirebaseAnalytics, אפשר להשתמש בה כדי לתעד אירועים באמצעות השיטות מסוג log בספרייה.

אירועים מוגדרים מראש

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

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

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

לחלופין, אפשר לתעד את אותו אירוע באמצעות logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

האפשרות הזו שימושית אם רוצים לציין פרמטרים נוספים מלבד הפרמטרים שצוינו (הנדרשים). אתם יכולים להוסיף את הפרמטרים הבאים לכל אירוע:

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

אפשר להשתמש בפרמטרים מותאמים אישית בהגדרות של קהלים שאפשר להחיל על כל דוח. פרמטרים מותאמים אישית כלולים גם בנתונים שמיוצאים ל-BigQuery אם האפליקציה מקושרת לפרויקט ב-BigQuery. שאילתות לדוגמה ועוד מידע זמינים במאמר BigQuery Export ב-Google Analytics 4.
הפרמטר value: פרמטר למטרות כלליות ששימושי לצבירת מדד מפתח שקשור לאירוע. דוגמאות: הכנסות, מרחק, זמן ונקודות.
שמות הפרמטרים יכולים להיות באורך של עד 40 תווים, חייבים להתחיל באות ולהכיל רק תווים אלפאנומריים וקווים תחתונים. יש תמיכה בסוגי המחרוזות והמספרים. ערכי פרמטרים של מחרוזות יכולים להיות באורך של עד 100 תווים. התחיליות 'firebase', 'google' ו-'ga_‎' שמורות, ואסור להשתמש בהן בשמות של פרמטרים.

אירועים מותאמים אישית

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

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

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

אפשר לרשום ביומן פרמטרים של אירועים שונים באמצעות setDefaultEventParameters(). פרמטרים שמוגדרים כברירת מחדל משויכים לכל האירועים העתידיים שיירשמו ביומן.

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

הערכים החוקיים של הפרמטרים הם String ו-num. הגדרת הערך של מפתח ל-null תמחק את הפרמטר הזה. העברת ערך null מנקה את כל הפרמטרים.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

אם מציינים פרמטר בשיטה logEvent() או log, המערכת משתמשת בערך הזה במקום בערך ברירת המחדל.

כדי למחוק פרמטר ברירת מחדל, צריך לבצע קריאה ל-method‏ setDefaultEventParameters() עם הפרמטר שמוגדר כ-null.

הצגת אירועים בלוח הבקרה

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

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