# Eş Anlamlılar

Farklı yazımları eşleştirin
Kaynak: https://selwise.com/docs/search/synonyms

Eş anlamlılar, ziyaretçinin yazdığı terimi kataloğunuzdaki kelimelerle eşleştirir. "Telefon" arayan birinin "cep telefonu" ürünlerini bulmasını sağlar.

## Panelde nerede

**Kişiselleştirme → Arama → Content → Search Synonyms** (Personalization → Search) (Overview sekmesindeki **Synonyms** kartı da aynı ekrana gider). Sayfanın sağ üstündeki **Add Synonym Group** yeni grup açar; liste **All**, **Active**, **Inactive** süzgeçleriyle ve arama kutusuyla daraltılır.

## Bir grubun alanları

| Alan | Açıklama |
|---|---|
| **Synonym Type** (Eş Anlamlı Türü) | **Equivalent (bidirectional)** ya da **One-way (source to targets)** |
| **Terms (comma-separated)** (Terimler) | Virgülle ayrılmış en az **2 farklı** terim. Terimler küçük harfe çevrilip kaydedilir, tekrarlar birleştirilir; "Telefon" ile "telefon" tek terimdir. |
| **Source Term** (Kaynak Terim) | Yalnızca tek yönlüde. Ziyaretçinin yazdığı terim; **Terms** listesindeki terimlerden biri olmalı. En fazla 100 karakter. |

Her grubun bir açma/kapama anahtarı, düzenle ve sil düğmeleri vardır. Gruplar kanala özeldir ve sözleşmenizdeki sınıra (hesabın tüm kanalları toplamı) sayılır; sınıra gelince **Add Synonym Group** kapanır ve bir uyarı bandı çıkar.

## İki tip

### Eşdeğer (Equivalent)

Listedeki tüm terimler birbirinin yerine geçer. Hangisini yazarsa yazsın aynı sonuçlar döner.

```
Terms: telefon, cep telefonu, akıllı telefon, smartphone
```

Bu grupta "smartphone" arayan da "telefon" arayan da aynı ürünleri görür.

### Tek yönlü (One-way)

Bir kaynak terim, diğer terimlere genişletilir; ama tersi olmaz. Kaynak terimi hem **Terms** listesine hem **Source Term** alanına yazarsınız:

```
Terms:       ayakkabı, bot, spor ayakkabı, sandalet
Source Term: ayakkabı
```

"Ayakkabı" arayan botları, spor ayakkabıları ve sandaletleri de görür; "bot" arayan yalnızca botları görür. Listede kaynak ile hedef terimler okla (kaynak → hedefler) gösterilir.

> **Tek yönlü neden gerekli**
>
> Genelden özele giden ilişkilerde eşdeğer kullanmak yanlış sonuç üretir: "bot" arayan birinin sandalet görmesini istemezsiniz. Kapsayan terim kaynak, kapsanan terimler hedef olur.

## Nasıl uygulanır

Eş anlamlı, sorgunun **içindeki kelimeyi** o kelimenin karşılığıyla değiştirir; sorguyu tümüyle başka bir şeyle değiştirmez. Ziyaretçinin kendi yazdığı hâl de aranmaya devam eder (iki seçenekten biri yeter). Örnek: yukarıdaki tek yönlü grup varken "kırmızı ayakkabı" araması "kırmızı ayakkabı", "kırmızı bot", "kırmızı spor ayakkabı" ve "kırmızı sandalet" ifadelerinden birini arar; "kırmızı" kelimesi hepsinde şart olarak kalır.

- Eşleşme **tam kelimedir**: `oje` için tanımlı bir eş anlamlı `ojeli` kelimesine dokunmaz.
- Eş anlamlı devreye girdiğinde çok kelimeli sorgu **ifade olarak** aranır (kelimeler bitişik ve aynı sırada) — bkz. [Alaka ve Eşleşme](/docs/search/relevance).
- Pasif bir grup uygulanmaz; değişiklik bir sonraki aramada geçerlidir, beklemek gerekmez.
- Yazım hatası toleransı ve Türkçe çekim ekleri ayrı çalışır; [Alaka ve Eşleşme](/docs/search/relevance) sayfasına bakın. Eş anlamlı, bunların kapsamadığı durumlar içindir.

## Ne zaman eklenir

En verimli yol tahmin etmek değil, **veriye bakmaktır**: [Sonuçsuz Aramalar](/docs/search/zero-results) listesi, ziyaretçilerin arayıp bulamadığı terimleri gösterir. Oradaki her terim için satırın **Add Synonym** menüsü, bu ekrana gitmeden küçük bir formla kuralı yazar; kural **tek yönlü** olarak, kaynak terim sorgunun kendisiyle oluşturulur. Overview'daki **Low-Result Action Center**'daki "Add synonym" bağlantısı da bu ekranı, terimi hazır doldurarak açar.

## Tipik gruplar

| Sebep | Örnek |
|---|---|
| Türkçe/İngilizce | `laptop, dizüstü, notebook` |
| Yazım farkı | `tişört, t-shirt, tshirt` |
| Marka/jenerik | `powerbank, taşınabilir şarj` |
| Kısaltma | `tv, televizyon` |
| Yaygın yazım hatası | `bilgisayar, bilgsayar` |

Yazım hatası için çok sayıda eş anlamlı yazmadan önce [yazım hatası toleransına](/docs/search/relevance) bakın: kısa bir ürün adındaki tek harf hatasını arama kendisi bulur.

## Etki göstergesi

Her grubun altında bir tıklama oranı karşılaştırması (`2.1% → 3.4%` gibi) görünür: grubun ilk terimini (tek yönlüde kaynak terimi) içeren aramaların tıklama oranı, grup oluşturulmadan önceki 30 güne karşı sonraki 30 günde. Yeterli arama yoksa "no data" yazar. Bu bir **göstergedir**, kanıt değildir: aynı dönemde başka şeyler de değişmiş olabilir.

## Aktif/pasif

Bir eş anlamlının beklenmedik sonuçlar ürettiğini düşünüyorsanız silmek yerine pasife alın; etkisini geri açmak kolay olur.

## Sınırlar ve hatalar

| Durum | Sonuç |
|---|---|
| 2'den az farklı terim | Kayıt reddedilir (`SEARCH_SYNONYM_TERMS_TOO_FEW`) |
| Tek yönlüde **Source Term** boş | Reddedilir (`SEARCH_SYNONYM_SOURCE_REQUIRED`) |
| **Source Term** **Terms** listesinde yok | Reddedilir (`SEARCH_SYNONYM_SOURCE_NOT_IN_TERMS`) |
| **Source Term** 100 karakterden uzun | `400`; sonuçsuz bir sorgu 255 karakterlik olabilir, bu durumda kuralı elle, kısa bir terimle ekleyin |
| Sözleşme sınırına ulaşıldı | `409` `LIMIT_REACHED`; eskileri silin ya da sınırı yükseltin |
| `search:manage_synonyms` yetkisi yok | `403` |