Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Google Analytics ile başlayın

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

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

  • Olaylar: Uygulamanızda kullanıcı eylemleri, sistem olayları veya hatalar gibi neler oluyor.
  • Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın segmentlerini 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 etkinleştirilmediği mevcut bir Firebase projesini kullanıyorsanız, etkinleştirmek için Entegrasyonlar sekmesine> 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. Firebase Android BoM'yi kullanarak, modülünüzdeki (uygulama düzeyinde) Gradle dosyanızdaki (genellikle app/build.gradle ) Analytics Android kitaplığının bağımlılığını app/build.gradle .

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.6.0')
    
        // Declare 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 kullanmadan Firebase kütüphane bağımlılıklarını beyan

    Firebase BoM'yi kullanmamayı seçerseniz, bağımlılık satırında her bir Firebase kitaplık sürümünü belirtmeniz gerekir.

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

    dependencies {
        // Declare 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:18.0.2'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:26.6.0')
    
        // Declare 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-ktx'
    }
    

    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 kullanmadan Firebase kütüphane bağımlılıklarını beyan

    Firebase BoM'yi kullanmamayı seçerseniz, bağımlılık satırında her bir Firebase kitaplık sürümünü belirtmeniz gerekir.

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

    dependencies {
        // Declare 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-ktx:18.0.2'
    }
    

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate() yönteminde bunu başlatın:

    Java

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

    Kotlin + KTX

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

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

Bir FirebaseAnalytics örneği oluşturduktan sonra, logEvent() yöntemiyle olayları günlüğe logEvent() 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 maksimum kullanılabilir ayrıntı sağlamak ve kullanıma sunulduğunda gelecekteki özelliklerden ve entegrasyonlardan yararlanmak için, önerilen olayları öngörülen parametreleriyle birlikte göndermelisiniz. Bu bölüm, olayları günlüğe kaydetme hakkında daha fazla bilgi için önceden tanımlanmış bir olayın günlüğe kaydedilmesini gösterir, bkz. Olayları günlüğe kaydetme.

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

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

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

Olayların doğru şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olmak için SDK tarafından olayların günlüğe kaydedilmesini izlemek için ayrıntılı günlük kaydını etkinleştirebilirsiniz. Bu, hem otomatik hem de manuel olarak kaydedilen olayları içerir.

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, olayların gönderildiğini hemen doğrulamanıza yardımcı olur.

Sonraki adımlar