Metinde Sepet ve Ürün Değerleri

Kampanya metnine o anki sepetin ya da ürünün değerlerini (sepet tutarı, ürün adı, fiyat, stok) yazan değerler. Hangi durumda hangi içeriğin gösterileceği için Koşullu İçerik.

Değer ekleme

Başlık, metin ve buton metni alanlarının altındaki Değer ekle satırından sepet ve ürün değerleri eklenebilir; temel içerikte de, bir durumun metninde de çalışır.

Sepet değerleri

Değer	Ne yazar	Örnek
{cart.total}	Sepet tutarı, kanalın para birimiyle	₺650
{cart.itemCount}	Sepetteki ürün adedi	2

Örnek: "Sepetinizde {cart.itemCount} ürün var, {cart.total} tutarındaki siparişinizi tamamlayın." Sepet değiştikçe canlı değişen tiplerde metin sayfa yenilenmeden güncellenir.

Bu değerler, widget sepetin tamamını bildiğinde söylenir. Sepetin nasıl ölçüldüğü için bkz. Hedef Çubuğu. Önizleme örnek bir sepetle (2 ürün) çizilir.

Ürün değerleri

Ürün değerleri ziyaretçinin baktığı ürünü anlatır ve yalnızca ürün sayfasında söylenir:

Değer	Ne yazar	Örnek	Ne zaman söylenir
{product.title}	Ürünün adı	Kırmızı ruj	Katalogda adı varsa
{product.price}	Ürünün şimdiki fiyatı	₺899	Fiyatı sıfırdan büyükse
{product.originalPrice}	İndirimden önceki fiyat	₺1.200	Ürün indirimdeyse
{product.discountAmount}	İndirim tutarı (önceki fiyat eksi şimdiki fiyat)	₺301	Ürün indirimdeyse
{product.discountRate}	İndirim yüzdesi, aşağı yuvarlanır	%25	Ürün en az %1 indirimdeyse
{product.stock}	Stoktaki adet	3	Stok biliniyorsa ve sıfırdan büyükse

Örnekler: "Bu üründe {product.discountAmount} tasarruf", "Son {product.stock} ürün", "{product.title} sepetinde bekliyor".

Değerler kanalınızın ürün kataloğundan, yani ürün beslemenizden gelir; son besleme senkronizasyonu kadar günceldir. Widget bunları ürün sayfası başına tek bir istekle okur ve bu isteği yalnızca o sayfayı hedefleyen bir kampanya ürün değeri ya da ürün koşulu kullanıyorsa yapar. Ürünün kodu sayfadan, ürün zenginleştirmenin okuduğu yerden okunur; katalogda bulunamayan bir ürün için değer söylenmez.

Fiyat sayfanın kendisinden. Ürün sayfası yapılandırılmış verisinde (JSON-LD'deki tek teklifin price alanı ya da Open Graph product:price:amount etiketi) ürünün fiyatını açıkça yazıyorsa {product.price} bu fiyatı söyler; mağazanızın panelinde değişen bir fiyat beslemeden önce sayfaya ulaşır. Bu fiyat katalogdakinden farklıysa önceki fiyat yalnızca sayfadaki fiyattan hâlâ yüksekse kullanılır; değilse önceki fiyat, indirim tutarı ve indirim yüzdesi söylenmez ve indirim cümlesi alternatifine geçer. Böylece bir cümlede iki farklı kaynaktan gelen fiyat yan yana çıkmaz. Birden fazla teklif (varyant) listeleyen, binlik ayırıcı ya da virgüllü ondalık kullanan ("1.299,90") veya katalogdan farklı bir para birimi yazan sayfa fiyatı okunmaz; o durumda katalog fiyatı geçerlidir.

Ürün indirimde değilse (indirimsiz fiyatı yoksa ya da şimdiki fiyattan yüksek değilse) önceki fiyat, indirim tutarı ve indirim yüzdesi söylenmez. "Önceki fiyat ₺899" yanında "₺899" yazmak olmayan bir indirimi duyurmak olurdu.

Ürün değeri kullanan kampanyayı Kurallar adımında Sayfa türleri altından Ürün seçerek ürün sayfalarına sınırlayın. Başka bir sayfada ürün olmadığı için bu değerler hiçbir zaman söylenmez; kampanyayı oralarda yarışmaya sokmak boşunadır.

Değer yoksa

Bir değer söylenemiyorsa ziyaretçi hiçbir zaman ham süslü parantez ya da boş bir yer görmez:

1. Değer bir durumun metnindeyse o durum atlanır. Koşulları sağlanan sıradaki duruma, hiçbiri kalmazsa temel içeriğe geçilir.
2. Değer temel içerikteyse ve önünde söylenebilen bir durum yoksa kampanya o ziyaretçiye gösterilmez.

Bu yüzden değer içeren cümleyi bir duruma, her zaman söylenebilecek cümleyi temel içeriğe yazmak alternatif bir cümle vermenin yoludur:

1. Temel metin: "Bugün sipariş verene kargo bedava".
2. Durum ekle ile "İndirimli ürün" adında bir durum açın. Durumun en az bir koşulu olmalıdır; her ziyaretçiye uyan bir koşul seçin, örneğin Sayfa görüntüleme (bu oturum) ≥ 1.
3. Durumun Duyuru Metni alanına "Bu üründe {product.discountAmount} tasarruf" yazın.

İndirimdeki bir üründe ziyaretçi "Bu üründe ₺301 tasarruf" görür; indirimde olmayan bir üründe durum atlanır ve "Bugün sipariş verene kargo bedava" görünür. Aynı yol sepet değerleri için de geçerlidir: sepeti ölçülmemiş bir ziyaretçi, sepet tutarını söyleyen durumu değil temel metni görür.

Ürün değerleri sayfa açıldıktan kısa süre sonra gelir. O ana kadar ürün değeri bekleyen kampanya çizilmez; önce temel metni gösterip sonra değiştirmez. Değerler gelince kampanya aynı sayfada çizilir.

Bu değerler, widget'ın bunları tanıyan sürümünü çalıştıran ziyaretçilere gönderilir. Tarayıcısında eski sürüm önbellekte kalmış bir ziyaretçi, güncellenene kadar bu kampanyayı görmez. Ürün değerleri, sepet değerlerinden sonra gelen bir sürümle eklendi; sepet değerlerini tanıyan ama ürün değerlerini tanımayan bir sürüm yalnızca ürün değeri kullanan kampanyaları görmez. Ürün koşulları da aynı şekilde daha yeni bir sürümle geldi: ürün koşulunu tanımayan eski bir sürüm o kuralı yok sayıp kampanyayı daha geniş bir kitleye gösterirdi, bu yüzden bir durumunda ya da hedeflemesinde ürün koşulu olan kampanya o sürüme hiç gönderilmez.