Web DataLayer Event Şablonu Entegrasyonu

Web sitenizde event entegrasyonunu hızlandırmak için DataLayer entegrasyonunu aşağıdaki şablonu kullanarak gerçekleştirebilirsiniz. Dokümandaki event’ler için web sitenizden toplamak istediğiniz verileri ve gerçekleştireceğiniz kurguları göz önünde bulundurarak şablonu uygulamanız durumunda web event entegrasyon süresi kısalacağı gibi sonraki kurgular için de bir standart oluşturulmuş olacak. DataLayer’a eklenen bu hazır event’ler farklı 3rd party ürünlerle entegrasyonlarınızda da kullanılabilir durumda olacaklar.

Event şablon implementasyonuna başlamadan önce lütfen web siteniz üzerinde Google Tag Manager (GTM) ve DataLayer implementasyonu yapılmış olduğundan emin olun. 

Üye Girişi - Login Event

Kayıtlı olan üye giriş yaptığı zaman DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.exVisitorID (ZORUNLU)

OM.b_login (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 //Login dataLayer.push({ event: "vlEvent", vl_label: "VL-Login", vl_userID: "ID or email of user", // Required });

Yeni Kayıt - Sign Up

Üye yeni kayıt olduğunda DataLayer’a data gönderilir.


Kullanılacak Parametreler

OM.exVisitorID (ZORUNLU)

OM.b_sgnp (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 // Signup dataLayer.push({ event: "vlEvent", vl_label: "VL-Signup", vl_userID: "ID or email of user", // Required });

Site içinde yapılan aramalardan sonra DataLayer’a data gönderilir.


Kullanılacak Parametreler

OM.OSS  (ZORUNLU)

OM.OSSR (OPSİYONEL)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 7 8 dataLayer.push({ event: "vlEvent", vl_label: "VL-SearchResultView", vl_search: { word: "Searched Word", // Required result: "Product Count Of Founded Search Result" // Optional } });

Kategori Sayfası Görüntüleme - Category Page View

Site içerisinde bir kategoriye giriş yapıldığında  DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.clist (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 dataLayer.push({ event: "vlEvent", vl_label: "VL-CategoryView", vl_category_id: "Category ID" // Required });

Ürün Görüntüleme - Product View

Ürün görüntülendiğinde DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.pv (ZORUNLU)

OM.pn (ZORUNLU)

OM.inv (ZORUNLU)

OM.ppr (ZORUNLU). 

OM.pv.1(OPSİYONEL)

OM.pv.2 (Varyantlı entegrasyon için ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 dataLayer.push({ event: "vlEvent", vl_label: "VL-ProductDetailView", 'vl_ecommerce': { 'detail': { 'product': { 'name': 'Product Name', // Required 'id': 'Product Code', // Required 'price': 'Product Price', // Required 'stock': 'Product Stock', // Required 'brand': 'Product Brand', // Optional 'category': 'Product Category', // Optional 'item_group_id': 'Product variantID' // Optional } } } });

Sepete Ürün Ekleme - Add To Cart

Sepete ürün eklemesi yada silinmesi durumunda  DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.pbid (ZORUNLU)

OM.pb (ZORUNLU

OM.pu (ZORUNLU

OM.ppr(ZORUNLU

OM.pb.2  (Varyantlı entegrasyon için ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 dataLayer.push({ event: "vlEvent", vl_label: "VL-CartView", 'vl_ecommerce': { 'cart': { 'basket_id': 'Unique Basket ID', // Required 'products': [ { 'id': 'Product Code', // Required 'price': 'Product Price', // Required 'qty': 'Product Quantity', // Required 'brand': 'Product Brand', // Optional 'item_group_id': 'Product variantID' // Optional }, { 'id': 'Product Code', // Required 'price': 'Product Price', // Required 'qty': 'Product Quantity', // Required 'brand': 'Product Brand', // Optional 'item_group_id': 'Product variantID' // Optional } ] } } });

Favorilere Ürün Ekleme/Çıkarma - Add or Remove Favorites

Favoriye ürün eklendiğinde yada çıkarıldığında DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.pf  (ZORUNLU)

OM.pfu (ZORUNLU)

OM.ppr (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 // Ekleme dataLayer.push({ event: "vlEvent", vl_label: "VL-AddFav", vl_product: { id: "Product Code", // Required qty: "1", // Required price: "Product Price" // Required } }); // Çıkarma dataLayer.push({ event: "vlEvent", label: "VL-RemoveFav", vl_product: { id: "Product Code", // Required qty: "-1", // Required price: "Product Price" // Required } });

Ürün Satın Alma - Product Purchase

Ürün satın alması gerçekleştikten sonra DataLayer’a data gönderilir.

 

Kullanılacak Parametreler

OM.tid (ZORUNLU)

OM.pp (ZORUNLU)

OM.pp.2  (Varyantlı entegrasyon için ZORUNLU)

OM.pu  (ZORUNLU)

OM.ppr  (ZORUNLU

OM.exVisitorID (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 dataLayer.push({ event: "vlEvent", vl_label: "VL-PurchaseView", 'vl_ecommerce': { 'checkout': { 'purchase_id': 'Receipt ID', // Required 'vl_userID': "ID or email of user", // Required 'products': [ { 'id': 'Product Code', // Required 'qty': 'Product Quantity', // Required 'price': 'Product Price', // Required 'brand': 'Product Brand', // Optional 'item_group_id': 'Product variantID' // Optional }, { 'id': 'Product Code', // Required 'qty': 'Product Quantity', // Required 'price': 'Product Price', // Required 'brand': 'Product Brand', // Optional 'item_group_id': 'Product variantID' // Optional } ] } } });

Sayfa Görüntüleme - PageView

Yukarda belirtilen sayfalar hariç tüm sayfalarda DataLayer‘a  gönderilmesi gereken kod aşağıdaki gibidir.

 

Kullanılacak Parametreler

OM.uri (ZORUNLU)

 

DataLayer’a gönderilmesi gereken data örneği

1 2 3 4 dataLayer.push({ event: "vlEvent", vl_label: "VL-PageView" });

Özel Event Tanımlanması  - Custom Event

Web sayfası üzerinde yukarıda belirtilen hali hazırdaki event'lere ek olarak gönderilmek istenen bir event var ise DataLayer’a data gönderilir. Bu data ister DataLayer içerisinde bir dizi istenirse de sadece parametre-değer şeklinde gönderilebilir.

 

Kullanılacak Parametreler

Bu parametrelerin müşterinin göndereceği data tipi ve adedine göre Entegrasyon ekibi tarafından RMC panelinde oluşturulması gerekmektedir.

 

DataLayer’a gönderilmesi gereken data örnekleri

1 2 3 4 5 6 7 8 9 10 11 12 13 dataLayer.push({ event: "vlEvent", vl_label: "VL-CustomEventType1", 'vl_ecommerce': { 'detail': { 'CustomEventArray': { 'Attribute1': 'Attribute1 Value', // Required 'Attribute2': 'Attribute2 Value', // Required 'AttributeN': 'AttributeN Value' // Required } } } });

ya da

 

1 2 3 4 5 6 7 dataLayer.push({ event: "vlEvent", vl_label: "VL-CustomEventType2", vl_CustomEventAttribute1: "Attribute1 Value", // Required vl_CustomEventAttribute2: "Attribute2 Value", // Required vl_CustomEventAttributeN: "AttributeN Value", // Required });