התחל עם 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 , הכריז על התלות של ספריית Android של Analytics בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle ).

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.3.1')
    
        // 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 , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

    (אלטרנטיבי) הכרזה על תלות בספריית 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:21.1.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.3.1')
    
        // 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 , האפליקציה שלך תמיד תשתמש בגרסאות תואמות של ספריות Firebase Android.

    (אלטרנטיבי) הכרזה על תלות בספריית 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:21.1.0'
    }
    

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

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

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

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

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

הקוד הבא רושם אירוע SELECT_CONTENT כאשר משתמש לוחץ על רכיב ספציפי באפליקציה שלך.

Java

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

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

הצעדים הבאים