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, web 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, JavaScript 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 projeniz varsa, Google Analytics'i > Proje ayarlarınızın Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

Projenizde Google Analytics'i etkinleştirdiğinizde, Firebase web uygulamalarınız bir Uygulama + Web mülkü ile ilişkili Google Analytics veri akışlarına bağlanır.

Analytics SDK'sını uygulamanıza ekleyin

Web uygulamanızın nasıl barındırıldığına bağlı olarak, yapılandırmanız otomatik olarak işlenebilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics kullanıyorsa, Firebase'i mevcut gtag.js etiketlemesiyle kullanma konusunda açıklanan ek kurulumlar yapmanız gerekebilir.

  1. Kodunuzdaki Firebase yapılandırma nesnenizin measurementId içerip içermediğini kontrol edin. Bu kimlik, Firebase projenizde Analytics'i etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak için gereklidir.

    • Uygulamanızın Barındırma Firebase kullanır ve varsa kullandığı URL'ler saklıdır Firebase SDK'lara:

      Firebase, uygulamanızı yapılandırmayı otomatik olarak halleder. Kurulumu tamamlamak için, henüz yapmadıysanız, Proje ayarlarınızdaki Uygulamalarınız kartındaki komut dosyalarını uygulamanızın <body> etiketine ekleyin.

    • Uygulamanız ayrılmış URL'ler kullanmıyorsa : Mevcut bir web uygulamasıyla çalışıyorsanız , measurementId alanının mevcut olduğundan emin olmak için kodunuzdaki Firebase yapılandırma nesnesini güncelleyin. Config nesnesi aşağıdaki örneğe benzer görünmelidir:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
      const firebaseConfig = {
        apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc",
        authDomain: "project-id.firebaseapp.com",
        databaseURL: "https://project-id.firebaseio.com",
        projectId: "project-id",
        storageBucket: "project-id.appspot.com",
        messagingSenderId: "637908496727",
        appId: "2:637908496727:web:a4284b4c99e329d5",
        measurementId: "G-9VP01NDSXJ"
      };
      
  2. Firebase Analytics'i başlatın:

     firebase.analytics();
    

Firebase'i mevcut gtag.js etiketlemesiyle kullanın

Daha önce uygulamanızda gtag.js snippet'ini kullanarak Google Analytics çalıştırdıysanız, aşağıdakilerden birini yapmayı planlıyorsanız uygulamanız ek kurulum gerektirebilir:

  • gtag() Google Analytics çağrılarını sayfaya ekleyin, ancak aynı zamanda gtag() çağrılarını doğrudan aynı sayfada kullanmaya devam gtag() .
  • Hem doğrudan gtag() çağrıları hem de gtag() gönderilen Google Analytics verileri arasında aynı ölçüm kimliğini kullanmak istiyorsanız.

Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabilmesini sağlamak için aşağıdaki ek kurulum adımlarını tamamlayın:

  • [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) kaldırın. Gtag snippet'iniz şuna benzer olmalıdır:

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • gtag('config', ' GA_MEASUREMENT_ID '); satırını gtag('config', ' GA_MEASUREMENT_ID '); GA_MEASUREMENT_ID , GA_MEASUREMENT_ID yapılandırma snippet'inizdeki measurementId GA_MEASUREMENT_ID ile aynıdır. Sayfada diğer Analytics mülkleri için başka kimlikleriniz varsa, bunların yapılandırma satırını kaldırmanıza gerek yoktur.

  • Emin aramak olun firebase.analytics() ile herhangi etkinlikleri göndermek önce gtag() .

Aksi takdirde, gtag() çağrılarıyla bu kimliğe gönderilen etkinlikler gtag() ile ilişkilendirilmeyecek ve diğer Firebase hizmetlerinde hedefleme için kullanılamayacaktır.

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

Analytics hizmetini 'firebase.analytics ()' ile başlattıktan sonra, olayları 'logEvent ()' yöntemiyle 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 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 örnek, bir kullanıcının uygulamanızda bir bildirim aldığını belirtmek için önerilen bir olayın nasıl günlüğe kaydedileceğini gösterir:

firebase.analytics().logEvent('notification_received');

Sonraki adımlar