# Entegrasyona Genel Bakış

Entegrasyon mimarisi ve sıralama
Kaynak: https://selwise.com/docs/integration/overview

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](/docs/channels/channel-types).

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ş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 |

```text
 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ı](/docs/integration/data-layer), [Veri Katmanı Ayarları](/docs/integration/data-layer-settings), [Event Referansı](/docs/integration/events).

### 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](/docs/integration/javascript-api), [Kullanıcı Kimliklendirme](/docs/integration/identify), [Sipariş Takibi](/docs/integration/order-tracking), [Onay Yönetimi](/docs/integration/consent).

### 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](/docs/product-enrichment/server-side), [Örnekler](/docs/product-enrichment/server-side-recipes), [API](/docs/api-reference/ssr-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](/docs/api-reference/authentication) sayfasında, uç dizini [Public API](/docs/api-reference/public-api) sayfasındadır. Ailelere göre:

| Konu | Sayfa |
| --- | --- |
| Olay gönderimi | [Olay Gönderimi](/docs/api-reference/events-ingest) |
| Sipariş | [Sipariş API'si](/docs/api-reference/orders-api) |
| Müşteri kimliği | [Kullanıcı Kimliklendirme API'si](/docs/api-reference/identify-api) |
| Arama | [Arama API'si](/docs/api-reference/search-api) |
| Öneriler | [Öneri API'si](/docs/api-reference/recommendations-api) |
| Zenginleştirme | [Zenginleştirme API'si](/docs/api-reference/enrichment-api) |
| Çerez onayı, pazarlama izni, bülten | [Onay ve Bülten API'si](/docs/api-reference/consent-newsletter-api) |
| Ürün beslemesi gönderme | [Besleme Gönderme](/docs/api-reference/feeds) |
| Kendi sisteminizin olayından senaryo başlatma | [İş Olayları](/docs/integration/business-events) |
| Hatalar, hız sınırları | [Hatalar ve Sınırlar](/docs/api-reference/errors-and-limits) |

Mobil uygulamada bu çağrıları hazır SDK yapar: [Mobil SDK](/docs/mobile/overview).

## Entegrasyon yol haritası

1. **Kanal oluşturun ve kanal anahtarını alın.** Bkz. [Kanal Ekleme](/docs/channels/adding-channels), [Kanal Anahtarı](/docs/channels/channel-key).
2. **Script'i ekleyin.** `client.js`'i tüm sayfalara yerleştirin. Bkz. [Widget Kurulumu](/docs/integration/widget-installation).
3. **Alan adını doğrulayın.** Doğrulanmadan içerik çizilmez ve olaylar kaydedilmez. Bkz. [Alan Adı Doğrulama](/docs/channels/domain-verification).
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ı](/docs/troubleshooting/tracking-issues).
5. **Ürün katalogunu bağlayın.** Ürün olaylarındaki `productItemCode` ile beslemenizdeki `item_code` birebir aynı olmalı. Bkz. [Ürün Beslemeleri](/docs/product-feeds/overview).
6. **Sipariş takibini bağlayın.** Bkz. [Sipariş Takibi](/docs/integration/order-tracking).
7. **Müşteri kimliklendirmeyi bağlayın.** Bkz. [Kullanıcı Kimliklendirme](/docs/integration/identify).
8. **Onay yönetimini yapılandırın.** KVKK/GDPR gerekiyorsa. Bkz. [Onay Yönetimi](/docs/integration/consent).
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ıç](/docs/getting-started/quickstart) sayfası 5 dakikalık özet sunar. Bu bölüm ise referans niteliğinde, eksiksiz entegrasyon rehberidir. Platformunuz için hazır kurulum: [Platformlar](/docs/platforms/overview).
