התחלה מהירה זו מראה לך כיצד להוסיף את Google Analytics לאפליקציה שלך ולהתחיל ברישום אירועים.
Google Analytics אוסף נתוני שימוש והתנהגות עבור האפליקציה שלך. ה-SDK רושם שני סוגים עיקריים של מידע:
- אירועים: מה קורה באפליקציה שלך, כגון פעולות משתמש, אירועי מערכת או שגיאות.
- מאפייני משתמש: תכונות שאתה מגדיר לתיאור פלחים של בסיס המשתמשים שלך, כגון העדפת שפה או מיקום גיאוגרפי.
Analytics רושם אוטומטית כמה אירועים ומאפייני משתמש ; אתה לא צריך להוסיף שום קוד כדי להפעיל אותם.
לפני שאתה מתחיל
אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך וודא ש-Google Analytics מופעל בפרויקט Firebase שלך:
אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך תהליך העבודה של יצירת הפרויקט.
אם אתה משתמש בפרויקט Firebase קיים ש-Google Analytics לא מופעל בו, עבור לכרטיסייה אינטגרציות שלך > הגדרות פרויקט כדי להפעיל אותו.
כאשר אתה מפעיל את Google Analytics בפרויקט שלך, יישומי Firebase שלך מקושרים לזרמי נתונים של Google Analytics.
הוסף את ה-SDK של Analytics לאפליקציה שלך
באמצעות 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' }
הכריז על האובייקט
com.google.firebase.analytics.FirebaseAnalytics
בראש הפעילות שלך:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
אתחל אותו בשיטת
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, ועוזרת לך לאמת מיד שאירועים נשלחים.
הצעדים הבאים
- השתמש ב- DebugView כדי לאמת את האירועים שלך.
- חקור את הנתונים שלך במסוף Firebase.
- חקור את המדריכים על אירועים ומאפייני משתמשים.
- למד כיצד לייצא את הנתונים שלך ל- BigQuery.