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

בחירת פלטפורמה:

‫iOS+‎ Android Web Flutter Unity C++‎

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

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

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

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

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

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