Ozel Platform

Ozel entegrasyon

Selwise, hazır bir entegrasyonu olmayan veya özel geliştirilmiş herhangi bir e-ticaret platformuyla çalışır. Bu sayfa, platform bağımsız kurulum reçetesini verir.

Genel reçete

  1. Script'i her sayfaya ekleyinclient.js'i tüm şablonlara yerleştirin. Bkz. Widget Kurulumu.
  2. Domain'i doğrulayın — Bkz. Domain Doğrulama.
  3. Ticari event'leri gönderin — Otomatik yakalama yeterli değilse veri katmanıyla manuel gönderin.
  4. Sipariş takibini bağlayın — Teşekkür sayfasında trackOrder çağırın.

1. Script

<script
  src="https://widget.selwise.com/client.js"
  data-site-key="SITE_KEY"
></script>

Selwise platformunuzu generic olarak ele alır ve sayfa görüntülemelerini otomatik yakalar. Ürün ve sepet event'leri temanıza bağlıdır; standart dışıysa aşağıdaki gibi manuel gönderin.

2. Ticari event'leri veri katmanıyla gönderin

En güvenilir yöntem, her önemli olayda window.selwiseLayer.push() çağırmaktır. Tüm zarflar ve alanlar için Veri Katmanı sayfasına bakın.

Ürün detay sayfasında:

<script>
  window.selwiseLayer = window.selwiseLayer || [];
  window.selwiseLayer.push({
    event: 'product_view',
    product: {
      sku: 'SUNUCUDAN_GELEN_SKU',
      title: 'Ürün Adı',
      price: 149.90,
      category: 'Kategori',
      currency: 'TRY',
    },
  });
</script>

Sepete ekleme butonunda:

<script>
  document.querySelector('#add-to-cart')?.addEventListener('click', function () {
    window.selwiseLayer.push({
      event: 'add_to_cart',
      basket: {
        step: 'add',
        currency: 'TRY',
        products: [{ sku: 'SKU-123', quantity: 1, price: 149.9 }],
      },
    });
  });
</script>

Kategori, arama, ödeme adımları için ilgili olayları aynı şekilde gönderin: category_view, search_query, checkout_begin, checkout_progress.

Mevcut dataLayer'ınız varsa

Sitenizde GA4/GTM için zaten bir window.dataLayer varsa, Selwise bunu otomatik dinleyip olayları dönüştürebilir (varsayılan olarak açık). Bu durumda çoğu event'i tekrar göndermeniz gerekmez. Bkz. Veri Katmanı — Harici dataLayer köprüsü.

3. Sipariş takibi

Sipariş onay sayfasında, sunucudan gelen gerçek verilerle:

<script>
  window.Selwise?.trackOrder({
    orderId: 'ORDER_12345',
    currency: 'TRY',
    total: 129.90,
    items: [
      { productItemCode: 'SKU-001', name: 'Ürün', quantity: 1, unitPrice: 129.90 },
    ],
  });
</script>

Sunucu tarafı (headless)

Tarayıcı tarafına erişiminiz yoksa (örn. mikroservis mimarisi), event ve siparişleri doğrudan public HTTP API ile gönderin. Bu durumda Origin başlığı yerine x-selwise-api-key kullanın. Bkz. Public API.

productItemCode tutarlılığı

Hangi yöntemi kullanırsanız kullanın, productItemCode / sku değerinin ürün beslemenizdeki stok koduyla birebir aynı olması gerekir. Bu, tüm ürün bazlı raporların ve önerilerin doğru çalışmasının ön koşuludur.

Son güncelleme: 1 Temmuz 2026

Bu makale yardimci oldu mu?