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

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

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

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

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

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

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

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

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

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

אפשר למצוא את שיטות הרישום ביומן של סוגי האירועים המומלצים בהפניות 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.