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"> 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. //Custom parametreler burada tanımlanmalı. 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: VL.AddParameter( Login, Kullanıcı adı veya e-mail ); VL.AddParameter( EventType, Login ); 2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden raporlanmak istenilenler script e eklenmelidir : 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 ); Segment Kurulum Dokümanı 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. 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 ); Ö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 VL.AddParameter( Signup, Kullanıcı adı veya e-mail ); VL.AddParameter( EventType, Signup ); 2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden raporlanmak istenilenler script e eklenmelidir : 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 ); Segment Kurulum Dokümanı 4
VL.AddParameter( EventType, Signup ); 3) Kullanıcı signup olduğunda ziyaretle ilgili parametreleri aşağıdaki şekilde gönderebilirsiniz. Ziyarete ilişkin 5 tane Custom parametre tanımlayabilirsiniz. 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 ); Ö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. 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ı"); Önemli: Ürünün fiyat bilgisinde Decimal Seperator bildirimi sadece ondalık kısımda yapılmalıdır. Segment Kurulum Dokümanı 5
VL.AddParameter("OM.ppr", 2500,5); Doğru Kullanım VL.AddParameter("OM.ppr", 2.500,5); 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. VL.AddParameter( OM.pb, Ürün kodu ); VL.AddParameter( OM.pu,"Adet"); 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 Segment Kurulum Dokümanı 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. VL.AddParameter( OM.pb, Ürün kodu ); VL.AddParameter("OM.pu", "Artirilan miktar ya da Azaltılan miktar") 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: Segment Kurulum Dokümanı 7
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 ); 2) Birden fazla ürün satın almışsa: 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 ); Ö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); Doğru Kullanım VL.AddParameter("OM.ppr", 2.500,5); 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: Segment Kurulum Dokümanı 8
VL.AddParameter( OM.OSS, Aranan kelime ); 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 : //Custom parametreler burada tanımlanmalı. 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 Segment Kurulum Dokümanı 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 Segment Kurulum Dokümanı 10