Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Google Analytics'i kullanmaya 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 temel bilgi türünü günlüğe kaydeder:

  • Olaylar : Kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda neler oluyor.

  • Kullanıcı özellikleri : Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın segmentlerini açıklamak için tanımladığınız nitelikler .

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

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 etkin olmadığı mevcut bir Firebase projesi kullanıyorsanız, etkinleştirmek için Entegrasyonlar > Proje ayarları sekmesine gidin.

Projenizde Google Analytics'i etkinleştirdiğinizde, Firebase web uygulamalarınız, birUygulama + Web mülküyle 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 gerçekleştirilebilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics kullanıyorsa Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ek kurulumu yapmanız gerekebilir.

  1. Kodunuzdaki sizin Firebase yapılandırma nesnesini içerdiğini kontrol edin measurementId . Bu kimlik, Firebase projenizde Analytics'i etkinleştirdiğinizde ve bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak gerekir.

    • 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 gerçekleştirir. 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 saklıdır URL'ler kullanmıyorsa: Mevcut bir web uygulaması ile çalışıyorsanız, emin olmak için kodunda Firebase yapılandırma nesnesi güncelleştirmek measurementId alan mevcuttur. Yapılandırma 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:

Web v8

const analytics = firebase.analytics();

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Firebase'i mevcut gtag.js etiketlemesiyle kullanın

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

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

Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabilir olduğundan emin olmak 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 '); burada GA_MEASUREMENT_ID , GA_MEASUREMENT_ID yapılandırma snippet'inizdeki measurementId GA_MEASUREMENT_ID ile aynıdır. Sayfadaki diğer Analytics mülkleri için başka kimlikleriniz varsa, bunların yapılandırma satırını kaldırmanız gerekmez.

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

Aksi takdirde, o kimliğe gtag() çağrılarıyla gönderilen olaylar gtag() ile ilişkilendirilmez ve diğer Firebase hizmetlerinde hedefleme için kullanılamaz.

Olayları günlüğe kaydetmeye başla

Analytics hizmetini 'firebase.analytics()' ile başlattıktan sonra, 'logEvent()' yöntemiyle olayları 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 ayrıntıyı sağlamak ve kullanıma sunuldukça gelecekteki özelliklerden ve entegrasyonlardan yararlanmak için önerilen etkinlikleri belirtilen parametreleriyle birlikte göndermelisiniz. Bu bölüm, bkz günlüğü olayları hakkında daha fazla bilgi için, önceden tanımlanmış olay günlüğü ortaya koyduğunu giriş etkinlik .

Aşağıdaki örnek, bir kullanıcının uygulamanızda bir bildirim aldığını belirtmek için önerilen bir etkinliğin nasıl günlüğe kaydedileceğini gösterir:

Web v8

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

Web v9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Sonraki adımlar