Google Analytics'i kullanmaya başlama


Bu hızlı başlangıç kılavuzunda, uygulamanıza Google Analytics nasıl ekleyeceğiniz ve etkinlikleri nasıl günlüğe kaydetmeye başlayacağınız gösterilmektedir.

Google Analytics, web uygulamanızla ilgili kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü kaydeder:

  • Etkinlikler: Uygulamanızda neler olduğu (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).

  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özellikler (ör. dil tercihi veya coğrafi konum).

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 etkinleştirin.

  • Google Analytics'in etkinleştirilmediği mevcut bir Firebase projesi kullanıyorsanız etkinleştirmek için > Proje ayarları bölümünün Entegrasyonlar sekmesine 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.

Uygulamanıza Analytics SDK'sını 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 etiketleme ile kullanma bölümünde açıklanan ek kurulumu yapmanız gerekebilir.

  1. Kodunuzdaki Firebase yapılandırma nesnesinin measurementId içerdiğinden emin olun. Bu kimlik, Firebase projenizde Analytics özelliğini etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics özelliğini kullanmak için gereklidir.

    • Uygulamanız Firebase Hosting 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 Uygulamalarınız kartındaki komut dosyalarını Proje ayarları bölümünde uygulamanızın <body> etiketine ekleyin (henüz yapmadıysanız).

    • Uygulamanızda ayrılmış URL'ler kullanılmıyorsa: Mevcut bir web uygulamasıyla çalışıyorsanız, kodunuzdaki Firebase yapılandırma nesnesini güncelleyerek measurementId alanının mevcut olduğundan emin olun. Yapılandırma nesnesi aşağıdaki örneğe benzer şekilde görünmelidir:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};

  2. Henüz yapmadıysanız Firebase JS SDK'yı yükleyin ve Firebase'i başlatın.

  3. Analytics JS SDK'sını ekleyin ve Analytics 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();

Mevcut gtag.js etiketlemeyle Firebase'i kullanma

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

  • Firebase'den Google Analytics çağrıları ekleyin ancak aynı sayfada doğrudan gtag() çağrılarını kullanmaya devam etmeyi planlayın.
  • Hem doğrudan gtag() çağrılar hem de Google Analytics Firebase'e gönderilen veriler arasında aynı ölçüm kimliğini kullanmak istiyorsanız.

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. Bu satırda GA_MEASUREMENT_ID, Firebase web uygulamanızın measurementId değeridir. Sayfada diğer Analytics mülkleri için başka kimlikleriniz varsa bu kimliklerin yapılandırma satırını kaldırmanız gerekmez.
  • gtag() ile etkinlik göndermeden önce firebase.analytics() işlevini çağırdığınızdan emin olun.

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

Etkinlikleri günlüğe kaydetmeye başlama

Analytics hizmetini başlattıktan sonra logEvent() yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.

Bazı etkinlikler tüm uygulamalar için önerilirken bazıları belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı sağlamak ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için önerilen etkinlikleri kendi belirlenen parametreleriyle göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir. Etkinliklerin günlüğe kaydedilmesi hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, bir kullanıcının uygulamanızda bildirim aldığını belirtmek için önerilen bir etkinliğin nasıl kaydedileceği gösterilmektedir:

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web

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

Sonraki adımlar