Ürün Dosyası
Ü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.
Ürün dosyası, RMC tarafından sağlanan FTP alanı yerine kök klasöre ( root directory) bırakıldığı takdirde; Datawarehouse modülü veriyi silmektedir. Bu sebepten, dosya FTP alanı dışında kullanılmak istenirse aşağıdaki adımlara dikkat edilmelidir:
Ürün dosyasına özel bir klasör açılıp, dosya bu klasöre bırakılmalıdır.
Güncellenmek istenen ürün dosyasının, her seferinde aynı adlandırmayla klasöre bırakılmalıdır.
Bu sayfada bulabilecekleriniz:
- 1 1. Ürün Dosyası Entegrasyon Metotları
- 2 2. Varyant Bazlı Ürün Entegrasyonu ve Site İmplementasyonu
- 3 3. Çoklu Dil, Çoklu Para Birimi ve Lokasyon için Ürün Entegrasyon Metotları
1. Ürün Dosyası Entegrasyon Metotları
Ürün dosyanızı RMC'ye entegre etmek için iki metod bulunur;
1.1. Başlık (Header) Olmadan CSV Kullanarak
1.2. Ürün Dosyası#XML Kullanarak
Boyut, renk, malzeme vb. farklı ürün varyasyonları sunuyorsanız, entegrasyonunuz biraz farklı olacaktır, lütfen "Varyant bazlı ürün entegrasyonu ve site implementasyonu" alanındaki yönergeleri izleyin.
Aynı kategoriye bağlı alt kategorilerin farklı kategori kodları olmalıdır. Alt kategori isimleri aynı olabilir ama kodları mutlaka farklı olmalıdır. Kategori ağacı şu şekilde olabilir; kadin>kadin_giyim>kadin_ayakkabi, erkek>erkek_giyim>erkek_ayakkabi.
Ç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. "Çoklu dil, çoklu para birimi ve lokasyon için ürün entegrasyonu" alanında detaylı bilgileri ve örnek uygulamaları bulabilirsiniz.
1.1. Başlık (Header) Olmadan CSV Kullanarak
1.1.1. Ürün Dosyası Hazırlama
Başarılı bir product.csv dosyası entegrasyonunu sağlamak için aşağıdaki kurallara uymanız gerekmektedir:
Dosya HTTP üzerinden erişilebilir olmalıdır.
Dosya günde en az bir kez güncellenmelidir.
İlk satırda başlık (header) kullanılmamalıdır.
Dosya BOM (byte order mark) olmadan UTF-8 formatında kodlanmalıdır.
Sütunları ayırmak için noktalı virgül " ; " kullanın.
Bir ürün stokta yoksa, stok sütunu 0 (sıfır) olarak bildirilmelidir veya tüm satır dosyadan kaldırılmalıdır.
İskonto edilmiş bir fiyat yoksa, orijinal fiyat indirimli fiyat kolonuna da yazılmalıdır, böylece her iki kolonunda da aynı değeri içermesi sağlanır.
Tüm ürün kodları benzersiz olmalıdır.
Bir ürün yalnızca 1 kategoriye ait olabilir. Bir ürün birden fazla kategoriye bağlıysa, yalnızca varsayılan kategoriyi kullanın.
Web sitelerinden veya mobil uygulamalardan gönderdiğiniz ürün kodları, Ürün Dosysındaki ürün kodlarıyla aynı olmalıdır.
Örnek CSV dosyasını indirmek ve görüntülemek için tıklayınız..
Kolonlar aşağıdaki şekilde sıralanmalıdır:
Kolon | Açıklama | Örnek | ||
|---|---|---|---|---|
1. | Product Code | Ürün Kodu | ZORUNLU | |
2. | Product Name | Ürün Adı | iPhone 7 Plus | ZORUNLU |
3. | Category Code | Hiyerarşik sıralama ile Kategori Kodu | ELECT > CELLPHN > SMRTPDH | ZORUNLU |
4. | Category Name | Hiyerarşik sıralama ile Kategori Adı | Elektronik > Cep Telefonu > Akıllı Telefonlar | ZORUNLU |
5. | Brand | Marka Adı | iPhone, Samsung | ZORUNLU |
6. | Is Active | 0 veya 1 | ZORUNLU | |
7. | Inventory | Toplam Stok Miktarı | ZORUNLU | |
8. | Original Price | Orijinal Fiyat | USD, EUR, TRY, RUB, GB | ZORUNLU |
9. | Discounted Price | İndirimli Fiyat | USD, EUR, TRY, RUB, GB | ZORUNLU |
10. | Product URL | Ürünün yer aldığı link | ZORUNLU | |
11. | Small Image URL | Ürün Resmi URL (Küçük) | ZORUNLU | |
12. | Medium Image URL | Ürün Resmi URL (Orta) | ZORUNLU | |
13. | Large Image URL | Ürün Resmi URL (Büyük) | ZORUNLU | |
14. | Rating | Kullanıcı Değerlendirmeleri | ZORUNLU | |
15. | Original Price Currency | Orijinal Fiyat Para Birimi | USD, EUR, TRY, RUB, GB | ZORUNLU |
16. | Discount Price Currency | İndirimli Fiyat Para Birimi | USD, EUR, TRY, RUB, GB | ZORUNLU |
17. | Same Day Delivery | Aynı Gün Teslimat. 0 veya 1 | ZORUNLU | |
18. | Free Delivery | Ücretsiz Kargo. 0 veya 1 | ZORUNLU | |
19. | Number of Comments | Yorum Sayısı | ZORUNLU | |
20. | Discount Ratio | İndirim Oranı | ZORUNLU | |
21. | Attribute 1 | OPSIYONEL | ||
22. | Attribute 2 | OPSIYONEL | ||
23. | Attribute 3 | OPSIYONEL | ||
24. | Attribute 4 | OPSIYONEL | ||
25. | Attribute 5 | OPSIYONEL | ||
26. | Color | Renk | OPSIYONEL | |
27. | Material | Malzeme | OPSIYONEL | |
28. | ItemGroupID | 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. | OPSIYONEL | |
29. | Gender | Cinsiyet Bilgisini içeren kolon Erkek için M, Kadın için F, Boş değer için NULL(boşluk) kullanınız. | OPSIYONEL | |
30. | Age Group | Yaş Grubu | OPSIYONEL | |
31. | Commentator | Yorumcu | OPSIYONEL | |
32. | Comment | Yorum | OPSIYONEL | |
33. | Gifts | OPSIYONEL | ||
34. | Attribute 6 | OPSIYONEL | ||
35. | Attribute 7 | OPSIYONEL | ||
36. | Attribute 8 | OPSIYONEL | ||
37. | Attribute 9 | OPSIYONEL | ||
38. | Attribute 10 | OPSIYONEL |
){kind=link}
Tüm sütunlar bir değerle tanımlanmalıdır. Bir kolonun bir değeri yoksa, boş bir değerle tanımlanması gerekir.
İlk 20 kolon zorunludur. Onları kullanmayacak olsanız bile, ilk 20 kolon için noktalı virgül eklemelisiniz. İndirim Oranı kolonundan sonraki kolonlar opsiyoneldir.
Boş bırakılmaması gereken kolonlar: Product Code, Category Code, Category Name, Inventory, Original Price, Discounted Price, Product URL, Original Price Currency.
Image kolonlarından (Small Image URL, Medium Image URL, Large Image URL) en az birinde, ürün resminin geçerli bir URL'i bulunmalıdır.
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:
Ayarlar ikonu > Personalization Center > Recommendation > Product Integration yolunu izleyiniz.
Oluşturduğunuz CSV dosyası için URL girin.
URL'yi ve dosyayı doğrulamak için aşağıdaki adımları izleyin.
Test Detaylarında herhangi bir hata bulunmuyorsa Save URL butonunu tıklayın.
Ü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.
Üst menüden Recommend > Product Catalog yolunu izleyerek, ürün dosyasıyla aktarılan ürünleri görüntüleyebilirsiniz.
1.2. Ürün Dosyası#XML Kullanarak
Ürün dosyasını Google Product Feed XML kullanarak RMC'ye göndermek istiyorsanız, Google standartlarını takip etmeniz gerekir.
RMC Segment Raporlamasını düzgün şekilde çalıştırmak için aşağıdaki etiketler <item> veya <product> etiketlerinin içinde olmalıdır.
Örnek bir XML dosyası indirmek ve görüntülemek için tıklayınız.
Tags | Açıklama |
|---|---|
<product_code> | Ürün Kodu |
<product_name> | Ürün Adı |
<category_code> | Kategori Kodu |
<category_name> | Kategori Adı |
<brand> | Marka Adı |
<is_active> | |
<inventory> | Toplam Stok Miktarı |
<original_price> | Orijinal Fiyatı |
<discounted_price> | İndirimli Fiyatı |
<product_url> | |
<small_image> | |
<medium_image> | |
<large_image> |
Copyright 2020 Related Digital