Check out what’s new from Firebase at Google I/O 2022. Learn more

יומן אירועים

מדריך זה מראה לך כיצד לרשום אירועים באפליקציה שלך.

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

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

לפני שאתה מתחיל

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

יומן אירועים

לאחר שהגדרת את המופע של firebase.analytics( firebase.analytics() , תוכל להתחיל לרשום אירועים עם השיטה logEvent() . אם אתה כבר מכיר את Google Analytics, שיטה זו מקבילה לשימוש בפקודה event ב- gtag.js.

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

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

תוכל למצוא פרטי יישום עבור מספר אירועים ואת הפרמטרים שלהם במדריך לאירוע gtag.js .

הדוגמה הבאה מדגימה כיצד לרשום אירוע select_content :

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

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

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

    ניתן להשתמש בפרמטרים מותאמים אישית בהגדרות קהל שניתן להחיל על כל דוח. פרמטרים מותאמים אישית נכללים גם בנתונים המיוצאים אל BigQuery אם האפליקציה שלך מקושרת לפרויקט BigQuery. מצא שאילתות לדוגמה ועוד הרבה יותר ב- Google Analytics 4 BigQuery Export .

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

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

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web version 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

הצג אירועים בלוח המחוונים

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

אתה יכול לגשת לנתונים האלה ממרכז השליטה של ​​אירועים במסוף Firebase. לוח המחוונים הזה מציג את דוחות האירועים שנוצרים אוטומטית עבור כל סוג אירוע נפרד שנרשם על ידי האפליקציה שלך.