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

    Java

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

    קוטלין+KTX

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

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    קוטלין+KTX

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

    Java

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

    קוטלין+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);

קוטלין+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, ועוזרת לך לאמת מיד שאירועים נשלחים.

הצעדים הבאים