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. SDKhashchangeolayları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(/(\?.*)?$/, '');
}
};
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 |