Boost Kuralı Alanları

Bir sıralama kuralının Raise ve Push down işlemleri, ürünün bir özelliğine bakar: "Marka Nike ise", "İndirim en az 20 ise", "Stokta değilse". Bu sayfa hangi özelliklere bakılabildiğini, her birinin hangi karşılaştırmaları kabul ettiğini ve değerin nasıl eşleştiğini anlatır. Kuralın kendisini yazmak için Boost Kuralları sayfasına bakın.

Panelde nerede

Personalization → Search → Content → Search ranking rules → bir kural → What should it do? adımındaki bir Raise ya da Push down işlemi. Bir işlem soldan sağa Product property (Ürün özelliği), Comparison (Karşılaştırma), Value (Değer) ve Strength (Güç) seçicilerinden oluşur. Pin işlemi bir özelliğe değil, tek bir ürüne bakar.

Hangi özelliklere bakılır

Üç tür özellik vardır ve her biri kendi karşılaştırmalarını kabul eder. Liste kapalıdır: burada olmayan bir özellik seçilemez ve kaydedilemez.

Tür	Özellikler	Karşılaştırmalar
Text (Metin)	Brand, Category, Category path, Product type, Product name, Product code, SKU, Group code	contains, is, is not, starts with, is one of
Number (Sayı)	Price, List price, Discount (%), Stock quantity, Rating, Review count	at least, at most, greater than, less than, is, is not
Yes / no (Evet / hayır)	In stock, New arrival, Bestseller, Has options	is (Yes ya da No)

Özellik türü değişirse (örneğin metinden sayıya) karşılaştırma yeni türe uymadığı için listenin ilki seçilir (metinde contains, sayıda at least, evet/hayırda is) ve değer sıfırlanır; aynı türde başka bir özelliğe geçerseniz karşılaştırma ve değer korunur.

Değerler beslemenizden gelir: Brand, Category, Category path ve Product type için değer kutusu kataloğunuzdaki gerçek değerleri önerir. Product code ve SKU, ürünün kodu ve SKU'sudur; Group code aynı grubun kardeş ürünlerini birleştiren koddur (Varyant Gruplama, Alan Eşleştirme). Özel besleme nitelikleri (kendi tanımladığınız alanlar) sıralama kuralında kullanılamaz.

Değer nasıl eşleşir

Metin özellikleri

• Büyük/küçük harf ve Türkçe karakter farkı iki tarafta da yok sayılır: gomlek yazmak Gömlek kayıtlarını bulur.
• contains ürünün değerinde geçmesine bakar, is birebir eşitlik arar, starts with başlangıcına bakar, is not eşit olmayanları seçer.
• is one of için değerleri virgülle ayırırsınız (Nike, Adidas, Puma); ürünün değeri listedekilerden biriyle birebir aynıysa uyar.
• Boş bir Value, hiçbir ürüne uymaz.
• Category besleme alanının tamamıdır (örneğin Makyaj > Dudak > Ruj); is bu tüm metni ister, çoğu zaman contains ya da Category path + starts with daha doğrudur.
• is not, o alanı boş olan ürünlere de uyar (boş değer, "Nike" değildir).

Sayı özellikleri

• Değer bir sayı olmalıdır.
• Ürünün o alanı boşsa (örneğin beslemede stok adedi hiç gelmiyorsa) hiçbir sayı karşılaştırması uymaz — is not dahil. "Stoğu 5'ten az olanları" seçen bir kural, stok bilgisi hiç gelmeyen ürünlere dokunmaz.
• Discount (%) yüzdedir (20 yazın, 0,2 değil).

Evet / hayır özellikleri

• Değer Yes ya da No seçicisidir.
• Beslemede o bayrak hiç gelmemişse ürün ne Yes ne No ile eşleşir.

Sınırlar

Alan	Sınır
Bir kuraldaki işlem sayısı (yükseltme + aşağı itme + sabitleme)	en fazla 20
Raise çarpanı	1,01 – 10
Push down çarpanı	0,01 – 0,99
Position (sabitleme sırası)	1 ya da daha büyük tam sayı
Rule name / Search term	100 / 255 karakter
Priority	tam sayı

Eski kurallar

Bu editörden önce yazılmış kurallar çalışmaya devam eder. Eski kayıtlardaki category, tags (kategori), onSale (indirim oranı) gibi adlar, yeni karşılıklarına okunur; hiçbirine uymayan bir özellik taşıyan bir işlem kartta "çalışamıyor" uyarısıyla işaretlenir. Kuralı düzenleyip özelliği yeniden seçin.

Kuralın saklanan biçimi

Kuralları API ile yazıyorsanız (panel de aynı kayıtları gönderir), bir kural şöyle görünür:

{
  "name": "Nike yükselt, stoksuzu it",
  "matchType": "contains",
  "queryPattern": "ayakkabı",
  "priority": 0,
  "boostRules": [
    { "field": "brand", "operator": "equals", "value": "Nike", "boost": 2 }
  ],
  "buryRules": [
    { "field": "inStock", "operator": "equals", "value": false, "weight": 0.2 }
  ],
  "pinRules": [
    { "productId": "SKU-1234", "position": 1 }
  ]
}

• matchType: all (desen gerekmez), exact, contains ya da regex; all dışındaki her biri queryPattern ister.
• field: brand, categories, categoryHierarchy, productType, title, itemCode, sku, groupCode, price, originalPrice, discountRate, stock, rating, reviewCount, inStock, isNew, isBestseller, hasVariants.
• operator: contains, equals, not_equals, starts_with, in_list, gt, gte, lt, lte. Verilmezse metinde contains, sayıda gte (fiyatta lte), evet/hayırda equals okunur.
• Fazladan bir alan göndermek, API'nin kuralı gereği 400 döndürür; hata, hangi özelliğin (örneğin boostRules.1.boost) reddedildiğini adıyla söyler.

Uç nokta: POST /sites/:siteId/search/analytics/boost-rules (oturum açmış kullanıcı ve search:manage_boosts yetkisi gerekir); güncelleme PUT, silme DELETE ile aynı yolun sonuna kural kimliği eklenerek yapılır.