Hazır uygulamanıza Firebase için Google Analytics'i ekleme

Hazır veya yüklü bir uygulamanın başarısını izlemek her geliştirici için önemlidir. Fabric Reviews, Localytics ve Mixpanel de dahil olmak üzere çeşitli analiz kitaplıkları Google Play Instant ile uyumludur.

Mevcut analiz çözümünüz listede yoksa veya Google Play Instant ile çalışmıyorsa telemetri çözümünüz olarak Firebase için Google Analytics'i kullanabilirsiniz. Bu sayfada, hazır uygulama projesinde Firebase için Google Analytics'in nasıl ayarlanacağı açıklanmaktadır.

Hazır uygulama projesine Firebase için Google Analytics'i ekleme

  1. Firebase için Google Analytics başlangıç kılavuzunda açıklanan talimatları uygulayarak Firebase SDK'sını uygulamanıza ekleyin.
  2. Google-services eklentisinin en son sürümünü kullanın.
  3. google-services.json dosyasını her bir modüle yerleştirin.

  4. Her bir modülün build.gradle dosyasına aşağıdaki satırı ekleyin:

    Modern

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

    Kotlin

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

Hazır uygulama projenize Firebase için Google Analytics'i ekledikten sonra, yüklenebilir bir uygulama projesinde olduğu gibi Firebase için Google Analytics API'lerini kullanabilirsiniz.

Firebase için Google Analytics API'lerini kullanma hakkında daha fazla bilgi edinmek istiyorsanız Firebase için Google Analytics başlangıç belgelerini inceleyin.

Yüklü ve hazır uygulama verileri arasındaki farklar

Hem yüklü uygulamanız hem de hazır uygulamanız aynı paket adını paylaştığından etkinlikleri ve her birinden toplanan verileri ayırt etmek isteyebilirsiniz. Hazır ve yüklü uygulamalarınızı Analytics'te ayırt etmek isterseniz hazır uygulama için "instant", yüklü uygulama içinse "installed" (yüklü) değerine sahip bir app_type kullanıcı özelliği ayarlayın.

Aşağıdaki kod snippet'i, bir Analytics örneği alan ve ardından kullanıcı özelliği ayarlayan bir etkinliği göstermektedir. Kodun, uygulama bağlamını belirlemek için onCreate(android.os.Bundle) yönteminde PackageManagerCompat.isInstantApp() kullandığına dikkat edin.

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 kullanıcı özelliğini ayarladıktan sonra Analytics konsolunun Etkinlikler sekmesinde bir etkinlik seçebilir ve bu etkinliği app_type değerine göre filtreleyebilirsiniz. Ortaya çıkan veri projeksiyonu, hazır veya yüklü uygulamanızda belirtilen etkinlik için bir sayı verir.

Firebase için Google Analytics'te etkinlikleri günlüğe kaydetme ve görüntüleme hakkında daha fazla bilgi edinmek için Etkinlikleri Günlüğe Kaydetme bölümüne bakın.

Analytics etkinliklerini yorumlama

Analytics, hazır uygulamalar için değerli olan çeşitli metrikleri izlemenize olanak tanır. Aşağıdaki tabloda, Analytics'teki ilgili etkinlik adı veya mülk de dahil olmak üzere hazır uygulamanızla alakalı metrikler açıklanmaktadır.

Ad Analytics değeri Tanım
Ziyaret Sayısı session_start Oturum başlatıldı. Bu etkinlik otomatik olarak izlenir.
Fiziksel satın alma işlemleri Firebase.Event.ECOMMERCE_PURCHASE Fiziksel satın alma işlemleri. Bu etkinliği kodunuzda açıkça izlemelisiniz.
Dijital satın alma işlemleri in_app_purchase Dijital uygulama içi satın alma işlemleri Bu etkinlik otomatik olarak izlenir.
Uygulamada geçirilen süre user_engagement Uygulamanın ön planda harcadığı süre. Bu etkinlik otomatik olarak izlenir.
Hazır uygulama bağlamı app_type Anında veya yüklü bağlamda çalışan uygulamadan oluşturulan etkinlikler. Bu etkinliği kodunuzda açıkça izlemelisiniz. Yukarıdaki Yüklü ve hazır uygulama verileri arasındaki farkları inceleyin.
Geri gelen ziyaretçiler session_start.count ve app_type İki veya daha fazla kez ziyaret eden kullanıcı kitlesi. app_type etkinliğini açıkça takip etmeniz gerekir; session_start sizin için takip edilir. Yukarıdaki Yüklü ve hazır uygulama verileri arasındaki farkları inceleyin.

Analytics'te toplayabileceğiniz etkinliklerin sabit değerleri hakkında daha fazla bilgi için FirebaseAnalytics.Event bölümüne bakın.