Tüm Ürünler
Search
Belge Merkezi

Application Real-Time Monitoring Service:Report page data from single-page applications

Son Güncelleme:Oct 05, 2026

Tek sayfa uygulamasında (SPA) sayfa yalnızca bir kez yüklenir; bu nedenle Browser Monitoring SDK, sayfa görüntüleme (PV) verilerini sadece ilk yükleme sırasında bildirir. SPA içindeki rota değişiklikleri ek PV raporlarını tetiklemez. Sonuç olarak alt sayfa görünümleri ve diğer türdeki günlükler rota bazında izlenmez.

Application Real-Time Monitoring Service (ARMS) Browser Monitoring SDK, her rota değişikliğinde PV verilerini bildirmek için iki yöntem sunar:

Yöntem Yönlendirme türü Kurulum
Otomatik raporlama Hash tabanlı (#/path) Bir yapılandırma bayrağı ayarlayın
Manuel raporlama Herhangi biri (hash, history veya özel) Her rota değişikliğinde setPage() çağrısı yapın

Otomatik SPA raporlamayı etkinleştirin

Bu yöntem, URL hash'ini ( # ) rota tanımlayıcısı olarak kullanan çoğu SPA ile uyumludur. SDK hashchange olaylarını dinler ve hash her değiştiğinde PV verilerini bildirir. SDK diğer verileri raporlarken hash değeri sayfa tanımlayıcısı olarak da kullanılır.

SDK yapılandırmasında enableSPA değerini true olarak ayarlayın:

const config = {
  pid: '<your-pid>',
  enableSPA: true
};

Sayfa adı çıkarmayı özelleştirin

Varsayılan olarak SDK ham URL hash'ini sayfa adı olarak kullanır. Hash'ten özel bir sayfa adı çıkarmak için enableSPA ile birlikte parseHash kullanın. parseHash işlevi tam hash dizesini alır ve bildirmek istediğiniz sayfa adını döndürür.

const config = {
  pid: '<your-pid>',
  enableSPA: true,
  parseHash: function (hash) {
    // Example: extract the path from '#/user/profile?tab=info'
    // and return '/user/profile'
    return hash.replace(/(\?.*)?$/, '');
  }
};

Tüm parametre referansı için bkz. enableSPA ve parseHash.

Sayfa verilerini manuel olarak raporlayın

Bu yöntem, history tabanlı ve özel yönlendirme dahil olmak üzere herhangi bir yönlendirme stratejisiyle çalışır. Otomatik hash tabanlı raporlama yönlendirme kurulumunuzla eşleşmediğinde bu yöntemi kullanın.

Rota değişikliği olduğunda sayfa adını güncellemek için setPage() çağrısı yapın. Varsayılan olarak her çağrı yeni bir PV raporu tetikler.

// Listen for route changes and report the new page name
app.on('routeChange', function (next) {
  __bl.setPage(next.name);
});

Olay dinleyicisini yönlendiricinize uygun şekilde uyarlayın. Örneğin React Router, Vue Router veya Angular Router tarafından sağlanan rota değiştirme geri arama işlevine bağlanın ve yeni sayfa adıyla __bl.setPage() çağrısı yapın.

Çerçeve entegrasyon örnekleri

Aşağıdaki örnekler yaygın SPA yönlendiricileriyle setPage() çağrısının nasıl yapılacağını gösterir.

React Router (v5 ve sonrası)

import { useEffect } from 'react';
import { useLocation } from 'react-router-dom';

function PageTracker() {
  const location = useLocation();

  useEffect(() => {
    // Report the pathname as the page name on each route change
    __bl.setPage(location.pathname);
  }, [location.pathname]);

  return null;
}

// Add <PageTracker /> inside your <Router> component

Vue Router

router.afterEach((to) => {
  __bl.setPage(to.path);
});

Tam setPage() API'si için bkz. setPage().

Bir raporlama yöntemi seçin

Kriter **Otomatik (enableSPA)** **Manuel (setPage())**
Yönlendirme türü Hash tabanlı (#/path) Herhangi biri (hash, history veya özel)
Kurulum çabası Bir yapılandırma bayrağı Her rota değişikliği için olay dinleyicisi
Sayfa adı kontrolü URL hash'inden türetilir (parseHash ile özelleştirilebilir) Tamamen özelleştirilebilir
En uygun olduğu durum Standart hash yönlendirme History API yönlendirme, özel sayfa adları veya iç içe yönlendirme