Salesforce Commerce'a Beden Widget Ekleme Rehberi

Salesforce B2C Commerce (SFCC) başlatmaları nadir olarak widget'ın çalışmamasından başarısız olur — başarısız olur çünkü iki kimse staging-to-production yolundan sorumlu değildir ve bir değişiklik isteği bir sandbox'ta altı hafta bekler. Bir enterprise mağazaya beden önerisi ekleme, JavaScript problemi değil, sürüm yönetimi problemidir. Yönetim kurallarını doğru ayarlar ve teknik entegrasyon kolay kısımdır.

Salesforce Commerce Cloud'u (eski adıyla Demandware) çalıştıran çoğu moda markasının çok katmanlı ortamı vardır: geliştirme, staging ve production örnekleri, genellikle merchandising ekipleri için ayrı bir UAT sandbox'ıyla. Bir beden önerisi widget'ı cartridge bağımlılıklarını, ISML şablon kalıtımını veya SFCC'nin varsayılan olarak uyguladığı CSP başlıklarını kırmadan hepsinde çalışmalıdır. Bu yazı iki entegrasyon yolunu, enterprise ekiplerinin gerçekten kullandığı QA kontrol listesini ve production'a kod dokunmadan önce kimin imzalaması gerektiğini anlatır.

Cartridge vs Embed: İki Meşru Yol

SFCC, üçüncü taraf bir boyutlandırma widget'ı eklemek için iki gerçekçi seçenek sunar ve doğru seçim teknolojiye göre değil, ekibinizin sürüm verme hızına göre daha fazla bağlıdır.

Özel bir cartridge, "yerli" SFCC yoludur: Business Manager aracılığıyla dağıtılan ve mağazanızın cartridge yolunda bulunan kontrolörleri ve ISML şablonlarını referans alan paketlenmiş bir modül. Bu, caching davranışı, sunucu tarafındaki veriler (SKU, beden tablosu, envanter) widget'a aktarılan ve mevcut extension kalıplarıyla tutarlılık üzerinde daha sıkı kontrol sağlar. Değiş tokuş, dağıtım sürtünmesidir — widget davranışında veya konfigde her değişiklik potansiyel olarak CI/CD ardışık düzeniniz aracılığıyla ve sürüm takviminizdeki bir kod dağıtımı gerektirir.

İstemci tarafı embed — bir script etiketi ve ürün detay sayfası (PDP) şablonunda bir mount noktası — daha hızlı sevk etmek ve daha kolay yinelemek için daha hızlıdır çünkü widget güncellemeleri YourSizer tarafından SFCC kod tabanına dokunmadan sevk edilir. Değiş tokuş, sunucu tarafından işlenen veriler üzerinde daha az kontrol ve CSP ve Page Designer konfigürasyonunuzun harici script ve iframe kaynaklarına izin verdiğine bağımlılıktır.

Çoğu enterprise ekibi, işletme durumunu kanıtladıktan sonra bir cartridge'e taşınmadan önce PDP şablonlarının bir alt kümesinde etki doğrulamak için bir embed ile başlar — uyumlu bir iş durumu oluşturmayı yapılandırma hakkında bilgi için beden teknolojisi için bir iç iş durumu nasıl oluşturulur bölümüne bakın.

İçerik Güvenlik Politikası ve CSP Tuzağı

SFCC'nin varsayılan CSP konfigürasyonu, çoğu satıcının bir widget sessizce render edilmekte başarısız olana kadar fark ettiğinden daha katıdır. Script veya iframe kaynağınız Business Manager'ın CSP ayarlarında açıkça beyaz listeye alınmamışsa (Merchant Tools > SEO > CSP veya SFCC sürümünüze bağlı olarak daha yeni Page Designer güvenlik konfigürasyonu), tarayıcı konsolunda engellenmiş kaynak hatası gösterecek ancak PDP'nin kendisi normal şekilde render edilecektir — bu da QA'nın devtools kontrol etmiyorsa kolayca kaçırabilmesi anlamına gelir.

