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 .

אירועי יומן

לאחר שיצרת FirebaseAnalytics למשל, אתה יכול להשתמש בו כדי להתחבר אירועים עם logEvent() שיטה.

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

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

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

ג'אווה

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

קוטלין+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

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

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

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

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

ג'אווה

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

הגדר פרמטרי ברירת מחדל לאירוע

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

ג'אווה

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

קוטלין+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

אם פרמטר מצוין על ב logEvent() השיטה, ערך המשמש במקום ברירת המחדל.

כדי לנקות פרמטר ברירת מחדל, קורא setDefaultEventParameters שיטה עם סט פרמטר null .

הצג אירועים ביומן באגים של 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

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

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

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

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