Visilabs Segment Kurulum Kılavuzu

Transkript

VISILABS SEGMENT KURULUM KILAVUZU
ARALIK 2014
1)GİRİŞ
A)TAKİP MEKANİZMASI
Visilabs Segment, web siteleri ve mobil uygulamalarda yapılan tüm hareketleri takip etmektedir.
Bu hareketlerin takibi, web sitelerinde JavaScript fonksiyonları ile yapılmaktadır. Tarayıcı kodları
işlerken veriler, standart ‘http GET image request’’leri ile sunucularımıza gönderilmektedir.
Visilabs Segment sunucularına ulaşan veriler ayrıştırılıp sonradan analizlerde kullanılmak üzere
hesabınız için açılan veritabanlarına yüklenmektedir.
B)ÇEREZLER(COOKIE)
Oturum ve ziyaretçi hareketlerini takip edebilmek için Visilabs Segment, çerezleri kullanmaktadır.
Oturum çerezi: Oturum çerezleri, sadece ziyaretçinin tarayıcı oturumu boyunca yaşamaktadır. Bir
oturum çerezi, ziyaretçi sitedeki ilk JavaScript kodunu çalıştırdığında başlar. Oturum çerezinin
ortadan kalkması için ziyaretçinin 30 dakikadan uzun bir süre sitede hareket yapmamış olması
gerekir.
Ziyaretçi çerezi: Ziyaretçi çerezi, bir ziyaretçinin birden fazla ziyaretini bir ziyaretçiyle
ilişkilendirmek için kullanılır.
2)TAGLEME KILAVUZU
A)VISILABS SEGMENT JAVASCRIPT KÜTÜPHANELERİ
Visilabs.js dosyası sitedeki bütün sayfalara include edilmelidir.
<script type="text/javascript" src="Visilabs.js"></script>
B)SİTEYİ TAGLEME
Tag’lerin yerleşimi:
Visilabs Segment tag’leri html içerisinde <body> tag’leri içerisine yerleştirilmelidir.
Segment Kurulum Dokümanı
2
3)ÖRNEK TAG’LER
Aşağıdaki kod bloğu standart olarak sitedeki bütün sayfalarda bulunmalıdır.
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
//Custom parametreler burada tanımlanmalı.
VL.Collect();
//]]>>
</script>
A)LOGIN
Kullanıcı Login olduğunda yönlendiği sayfada yukarıdaki kod aşağıdaki şekilde değiştirilmelidir.
1) ‘Custom’ parametreler tanımlanmadan login işlemi:
//<![CDATA[
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
VL.AddParameter(“Login”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Login”);
VL.Collect();
//]]>>
</script>
2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden
raporlanmak istenilenler script’e eklenmelidir :
//<![CDATA[
VL.AddParameter(“OM.vn”,”Ziyaretçinin Adı”);
VL.AddParameter(“OM.sn”,”Ziyaretçinin Soyadı”);
VL.AddParameter(“OM.bd”,”Ziyaretçinin Doğum Tarihi”);
VL.AddParameter(“OM.gn”,”Ziyaretçinin Cinsiyeti”); //(Male ? Female)
VL.AddParameter(“OM.loc”,”Ziyaretçinin Şehri”);
VL.AddParameter(“OM.em”,”Ziyaretçinin E-mail adresi”);
VL.Collect();
//]]>>
</script>
3
3) Kullanıcı login olduğunda kullanıcının ziyaretiyle ilgili parametreleri aşağıdaki şekilde
gönderebilirsiniz. Ziyarete ilişkin 5 tane ‘Custom’ parametre tanımlayabilirsiniz.
//<![CDATA[
VL.AddParameter(“OM.custom1”,”değer”);
VL.Collect();
//]]>>
</script>
Önemli: Visilabs'in eposta gönderme özelliğini kullanacaksanız OM.exVisitorID değeri olarak
eposta servis sağlayıcınızla paylaştığınız ID değerini kullanınız.
B)SIGNUP
Kullanıcı Signup olduğunda yönlendiği sayfada aşağıdaki kod çalıştırılmalıdır.
1) ‘Custom’ parametreler tanımlanmadan login işlemi
//<![CDATA[
VL.AddParameter(“Signup”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Signup”);
VL.Collect();
//]]>>
</script>
2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden
raporlanmak istenilenler script’e eklenmelidir :
//<![CDATA[
VL.AddParameter(“OM.vn”,”Ziyaretçinin Adı”);
VL.AddParameter(“OM.sn”,”Ziyaretçinin Soyadı”);
VL.AddParameter(“OM.bd”,”Ziyaretçinin Doğum Tarihi”);
VL.AddParameter(“OM.gn”,”Ziyaretçinin Cinsiyeti”); //(Male ? Female)
VL.AddParameter(“OM.loc”,”Ziyaretçinin Şehri”);
VL.AddParameter(“OM.em”,”Ziyaretçinin E-mail adresi”);
4
VL.Collect();
//]]>>
</script>
3) Kullanıcı signup olduğunda ziyaretle ilgili parametreleri aşağıdaki şekilde gönderebilirsiniz.
Ziyarete ilişkin 5 tane ‘Custom’ parametre tanımlayabilirsiniz.
//<![CDATA[
VL.Collect();
//]]>>
</script>
Önemli: Visilabs'in eposta gönderme özelliğini kullanacaksanız OM.exVisitorID değeri olarak
eposta servis sağlayıcınızla paylaştığınız ID değerini kullanınız.
C)PRODUCTVIEW
Kullanıcının ürün görüntülediği sayfada kod aşağıdaki gibi olmalıdır.
//<![CDATA[
VL.AddParameter(“OM.pv”,”Ürün kodu”);
VL.AddParameter(“OM.pn”,”Ürün adı”);
VL.AddParameter(“OM.cat”,”Kategori kodu”);
VL.AddParameter(“OM.catn”,”Kategori adı”);
VL.AddParameter("OM.inv" , "Stok durumu");
VL.AddParameter("OM.ppr", "Ürün fiyatı");
VL.AddParameter("OM.pv.1", "Ürün markası");
VL.Collect();
//]]>>
</script>
Önemli: Ürünün fiyat bilgisinde Decimal Seperator bildirimi sadece ondalık kısımda yapılmalıdır.
5
VL.AddParameter("OM.ppr", 2500,5);
VL.AddParameter("OM.ppr", 2.500,5);
Doğru Kullanım
Yanlış Kullanım
Önemli: Burada kategori hiyerarşisini aralara "|" koyarak gönderebilirsiniz. Kategori
hiyerarşisinin derinliğini mümkün olduğunca uzun tutmak gerekmektedir.
Örn:
VL.AddParameter(“OM.cat”,”1212|1456”);
VL.AddParameter(“OM.catn”,”Bilgisayar|Notebook”);
Önemli: Kategori hiyerarşisinin derinliğini mümkün olduğunca uzun tutmak daha sağlıklı
sonuçlar almak için gerekmektedir.
Örn;
VL.AddParameter("OM.cat", "232|4343|335");
VL.AddParameter("OM.catn"," ev-elektronigi-tv|elektrikli-ev-aletleri|haliyikama-makineleri");
D)PRODUCTBASKET
1) Sepete ekle butonu tetiklendiğinde
Ürün sepete eklendiğinde aşağıdaki kod çalıştırılmalıdır. ‘ProductUnit’ parametresinin değeri
sepete atılan ürünün adedir.
//<![CDATA[
VL.AddParameter(“OM.pb”,”Ürün kodu”);
VL.AddParameter(“OM.pu” ,"Adet");
VL.Collect();
//]]>>
</script>
NOT: Custom Parametreleri AddParameter methodu ile tek tek gönderebileceğiniz gibi , bir
Array olarak da dönebilirsiniz.
Eğer "Sepete Ekle" butonuna kliklendiğinde , ajax kullanıyorsanız, belirli adette ürünün
eklenmesi bilgisini aşağıdaki gibi gönderebilirsiniz.
VL.ReCollect(new Array (["OM.pb" , "Product Code"] ,["OM.pu" , "Adet Miktarı"]));
2) Sepet sayfasında ürün adet miktarı güncellendiğinde
6
Kullanıcı bir ürünü sepete attığı zaman yönlendirildiği .*/sepet sayfasında ürünün adet bilgisini
güncelleyebilmektedir. Kullanıcı adet bilgisini güncellediği zaman Sepeti güncelle butonu
tetiklendiğinde aşağıda belirtildiği gibi bir implemantasyon yapılmalıdır.
Sepeti güncelle butonu tetiklendiğinde
.*/sepet sayfası üzerinde ürün adet miktarı artırılmışsa OM.pu=ArtirilanMiktar
.*/sepet sayfası üzerinde ürün adet miktarı azaltılmışsa OM.pu=-AzaltilanMiktar
şeklinde set edilmesi gerekmektedir.
//<![CDATA[
VL.AddParameter(“OM.pb”,”Ürün kodu”);
VL.AddParameter("OM.pu" , "Artirilan miktar ya da Azaltılan miktar")
VL.Collect();
//]]>>
</script>
Burada VL.AddParameter("OM.pu" , "Artırılan miktar ya da Azaltılan Miktar"); parametre değeri
sepeti güncelle butonu tetiklendiğinde aşağıda belirtilen örnekdeki gibi set edilmelidir.
ürün adedi 3 artırılmışsa
VL.AddParameter("OM.pu" , "3")
ürün adedi 3 azaltılmışsa
VL.AddParameter("OM.pu" , "-3")
NOT: Custom Parametreleri AddParameter methodu ile tek tek gönderebileceğiniz gibi , bir
Array olarak da dönebilirsiniz.
Eğer "sepeti güncelleme" aşamasında ajax kullanıyorsanız , ürün adetleri güncellendiğinde
veya bir ürün sepetten çıkarıldığı zaman aşağıdaki fonksiyonu kullanabilirsiniz:
VL.ReCollect(new Array (["OM.pb" , "Product Code"] ,["OM.pu" , "Artırılan ya da Azaltılan
miktar"]));
E)PRODUCTPURCHASE
Kullanıcı bir ürün satın aldıktan sonra yönlendiği sayfada
1) Tek ürün satın almışsa:
7
//<![CDATA[
VL.AddParameter(“OM.pp”,”Ürün kodu”);
VL.AddParameter(“OM.ppr”,”Ürün Fiyatı*Adet”);
VL.AddParameter(“OM.pu”,”Adet”);
VL.AddParameter(“OM.exVisitorID”,”VisitorID”);
VL.AddParameter(“OM.tid”,”TransactionID”);
VL.Collect();
//]]>>
</script>
2) Birden fazla ürün satın almışsa:
//<![CDATA[
VL.AddParameter(“OM.pp”,”Ürün kodu1;Ürün kodu2”);
VL.AddParameter(“OM.ppr”,”Fiyat1*Adet1;Fiyat2*Adet2”);
VL.AddParameter(“OM.pu”,”Adet1;Adet2”);
VL.AddParameter(“OM.exVisitorID”,”VisitorID”);
VL.AddParameter(“OM.tid”,”TransactionID”);
VL.Collect();
//]]>>
</script>
Önemli : Bir ürünün Product View , Product Basket ve Product Purchase aşamalarında istenilen
ürün kodu parametreleri OM.pv , OM.pb ve OM.pp birbirine eşit olmalıdır.
Önemli: Ürünün fiyat bilgisinde Decimal Seperator bildirimi sadece ondalık kısımda yapılmalıdır.
VL.AddParameter("OM.ppr", 2500,5);
VL.AddParameter("OM.ppr", 2.500,5);
Doğru Kullanım
Yanlış Kullanım
Önemli: Eğer Visilabs'in eposta gönderme özelliğini kullanacaksanız OM.exVisitorID değeri olarak
eposta servis sağlayıcınızla paylaştığınız ID değerini kullanın.
Önemli: OM.ppr parametresine Ürünün Birim Fiyatı ve Satın alınan ürün adedinin çarpımı değer
olarak geçilmelidir.
F)ONSITESEARCH
Site üstünde bir phrase arandığında, arama sonuç sayfasında,
Kullanıcı arama kutusundan arama yaptığında yönlendiği sayfadaki kod aşağıdaki şekilde
olmalıdır:
8
//<![CDATA[
VL.AddParameter(“OM.OSS”,”Aranan kelime”);
VL.Collect();
//]]>>
</script>
G) PAGEVIEW
Özel olarak implementasyon istediğimiz Login , Signup , Product View, Product Basket ,
Product Purchase, OnSiteSearch aşamalarında Default implementasyon ile toplanan parametreler de
toplanmaktadır , Bu aşamalarda bir kez daha Collect method çağrımı yapılarak Visilabse request
atılmasına gerek yoktur. Master Pages , base.html gibi ortak bir content üzerinde Login , Signup ,
Product View ,Product Basket , Product Purchase, OnSiteSearch aşamaları gerçekleştiğinde tüm
sayfalara yerleştirilen Collect methodu cağrımı exclude edilmeli. Bu durum Total Page View ve Total
PageView 'e bağlı raporların en doğru sonucu vermesi açısından son derece önemlidir.
Ayrıca Ürünlerin grid şeklinde gösteriminin yapıldığı kategori sayfalarında ve static sayfalarda
Default implemantasyonun da yapılması sağlanmalıdır.
Özet olarak özel implementasyon istemediğimiz tüm sayfalarda Default implementasyon
yapılmalıdır Geri kalan tüm sayfalarda standart olarak yapılmasını istediğimiz İmplemantasyon şu
şekildedir :
//<![CDATA[
//Custom parametreler burada tanımlanmalı.
VL.Collect();
//]]>>
</script>
H)ONSITEBANNERCLICK
Kullanıcınınn site içerisinde tıkladığı bannerları raporlamak için banner’ın yönlendiği sayfanın
URL’sine ‘OM.OSB’ parametresi eklenmeli:
orneksite.com/orneksayfa.html?OM.OSB=bannerAdi
9
Önemli :
Site içerisinde Banner click eventi gerçekleştiğinde , bannerın yönlendirildiği url , bir Product
View sayfası ise parametre şu şekilde eklenmeli :
orneksite.com/orneksayfa.html?OM.OSB=ProductCode
I) KAMPANYA TAKİBİ
Yaptığınız kampanyaların ölçümlenebilmesi için sitenize gelen linklere aşağıdaki parametrelerin
eklenmesi gerekmektedir.
destinationUrl.com?OM.cname=KampanyaAdı&OM.csource=Mecra&OM.cmedium=x
OM.cname: Kampanyanın ismi
OM.csource: Kampanyanın yapıldığı mecra (Örn: Hurriyet, Google,..)
OM.cmedium: Kampanya aracı (CPC, Banner, Email)
J) ADWORDS TAKİBİ
Adwords kampanyalarının ölçümlenebilmesi için sitenize gelen linke gerekli parametrelerin
aşağıdaki şekilde eklenmiş olması gerekmektedir:
destinationUrl?OM.csource=google&OM.cname=Campaign&OM.cmedium=ppc
&OM.keyword=Kelime&OM.adgroup=adgroupadi
OM.cname: Kampanyanın ismi
OM.csource: google
OM.cmedium: cpc
OM.adgroup=Adgroup adı
OM.keyword=Kelime
10

Visilabs Segment Kurulum Kılavuzu

Transkript

Benzer belgeler

Web Uygulamaları Sızma Testi Eğitimi

mobılepax xml product apı kullanım şekli