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

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

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

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

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

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

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

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

אחרי שיוצרים מופע של FirebaseAnalytics, אפשר להשתמש בו כדי לתעד אירועים באמצעות ה-methods של הספרייה 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 > Events > Manage Custom Definitions > Create Custom Dimensions (‏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.