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ı

  1. 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.
  2. Parçayı platformunuzun sayfasında yazan yere, tüm sayfalara ekleyin.
  3. Verify Now düğmesine basın. Doğrulama, ana sayfanın ham HTML'inde data-site-key değerini arar; etiketi yalnızca bir etiket yöneticisi sayfa yüklendikten sonra ekliyorsa görmez. Ayrıntı: Domain Doğrulama.
  4. 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.
  5. Sepeti okunmayan bir platformdaysanız sepet olaylarını gönderin; sipariş onay sayfasına sipariş parçasını ekleyin.
  6. Ürün beslemesini bağlayın: Katalog → Ürün Beslemesi (Catalog → Product Feed). Bkz. Besleme Kurulumu.
  7. Öneri ya da arama ayarında sepet platformunu seçin ve sepete eklemeyi test modunda deneyin.

Platform üç yerde seçilir

AlanNeredeNe yapar
E-commerce Platform PresetData Layer ConfigurationMağ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 formuAynı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' ve step: '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>
  • orderId zorunludur; id ya da productId yazarsanı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

  1. Mağaza sayfasının kaynağında (view-source) data-site-key değerini arayın; yoksa Verify Now geçmez.
  2. Mağazanın konsolunda localStorage.setItem('selwise_debug', 'true') yazıp sayfayı yenileyin; Selwise konsola ne yaptığını yazar. Ardından Selwise.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.
  3. 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.
  4. Ayarlar → Entegrasyonlar → Data Layer Configuration → View Events (Settings → Integrations) ekranı gerçek zamanlı olayları kaynak ve doğrulama sonucuyla listeler.
  5. 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