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.

B)SİTEYİ TAGLEME Tag’lerin yerleşimi: Visilabs Segment tag’leri html içerisinde 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. //>

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:

//>

2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden raporlanmak istenilenler script’e eklenmelidir :

//>

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. //>

Ö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

//>

2) Kullanıcıyla ait özellikleri raporlamak için aşağıdaki 6 kullanıcı parametresinden raporlanmak istenilenler script’e eklenmelidir : //
Segment Kurulum Dokümanı

4

VL.AddParameter(“EventType”,”Signup”); VL.Collect(); //]]>>

3) Kullanıcı signup olduğunda ziyaretle ilgili parametreleri aşağıdaki şekilde gönderebilirsiniz. Ziyarete ilişkin 5 tane ‘Custom’ parametre tanımlayabilirsiniz.

//>

Ö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.

//>

Ö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); 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. //>

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.

//>

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

//>

2) Birden fazla ürün satın almışsa:

//>

Ö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:

Segment Kurulum Dokümanı

8

//>

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 :

//>

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