Ürün Dosyası Entegrasyonu, RMC Target ve RMC Recommend modüllerini kullanan müşterilerin; web ve mobil ortamlardaki ziyaretçilerinin davranışlarına göre tavsiye ürünler gösterebilmek, ziyaretçi verilerini kullanarak segmentasyon yapabilmek, banner, popup gösterimi gibi aksiyonlar alabilmek ve senaryolar kurmak için gerekli olan dosyalardır. 

Bu sayfada bulabilecekleriniz:

1.1.2. Ürün Entegrasyonu için Gerekli Tanımlamalar

Gerekli ürün dosyasını yukarıda bahsedilen kurallara ve standartlara göre hazırladıktan sonra, dosyayı doğrulamak ve otomatik bir yükleme planlamak için aşağıdaki adımları uygulayın:

1. Ayarlar ikonu > Personalization Center > Recommendation > Product Integration yolunu izleyiniz.
   
   
2. Oluşturduğunuz CSV dosyası için URL girin.
   
   

3. URL'yi ve dosyayı doğrulamak için aşağıdaki adımları izleyin.

    Doğrulama Adımları

   1. Ürün Dosyası için url girdikten sonra, Add Trigger butonunu kullanarak şu anda bulunduğunuz saatten yalnızca bir kaç dakika ilerisini seçin.
      5. Adımda anlatılmaktadır.
      
      
   2. Planladığınız zamana kadar bekleyin ve entegrasyon sonuçlarını görmek için sayfayı yenileyin.
      
      
   3. Ürün dosyanızda herhangi bir hata olup olmadığını görmek için Log Detail butonunu kullanın.
      

   
   

4. Test Detaylarında herhangi bir hata bulunmuyorsa Save URL butonunu tıklayın.
   
   
5. Ürün veri yüklemelerini planlamak için Add Trigger seçeneğini tıklayın. Buradan seçilen periyotlarda, aynı link üzerinde yer alan ürün dosyası sisteme otomatik olarak yüklenecektir.

1.2. Ürün Dosyası#XML Kullanarak

2. Varyant Bazlı Ürün Entegrasyonu ve Site İmplementasyonu

Varyant bazlı ürün önerisi yapılmak istendiğinde ürün entegrasyonu da, sitedeki implementasyon da buna uygun şekilde tasarlanmalıdır.

Site üzerinden iletilen visilabs parametrelerinde Ürün Detay sırasında bize iletilen OM.pv parametresinde varyantlı ürün kodu iletilmeli, öyle bir kod yok ise bu kod üretilmelidir. Bu durumda bir ürünün 1’den fazla ürün kodu olacağı için, ayrıca hepsinin ortak bir grup kodu da olmalıdır. Bu grup kodu (Item Group ID) sayesinde sistemimiz bu ürün kodlarının tek bir ürüne ait olduğunu anlamış olacaktır.

Item Group ID Nedir?

Ürün Grup Kimliği (Item Group ID), belirli bir ürünün farklı varyantlarını gruplamak için kullanılır. Örneğin, bir gömlek her boyut ve renk varyasyonu için farklı bir VariantID'ye sahip olacak ve tüm varyantlar tek bir Ürün Grubu Kimliğine (Item Group ID) göre gruplandırılacaktır.

Varyant bazlı ürün entegrasyondan etkilenen 4 farklı alan vardır:

1. Product View Event

2. Add to Cart Event

3. Product Purchase Event

4. Product File

Örnek:

Gömlek örneği için, Ürün Grubu Kimliği'nin (Item Gorup ID) "PCShirt123" olduğunu ve renk seçeneği Mavi (Blue) olan ürün için, VariantID "PCShirt123-BL" olduğunu varsayalım.

1. Product View Event 

<script type="text/javascript">
function OnVisilabsLoaded(){
var VL = new Visilabs();
VL.AddParameter("OM.pv","Variant ID");//VL.AddParameter("OM.pv","PCShirt123-BL");
VL.AddParameter("OM.pn","Product Name");
VL.AddParameter("OM.inv" , "Number of items in stock");
VL.AddParameter("OM.ppr", "Product Price");
VL.AddParameter("OM.pv.1", "Product Brand");
VL.AddParameter("OM.pv.2", "Item Group ID");//VL.AddParameter("OM.pv.2", "PCShirt123");
VL.Collect();
VL.SuggestActions();
}
</script>

2. Add To Cart Event 

<script type="text/javascript">
function OnVisilabsLoaded(){
var VL = new Visilabs();
VL.AddParameter("OM.pbid","Basket ID");
VL.AddParameter("OM.pb","Variant Code 1;Variant Code2");
VL.AddParameter("OM.pb.2","Item Group ID 1;Item Group ID 2");
VL.AddParameter("OM.pu" ,"product Quantity 1;product Quantity 2")
VL.AddParameter("OM.ppr" ,"Product Price1*Product Quantity 1;Product Price2*Product Quantity2");
VL.Collect();
VL.SuggestActions();
}
</script>

