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:
- İçerikleri çizer: kampanyalar, öneri şeritleri, arama, zenginleştirme blokları.
- Davranışı ölçer: sayfa görüntüleme, ürün görüntüleme, sepet, satın alma ve diğer olaylar.
- 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şen | Ne işe yarar | Nerede ç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 toplar | Selwise sunucularında |
| Dashboard | Kampanya, öneri, segment, zenginleştirme ve senaryo tanımlarsınız; analitiği görürsünüz | selwise.com/dashboard |
| Sunucunuz (isteğe bağlı) | Sunucu taraflı render, sunucudan sipariş ve olay, izin senkronizasyonu | Sizin 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:
| Konu | Sayfa |
|---|---|
| Olay gönderimi | Olay Gönderimi |
| Sipariş | Sipariş API'si |
| Müşteri kimliği | Kullanıcı Kimliklendirme API'si |
| Arama | Arama API'si |
| Öneriler | Öneri API'si |
| Zenginleştirme | Zenginleştirme API'si |
| Çerez onayı, pazarlama izni, bülten | Onay ve Bülten API'si |
| Ürün beslemesi gönderme | Besleme 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ı
- Kanal oluşturun ve kanal anahtarını alın. Bkz. Kanal Ekleme, Kanal Anahtarı.
- Script'i ekleyin.
client.js'i tüm sayfalara yerleştirin. Bkz. Widget Kurulumu. - Alan adını doğrulayın. Doğrulanmadan içerik çizilmez ve olaylar kaydedilmez. Bkz. Alan Adı Doğrulama.
- 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ı.
- Ürün katalogunu bağlayın. Ürün olaylarındaki
productItemCodeile beslemenizdekiitem_codebirebir aynı olmalı. Bkz. Ürün Beslemeleri. - Sipariş takibini bağlayın. Bkz. Sipariş Takibi.
- Müşteri kimliklendirmeyi bağlayın. Bkz. Kullanıcı Kimliklendirme.
- Onay yönetimini yapılandırın. KVKK/GDPR gerekiyorsa. Bkz. Onay Yönetimi.
- Modülleri açın. Kampanya, öneri, arama, zenginleştirme.
- İ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
