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

אזהרה: התכונה 'Google Play ללא התקנה' לא תהיה זמינה יותר. החל מדצמבר 2025, לא תהיה אפשרות לפרסם אפליקציות ללא התקנה דרך Google Play, וכל ממשקי Instant API של Google Play Services יפסיקו לפעול. המשתמשים לא יקבלו יותר אפליקציות מיידיות מ-Play באמצעות מנגנון כלשהו.

אנחנו מבצעים את השינוי הזה על סמך משוב שקיבלנו ממפתחים וההשקעות המתמשכות שלנו בשיפור הסביבה העסקית מאז השקת Google Play ללא התקנה.

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

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

אם פתרון הניתוח הנוכחי שלכם לא מופיע ברשימה או אם הוא לא פועל עם Google Play Instant, כדאי להשתמש ב-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 של כל מודול:

    Groovy

    // 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 לאפליקציה המיידית ועם הערך installed לאפליקציה המותקנת.

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

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

Kotlin

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)
    }
}

Java

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.

שם הערך ב-Analytics הגדרה
ביקורים אצל מומחים רפואיים session_start הסשן התחיל. המערכת עוקבת אחרי האירוע הזה באופן אוטומטי.
רכישות של מוצרים פיזיים Firebase.Event.ECOMMERCE_PURCHASE קניות פיזיות. צריך לעקוב אחרי האירוע הזה באופן מפורש בקוד.
רכישות דיגיטליות in_app_purchase רכישות דיגיטליות מתוך האפליקציות. המערכת עוקבת אחרי האירוע הזה באופן אוטומטי.
משך הזמן באפליקציה user_engagement משך הזמן שהאפליקציה פועלת בחזית. המערכת עוקבת אחרי האירוע הזה באופן אוטומטי.
הקשר של אפליקציה ללא התקנה app_type אירועים שמופעלים מהאפליקציה שפועלת בהקשר של אפליקציה מיידית או אפליקציה מותקנת. צריך לעקוב אחרי האירוע הזה באופן מפורש בקוד. מידע נוסף זמין בקטע ההבדלים בין נתונים של אפליקציות מותקנות לבין נתונים של אפליקציות מיידיות שלמעלה.
מבקרים חוזרים session_start.count וגם app_type קהל של משתמשים שמבקרים באתר פעמיים או יותר. אתם צריכים לעקוב באופן מפורש אחרי האירוע app_type; session_start מתבצע מעקב אוטומטי. מידע נוסף זמין בקטע ההבדלים בין נתונים של אפליקציות מותקנות לבין נתונים של אפליקציות מיידיות שלמעלה.

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