Herhangi bir dağıtımdan önce, SFCC yöneticinizle üç şeyi onaylayın: script-src yönergesi widget'ın barındırma alanını içerir, frame-src veya child-src yönergesi iframe tabanlı bir embed kullanıyorsanız iframe kaynağına izin verir ve connect-src, widget'ın beden önerileri için yaptığı API çağrılarına izin verir. Bu, başlatma günü geri dönüşü önleyen beş dakikalık bir kontrol.

Staging Disiplini: Canlı Geçişten Önce Ne Test Edilmeli

Bir beden widget'ı PDP'ye dokunur, bu sitenizin en yüksek trafikli, en yüksek gelirli şablonudur — başlatmayı bir badge veya banner ekleme gibi değil, checkout değişikliği ile aynı titizlikle işleyin.

Enterprise SFCC ekiplerinin tipik olarak çalıştırdığı staging kontrol listesi şunları içerir:

• Widget'ın dokunduğu her mağazada locale ve döviz rendering'i, SFCC çok siteli kurulumları genellikle tek kod tabanından beş fazla locale hizmet ettiğinden.
• Ürün türü başına beden tablosu doğruluğu — bir kategori için yanlış beden tablosunu okuyan ancak güvenle tavsiye eden bir widget, hiç widget'ından daha kötüdür.
• Mobil PDP düzeni, SFRA referans mimarisi PDP bileşenlerini kesme noktaları arasında farklı şekilde render ettiğinden ve kötü kapsamlı bir embed içeriği fold altına itebilir.
• Sayfa yükleme etkisi, SEO ekibinizin zaten kullandığı aynı Core Web Vitals araçlarıyla ölçülmüş, çünkü yavaş yüklenen bir widget, sunmak için tasarlandığı dönüşüm artışını dengeleyebilir — richer widget'lar ve yükleme zamanı arasındaki değiş tokuş için sanal deneme dönüşüm oranlarını artırır bölümüne bakın.
• Widget API zaman aşımı yapıyorsa veya ürünün hiç beden tablosu eşlemesi yoksa fallback davranışı, böylece PDP kesilen durum göstermek yerine zarif şekilde kötüleşir.

Bunu sadece manuel tıklamadan geçiş değil, production benzeri trafik simülasyonu ile staging örneğinde çalıştırın — enterprise merchandising ekipleri genellikle locale hatalarını yalnızca gerçek eşzamanlı yük altında yakalar.

Yönetim: Kimin Onaylamak ve Ne Zaman

Teknik başlatma bir SFCC beden widget'ı projesinin en kısa kısmıdır; onay zinciri genellikle uzun çubuğu. Tipik bir enterprise onay sırası ecommerce platform ekibini (CSP, performans, cartridge incelemesi), merchandising veya UX ekibini (beden tablosu eşleme doğruluğu, kategori kapsamı), yasal veya gizlilik (herhangi bir beden ölçümü verisi toplanırsa, beden sadece beden ölçüsü akışı için öyle olmamalıdır) ve SFCC sürüm takvimine dağıtımı yerleştiren bir sürüm yöneticisini içerir.

Başlatmadan önce bir açık rollback sahibi belirleyin — cartridge'i devre dışı bırakabilen veya dakika içinde embed script'ini çekebilen Business Manager erişimi olan biri. İadeler ve uyum verileri, finans için önemli olan aşağı akış sinyalleridir; başlatmayı moda markaları için bir iade gerçek maliyeti açısından çerçeveleme, UX tek sunuşundan daha hızlı bütçe ve yasal onay sağlama eğilimindedir.

YourSizer'ın Yerleştiği Yer

YourSizer, Salesforce Commerce Cloud'da hem entegrasyon yolunu destekler: ekiplerin günler içinde PDP'lerin bir alt kümesi üzerinde etki doğrulamak istediği hafif bir embed ve rollout kanıtlandıktan sonra sunucu tarafındaki veriler ve caching üzerinde daha sıkı kontrol gereken ekipler için cartridge tabanlı dağıtım. Beden önerisi mantığı, hangi yoldan olursa olsun SFCC sürüm döngüsünden bağımsız çalışır, bu nedenle beden tablosu eşlemelerinde veya tavsiye eşikleri üzerinde yinelemek, sürüm treniniz aracılığıyla bir kod dağıtımı gerektirmez. Enterprise ekipleri için, staging sırasında CSP konfigürasyonu, locale kapsamı ve fallback davranışını doğrulamak için platform ve merchandising paydaşlarıyla doğrudan çalışırız — herhangi birşey production'a ulaşmadan önce yukarıda özetlenen aynı kontrol listesi, teslim edilmiş yerine ortak olarak çalıştırılmış.

