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.