Bu kılavuzda, geleneksel tam sayfa yüklemeleri olmadan içeriği dinamik olarak yüklenen sitelerdeki sayfa etkinliğini ölçmek için analytics.js'nin nasıl kullanılacağı açıklanmaktadır.
Genel bakış
Tek Sayfalık Uygulama (SPA), sitedeki ilk sayfa yüklemesinde gezinmek için gereken tüm kaynakları yükleyen bir web uygulaması veya web sitesidir. Kullanıcı bağlantıları tıklayıp sayfayla etkileşime girdikçe, sonraki içerik dinamik olarak yüklenir. Uygulama genellikle adres çubuğundaki URL'yi geleneksel sayfa gezinmesine öykünecek şekilde günceller, ancak hiçbir zaman başka bir tam sayfa isteği yapılmaz.
Kullanıcılar yeni bir sayfa yüklediğinde snippet kodu çalıştırıldığından, varsayılan Google Analytics etiketi geleneksel web sitelerinde iyi performans gösterir. Ancak, sitenin yeni sayfa içeriğini tam sayfa yüklenirken değil dinamik olarak yüklediği tek sayfalık uygulamalarda analytics.js snippet kodu yalnızca bir kez çalışır. Bu, yeni içerik yüklenirken sonraki (sanal) sayfa görüntülemelerin manuel olarak yakalanması gerektiği anlamına gelir.
Sanal sayfa görüntülemelerini izleme
Uygulamanız içeriği dinamik olarak yüklediğinde ve adres çubuğundaki URL'yi güncellediğinde, izleyicinizde depolanan veriler de güncellenir.
İzleyiciyi güncellemek için set komutunu kullanın ve yeni page değerini sağlayın:
ga('set', 'page', '/new-page.html');
Yeni sayfa değerini ayarladıktan sonra, gönderilen sonraki tüm isabetler bu yeni değeri kullanır. Bir sayfa görüntüleme kaydetmek için izleyiciyi güncelledikten hemen sonra bir sayfa görüntüleme isabeti gönderin.
ga('set', 'page', '/new-page.html');
ga('send', 'pageview');
Sayfa görüntüleme isabetleri için send komutu teknik olarak üçüncü parametre olarak isteğe bağlı page alanını kabul eder. Ancak tek sayfalık uygulamaları ölçerken page alanının bu şekilde geçirilmesi önerilmez. Bunun nedeni, send komutu aracılığıyla iletilen alanların izleyicide ayarlanmamasıdır. Bu alanlar yalnızca mevcut isabete uygulanır. İzleyiciyi güncellememek, uygulamanız sayfa görüntüleme olmayan isabetler (ör.etkinlikler veya sosyal etkileşimler) gönderirse sorunlara yol açar. Bunun nedeni, bu isabetlerin izleyicinin oluşturulduğu sırada sahip olduğu page değeriyle ilişkilendirilir.
Aynı kaynak için birden fazla URL'yi işleme
Bazı SPA'lar, içeriği dinamik olarak yüklerken yalnızca URL'nin karma kısmını günceller. Bu uygulama, birçok farklı sayfa yolunun aynı kaynağı işaret etmesine yol açabilir. Bu gibi durumlarda genellikle en iyi yöntem standart URL seçmek ve Google Analytics'e sadece page değerini göndermektir.
Örneğin, "Hakkımızda" sayfasına aşağıdaki URL'lerden herhangi biri aracılığıyla ulaşılabilen bir web sitesi düşünün:
/about.html/#about.html/home.html#about.html
Raporlarınızda tekrarlardan kaçınmak için en iyisi, bu sayfa görüntülemelerin tümünü /about.html olarak kaydetmektir.
Dikkat edilmesi gerekenler
Doküman yönlendireni güncelleme
create komutunu kullanarak bir izleyici nesnesi oluşturduğunuzda document.referrer değeri, izleyicinin referrer alanında depolanır. Tam sayfa yüklemelerini kullanmayan tek sayfalık uygulama bağlamında referrer alanı her zaman aynı kalır.
Yine de, sayfa görüntüleme isabetlerini göndermeden önce yönlendiren alanının manuel olarak güncellenmesine gerek yoktur. Google Analytics, doğru gezinme yolunu otomatik olarak belirleyebilir.
Dokümanın konumunu güncelleme
İzleyicinin referrer alanı için document.referrer etiketini kullanması gibi location alanı için document.location değerini kullanır. Bu alan, kampanya verilerini veya diğer meta verileri URL'nin sonuna eklenen sorgu parametreleri biçiminde içerebilir.
Google Analytics'in kontrol ettiği kampanya alanlarından veya diğer meta verilerden herhangi birini güncellemek, geçerli oturumun sona ermesine ve yeni bir oturumun başlamasına neden olabilir. Bu sorunu önlemek için, tek sayfalık bir uygulamada sanal sayfa görüntülemelerini ölçerken location alanını güncellemeyin. Bunun yerine page alanını kullanın.
Yeni takip cihazları oluşturma
JavaScript izleme snippet'inin geleneksel web siteleri için yaptığını taklit etmek için tek sayfalık bir uygulamada yeni izleyiciler oluşturmayın. Bunu yapmak, yukarıda açıklandığı gibi yanlış kampanya verilerinin yanı sıra yanlış yönlendirenin gönderilmesi riskiyle karşı karşıya kalır.