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

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

iOS+‎ Android אינטרנט Flutter Unity C++‎

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

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

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

אם אתם רוצים לאסוף נתונים של שיוך קמפיינים לאפליקציות בפלטפורמות של אפל, הקפידו להוסיף את מסגרת AdSupport לפרויקט.

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

אחרי שיוצרים מופע של 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. במאמר Google Analytics 4 BigQuery Export אפשר למצוא שאילתות לדוגמה ומידע נוסף.

• הפרמטר 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'
  });

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

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