רישום אירועים

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

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

אירועים מספקים תובנות לגבי מה שקורה באפליקציה, כמו פעולות של משתמשים, אירועי מערכת או שגיאות.

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

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

לפני שתוכלו להשתמש ב-Google Analytics, אתם צריכים:

• רושמים את הפרויקט ב-Unity ומגדירים אותו לשימוש ב-Firebase.

  • אם פרויקט Unity שלכם כבר משתמש ב-Firebase, הוא כבר רשום ומוגדר ל-Firebase.

  • אם אין לכם פרויקט ב-Unity, אתם יכולים להוריד אפליקציה לדוגמה.

• מוסיפים את Firebase Unity SDK (באופן ספציפי, FirebaseAnalytics.unitypackage) לפרויקט ב-Unity.

הוראות מפורטות למשימות ההגדרה הראשוניות האלה מופיעות במאמר הוספת Firebase לפרויקט ב-Unity.

שימו לב: הוספת Firebase לפרויקט ב-Unity כוללת משימות גם במסוף Firebase וגם בפרויקט הפתוח ב-Unity (לדוגמה, אתם מורידים קובצי תצורה של Firebase מהמסוף ואז מעבירים אותם לפרויקט ב-Unity).

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

אחרי שמפעילים את המודול Firebase.Analytics.FirebaseAnalytics, אפשר להשתמש בו כדי לתעד אירועים באמצעות ה-method‏ LogEvent().

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

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

אפשר למצוא פרטי הטמעה של אירועים מומלצים במיקומים הבאים:

• אירועים מוצעים: אפשר לעיין ברשימת הקבועים של Event.
• פרמטרים שהוגדרו מראש: רשימה של קבועים מסוג Parameters.

בדוגמה הבאה אפשר לראות איך מתעדים אירוע SELECT_CONTENT מוצע:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

בנוסף לפרמטרים שנקבעו מראש, אתם יכולים להוסיף את הפרמטרים הבאים לכל אירוע:

• פרמטרים מותאמים אישית: הפרמטרים המותאמים אישית לא מיוצגים ישירות בדוחות של Analytics, אבל אפשר להשתמש בהם כמסננים בהגדרות של קהלים שאפשר להחיל על כל דוח. פרמטרים מותאמים אישית נכללים גם בנתונים שמיוצאים ל-BigQuery אם האפליקציה מקושרת לפרויקט ב-BigQuery.

• VALUE פרמטר: VALUE הוא פרמטר למטרות כלליות שמועיל לצבירת מדד חשוב שקשור לאירוע Analytics. לדוגמה: הכנסה, מרחק, זמן ונקודות.

אם לאפליקציה שלכם יש צרכים ספציפיים שלא נכללים בסוג אירוע מוצע של Analytics, אתם יכולים לתעד אירועים מותאמים אישית משלכם ב-Analytics, כמו שמוצג בדוגמה הזו:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

הצגת אירועים בפלט של היומן

iOS+‎

האירועים מתועדים במסוף, ואפשר לראות אותם בזמן שהאפליקציה פועלת דרך XCode.

Android

אתם יכולים להפעיל רישום מפורט ביומן ניפוי הבאגים של Android Studio, כדי לוודא שהאירועים מתועדים ביומן בצורה תקינה על ידי ה-SDK. הנתונים האלה כוללים אירועים שמתועדים באופן אוטומטי ואירועים שמתועדים באופן ידני.

כדי להפעיל רישום מפורט ביומן, אפשר להשתמש בסדרה של פקודות adb:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

הפקודה הזו מציגה את האירועים ב-logcat של Android Studio, וכך אתם יכולים לוודא מיד שהאירועים נשלחים.

צפייה באירועי ניתוח נתונים במרכז הבקרה

במסוף Firebase, אתם יכולים לראות נתונים סטטיסטיים נצברים על האירועים שלכם במרכז הבקרה של Analytics > Events.

כמה נקודות חשובות לגבי מרכז הבקרה הזה:

• בלוח הבקרה מוצגים דוחות האירועים שנוצרים באופן אוטומטי לכל סוג נפרד של יומן אירועים שהאפליקציה מתעדת.

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

מידע נוסף על מרכז הבקרה