Kurulum ve Doğrulama
Kurulum sırası, sayfa türü desenleri, doğrulama
Her platformda aynı sıra geçerlidir. Bu sayfa kurulum sırasını, platform seçiminin üç yerini, sayfa türü desenlerini ve kurulumun çalıştığını nasıl doğrulayacağınızı toplar. Hangi platformun neyi kendiliğinden yaptığı için Platformlar karşılaştırmasına, kendi platformunuzun ayrıntısı için ilgili platform sayfasına bakın.
Kurulum sırası
- Kanallar (Channels) ekranında kanalı oluşturun ve Kanallar → Kanal Özeti → Setup (Channels → Channel Overview) bölümündeki kod parçasını alın. Site anahtarı
sk_ile başlar ve 24 onaltılık karakter taşır. - Parçayı platformunuzun sayfasında yazan yere, tüm sayfalara ekleyin.
- Verify Now düğmesine basın. Doğrulama, ana sayfanın ham HTML'inde
data-site-keydeğerini arar; etiketi yalnızca bir etiket yöneticisi sayfa yüklendikten sonra ekliyorsa görmez. Ayrıntı: Domain Doğrulama. - Ayarlar → Entegrasyonlar → Data Layer Configuration (Settings → Integrations) ekranında Enable Data Layer anahtarını açın, E-commerce Platform Preset (E-ticaret Platform Ön Ayarı) alanından platformunuzu seçin ve Save Changes ile kaydedin.
- Sepeti okunmayan bir platformdaysanız sepet olaylarını gönderin; sipariş onay sayfasına sipariş parçasını ekleyin.
- Ürün beslemesini bağlayın: Katalog → Ürün Beslemesi (Catalog → Product Feed). Bkz. Besleme Kurulumu.
- Öneri ya da arama ayarında sepet platformunu seçin ve sepete eklemeyi test modunda deneyin.
Platform üç yerde seçilir
| Alan | Nerede | Ne yapar |
|---|---|---|
| E-commerce Platform Preset | Data Layer Configuration | Mağazanın veri katmanı adlarını ve ürün sayfası ayırt edicilerini belirler; IdeaSoft ve Akinon için olay eşlemesini yükler |
| E-commerce Platform (E-ticaret Platformu) | Öneri formu, sepet bölümü | Karttaki sepete ekle düğmesinin hangi sepetle konuşacağını belirler |
| Cart Platform (Sepet Platformu) | Arama formu | Aynısı, arama sonuçları için |
Yeni bir öneri widget'ında sepet platformu, kanalın veri katmanı platformuyla doldurulur.
Auto Detect ile açıkça seçmek aynı şey değildir
Auto Detect (Otomatik Algıla), veri katmanı kodunun platformu sayfadan tanımasını sağlar. Mağazanın kendi sepetini okuyan hedef çubuğu ise yalnızca kanalın ön ayarında platform açıkça seçiliyse çalışır. Platformunuz listedeyse otomatik algılamaya güvenmeyin, seçin. Varsayılan değer Generic'tir ve hiçbir platforma özgü davranış getirmez.
Sayfa türü
Sayfa türü (ürün, kategori, sepet, ödeme, arama, hesap) iki yerde belirlenir: önce sayfanın URL'i Page Type Patterns (Sayfa Türü Desenleri) ile, sonra sayfanın kendisi (gövde sınıfı, Product şemalı JSON-LD ve platformun ürün sayfası ayırt edicileri) ile karşılaştırılır. IdeaSoft ayrıca kendi yönlendirici değişkenini önce okur.
Panel, boş bırakılan bir deseni varsayılanla doldurur ve platform seçimi bu desenleri değiştirmez. Varsayılanlar /products/, /cart, /checkout, /search gibi İngilizce yolları tanır; /urun/, /sepet, /odeme, /arama gibi Türkçe yolları tanımaz. Türkçe yollu bir mağazada kategori, sepet ve arama sayfalarını tanımak için desenleri platform sayfasındaki değerlerle doldurun. Hangi sayfa türünün nasıl bulunduğunu doğrulamak için Ayarlar → Entegrasyonlar → Data Layer Configuration → View Events (Settings → Integrations) listesinde page_view olaylarına bakın.
Sepet olayları
Hazır veri katmanı eşlemesi olmayan platformlarda (Ticimax, T-Soft, ikas) sepete ekleme ve çıkarma kendiliğinden gelmez; hangi platformun sepeti nasıl okuduğu Platformlar karşılaştırmasında yazar. Bu platformlarda, sepete ekleme ya da çıkarma başarıyla tamamlandığında mağazanın kendi sepet kodundan şunu çağırın:
<script>
window.selwiseLayer = window.selwiseLayer || [];
window.selwiseLayer.push({
event: 'add_to_cart',
basket: {
step: 'add',
currency: 'TRY',
total: 299.8,
itemCount: 2,
products: [{ sku: 'URUN_KODU', quantity: 1, price: 149.9 }]
}
});
</script>
total, sepetteki tüm ürünlerin indirimler düşülmüş tutarıdır (kargo hariç). Sepet tutarını kendisi okuyamayan bir platformda (Ticimax, ikas) göndermezseniz sepet ölçülmüş sayılmaz ve hedef çubuğu çizilmez.- Çıkarma için
event: 'remove_from_cart'vestep: 'remove'yazın. sku, beslemedeki ürün kodu (item_code) ile aynı olmalıdır.
Tüm zarflar: Veri Katmanı.
Sipariş onay sayfası
Hazır sipariş okuyucusu olmayan her platformda siparişi siz gönderirsiniz. Parçayı yalnızca ödeme başarıyla tamamlandığında basılan sipariş onay sayfasına ekleyin ve değerleri platformun şablon değişkenleriyle doldurun:
<script>
window.Selwise.trackOrder({
orderId: 'SIPARIS_NO',
currency: 'TRY',
total: 1299.9,
items: [
{ productItemCode: 'URUN_KODU', name: 'Ürün adı', quantity: 1, unitPrice: 1299.9 }
]
});
</script>
orderIdzorunludur;idya daproductIdyazarsanız Selwise onları okumaz.- Aynı sipariş numarası ikinci kez gelirse yok sayılır; sayfanın yenilenmesi çift sipariş yazmaz.
productItemCode, beslemedeki ürün kodu ile aynı olmalıdır; değilse ürün bazlı rakamlar boş kalır.
Panelde birkaç gerçek siparişin Orders satırında göründüğünü doğrulamadan kurulumu tamamlanmış saymayın. Ayrıntı: Sipariş Takibi.
Kurulumu doğrulama
- Mağaza sayfasının kaynağında (
view-source)data-site-keydeğerini arayın; yoksa Verify Now geçmez. - Mağazanın konsolunda
localStorage.setItem('selwise_debug', 'true')yazıp sayfayı yenileyin; Selwise konsola ne yaptığını yazar. ArdındanSelwise.explain()hazırlanmış ama sayfaya konmamış yüzeyleri nedenleriyle listeler. Channel Overview sayfasındaki Debug Mode kartı bu satırları kopyalamanız içindir; bayrak mağazanın kendi tarayıcı deposunda tutulduğu için panelden açılamaz. - Birkaç sayfa gezip Channel Overview sayfasında Data flow satırına bakın: seçili gün penceresindeki olay sayısı görünür; son olay eskiyse kurulumun bozulmuş olabileceği uyarısı çıkar.
- Ayarlar → Entegrasyonlar → Data Layer Configuration → View Events (Settings → Integrations) ekranı gerçek zamanlı olayları kaynak ve doğrulama sonucuyla listeler.
- Bir test siparişi verin; Orders satırında ve sipariş listesinde görünmelidir.
Sorun çıkarsa: Takip Sorunları ve Widget Görünmüyor.
Son güncelleme: 15 Kasım 2026
