# T-Soft

T-Soft kurulumu
Kaynak: https://selwise.com/docs/platforms/tsoft

T-Soft mağazalarında Selwise kurulumu. T-Soft için hazır bir dataLayer eşlemesi ve hazır bir besleme eşlemesi yoktur; ama Selwise mağazanın sepet tutarını temanın kendi değişkenlerinden okur. Bu sayfa neyin kendiliğinden geldiğini ve neyi sizin göndermeniz gerektiğini ayrı ayrı yazar.

## 1. Script kurulumu

T-Soft panelinde tema ya da özel kod alanına, **her sayfada** ve kapanış `body` etiketinden önce çalışacak şekilde parçayı ekleyin. Alan adı T-Soft sürümüne göre değişir. `SITE_KEY` yerine **Kanallar → Kanal Özeti → Setup** (Channels → Channel Overview) bölümündeki anahtarı yazın.

```html
<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>
```

Sipariş tamamlama sayfasında da yüklü olduğunu o sayfanın konsolunda `window.Selwise` yazarak doğrulayın. **Verify Now** ham HTML'e baktığından etiket sunucuda basılmalıdır; JavaScript ile sonradan eklenen etiket görülmez.

## 2. Veri katmanı ayarı

**Ayarlar → Entegrasyonlar → Data Layer Configuration** (Settings → Integrations) ekranında **Enable Data Layer** (Data Layer'ı Etkinleştir) anahtarını açın; varsayılan kapalıdır ve kapalıyken hiçbir otomatik olay gelmez. **E-commerce Platform Preset** olarak **T-Soft** seçin ve **Save Changes** ile kaydedin. Platformu açıkça seçmek, aşağıdaki sepet okumasının çalışması için de şarttır. Ön ayar T-Soft için yalnızca ürün sayfası ayırt edicilerini ekler (`[data-product-id]`, `[data-stock-code]`, `.product-detail`); olay eşlemesi taşımaz.

## Hangi veri nereden gelir

| Veri | Kaynağı |
|---|---|
| Sayfa görüntüleme | Otomatik |
| Ürün görüntüleme | Otomatik: sayfadan ürün kodu okunur (`Product` şemalı JSON-LD, `data-stock-code`, `data-product-code`, `data-product-id`) |
| Sayfa türü | URL desenleri ve sayfa ayırt edicileri; Türkçe yollar için aşağıdaki desenleri girin |
| Sepete ekleme ve çıkarma olayı | Kendiliğinden **gelmez**; `window.selwiseLayer.push` ile gönderin |
| Sepet tutarı | **Okunur**: temanın `window.CART_COUNT` ve `window.CART_TOTAL` değişkenleri (para birimi `CURRENCY`, `TL` ise `TRY` sayılır) |
| Kullanıcı kimliği | `Selwise.identify` ([Kimliklendirme](/docs/integration/identify)) |
| Arama terimi | Selwise araması açıksa kendisi kaydeder; yoksa `search_query` olayını gönderin |
| Sipariş | `trackOrder` |

### Sepet tutarı

Hedef çubuğu ve "ücretsiz kargoyu tamamla" şeridi sepetin tamamını ister. T-Soft'ta Selwise bunu istek atmadan, temanın başlıkta gösterdiği `CART_COUNT` ve `CART_TOTAL` değişkenlerinden okur (biçimli metin olarak gelen `1.234,56` gibi tutarı sayıya çevirir). Değişkenler temanızda yoksa sepet ölçülmez. Durumu **Kanallar → Kanal Özeti** (Channels → Channel Overview) sayfasındaki **Cart value** satırı gösterir. Ayrıntı: [Hedef Çubuğu](/docs/widgets/goal-bar).

### Sayfa türü desenleri

Panelin varsayılan desenleri `/urun/`, `/kategori/`, `/sepet`, `/odeme`, `/arama` gibi Türkçe yolları tanımaz ve **platform seçimi bunları değiştirmez**. **Page Type Patterns** (Sayfa Türü Desenleri) alanlarına, mağazanızın gerçek adreslerine göre doğrulayarak şunları yazın:

```text
Product:  \/(urun|product)\/
Category: \/(kategori|category)\/
Search:   \/(arama|search)
Checkout: \/(odeme|checkout)
Cart:     \/(sepet|cart)
Account:  \/(hesabim|account)
```

### Sepet olayları

Sepete ekleme ve çıkarma T-Soft'ta kendiliğinden gelmez: temanın sepet kodundan [sepet olaylarını](/docs/platforms/install-and-verify#sepet-olayları) gönderin. Sepet tutarı yukarıdaki değişkenlerden okunur.

## 3. Sipariş takibi

Sipariş onay sayfasına [ortak sipariş parçasını](/docs/platforms/install-and-verify#sipariş-onay-sayfası) ekleyin; yalnızca ödeme başarıyla tamamlandığında basılan sayfaya.

## 4. Sepete ekleme (öneri ve arama kartı)

Öneri ve arama formunda sepet platformu olarak **T-Soft** seçin. Selwise sepet API'sini çağırmaz; sayfada **o ürünün kendi kutucuğundaki** ekle düğmesine ya da formuna tıklar. Ürünün kutucuğu sayfada yoksa ekleme sessizce başarısız olur; ürün koduyla ilişkisi olmayan genel bir düğmeye ise yanlış ürünü eklememek için hiç tıklanmaz.

## 5. Ürün beslemesi

**Katalog → Ürün Beslemesi** (Catalog → Product Feed) ekranında besleme adresini girin ve alan eşlemesini kontrol edin: [Besleme Kurulumu](/docs/product-feeds/setup), [Alan Eşleme](/docs/product-feeds/field-mapping). İki alana dikkat edin:

- **Ürün kodu**, siparişte gönderdiğiniz kodla aynı olmalıdır.
- **Liste fiyatı**, indirim oranının hesaplanması için gerekir.

## İmzalı kimlik

Bu platformun şablon dili müşteri numarasını sunucuda imzalayamadığı için kanal **Report** (Raporla) modunda kalır; **Enforce** modunu açmayın. Kanal yine korunur: bir tarayıcı bir günde çok sayıda farklı müşteri numarasıyla tanıtılamaz, müşterinin kayıtlı e-postası imzasız bir çağrıyla değişmez ve yeni bağlanmış bir tarayıcı müşterinin mevcut iletişim adresinin yerine geçemez. Bkz. [İmzalı Kimlik](/docs/integration/identity-verification).

## Kontrol listesi

- [ ] Script tüm sayfalarda, **Verify Now** geçti
- [ ] **Enable Data Layer** açık, ön ayar **T-Soft**
- [ ] Sayfa türü desenleri girildi
- [ ] **Cart value** satırı ölçüldü diyor (hedef çubuğu kullanıyorsanız)
- [ ] Siparişler **Orders** satırında; ürün kodları eşleşiyor
- [ ] Besleme senkronize
- [ ] Öneri kartından sepete ekleme test modunda çalışıyor

Doğrulama yolları: [Kurulum ve Doğrulama](/docs/platforms/install-and-verify#kurulumu-doğrulama).