Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

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

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

אירועי יומן

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

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

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

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

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

גרסת אינטרנט 9

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

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

גרסת אינטרנט 8

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

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

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

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

גרסת אינטרנט 9

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

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

גרסת אינטרנט 8

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

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

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

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