Entegrasyona Genel Bakış

Entegrasyon mimarisi ve sıralama

Bu rehber, Selwise'i bir e-ticaret sitesine ya da mobil uygulamaya uçtan uca entegre etmek için gereken her şeyin haritasıdır: script kurulumundan ölçüme, sipariş ve gelire, arama ve önerilere, sunucu taraflı render'a ve doğrudan HTTP çağrılarına kadar. Her konunun ayrıntısı kendi sayfasındadır; burası hangi sayfayı ne zaman okuyacağınızı söyler.

Selwise nedir

Selwise; kampanya ve widget yönetimi, ürün önerileri, site içi arama, ürün zenginleştirme, segmentasyon, A/B test, senaryo ve davranışsal analitiği tek platformda birleştiren bir e-ticaret kişiselleştirme platformudur. Müşterinin yapılandırdığı birim bir kanaldır: bir web sitesi (<script> etiketiyle) ya da bir mobil uygulama (@selwise/react-native ile). Bkz. Kanal Türleri.

Sitenize eklediğiniz tek bir hafif script (client.js) üç işi birden yapar:

  1. İçerikleri çizer: kampanyalar, öneri şeritleri, arama, zenginleştirme blokları.
  2. Davranışı ölçer: sayfa görüntüleme, ürün görüntüleme, sepet, satın alma ve diğer olaylar.
  3. Kişiselleştirir: segment ve deney atamalarına göre içeriği ve önerileri ziyaretçiye özelleştirir.

Ana script'in gzip boyutu 50 KB'nin altında tutulur (bugün yaklaşık 25 KB); arama, öneri ve diğer parçalar yalnızca o özellik açıksa ayrı parçalar olarak indirilir.

Mimari

BileşenNe işe yararNerede çalışır
Client script (client.js)İçerik çizimi ve olay ölçümüZiyaretçinin tarayıcısında
Public API (/api/v1/public/...)İçerik servis eder; olay, sipariş, kimlik ve onay toplarSelwise sunucularında
DashboardKampanya, öneri, segment, zenginleştirme ve senaryo tanımlarsınız; analitiği görürsünüzselwise.com/dashboard
Sunucunuz (isteğe bağlı)Sunucu taraflı render, sunucudan sipariş ve olay, izin senkronizasyonuSizin altyapınızda
 Ziyaretçi tarayıcısı                           Selwise sunucusu
┌───────────────────────────┐                  ┌───────────────────────────┐
│ Siteniz + client.js        │   1. yapılandırma │ Public API (/api/v1)      │
│                            │ ───────────────▶ │ GET  .../config           │
│ içerik çizimi              │ ◀─────────────── │                           │
│                            │   2. ölçüm        │                           │
│ olaylar (toplu)  ──────────┼───────────────▶ │ POST .../events/batch     │
│ sipariş  ──────────────────┼───────────────▶ │ POST .../orders           │
└───────────────────────────┘                  └───────────────────────────┘
        ▲                                                    ▲
        │ sayfa HTML'i (içerik içinde)                       │ x-selwise-api-key
 ┌──────┴────────────────┐                                   │
 │ Sizin uygulama sunucunuz ├───────────────────────────────┘
 └─────────────────────────┘   sunucu taraflı render, sipariş, izin

Neyi nerede kullanmalısınız

Entegrasyonda dört seviye vardır. İhtiyacınıza göre birini ya da hepsini kullanabilirsiniz.

1. Otomatik: script ve veri katmanı

Script'i eklediğinizde Veri Katmanı devreye girer. Sayfa görüntüleme, ürün görüntüleme ve (birçok platformda) sepet olayları otomatik yakalanır. Sitenizde zaten bir window.dataLayer (GTM) varsa Selwise bunu dinleyip olayları kendi kanonik biçimine çevirir; purchase olayı varsa siparişi de kaydeder. Bkz. Veri Katmanı, Veri Katmanı Ayarları, Event Referansı.

2. Manuel: JavaScript API

Otomatik yakalanamayan durumlar için window.Selwise API'si kullanılır: müşteri tanımlama (identify), sipariş (trackOrder), özel olay (track), onay (grantConsent). Bkz. JavaScript API, Kullanıcı Kimliklendirme, Sipariş Takibi, Onay Yönetimi.

3. Sunucu taraflı render

Zenginleştirme içeriğinin JavaScript çalıştırmayan istemcilere (arama motoru botları, yapay zekâ botları, bağlantı önizlemeleri) de görünmesi için içerik sizin sunucunuzda HTML'e basılır. Bkz. Sunucu Taraflı Render, Örnekler, API.

4. Headless: doğrudan HTTP

Mobil uygulama, sunucu entegrasyonu ya da kendi arayüzünüz için public HTTP uçları doğrudan çağrılır. Hangi uca hangi kimlikle gidileceği Kimlik Doğrulama ve Erişim sayfasında, uç dizini Public API sayfasındadır. Ailelere göre:

KonuSayfa
Olay gönderimiOlay Gönderimi
SiparişSipariş API'si
Müşteri kimliğiKullanıcı Kimliklendirme API'si
AramaArama API'si
ÖnerilerÖneri API'si
ZenginleştirmeZenginleştirme API'si
Çerez onayı, pazarlama izni, bültenOnay ve Bülten API'si
Ürün beslemesi göndermeBesleme Gönderme
Kendi sisteminizin olayından senaryo başlatmaİş Olayları
Hatalar, hız sınırlarıHatalar ve Sınırlar

Mobil uygulamada bu çağrıları hazır SDK yapar: Mobil SDK.

Entegrasyon yol haritası

  1. Kanal oluşturun ve kanal anahtarını alın. Bkz. Kanal Ekleme, Kanal Anahtarı.
  2. Script'i ekleyin. client.js'i tüm sayfalara yerleştirin. Bkz. Widget Kurulumu.
  3. Alan adını doğrulayın. Doğrulanmadan içerik çizilmez ve olaylar kaydedilmez. Bkz. Alan Adı Doğrulama.
  4. Otomatik ölçümü doğrulayın. Debug modunu açıp sayfa ve ürün olaylarının aktığını görün. Bkz. Takip Sorunları.
  5. Ürün katalogunu bağlayın. Ürün olaylarındaki productItemCode ile beslemenizdeki item_code birebir aynı olmalı. Bkz. Ürün Beslemeleri.
  6. Sipariş takibini bağlayın. Bkz. Sipariş Takibi.
  7. Müşteri kimliklendirmeyi bağlayın. Bkz. Kullanıcı Kimliklendirme.
  8. Onay yönetimini yapılandırın. KVKK/GDPR gerekiyorsa. Bkz. Onay Yönetimi.
  9. Modülleri açın. Kampanya, öneri, arama, zenginleştirme.
  10. İsteğe bağlı: sunucu taraflı render, sunucudan sipariş, izin senkronizasyonu.

Hızlı yol

Yalnızca hızlıca başlamak istiyorsanız Hızlı Başlangıç sayfası 5 dakikalık özet sunar. Bu bölüm ise referans niteliğinde, eksiksiz entegrasyon rehberidir. Platformunuz için hazır kurulum: Platformlar.

Son güncelleme: 9 Ekim 2026