Web için Google Analytics'i kullanmaya başlama

Platform seçin: iOS+ Android Web Flutter Unity C++


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

Google Analytics, web uygulamanız için kullanım ve davranış verileri toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:

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

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

Analytics bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder. Bunları etkinleştirmek için 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 Ayarlar > Entegrasyonlar sekmesinden etkinleştirebilirsiniz.

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ızda Google Analytics zaten kullanılıyorsa Firebase'i mevcut gtag.js etiketleme ile kullanma başlıklı makalede açıklanan ek kurulum adımlarını uygulamanız gerekebilir.

  1. Kodunuzdaki Firebase yapılandırma nesnenizin measurementId içerdiğini kontrol edin. Bu kimlik, Firebase projenizde Analytics'ı etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'ı kullanmak için gereklidir.

    • Uygulamanız Firebase Hosting 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 Uygulamalarınız kartındaki komut dosyalarını Proje ayarlarınızda uygulamanızın <body> etiketine ekleyin (daha önce yapmadıysanız).

    • Uygulamanızda ayrılmış URL'ler kullanılmıyorsa: Mevcut bir web uygulamasıyla çalışıyorsanız measurementId alanının bulunduğ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: "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"
};
      <0 Henüz yapmadıysanız Firebase JS SDK'sını yükleyin ve Firebase'i başlatın. 2. Analytics JS SDK'sını ekleyin ve Analytics'yı 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ızın ek kurulum gerektirmesi mümkündür:

  • Firebase'den Google Analytics çağrıları sayfaya 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 Firebase'e gönderilen Google Analytics 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. Burada GA_MEASUREMENT_ID, Firebase web uygulamanızın measurementId'sıdır. 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() ile iletişime geçtiğinizden emin olun.

Aksi takdirde, gtag() aramaları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.

Belirli etkinlikler tüm uygulamalar için önerilirken diğerleri belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı elde etmek 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 kaydedileceği gösterilmektedir. Etkinliklerin kaydedilmesi hakkında daha fazla bilgi için Etkinlikleri kaydetme başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, 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');

Web

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

Sonraki adımlar