Sıkça Sorulan Sorular

Beden önerisi widget'ı tam bir SFCC cartridge gerektiriyor mu, yoksa bir script embed olarak çalışabilir mi?

Her ikisi de çalışır ve doğru seçim ne kadar sunucu tarafındaki kontrol gerektiği ve ekibinizin ne kadar hızlı yinelemek istediğine bağlıdır. Bir embed başlatmak daha hızlı ve SFCC sürüm takviminizden bağımsız olarak güncellemek daha kolaydır, cartridge ise sunucu tarafından işlenen veriler üzerinde daha fazla kontrol sağlar ve zaten Business Manager dağıtımları aracılığıyla çoğu extension'ı yöneten ekiplere uyum sağlar. Çoğu ekip, iş durumunun doğrulanmasından sonra bir cartridge'e taşınmadan önce etki kanıtlamak için bir embed ile başlar.

Tipik bir SFCC beden widget'ı başlatması başlangıçtan production'a kadar ne kadar sürer?

PDP'lerin bir alt kümesinde doğrulanan embed tabanlı entegrasyon için, ekipler genellikle iki ila dört hafta içinde production'a ulaşır, çoğu gerçek kodlamadan ziyade CSP konfigürasyonu, staging QA ve paydaş onayıdır. Cartridge tabanlı dağıtım, genellikle kuruluşunuzun değişiklik yönetimi sürecine bağlı olarak aylık veya üç aylık bir döngüde çalışabilen mevcut SFCC sürüm treninize yerleşmesi gerektiğinden daha uzun sürer.

Widget canlı bir ürün sayfasında yüklenirse ne olur?

İyi yapılandırılan bir entegrasyon, PDP'nin sayfayı kırmak veya add-to-cart'ı engellemek yerine normal şekilde widget olmadan render etmesi anlamında zarif şekilde kötüleşmelidir. Bu, kasıtlı olarak test etmeye değer staging kontrolleridir — başlatmadan sonra değil, başlatmadan önce bir API zaman aşımı veya eksik beden tablosu eşlemesi simüle edin, çünkü hata modu yalnızca QA'ın varsayılan olarak yeniden üretmediği koşullar altında görünür.

Beden önerisi widget'ı eklemek için yasal veya gizlilik onayı gerekli mi?

Ürüne ve beden tablosu verilerine dayanan beden ölçüsü önerisi, kamera tabanlı sanal deneme gibi vücut taramaları veya depolanan biyometrik ölçümlere dayanmayan gizlilik sorularını yükseltir. Yine de, çoğu enterprise yönetim süreci, PDP'ye eklenen herhangi bir üçüncü taraf script için standart bir adım olarak gizlilik incelemesi gerektirir, bu nedenle onu saf bir mühendislik kararı olarak işlemek yerine yasal bilgileri erken dahil etmeye değer — deneme'deki vücut veri gizliliği için daha geniş bağlam için deneme: alışveriş yapanlar ve düzenleyiciler gerçekten ne ararlar bölümüne bakın.

Sonuç

Salesforce Commerce Cloud'da cartridge ve embed arasındaki teknik fark iyi anlaşılmış; daha zor kısım, kuruluşunuzun gerçek sürüm takvimini, CSP politikasını ve aylar boyunca duraksıyorsa onay zincirini sürdüren bir başlatma süreci oluşturmaktır. PDP değişikliğini checkout seviyesi titizliği ile işleyen ekipler — açık rollback mülkiyeti, locale'ler arasında staging disiplini ve başlangıçtan önce kabul edilen yönetim yolu — çeyrekler yerine haftalar içinde sevk etme eğilimindedir ve bu disiplin aynı platform'da bir uyum özelliği hayata geçmesi gereken bir sonraki sefer yeniden ödeme sağlar.