3. Product Purchase Event 

<script type="text/javascript">
function OnVisilabsLoaded(){
var VL = new Visilabs();
VL.AddParameter("OM.tid","TransactionID");
VL.AddParameter("OM.pp","Variant Code 1;Variant Code2");
VL.AddParameter("OM.pp.2","Item Group ID 1;Item Group ID 2");
VL.AddParameter("OM.pu","product Quantity 1;product Quantity 2");
VL.AddParameter("OM.ppr","Product Price1*Product Quantity 1;Product Price2*Product Quantity2");
VL.AddParameter("OM.exVisitorID","User ID");
VL.Collect();
VL.SuggestActions();
}
</script>

4. Product File

Varyasyonlar satırlarda görünür. Ürün dosyasında, satır başına bir ürün varyantınız olmalıdır. Diyelim ki aynı üründe 4 farklı varyantınız var: Mavi, Kırmızı, Yeşil, Sarı, her varyant için bir tane olmak üzere 4 sıra olacak ve hepsi aynı Ürün Grubu Kimliği altında gruplanacaktır.

1st Column: Ürün kodu yerine Varyant Kimliği (Variant ID) gönderin.

28th Column: Ürün Grubu Kimliği gönderin.

Örnek uygulamalar;

1. Default (varyant seçmeden) bir ürün incelendiğinde:

Ziyaretçi henüz hiçbir varyant seçimi yapmamış ise aşağıda kırmızı ile belirtilen şekilde defaultta belirlenen ürün kodu gönderilmelidir. Default’da genelde ilk varyanta ait ürün kodu gönderilir. Burada da 'Small' varyantına ait ürün kodu iletilmiştir. Bununla birlikte resimde de görüldüğü üzere OM.pv.1 parametresinde grup kodu da iletilmiştir. OM.pv.1 parametresinde marka bilgisi iletiliyor ise bu değer OM.pv.2 parametresinde de bize iletilebilir.

2- Varyant Bazlı bir ürün incelendiğinde ise:

3- Ürün Detay Sayfasında Sepete Ekleme İşlemi

Ürün Detay Sayfaları üzerinden sepete ekleme, sepetten çıkarma veya sepeti artırma işlemleri gerçekleştirilirken gönderilmesi gereken 5 adet parametre mevcuttur. Bunlar;

VL.AddParameter("OM.pb","Product Code");
VL.AddParameter("OM.pb.2","Product Group Code");
VL.AddParameter("OM.pu" ,"Product Quantity");
VL.AddParameter("OM.ppr" ,"Product Price*Product Quantity");
VL.AddParameter("OM.uri" ,"/om.gif");

3. Çoklu Dil, Çoklu Para Birimi ve Lokasyon için Ürün Entegrasyon Metotları

3.1. CSV Kullanarak

RMC Recommend ürününde bulunan widget'larda önerilen ürünlerin, çoklu dil (multi-language), çoklu para birimi (multi-currency) destekleyen web sitelerine uyumlu olarak çalışabilmesi için ürün entegrasyonunda uyulması gereken kuralları bu bölümde bulabilirsiniz.

Visilabs CSV ürün entegrasyon servisi hali hazırda başlık bilgisi bulunmayan, CSV de bulunan kolon sırasının sabit olduğu bir yapıya sahiptir. Çoklu dil, çoklu para birimi destekleyen sitelerde widget'larda önerilecek ürünlerin ziyaretçinin o anda tercih ettiği dil ve tercih ettiği para birimi görüntülenebilmesi için hali hazırdaki entegrasyon dosyası standartlarına eklemeler yapılmıştır.

Değişiklikler kısaca şöyledir:

1. CSV ürün entegrasyon dosyasına başlık bilgisi konulması çoklu dil desteği için zorunludur. Detaylar  “CSV Dosyası Başlık Bilgileri”  bölümünde açıklanmıştır.
2. Sitenin lokalizasyon seçenekleri (para birimi, ürünün temin edilebilirliği ve dil) ile standart ürün bilgilerinin sağlanması gereklidir. Bir başka deyişle standart kolonların desteklenen lokasyon seçeneklerine göre karşılıklarının sağlanması gereklidir. Detaylar “Ürün Verilerinin Özelleştirilmesi” bölümünde açıklanmıştır.
3. Lokalizasyon için sağlanan ürün bilgilerinde tutarlılık sağlanmalıdır. Detaylar “Lokalizasyon Yapılan Ürün Bilgilerinde Tutarlılık” bölümünde açıklanmıştır.
   
   

3.1.1. CSV Dosyası Başlık Bilgileri 

3.1.2. Ürün Verilerinin Özelleştirilmesi 

Yukarda yer alan, "CSV Dosyası Başlık Bilgileri" bölümünde ürün bilgilerinin dil, para birimi, ve temin edilebilirlik (lokasyon) bazında özelleştirilebileceğinden bahsetmiştik.

3.1.2.1. DİL ile özelleştirilebilecek ürün bilgileri

