במדריך למתחילים הזה נסביר איך מוסיפים את Google Analytics לאפליקציה ומתחילים לתעד אירועים.
Google Analytics אוסף נתוני שימוש והתנהגות של האפליקציה. ביומן של ה-SDK מתועדים שני סוגים עיקריים של מידע:
- אירועים: מה קורה באפליקציה שלכם, כמו פעולות של משתמשים, אירועי מערכת או שגיאות.
- מאפייני משתמשים: מאפיינים שאתם מגדירים כדי לתאר פלחים של בסיס המשתמשים שלכם, כמו העדפות שפה או מיקום גיאוגרפי.
Analytics מתעד באופן אוטומטי חלק מהאירועים ומאפייני המשתמשים. אין צורך להוסיף קוד כדי להפעיל אותם.
לפני שמתחילים
אם עדיין לא עשיתם זאת, עליכם להוסיף את Firebase לפרויקט Android ולוודא שהשדה Google Analytics מופעל בפרויקט Firebase:
אם אתם יוצרים פרויקט חדש ב-Firebase, צריך להפעיל את Google Analytics במהלך תהליך יצירת הפרויקט.
אם אתם משתמשים בפרויקט קיים ב-Firebase שלא מופעל בו Google Analytics, תוכלו להפעיל אותו בכרטיסייה Integrations בקטע
. > Project settings
כשמפעילים את Google Analytics בפרויקט, האפליקציות ב-Firebase מקושרות למקורות נתונים של Google Analytics.
הוספת ה-SDK של Analytics לאפליקציה
בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
<project>/<app-module>/build.gradle.kts
או<project>/<app-module>/build.gradle
), מוסיפים את התלות בספרייה Analytics ל-Android. מומלץ להשתמש ב-Firebase Android BoM כדי לשלוט בגרסאות הספרייה.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add 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 { // Add 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:22.1.2") }
מגדירים את האובייקט
com.google.firebase.analytics.FirebaseAnalytics
בחלק העליון של הפעילות:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
מאתחלים אותו בשיטה
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
התחלת הרישום של אירועים ביומן
אחרי שיוצרים מכונה FirebaseAnalytics
, אפשר להתחיל לתעד אירועים באמצעות השיטה logEvent()
.
יש אירועים שמומלצים לכל האפליקציות. יש אירועים מסוימים שמומלצים לקטגוריות או לסוגים ספציפיים של עסקים. כדי שבדוחות יוצגו כמה שיותר פרטים וכדי ולהפיק תועלת מהתכונות ומהשילובים שיהיו זמינים בעתיד, כדאי לשלוח את האירועים המוצעים עם הפרמטרים שלהם שהוגדרו מראש. בקטע הזה נסביר איך רושמים ביומן אירוע שהוגדר מראש. מידע נוסף על רישום אירועים ביומן זמין במאמר רישום אירועים ביומן.
הקוד הבא מתעד אירוע SELECT_CONTENT
כשמשתמש לוחץ על רכיב ספציפי באפליקציה.
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") }
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);
אתם יכולים להפעיל רישום מפורט ביומן כדי לעקוב אחרי רישום האירועים על ידי ה-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
הפקודה הזו מציגה את האירועים ב-logcat של Android Studio, ומאפשרת לוודא באופן מיידי שהאירועים נשלחים.
השלבים הבאים
- הסבר על כל דוח ב-Analytics
- משתמשים ב-DebugView כדי לאמת את האירועים.
- בודקים את הנתונים במסוף Firebase.
- מומלץ לעיין במדריכים בנושא אירועים ומאפייני משתמשים.
- כך מייצאים את הנתונים ל-BigQuery.