Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל לעבוד עם Google Analytics

התחלה מהירה זו מראה לך כיצד להוסיף את Google Analytics לאפליקציה שלך ולהתחיל ברישום אירועים.

Google Analytics אוספת נתוני שימוש והתנהגות עבור האפליקציה שלך. ה- SDK רושם שני סוגים עיקריים של מידע:

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

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

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

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך וודא ש- Google Analytics מופעל בפרויקט Firebase שלך:

  • אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך זרימת העבודה של יצירת הפרויקט.

  • אם אתה משתמש בפרויקט Firebase קיים שאינו פעיל ב- Google Analytics, עבור לכרטיסייה שילובים שלך> הגדרות פרויקט כדי להפעיל אותו.

כאשר אתה מפעיל את Google Analytics בפרויקט שלך, אפליקציות Firebase שלך ​​מקושרות לזרמי נתונים של Google Analytics.

הוסף את ה- SDK של Analytics לאפליקציה שלך

  1. באמצעות Firebase Android BoM , הצהירו על התלות בספריית אנדרואיד Analytics במודול (ברמת האפליקציה) קובץ Gradle (בדרך כלל app/build.gradle ).

    ג'אווה

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // Declare the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics'
    }
    

    על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.

    (חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM

    אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

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

    dependencies {
        // Declare the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics:19.0.0'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // Declare the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx'
    }
    

    על ידי שימוש ב- Firebase Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.

    (חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM

    אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

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

    dependencies {
        // Declare the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx:19.0.0'
    }
    

  2. הכריזו על האובייקט com.google.firebase.analytics.FirebaseAnalytics בראש הפעילות שלכם:

    ג'אווה

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. אתחל אותו בשיטת onCreate() :

    ג'אווה

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

    Kotlin + KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

התחל לרשום אירועים

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

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

הקוד הבא רושם אירוע 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);

Kotlin + 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")
}

באפשרותך לאפשר רישום מילולי כדי לפקח על רישום אירועים על ידי 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, ומסייעת לך לוודא מיד שהאירועים נשלחים.

הצעדים הבאים