Google Analytics'i kullanmaya başlama


Bu hızlı başlangıç kılavuzunda, Google Analytics hizmetini uygulamanıza nasıl ekleyeceğiniz ve etkinlikleri günlüğe kaydetmeye başlar.

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

  • Etkinlikler: Uygulamanızda neler olup bittiği. Örneğin, kullanıcı işlemleri, sistem veya veya hataları anlamına gelir.
  • Kullanıcı özellikleri: Kullanıcılarınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum)

Analytics, bazı işlemleri otomatik olarak günlüğe kaydeder events ve kullanıcı özellikleri; bunları etkinleştirmek için kod eklemeniz gerekmez.

Başlamadan önce

Henüz yapmadıysanız Firebase'i Android cihazınıza ekleyin projesi ve Google Analytics Firebase projenizde etkinleştirin:

  • Yeni bir Firebase projesi oluşturuyorsanız Google Analytics özelliğini etkinleştirin müzakere tekniği de eklediniz.

  • Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics etkin, şuraya gidin: Entegrasyonlar () > Proje ayarları'nı tıklayın.

Projenizde Google Analytics hizmetini etkinleştirdiğinizde Firebase uygulamalarınız: Google Analytics veri akışına bağlı.

Analytics SDK'sını uygulamanıza ekleyin

  1. Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), Android için Analytics kitaplığına bağımlılığı ekleyin. Şunu kullanmanızı öneririz: Firebase Android BoM Kitaplık'ta sürüm oluşturmayı kontrol etmek için

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:33.2.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 her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanacaktır.

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

    Firebase BoM kullanmamayı seçerseniz her Firebase kitaplığı sürümünü belirtmeniz gerekir değerini alır.

    Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız, kitaplık sürümlerini yönetmek için BoM kullanmanızı öneririz. Bu, tüm sürümlerin uyumlu olduğundan emin olun.

    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.0")
    }
    
    .
    'nı inceleyin. Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Başlamak için kalan süre: Ekim 2023 (Firebase BoM 32.5.0), hem Kotlin hem de Java geliştiricileri (ayrıntılar için bkz. Bu girişimle ilgili SSS).

  2. com.google.firebase.analytics.FirebaseAnalytics nesnesini şurada tanımlayın: en önemlisi:

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

Etkinlikleri günlüğe kaydetmeye başla

Bir FirebaseAnalytics örneği oluşturduktan sonra, etkinlikleri logEvent() yöntemiyle gerçekleştirebilirsiniz.

Belirli etkinlikler tüm uygulamalar için önerilir; belirli işletme türleri veya sektörler için diğer öneriler önerilir. Göndermeniz gereken belgeler Böylece, önerilen etkinlikleri kendi belirlenen parametreleriyle birlikte kullanarak en yüksek düzeyde kullanılabilir ayrıntılara yer vermek ve gelecekte sunacağınız özelliklerden Google Analytics 360'ta kullanıma sunulur. Bu bölümde, daha fazla bilgi için bkz. Etkinlikleri günlüğe kaydedin.

Aşağıdaki kod, aşağıdaki durumlarda bir SELECT_CONTENT etkinliği kaydeder: Kullanıcı, uygulamanızdaki belirli bir öğeyi tıkladığında.

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

SDK tarafından etkinliklerin günlüğe kaydedilmesine yardımcı olmak amacıyla ayrıntılı günlük kaydını etkinleştirebilirsiniz. etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulayın. Bu, hem otomatik hem de ve manuel olarak günlüğe kaydedilen etkinlikler.

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örüntüleyerek etkinliklerin gönderildiğini hemen doğrular.

Sonraki adımlar