Dil ([language]) ile özelleştirilebilecek olan CSV ürün entegrasyon dosyası kolonları şöyledir:

Para birimi le özelleştirilebilecek olan CSV ürün entegrasyon dosyası kolonları şöyledir:

3.1.2.3 LOKASYON (temin edilebilirlik) ile özelleştirilecek ürün bilgileri

Lokasyon ile özelleştirilebilecek olan CSV ürün entegrasyon dosyası kolonları şöyledir:

3.1.2.4. Diğer Alanlar

Standart ürün alanlarının yanı sıra ürün bilgilerine widget render edilirken kullanılabilecek veya email gönderiminde kullanılacak ekstra alanlar ekleyebilirsiniz. 

Örneğin ürününüzdeki RMC’de standart olmayan “MadeIn” alanını dosyada aşağıdaki şekillerde de gönderebilirsiniz:

3.2. Single XML Kullanarak

RMC Recommend ürününde bulunan widget'larda önerilen ürünlerin, çoklu dil (multi-language), çoklu para birimi (multi-currency) destekleyen web sitelerine uyumlu olarak çalışabilmesi için ürün entegrasyonunda uyulması gereken kuralları bu bölümde bulabilirsiniz.

3.2.1. DİL ile özelleştirilebilecek ürün bilgileri

Dil ([language]) ile özelleştirilebilecek olan XML tag'leri şöyledir:

3.2.2. PARA BİRİMİ ile özelleştirilebilecek ürün bilgileri

4. Lokalizasyon Yapılan Ürün Bilgilerinde Tutarlılık 

Widgetların site üzerinde gösterilebilmesi için visilabs JavaScript kütüphanesinin, gösterim yapılacak tüm sayfalara yerleştirilmesi gereklidir. Bu kütüphane  ziyaretçinin gezinmesi sırasında elde ettiği bazı bilgileri, visilabs internet servislerinden öneriler isterken gönderir. Aynı zamanda sitede yapılacak implementasyon gereği bu bilgiler dışındaki bazı bilgilerde site kodlayıcıları tarafından ilgili sayfalarda, kütüphane içinde bulunan bazı metodlar aracılığıyla gönderilebilir.

Çoklu dil, çoklu parabirimi desteği için 3 parametrenin öneri istenen metodun çağırılmasından önce visilabs kütüphanesinin topladığı parametre dizisi içerisine eklenmesi gerekmektedir. 

Bu parametreler şunlardır: OM.p_lng, OM.p_loc, OM.p_dc

Bu bilgiler ışığında visilabs öneri servisi istemciye önerilecek ürün bilgilerini gönderirken, tasarımda kullanılabilecek tüm bilgileri, kullanıcının lokalizasyon ayarlarına uyumlu hale getirerek gönderimi sağlar.

Bu noktada istenmeyen durumlardan kaçınmak için lokalizasyon için kullanılacak bilgilerin uyumlu olması gereklidir.

Örneğin bir ziyaretçi için öneri istenirken gönderilecek parametre değeri şöyle olsun:

OM.p_lng = de

OM.p_loc = DE

OM.p_dc = EUR

Ürün dosyasında da “ABC” ürünü için lokalize edilen alanlar şu şekilde olsun:

Inventory_DE  = 1

OriginalPrice_EUR = boş veya “” olsun. Bu durumda önerilecek ürün “ABC” olması durumunda widget site üzerinde oluşturulurken kullanılabilecek olan fiyat bilgisi gönderilemeyecek 0 olarak görüntülenecektir.

Aynı durum ürün görüntüleme linki (TargetUrl) içinde geçerli olabilir. Inventory_DE = 1 gönderilirken “TargetUrl_de” gönderilmiyor veya boş gönderiliyor ise widget üzerinde ürüne tıklandığından gidilebilecek bir link olamayacaktır.

Buradan yola çıkarak 3 dil, 3 parabirimi ve 3 lokasyon destekleyen bir site de widgetların uyumlu bir şekilde çalışabilmesi için standart field'ların yanısıra widgetlar render edilirken en çok ihtiyaç duyulan field'ların özelleştirilmiş kolonları ürün entegrasyonunda gönderilmelidir.

Bu fieldlar şöyledir:

ProductName, TargetURL,  (SmallImageURL veya MediumImageURL veya LargeImageURL) en az bir tanesi, OriginalPrice, Currency, DiscountedPrice, DiscountCurrency ,Inventory

Bu durumda ürün dosyasında bulunması gereken kolon sayısı:

• Standart kolon sayısı: 20 

• Özeleştirilmiş field sayısı: ProductName_[language]  * 3 + TargetURL_[language]  *3 + MediumImageURL_[language] *3 + OriginalPrice_[currency] * 3 + OriginalPriceCurrency_[currency] * 3 + DiscountedPrice_[currency] * 3 + DiscountPriceCurrency_[currency] * 3 + Inventory_[location] * 3 = 24

• Toplamda en az 44 (20 + 24) kolon olmalıdır.

Ana Başlık: RMC'ye Veri Gönderimi