EntegrasyonlarFinteza JavaScript İstemcisiKurulum

İzleme komut dosyası nasıl yüklenir?

Bir izleme komut dosyası eklemek için web sitesi sayfalarınıza küçük bir kod eklemeniz yeterlidir. Finteza panelinden web sitenizi açın ve Ayarlar'a gidin:

Web siteniz için bir izleme kodu alın

İzleme kodunu kopyalayın ve tüm web sayfalarında <head></head> etiketlerinin arasına yapıştırın.

Web sitenizi Finteza'ya henüz kayıt etmediyseniz, Web Siteleri bölümünden Ekle'ye tıklayın. Web sitesi adını ve adresini belirterek izleme kodunu hemen edinebilirsiniz.


İzleme kodunu web sitenizin tüm sayfalarına eklediğinizden emin olun, aksi takdirde ziyaret istatistikleri eksik olacaktır.


Örnek #

Oluşturulacak kod aşağıdaki gibidir:

<script type="text/javascript">
  (function(a,e,f,g,b,c,d){a[b]||(a.FintezaCoreObject=b,a[b]=a[b]||function(){(a[b].q=a[b].q||[]).push(arguments)},a[b].l=1*new Date,c=e.createElement(f),d=e.getElementsByTagName(f)[0],
   c.async=!0,c.defer=!0,c.src=g,d&&d.parentNode&&d.parentNode.insertBefore(c,d))})
  (window,document,"script","{SCRIPT_URL}","fz");
  fz("register","website","{WEBSITE_ID}");
</script>

Sizin için oluşturulan kodda, {SCRIPT_URL}, Finteza sunucusundan indirilen ana izleme komut dosyasının URL adresi ile değiştirilecektir. {WEBSITE_ID} ise, Finteza panelindeki web sitesi kimliğinizle değiştirilecektir.

Kodu yerleştirdikten sonra, web sayfasının ana bağlam penceresinde fz() fonksiyonu görünür. Kullanılabilirliğini kontrol etmek için, konsolda window.fz çalıştırın. Bu fonksiyon Finteza ile etkileşime girme metodlarını çağırmak için kullanılır. Bir web sitesine kaydolma örneği:

fz("register","website","{WEBSITE_ID}");

fz fonksiyonunun adı zaten kullanımdaysa, başka bir tane kullanın. Bunu yapmak için, izleme kodunda fonksiyonun adını iki yerde değiştirerek metod bildirimini düzenleyin:

(window,document,"script","{SCRIPT_URL}","fz-your-name");
fz-your-name("register","website","{WEBSITE_ID}");

Ana izleme komut dosyası (Finteza sunucusundan indirilen), diğer ögelerle eşzamanlı olmadan — bağımsız olarak sayfaya eklenir. Böylece, ana sayfanın yüklenmesini yavaşlatmaz.

Web sitesi kayıt parametreleri #

Oluşturulan kod, web sitesi ziyaret olaylarını Finteza'ya gönderen fz("register", ...) fonksiyonunun çağrılmasını içerir. Bu fonksiyon birkaç ek parametreyi destekler:

Parametre

Tip

Açıklama

trackHash

boolean

Web sayfası hash (çapa) değişimini izlemeyi sağlar.
 
Varsayılan olarak, web sayfasının içindeki çapa linklerinden yapılan geçişler izlenmez. Bir web sayfasının sadece ilk açılması bir sayfa görüntülemesi olarak kabul edilir. Bu yaklaşım, içeriğin tamamının uzun bir sayfada (tek sayfa uygulaması) bulunduğu web siteleri için kabul edilemez olabilir.

 

Finteza'nın web sayfası URL'sindeki hash değişimlerini izlemesini sağlamak için bu parametreyi etkinleştirin. Her hash değişiminde sisteme yeni bir web sayfası ziyaret olayı gönderilecektir.

trackLinks

boolean

Web sitenizdeki sayfalarda bulunan harici linklere yapılan tıklamaların izlenmesini sağlar.

 

Web sitenizde birden fazla harici bağlantı kullanıyorsanız (örneğin, bir reklamcılık ağıyla işbirliği yaparken), bu parametre kullanıcıların web sitenizden tam olarak nasıl ayrıldığını belirlemenizi sağlar.

 

Harici bir link tıklandığında, Finteza'ya özel bir olay gönderilir. Bu tür olaylar hakkındaki raporları, Finteza panelinde web sitenizin Sayfalar — Çıkışlar bölümünde bulabilirsiniz.

timeOnPage

boolean

Bir kullanıcı tarafından bir web sayfasında harcanan sürenin doğru bir şekilde hesaplanmasını sağlar.

 

Varsayılan olarak, sistem sayfada harcanan süreyi sayfaya giriş zamanı ile site içi bir sonraki sayfaya geçiş zamanı arasındaki süre olarak hesaplar. Ancak, site içi bir sonraki web sayfasına geçiş olmazsa, son ziyaret edilen sayfa için böyle bir hesaplama yapılamaz.

 

Etkinleştirilirse, JavaScript İstemcisi Finteza'ya her 15 saniyede bir kullanıcının hala web sayfasında olduğunu bildiren özel bir olay gönderir. Böylece, tek görüntülemeler için dahi harcanan zamanı daha doğru bir şekilde izleyebilirsiniz.

 

Olaylar, yalnızca kullanıcının web sayfasında harcadığı ilk iki dakika için gönderilir.

Ek parametrelerin etkinleştirilmesine örnek:

fz( "register""website", {
    "id":"cacgfaknbbubiozaeidyvhoisrajbdvjqg",
    "trackHash"true,
    "trackLinks"true,
    "accurateBounceRate"true,
    "timeOnPage"true
} );

İçerik Güvenliği Politikasını kullanırken #

İçerik Güvenliği Politikası standardı, kötü amaçlı kodların web sayfalarına girmesiyle ilişkili saldırıları önlemek için tasarlanmıştır. Bu güvenlik politikasını kullanıyorsanız, her web sayfası üst bilgisinde ilgili bildirimi içeren dizgeye Finteza izleme komut dosyasının indirildiği web sitesi için bir istisna ekleyin, örneğin:

Content-Security-Policy: script-src 'self' content.mql5.com;

Aksi halde, tarayıcılar core.js'nin yüklemesini engeller, böylece web sitesi istatistik toplamayı devre dışı bırakır.

X-DNS-Prefetch-Control kullanarak indirme işlemini hızlandırma #

İzleme komut dosyasının indirilmesini hızlandırmak için, tüm web sitesi sayfalarının üst bilgisine X-DNS-Prefetch-Control komutunu eklemeniz önerilir:

<meta http-equiv='x-dns-prefetch-control' content='on'>
<link rel='dns-prefetch' href='https://content.mql5.com'>

Bu şekilde Finteza komut dosyasının konumu tarayıcı gösterilir ve böylece tarayıcı komut dosyasını indirmek için ayrıca zaman harcamaksızın adresi hemen (web sayfasını indirirken) çözebilir.

Komut dosyasının indirilmesini web siteniz üzerinden proxyleme #

Finteza komut dosyasının indirilmesinin engellenmesini önlemek için, komut dosyasını web siteniz üzerinden proxylemeniz önerilir.