Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri 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 temel bilgi türünü günlüğe kaydeder:
- Olaylar: Kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda olup bitenler.
- 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 öznitelikler.
Analytics, bazı etkinlikleri 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 sekmesine > Proje ayarlarına gidin.
Projenizde Google Analytics'i etkinleştirdiğinizde, Firebase web uygulamalarınız, bir Uygulama + 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 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 bölümünde açıklanan ek ayarları yapmanız gerekebilir.
Kodunuzdaki Firebase yapılandırma nesnesinin
measurementId
içerip içermediğini kontrol edin. Bu kimlik, Firebase projenizde Analytics'i etkinleştirdiğinizde ve bir web uygulamasını kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak için gereklidir.Uygulamanız Firebase Barındırma kullanıyorsa ve Firebase SDK'ları için ayrılmış URL'ler kullanıyorsa :
Firebase, uygulamanızın yapılandırılmasını 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 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. 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" };
Henüz yapmadıysanız, Firebase JS SDK'yı kurun ve Firebase'i başlatın .
Analytics JS SDK'sını ekleyin ve Analytics'i başlatın:
Web modüler API
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 ad alanlı API
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 kullanın
Daha önce uygulamanızda gtag.js snippet'ini kullanarak çalışan Google Analytics varsa, aşağıdakilerden birini yapmayı planlıyorsanız uygulamanız için ek kurulum gerekebilir:
- Firebase'den Google Analytics çağrılarını sayfaya 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 Firebase'e gönderilen Google Analytics verileri arasında aynı ölçüm kimliğini kullanmak istiyorsunuz.
Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabilmesini sağlamak için aşağıdaki ek kurulum adımlarını tamamlayın:
-
gtag('config', ' GA_MEASUREMENT_ID ');
satırını kaldırın. buradaGA_MEASUREMENT_ID
, Firebase web uygulamanızınmeasurementId
kimliğidir. Sayfadaki diğer Analytics mülkleri için başka kimlikleriniz varsa, bunların yapılandırma satırını kaldırmanız gerekmez. -
gtag()
ile herhangi bir olay göndermeden öncefirebase.analytics()
i çağırdığınızdan emin olun.
Aksi takdirde, gtag()
çağrıları ile o kimliğe gönderilen olaylar Firebase ile ilişkilendirilmez ve diğer Firebase hizmetlerinde hedeflenemez.
Olayları günlüğe kaydetmeye başla
Analytics hizmetini 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 kullanılabilir ayrıntı sağlamak ve kullanıma sunuldukça gelecekteki özelliklerden ve entegrasyonlardan yararlanmak için önerilen etkinlikleri belirtilen parametrelerle birlikte göndermelisiniz. Bu bölümde, önceden tanımlanmış bir olayın günlüğe kaydedilmesi gösterilmektedir, olayların günlüğe kaydedilmesi hakkında daha fazla bilgi için 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 etkinliğin nasıl günlüğe kaydedileceğini gösterir:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
Sonraki adımlar
- Olaylarınızı doğrulamak için DebugView'ı kullanın.
- Verilerinizi Firebase konsolunda keşfedin.
- Olaylar ve kullanıcı özellikleriyle ilgili kılavuzları keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin .