vısılabs segment kurulum kılavuzu

VISILABS SEGMENT
KURULUM KILAVUZU
EYLÜL 2014
İçindekiler
A.
GİRİŞ ............................................................................................................................................ 3
1.
TAKİP MEKANİZMASI ............................................................................................................... 3
2.
ÇEREZLER (COOKIE) ................................................................................................................. 3
B.
TAGLEME KILAVUZU .................................................................................................................... 3
1.
VISILABS SEGMENT JAVASCRIPT KÜTÜPHANELERİ ................................................................. 3
2.
SİTEYİ TAGLEME....................................................................................................................... 3
C.
ÖRNEK TAG’LER ........................................................................................................................... 3
1.
LOGIN....................................................................................................................................... 4
2.
SIGN UP ................................................................................................................................... 5
3.
PRODUCT VIEW ....................................................................................................................... 6
4.
PRODUCT BASKET .................................................................................................................... 7
5.
PRODUCT PURCHASE............................................................................................................... 8
6.
ON SITE SEARCH ...................................................................................................................... 9
7.
PAGE VIEW .............................................................................................................................. 9
8.
ON SITE BANNER CLICK.......................................................................................................... 10
9.
KAMPANYA TAKİBİ................................................................................................................. 10
10.
ADWORDS TAKİBİ .............................................................................................................. 10
Visilabs Segment Kurulum Kılavuzu
2
A.
GİRİŞ
1.
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.
2.
ÇEREZLER (COOKIE)
Oturum ve ziyaretçi harekerlerini takip edebilmek için Visilabs Segment çerezleri
kullanılmaktadı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.
B.
TAGLEME KILAVUZU
1.
VISILABS SEGMENT JAVASCRIPT KÜTÜPHANELERİ
Visilabs.js dosyası sitedeki bütün sayfalara include edilmelidir.
<script type="text/javascript" src="Visilabs.js"></script>
2.
SİTEYİ TAGLEME
Tag’lerin yerleşimi: Visilabs Segment tag’leri html içerisinde <body> tag’leri içerisine
yerleştirilmelidir.
C.
ÖRNEK TAG’LER
Aşağıdaki kod bloğu standart olarak sitedeki bütün sayfalarda bulunmalıdır.
Visilabs Segment Kurulum Kılavuzu
3
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
//Custom parametreler burada tanımlanmalı.
VL.Collect();
//]]>>
</script>
1.
LOGIN
Kullanıcı Login olduğunda yönlendiği sayfada yukarıdaki kod aşağıdaki şekilde değiştirilmelidir.
a)
“Custom” parametreler tanımlanmadan login işlemi:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
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>
b)
Kullanıcıya ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden
raporlanmak istenilenler script’e eklenmelidir:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
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.AddParameter(“Login”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Login”);
VL.Collect();
//]]>>
</script>
Visilabs Segment Kurulum Kılavuzu
4
c)
Kullanıcı login olduğunda kullanıcının ziyaretiyle ilgili parametreleri aşağıdaki
şekilde görebilirsiniz. Ziyarete ilişkin 5 tane “Custom” paramtre tanımlayabilirsiniz:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
VL.AddParameter(“OM.custom1”,”değer”);
VL.AddParameter(“OM.custom2”,”değer”);
VL.AddParameter(“Login”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Login”);
VL.Collect();
//]]>>
</script>
2.
SIGN UP
Kullanıcı Signup olduğunda yönlendiği sayfada aşağıdaki kod çalıştırılmalıdır.
a)
“Custom” parametreler tanımlanmadan login işlemi:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
VL.AddParameter(“Signup”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Signup”);
VL.Collect();
//]]>>
</script>
b)
Kullanıcıya ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden
raporlanmak istenenler script’e eklenmelidir:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
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.AddParameter(“Signup”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Signup”);
VL.Collect();
//]]>>
</script>
Visilabs Segment Kurulum Kılavuzu
5
c)
Kullanıcı signup olduğunda ziyaretle ilgili parametreleri aşağıdaki şekilde
gönderebilirsiniz. Ziyarete ilişkin 5 tane “Custom” parametre tanımlayabilirsiniz:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.exVisitorID”,”kullanıcı adı veya e-mail adresi”);
VL.AddParameter(“OM.custom1”,”değer”);
VL.AddParameter(“OM.custom2”,”değer”);
VL.AddParameter(“Signup”,”Kullanıcı adı veya e-mail”);
VL.AddParameter(“EventType”,”Signup”);
VL.Collect();
//]]>>
</script>
3.
PRODUCT VIEW
Kullanıcının ürün görüntülediği sayfada kod aşağıdaki gibi olmalıdır.
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
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>
Not : 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”);
Not : 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");
Visilabs Segment Kurulum Kılavuzu
6
4.
PRODUCT BASKET
a)
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.
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
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ı"]));
b)
Sepet sayfasında ürün adet miktarı güncellendiğinde:
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 isimli 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.
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.pb”,”Ürün kodu”);
VL.AddParameter("OM.pu" , "Artirilan miktar ya da Azaltılan miktar")
VL.Collect();
//]]>>
</script>
Visilabs Segment Kurulum Kılavuzu
7
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"]));
5.
PRODUCT PURCHASE
Kullanıcı bir ürün satın aldıktan sonra yönlendiği sayfada;
a)
Tek ürün satın almış ise:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.pp”,”Ürün kodu”);
VL.AddParameter(“OM.ppr”,”Fiyat”);
VL.AddParameter(“OM.pu”,”Adet”);
VL.Collect();
//]]>>
</script>
Visilabs Segment Kurulum Kılavuzu
8
b)
Birden fazla ürün satın almışsa:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.pp”,”Ürün kodu1;Ürün kodu2”);
VL.AddParameter(“OM.ppr”,”Fiyat1;Fiyat2”);
VL.AddParameter(“OM.pu”,”Adet1;Adet2”);
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.
6.
ON SITE SEARCH
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:
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
VL.AddParameter(“OM.OSS”,”Aranan kelime”);
VL.Collect();
//]]>>
</script>
7.
PAGE VIEW
Özel olarak implementasyon istediğimiz Login , Signup , Product View, Product Basket ,
Product Purchase aşamalarında kullanıcı bazlı custom data ile Default implementasyon ile düşen
datayla beraber Visilabse düşmektedir. Bu nedenle Özel olarak implementasyon yaptığınız Login ,
Signup , Product View, Product Basket , Product Purchase , OnSiteSearch aşamalarında ayrıca
default impl. yapılmasına gerek yoktur . Master Pages , base.html gibi ortak bir content üzerinde
Login , Signup , Product View ,Product Basket , Product Purchase aşamaları gerçekleştiğinde Default
implementasyon ile data düşmesi engellenmelidir. 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.
Geri kalan tüm sayfalarda standart olarak yapılmasını istediğimiz İmplemantasyon şu şekildedir :
Visilabs Segment Kurulum Kılavuzu
9
<script type="text/javascript">
//<![CDATA[
var VL = new Visilabs();
//Custom parametreler burada tanımlanmalı.
VL.Collect();
//]]>>
</script>
8.
ON SITE BANNER CLICK
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.
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)
10.
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
Visilabs Segment Kurulum Kılavuzu
10

Download Report