Google Analytics'i kullanmaya başlama


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

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

  • Etkinlikler: Uygulamanızda neler olduğu (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).
  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum).

Analytics bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder. Bunları etkinleştirmek için herhangi bir kod eklemeniz gerekmez.

Başlamadan önce

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

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

  • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız Google Analytics'ü etkinleştirmek için > Proje ayarları bölümündeki Entegrasyonlar sekmesine gidin.

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

Analytics SDK'sını uygulamanıza ekleme

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

    // 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 kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

    (Alternatif) BoM

    Firebase BoM kullanmamayı seçerseniz her Firebase kitaplık 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 BoM'ı kullanmanızı önemle tavsiye ederiz. Bu, tüm sürümlerin uyumlu olmasını sağlar. 

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

  2. İşleminizin en başında com.google.firebase.analytics.FirebaseAnalytics nesnesini tanımlayın:

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. onCreate() yönteminde başlatın:

    Kotlin+KTX 

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

    Java 

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

Etkinlikleri günlüğe kaydetmeye başlama

Bir FirebaseAnalytics örneği oluşturduktan sonra logEvent() yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.

Bazı etkinlikler tüm uygulamalar için önerilir, bazıları ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı elde etmek ve kullanıma sunulan özellikler ile entegrasyonlardan yararlanmak için önerilen etkinlikleri kendi belirlenen parametreleriyle göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin günlüğe kaydedilmesi gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Günlük etkinlikleri başlıklı makaleyi inceleyin.

Aşağıdaki kod, bir kullanıcı uygulamanızdaki belirli bir öğeyi tıkladığında bir SELECT_CONTENT etkinliği 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")
}
MainActivity.kt

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);
MainActivity.java

Etkinliklerin SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlük kaydını etkinleştirerek etkinliklerin doğru şekilde günlüğe kaydedildiğini doğrulayabilirsiniz. Hem otomatik olarak hem de manuel olarak kaydedilen etkinlikler buna dahildir.

Ayrıntılı günlük kaydını bir dizi adb komutuyla 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'te gösterir ve etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Sonraki adımlar