הוספה של Google Analytics for Firebase לאפליקציה ללא התקנה

חשוב לעקוב אחר ההצלחה של אפליקציות, מיידיות או מותקנות, למפתחים. יש ספריות ניתוח נתונים שתואמות לחלק Google Play ללא התקנה, כולל תשובות טקסט, Localytics, ו-Mixpanel.

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

הוספה של Google Analytics for Firebase לפרויקט של אפליקציה ללא התקנה

1. מוסיפים את Firebase SDK לאפליקציה לפי ההוראות. שמתוארים מדריך לתחילת העבודה ב-Google Analytics for Firebase.
2. עליכם להשתמש בגרסה האחרונה של הפלאגין google-services.
3. מציבים את הקובץ google-services.json בכל אחד מהמודולים.

4. מוסיפים את השורה הבאה לקובץ build.gradle של כל מודול:

   מגניב

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }
   

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }
   

אחרי שמוסיפים את Google Analytics for Firebase לפרויקט האפליקציה ללא התקנה, אפשר משתמשים בממשקי ה-API של Google Analytics for Firebase כמו בפרויקט של אפליקציה להתקנה.

למידע נוסף על השימוש בממשקי ה-API של Google Analytics for Firebase: ה מסמכי תיעוד לתחילת העבודה ב-Google Analytics for Firebase.

הבחנה בין נתונים של אפליקציות מותקנות לנתוני אפליקציות ללא התקנה

גם לאפליקציה ללא התקנה וגם לאפליקציה ללא התקנה יש שם חבילה, לכן ייתכן שיהיה צורך להבדיל בין האירועים והנתונים שנאספים מכל אחד מהם. שפת תרגום להבדיל בין האפליקציות ללא התקנה לבין האפליקציות המותקנות ב-Analytics, מאפיין משתמש app_type עם הערך instant לאפליקציה ללא התקנה 'מותקן' של האפליקציה המותקנת.

בקטע הקוד הבא מוצגת פעילות שמקבלת מופע ב-Analytics ואז מגדיר מאפיין משתמש. שימו לב הקוד משתמש PackageManagerCompat.isInstantApp() בonCreate(android.os.Bundle) כדי לקבוע את ההקשר של האפליקציה.

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

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

לקבלת מידע נוסף על רישום של אירועים וצפייה בהם ב-Google Analytics for Firebase, ראו רישום אירועים.

פירוש של אירועים ב-Analytics

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

לקבלת מידע נוסף על הקבועים של אירועים שאפשר לאסוף בהם ל-Analytics, FirebaseAnalytics.Event.