Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe kaydetmeye nasıl başlayacağınızı gösterir.

Google Analytics, uygulamanıza ilişkin kullanım ve davranış verilerini toplar. SDK iki temel bilgi türünü günlüğe kaydeder:

  • Etkinlikler: Kullanıcı eylemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda olup bitenler.
  • Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın bölümlerini tanımlamak için tanımladığınız özellikler.

Analytics, bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder; bunları etkinleştirmek için herhangi bir kod eklemenize gerek yoktur.

Sen başlamadan önce

Henüz yapmadıysanız Android projenize Firebase'i ekleyin ve Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun:

  • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics'i etkinleştirin.

  • Google Analytics'in etkin olmadığı mevcut bir Firebase projesini kullanıyorsanız uygulamanızın Entegrasyonlar sekmesine gidin. etkinleştirmek için > Proje ayarları'na gidin.

Projenizde Google Analytics'i etkinleştirdiğinizde Firebase uygulamalarınız Google Analytics veri akışlarına bağlanır.

Analytics SDK'sını uygulamanıza ekleyin

  1. Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Analytics kitaplığı bağımlılığını ekleyin Android için. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:32.7.4"))
    
        // 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'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

    (Alternatif) BoM'yi kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin

    Firebase BoM'yi kullanmamayı tercih ederseniz her Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.

    Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın.

    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:21.5.1")
    }
    
    Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).

  2. Etkinliğinizin üst kısmında com.google.firebase.analytics.FirebaseAnalytics nesnesini bildirin:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. onCreate() yönteminde başlatın:

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

    Java

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

Olayları günlüğe kaydetmeye başlayın

FirebaseAnalytics örneğini oluşturduktan sonra logEvent() yöntemini kullanarak olayları günlüğe kaydetmeye başlayabilirsiniz.

Tüm uygulamalar için belirli etkinlikler önerilir ; diğerleri belirli iş türleri veya sektörler için önerilir. Raporlarınızda mümkün olan maksimum ayrıntıyı sağlamak ve gelecekte kullanıma sunulacak özelliklerden ve entegrasyonlardan yararlanmak için, önerilen etkinlikleri önceden belirlenmiş parametrelerle birlikte göndermelisiniz. Bu bölümde önceden tanımlanmış bir olayın günlüğe kaydedilmesi gösterilmektedir; olayların günlüğe kaydedilmesi hakkında daha fazla bilgi için bkz . Olayların günlüğe kaydedilmesi .

Aşağıdaki kod, bir kullanıcı uygulamanızdaki belirli bir öğeyi tıkladığında bir SELECT_CONTENT olayını günlüğe kaydeder.

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

Olayların düzgün şekilde günlüğe kaydedildiğinin doğrulanmasına yardımcı olmak amacıyla olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak kaydedilen olaylar dahildir.

Bir dizi adb komutuyla ayrıntılı günlük kaydını etkinleştirebilirsiniz:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Bu komut, etkinliklerinizi Android Studio logcat'ta görüntüleyerek etkinliklerin gönderildiğini anında doğrulamanıza yardımcı olur.

Sonraki adımlar