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

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

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

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

אם רוצים לאסוף נתוני ייבוא נתוני הקמפיין לאפליקציות בפלטפורמת Apple, חשוב להוסיף את AdSupport framework לפרויקט.

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

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