Özel Platform

Selwise, hazır bir entegrasyonu olmayan ya da özel geliştirilmiş herhangi bir e-ticaret platformuyla çalışır. Bu sayfa platform bağımsız kurulum reçetesini verir: script, ticari olaylar, sipariş, kimlik, onay ve gerekiyorsa sunucu taraflı çağrılar. Platformunuz hazır listedeyse (Akinon, Ticimax, T-Soft, ikas, IdeaSoft, Shopify) önce Platformlar sayfasına bakın.

Genel reçete

1. Kanal oluşturun ve alan adını doğrulayın. Bkz. Kanal Ekleme, Alan Adı Doğrulama.
2. Script'i her sayfaya ekleyin. client.js'i tüm şablonlara yerleştirin: Widget Kurulumu.
3. Ürün katalogunu bağlayın. Ürün olaylarındaki kod, beslemedeki item_code ile eşleşmelidir: Ürün Beslemeleri.
4. Ticari olayları gönderin. Otomatik yakalama yeterli değilse veri katmanıyla.
5. Sipariş takibini bağlayın. Teşekkür sayfasında trackOrder.
6. Müşteriyi kimliklendirin. Giriş yapan kullanıcı için identify.
7. Doğrulayın: Takip Sorunları.

1. Script

<link rel="preconnect" href="https://widget.selwise.com" crossorigin>
<link rel="preconnect" href="https://api.selwise.com" crossorigin>
<script>window.Selwise=window.Selwise||{};window.Selwise.q=window.Selwise.q||[];['track','trackOrder','identify','setTraits','pushDataLayer','grantConsent','revokeConsent','showConsentPreferences','withdrawConsent','endJourney'].forEach(function(m){if(!window.Selwise[m])window.Selwise[m]=function(){window.Selwise.q.push([m,arguments])}});</script>
<script async src="https://widget.selwise.com/client.js" data-site-key="SITE_KEY"></script>

Platformunuz için hazır bir veri katmanı profili yoksa Selwise onu generic olarak ele alır ve sayfa görüntülemelerini otomatik yakalar. Ürün ve sepet olayları temanıza bağlıdır; standart dışıysa aşağıdaki gibi manuel gönderin. Sayfa türü (ürün, kategori, sepet ...) tespiti URL desenlerine ve sayfa işaretlerine dayanır: Veri Katmanı Ayarları.

2. Ticari olayları 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ı, olay adları için Event Referansı 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 (sepetin tamamının tutarını total ile verin; hedef çubuğu gibi yüzeyler yalnızca ölçülmüş bir sepetle çizilir):

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

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

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>

Alanlar ve tekilleştirme: Sipariş Takibi.

4. Kimliklendirme

Giriş yapmış kullanıcının sayfa şablonuna kimliğini yazabiliyorsanız:

<script>
  window.Selwise?.identify('MUSTERI-1001', { email: 'ayse@example.com' });
</script>

Kimlik, siparişte kullandığınız müşteri kimliğiyle aynı olmalıdır: Kullanıcı Kimliklendirme.

5. Onay

Kendi çerez çözümünüz varsa kararını grantConsent() ve revokeConsent() ile Selwise'e bildirin: Onay Yönetimi.

6. İsteğe bağlı: sunucu taraflı render

Özel bir platformda sunucu şablonlarını siz yazdığınız için ürün sayfasına zenginleştirme içeriğini HTML'de basabilirsiniz; PHP, Node, Next.js ve Django örnekleri hazırdır: Sunucu Taraflı Render Örnekleri.

Sunucu tarafı (headless)

Tarayıcı tarafına erişiminiz yoksa (mikroservis mimarisi, kendi mobil uygulamanız) olay ve siparişleri doğrudan public HTTP API ile gönderin. Bu durumda Origin başlığı göndermeyin; başlıksız istek ve x-selwise-api-key (kapsam mobile_read/mobile_write) kullanın. Sırasıyla: Kimlik Doğrulama ve Erişim, Olay Gönderimi, Sipariş API'si, Kullanıcı Kimliklendirme API'si. Kendi sisteminizin olaylarından senaryo başlatmak için İş Olayları.