Android için Google Analytics'i kullanmaya başlama

Platform seçin: iOS+ Android Web Flutter Unity C++


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

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

  • Etkinlikler: Kullanıcı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğu.
  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özelliklerdir (ö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 özelliğinin etkinleştirildiğinden emin olun:

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

  • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız Ayarlar > Entegrasyonlar sekmesinde etkinleştirebilirsiniz.

Projenizde Google Analytics hizmetini 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üzeyinde) Gradle dosyasında (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) Android için Analytics kitaplığına olan bağımlılığı ekleyin. Kitaplık sürümünü kontrol etmek için Firebase Android BoM kullanmanızı öneririz. 

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

    // 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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.

    (Alternatif)  BoM kullanmadan Firebase kitaplığı bağımlılıklarını ekleme

    Firebase BoM kullanmamayı tercih ederseniz her Firebase kitaplığı sürümünü kendi 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 sayede tüm sürümlerin uyumlu olmasını sağlayabilirsiniz. 

    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:24.0.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

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

    Kotlin 

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

    Java 

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

Etkinlikleri günlüğe kaydetmeye başlama

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

Belirli etkinlikler tüm uygulamalar için önerilir. Diğerleri ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda mümkün olan en ayrıntılı bilgileri edinmek ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri kendi belirlenen parametreleriyle göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme başlıklı makaleyi inceleyin.

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

Kotlin 

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

Etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulamak için SDK tarafından etkinliklerin günlüğe kaydedilmesini izlemek üzere ayrıntılı günlük kaydını etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak günlüğe kaydedilen etkinlikler 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östererek etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Sonraki adımlar