Bu hızlı başlangıç kılavuzunda, Google Analytics hizmetini uygulamanıza nasıl ekleyeceğiniz ve etkinlikleri günlüğe kaydetmeye başlar.
Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK günlüğe iki tür bilgi kaydeder:
- Etkinlikler: Uygulamanızda neler olup bittiği. Örneğin, kullanıcı işlemleri, sistem veya veya hataları anlamına gelir.
- Kullanıcı özellikleri: Kullanıcılarınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum)
Analytics, bazı işlemleri otomatik olarak günlüğe kaydeder events ve kullanıcı özellikleri; bunları etkinleştirmek için kod eklemeniz gerekmez.
Başlamadan önce
Henüz yapmadıysanız Firebase'i JavaScript'inize ekleyin. projenin ve Google Analytics uygulamasının etkinleştirildiğinden emin olun Firebase projenizde:
Yeni bir Firebase projesi oluşturuyorsanız Google Analytics özelliğini etkinleştirin müzakere tekniği de eklediniz.
Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics etkin, şuraya gidin: Entegrasyonlar (
'nı tıklayın. ) > Proje ayarları
Projenizde Google Analytics eklentisini etkinleştirdiğinizde Firebase web uygulamalarınız şununla ilişkili Google Analytics veri akışına bağlı: Uygulama + Web mülkü.
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 ele alınır veya Firebase yapılandırma nesnesi. Web uygulamanız zaten Google Analytics'i kullanıyorsa, Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ayarları uygulayın.
Kodunuzdaki Firebase yapılandırma nesnesinin şunu içerdiğinden emin olun:
measurementId
Bu kimlik, etkinleştirildiğinde otomatik olarak oluşturulur Analytics Firebase projenize gidip bir web uygulaması kaydedin, Analytics kullanımı için gereklidir.Uygulamanız Firebase Hosting ve kullanıyorsa Firebase SDK'ları için ayrılmış URL'ler:
Firebase, uygulamanızın yapılandırmasını otomatik olarak gerçekleştirir. Tamamlamak için Uygulamalarınız kartındaki komut dosyalarını Proje ayarları to <body> Henüz yapmadıysanız uygulamanızın etiketi.
Uygulamanız ayrılmış URL'ler kullanmıyorsa: Mevcut bir web uygulamasıyla çalışıyorsanız Firebase yapılandırmasını güncelleyin nesnenizde
measurementId
alanının bulunduğundan emin olun. İlgili içeriği oluşturmak için kullanılan 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'sını ekleyin ve Analytics uygulamasını 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 Google Analytics'i uygulamanızda gtag.js snippet'i Aşağıdakilerden birini yapmayı planlıyorsanız uygulamanızda ek kurulum gerekebilir:
- Firebase'den sayfaya Google Analytics çağrısı ekleyin, ancak şunu da planlayın:
gtag()
aramasını doğrudan aynı sayfada kullanmaya devam et. - Hem doğrudan
gtag()
çağrılar ve Google Analytics verileri Firebase'e gönderildi.
Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabildiğinden emin olmak için şu ek kurulum adımlarını uygulayın:
gtag('config', 'GA_MEASUREMENT_ID');
satırını kaldır buradaGA_MEASUREMENT_ID
metriğinizinmeasurementId
değeridir Firebase web uygulaması. Diğer Analytics mülkleri için başka kimlikleriniz varsa yapılandırma satırını kaldırmanız gerekmez.- Etkinlik göndermeden önce mutlaka
firebase.analytics()
adlı kişiyi arayıngtag()
ile.
Aksi takdirde, bu kimliğe gtag()
çağrılarıyla gönderilen etkinlikler ilişkilendirilmez
ve diğer platformlarda hedefleme için kullanılamaz.
Firebase hizmetleri.
Etkinlikleri günlüğe kaydetmeye başla
Analytics hizmetinizle
şununla etkinlikleri günlüğe kaydetmeye başlar:
logEvent()
yöntemidir.
Belirli etkinlikler tüm uygulamalar için önerilir; belirli işletme türleri veya sektörler için diğer öneriler önerilir. Göndermeniz gereken belgeler Böylece, önerilen etkinlikleri kendi belirlenen parametreleriyle birlikte kullanarak en yüksek düzeyde kullanılabilir ayrıntılara yer vermek ve gelecekte sunacağınız özelliklerden Google Analytics 360'ta kullanıma sunulur. Bu bölümde, daha fazla bilgi için bkz. Etkinlikleri günlüğe kaydedin.
Aşağıdaki örnekte, kullanıcı, uygulamanızda bir bildirim aldı:
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 inceleyin.
- Etkinlikler ve özelliklerini ekleyin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.