# Kurulum ve Doğrulama

Kurulum sırası, sayfa türü desenleri, doğrulama
Kaynak: https://selwise.com/docs/platforms/install-and-verify

Her platformda aynı sıra geçerlidir. Bu sayfa kurulum sırasını, platform seçiminin üç yerini, sayfa türü desenlerini ve kurulumun çalıştığını nasıl doğrulayacağınızı toplar. Hangi platformun neyi kendiliğinden yaptığı için [Platformlar](/docs/platforms/overview) karşılaştırmasına, kendi platformunuzun ayrıntısı için ilgili platform sayfasına bakın.

## Kurulum sırası

1. **Kanallar** (Channels) ekranında kanalı oluşturun ve **Kanallar → Kanal Özeti → Setup** (Channels → Channel Overview) bölümündeki kod parçasını alın. Site anahtarı `sk_` ile başlar ve 24 onaltılık karakter taşır.
2. Parçayı platformunuzun sayfasında yazan yere, **tüm sayfalara** ekleyin.
3. **Verify Now** düğmesine basın. Doğrulama, ana sayfanın ham HTML'inde `data-site-key` değerini arar; etiketi yalnızca bir etiket yöneticisi sayfa yüklendikten sonra ekliyorsa görmez. Ayrıntı: [Domain Doğrulama](/docs/channels/domain-verification).
4. **Ayarlar → Entegrasyonlar → Data Layer Configuration** (Settings → Integrations) ekranında **Enable Data Layer** anahtarını açın, **E-commerce Platform Preset** (E-ticaret Platform Ön Ayarı) alanından platformunuzu seçin ve **Save Changes** ile kaydedin.
5. Sepeti okunmayan bir platformdaysanız [sepet olaylarını](#sepet-olayları) gönderin; sipariş onay sayfasına [sipariş parçasını](#sipariş-onay-sayfası) ekleyin.
6. Ürün beslemesini bağlayın: **Katalog → Ürün Beslemesi** (Catalog → Product Feed). Bkz. [Besleme Kurulumu](/docs/product-feeds/setup).
7. Öneri ya da arama ayarında sepet platformunu seçin ve sepete eklemeyi test modunda deneyin.

## Platform üç yerde seçilir

| Alan | Nerede | Ne yapar |
|---|---|---|
| **E-commerce Platform Preset** | Data Layer Configuration | Mağazanın veri katmanı adlarını ve ürün sayfası ayırt edicilerini belirler; IdeaSoft ve Akinon için olay eşlemesini yükler |
| **E-commerce Platform** (E-ticaret Platformu) | Öneri formu, sepet bölümü | Karttaki sepete ekle düğmesinin hangi sepetle konuşacağını belirler |
| **Cart Platform** (Sepet Platformu) | Arama formu | Aynısı, arama sonuçları için |

Yeni bir öneri widget'ında sepet platformu, kanalın veri katmanı platformuyla doldurulur.

> **Auto Detect ile açıkça seçmek aynı şey değildir**
>
> **Auto Detect** (Otomatik Algıla), veri katmanı kodunun platformu sayfadan tanımasını sağlar. Mağazanın kendi sepetini okuyan hedef çubuğu ise yalnızca kanalın ön ayarında platform **açıkça** seçiliyse çalışır. Platformunuz listedeyse otomatik algılamaya güvenmeyin, seçin. Varsayılan değer **Generic**'tir ve hiçbir platforma özgü davranış getirmez.

## Sayfa türü

Sayfa türü (ürün, kategori, sepet, ödeme, arama, hesap) iki yerde belirlenir: önce sayfanın URL'i **Page Type Patterns** (Sayfa Türü Desenleri) ile, sonra sayfanın kendisi (gövde sınıfı, `Product` şemalı JSON-LD ve platformun ürün sayfası ayırt edicileri) ile karşılaştırılır. IdeaSoft ayrıca kendi yönlendirici değişkenini önce okur.

Panel, boş bırakılan bir deseni varsayılanla doldurur ve **platform seçimi bu desenleri değiştirmez**. Varsayılanlar `/products/`, `/cart`, `/checkout`, `/search` gibi İngilizce yolları tanır; `/urun/`, `/sepet`, `/odeme`, `/arama` gibi Türkçe yolları tanımaz. Türkçe yollu bir mağazada kategori, sepet ve arama sayfalarını tanımak için desenleri platform sayfasındaki değerlerle doldurun. Hangi sayfa türünün nasıl bulunduğunu doğrulamak için **Ayarlar → Entegrasyonlar → Data Layer Configuration → View Events** (Settings → Integrations) listesinde `page_view` olaylarına bakın.

## Sepet olayları

Hazır veri katmanı eşlemesi olmayan platformlarda (Ticimax, T-Soft, ikas) sepete ekleme ve çıkarma kendiliğinden gelmez; hangi platformun sepeti nasıl okuduğu [Platformlar](/docs/platforms/overview) karşılaştırmasında yazar. Bu platformlarda, sepete ekleme ya da çıkarma başarıyla tamamlandığında mağazanın kendi sepet kodundan şunu çağırın:

```html
<script>
  window.selwiseLayer = window.selwiseLayer || [];
  window.selwiseLayer.push({
    event: 'add_to_cart',
    basket: {
      step: 'add',
      currency: 'TRY',
      total: 299.8,
      itemCount: 2,
      products: [{ sku: 'URUN_KODU', quantity: 1, price: 149.9 }]
    }
  });
</script>
```

- `total`, sepetteki **tüm** ürünlerin indirimler düşülmüş tutarıdır (kargo hariç). Sepet tutarını kendisi okuyamayan bir platformda (Ticimax, ikas) göndermezseniz sepet ölçülmüş sayılmaz ve hedef çubuğu çizilmez.
- Çıkarma için `event: 'remove_from_cart'` ve `step: 'remove'` yazın.
- `sku`, beslemedeki ürün kodu (`item_code`) ile aynı olmalıdır.

Tüm zarflar: [Veri Katmanı](/docs/integration/data-layer).

## Sipariş onay sayfası

Hazır sipariş okuyucusu olmayan her platformda siparişi siz gönderirsiniz. Parçayı **yalnızca ödeme başarıyla tamamlandığında** basılan sipariş onay sayfasına ekleyin ve değerleri platformun şablon değişkenleriyle doldurun:

```html
<script>
  window.Selwise.trackOrder({
    orderId: 'SIPARIS_NO',
    currency: 'TRY',
    total: 1299.9,
    items: [
      { productItemCode: 'URUN_KODU', name: 'Ürün adı', quantity: 1, unitPrice: 1299.9 }
    ]
  });
</script>
```

- `orderId` zorunludur. `id`, `productId` / `sku` ve `price` yazılırsa Selwise onları `orderId`, `productItemCode` ve `unitPrice`'a çevirir; yine de doğru adları yazın.
- Aynı sipariş numarası ikinci kez gelirse yok sayılır; sayfanın yenilenmesi çift sipariş yazmaz.
- `productItemCode`, beslemedeki ürün kodu ile aynı olmalıdır; değilse ürün bazlı rakamlar boş kalır.

Panelde birkaç gerçek siparişin **Orders** satırında göründüğünü doğrulamadan kurulumu tamamlanmış saymayın. Ayrıntı: [Sipariş Takibi](/docs/integration/order-tracking).

## Kurulumu doğrulama

1. Mağaza sayfasının kaynağında (`view-source`) `data-site-key` değerini arayın; yoksa **Verify Now** geçmez.
2. Mağazanın konsolunda `localStorage.setItem('selwise_debug', 'true')` yazıp sayfayı yenileyin; Selwise konsola ne yaptığını yazar. Ardından `Selwise.explain()` hazırlanmış ama sayfaya konmamış yüzeyleri nedenleriyle listeler. **Channel Overview** sayfasındaki **Debug Mode** kartı bu satırları kopyalamanız içindir; bayrak mağazanın kendi tarayıcı deposunda tutulduğu için panelden açılamaz.
3. Birkaç sayfa gezip **Channel Overview** sayfasında **Data flow** satırına bakın: seçili gün penceresindeki olay sayısı görünür; son olay eskiyse kurulumun bozulmuş olabileceği uyarısı çıkar.
4. **Ayarlar → Entegrasyonlar → Data Layer Configuration → View Events** (Settings → Integrations) ekranı gerçek zamanlı olayları kaynak ve doğrulama sonucuyla listeler.
5. Bir test siparişi verin; **Orders** satırında ve sipariş listesinde görünmelidir.

Sorun çıkarsa: [Takip Sorunları](/docs/troubleshooting/tracking-issues) ve [Widget Görünmüyor](/docs/troubleshooting/widget-not-showing).
