Bu hızlı başlangıç kılavuzu, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe nasıl kaydetmeye başlayacağınızı gösterir.
Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:
- Etkinlikler: Uygulamanızda olup bitenler (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar)
- 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 eklemeniz gerekmez.
Başlamadan önce
Henüz yapmadıysanız Firebase'i JavaScript projenize 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
sayfanızdaki > Proje ayarlarıEntegrasyonlar sekmesine giderek projeyi etkinleştirin.
Projenizde Google Analytics'i etkinleştirdiğinizde Firebase web uygulamalarınız bir Uygulama + Web mülkü ile ilişkilendirilmiş 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 uygulanabilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics'i kullanıyorsa Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ek kurulumları yapmanız gerekebilir.
Kodunuzdaki Firebase yapılandırma nesnesinin
measurementId
içerdiğinden emin olun. Bu kimlik, Firebase projenizde Analytics'i etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak gerekir.Uygulamanız Firebase Hosting'i ve Firebase SDK'ları için ayrılmış URL'ler kullanıyorsa:
Firebase, uygulamanızın yapılandırmasını otomatik olarak gerçekleştirir. Kurulumu tamamlamak için Proje ayarları'ndaki Uygulamalarınız kartındaki komut dosyalarını henüz yapmadıysanız 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 olmalıdır:// 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" };
Henüz yapmadıysanız Firebase JS SDK'yı yükleyin ve Firebase'i başlatın.
Analytics JS SDK'yı ekleyin ve Analytics'i başlatın:
Web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Firebase'i mevcut gtag.js etiketlemesiyle kullanma
Daha önce uygulamanızda Google Analytics'i gtag.js snippet'ini kullanarak çalıştırdıysanız aşağıdakilerden birini yapmayı planlıyorsanız uygulamanızda ek kurulum gerekebilir:
- Sayfaya Firebase'den Google Analytics çağrılarını ekleyin ancak
gtag()
çağrılarını doğrudan aynı sayfada kullanmaya devam etmeyi de planlayın. - Doğrudan
gtag()
çağrıları ve Firebase'e gönderilen Google Analytics verileri arasında aynı ölçüm kimliğini kullanmak istiyorsanız.
Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabildiğinden emin olmak için aşağıdaki ek kurulum adımlarını tamamlayın:
GA_MEASUREMENT_ID
değerinin Firebase web uygulamanızdameasurementId
olduğugtag('config', 'GA_MEASUREMENT_ID');
satırını kaldırın. Sayfadaki başka Analytics mülkleri için başka kimlikleriniz varsa bunların yapılandırma satırını kaldırmanız gerekmez.gtag()
ile etkinlik göndermeden önce mutlakafirebase.analytics()
numaralı telefonu arayın.
Aksi takdirde, bu kimliğe gtag()
çağrılarıyla gönderilen etkinlikler Firebase ile ilişkilendirilmez ve diğer Firebase hizmetlerinde hedefleme için kullanılamaz.
Etkinlikleri günlüğe kaydetmeye başla
Analytics hizmetini başlattıktan sonra logEvent()
yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.
Bazı etkinlikler tüm uygulamalar için önerilir, bazıları ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum sayıda kullanılabilir ayrıntı sağlamak ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri belirlenen parametreleriyle birlikte göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin günlüğe kaydedilmesi gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme bölümüne bakın.
Aşağıdaki örnekte, bir kullanıcının uygulamanızda bildirim aldığını belirtmek için önerilen bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Sonraki adımlar
- Tüm Analytics raporlarını anlayın.
- Etkinliklerinizi doğrulamak için DebugView'ı kullanın.
- Firebase konsolunda verilerinizi keşfedin.
- Etkinlikler ve kullanıcı özellikleri ile ilgili rehberleri keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.