Bu hızlı başlangıç kılavuzunda, Google Analytics'i 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 temel bilgi türü 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ı verileri 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. Google Analytics'in etkinleştirildiğinden emin olun. Firebase projenizde:
Yeni bir Firebase projesi oluşturuyorsanız Google Analytics'i etkinleştirin müzakere tekniği de eklediniz.
Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics'i etkinleştirdiyseniz, Entegrasyonlar sekmenizin
'nı tıklayın. > Proje ayarları
Projenizde Google Analytics'i etkinleştirdiğinizde Firebase web uygulamalarınız bir 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 Firebase projenize girip bir web uygulaması kaydedin. Analytics'i kullanmak için gerekli.Uygulamanız Firebase Hosting'i ve 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'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 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ılarını da ekleyin
gtag()
aramalarını doğrudan aynı sayfada kullanmaya devam et. - Hem doğrudan
gtag()
çağrılar ve Google Analytics verileri Firebase'e gönderilir.
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 keşfedin.
- Etkinlikler ve özelliklerini ekleyin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.