Segmage
Platform Turu Demo Talep Edin

Veri setleri

Şablonların data.<anahtar> ile okuduğu satır listelerini (veri setlerini) tanımlar, dener ve yönetir.

Bir veri seti “hangi kaynaktan, hangi koşullarla, kaç satır” sorularını cevaplar; şablona bağlı ya da firma düzeyinde tutulur ve gönderimde kişi başına çözülür.

Güncellendi: 4 Kasım 20268 dakikalık okuma

Bu sayfada neler yapabilirsiniz?

Veri nereden gelir?

Veri seti kayıtlarıAnahtar, kapsam, tanım JSON’u, sürüm ve aktiflik. Sürümü sunucu yönetir.
Deneme çalıştırmasıTanımı şablondan bağımsız çalıştırır; satırlar, boş nedeni, hata kodu ve çalışan sorgu döner.
İçerik şablonlarıŞablona bağlı veri setinin hangi şablonda okunduğu; şablon başına en çok 16 veri seti.

Terimler

Ekranda geçen kapsam, liste ve boş davranışı adları.

Şablona bağlı
Bir içerik şablonuna bağlıdır; kampanya yayına alınınca şablonla birlikte dondurulur.
Firma düzeyi
Şablonsuz kayıt; durum tanımları ve hesaplanmış veri setleri anahtarıyla okur, kampanya kopyasına girmez.
Kişi başına
Her alıcının kendi satırları vardır (sepet, kişisel öneri, olay).
Herkese aynı liste
Herkese aynı liste döner (genel popüler, katalog, dış veri); boşsa herkes için boştur.
Bu kişiye gönderme
Satır çıkmazsa mesaj o kişiye gitmez.
Bloğu atla
Satır çıkmazsa yalnız bu blok atlanır, mesajın geri kalanı gider.
Yedek listeyle doldur
Satır çıkmazsa tanımdaki yedek liste basılır (yalnız öneri kaynaklarında).
Hesaplanmış üretici
Firma düzeyi tanımı düzenli aralıkla herkes için önceden hesaplayan veri seti.

Veri setini adım adım kurmak

Kılavuzlu görünümde üç adımda amacı, kaynağı ve kayıtları seçer, kaydedersiniz.

  1. Amaç ve kaynak

    Veri setinin mesajda liste için mi, firma düzeyinde mi kullanılacağını ve kayıtların nereden geleceğini seçin. Veri Tablosu seçerseniz tabloyu kartlardan seçin.

  2. Kayıtlar

    Geriye bakış süresini, koşulları, sırayı ve kayıt sayısını seçin. Alttaki denemede Örnek kişi bul ile örnek kişi bulup Çalıştır düğmesine basın.

  3. Boş gelirse ve kaydet

    Kayıt çıkmayan kişide mesaja ne olacağını seçin, ad verin ve Kaydet düğmesine basın. Teknik ad addan kendiliğinden oluşur.

Yeni veri seti oluşturmak

Anahtarı ve kapsamı verin, kaynağı seçin, kaynağın ayarlarını doldurun; kaydetmeden önce deneyin. Bu kılavuz Uzman görünümünü anlatır.

  1. Listeden yeni kayıt açın

    Araç çubuğundaki Yeni veri seti düğmesine basın; oluşturma ekranı açılır.

    Listeden yeni kayıt açın
  2. Anahtarı ve kapsamı verin

    Anahtar alanına şablonun okuyacağı adı yazın. Şablonda kullanılacaksa Şablona bağlı seçip şablonu belirleyin; durum tanımı ya da üretici için Firma düzeyi seçin.

    Anahtarı ve kapsamı verin
    Anahtar projede tekildir; aynı anahtar iki kayıtta olamaz.
  3. Kaynağı seçin

    Kaynak kartlarından birini seçin. Kartın altındaki Kişi başına / Herkese aynı liste etiketi satırların kişiye özel mi herkese aynı mı olduğunu söyler.

    Kaynağı seçin
  4. Kaynağın ayarlarını doldurun

    Satır sayısı ve Sıralama değerlerini verin; gerekiyorsa Koşul ekle ile Koşullar ekleyin. Alanlar seçtiğiniz kaynağa göre değişir.

    Kaynağın ayarlarını doldurun
    Kartın altındaki “Bu kaynakta yok:” satırı bu kaynağın desteklemediği alanları listeler.
  5. Boş gelince ne olacağını seçin

    Boş gelince kartında Bu kişiye gönderme, Bloğu atla ya da Yedek listeyle doldur seçin. Yedek liste yalnız öneri kaynaklarında seçilebilir.

  6. Kaydetmeden deneyin

    Sağdaki Deneme çalıştırması kartında örnek kişiyi seçip Çalıştır düğmesine basın; satırlar, boş nedeni ya da hata görünür. Hiçbir şey kaydedilmez.

    Kaydetmeden deneyin
  7. Durumu seçip kaydedin

    Başlıktaki rozetle Aktif / Pasif arasında geçin ve Kaydet düğmesine basın. Pasif veri seti kampanyaya dondurulmaz.

Bir tanımı denemek

Tanımı seçilen kişi için çalıştırıp sonucu okuyun.

  1. Deneme panelini açın

    Listede satırı seçip Çalıştır ile ya da Düzenle ile açın; panel düzenleme ekranının sağındadır.

  2. Örnek kişiyi seçin

    Örnek kişi alanında ad, e-posta ya da telefonla arayın. Tablo kaynağında Örnek kişi bul tanımın dolu olduğu kişileri getirir.

    Katalog, dış veri ve tetik satırı kaynakları kişi istemez.
  3. Tetik değerlerini ve anı verin

    Tanım @trigger.<alan> okuyorsa Tetik değerleri · isteğe bağlı satırlarına alan ve değer yazın. Çalıştırma anı boşsa sunucunun o anki saati kullanılır.

  4. Sonucu okuyun

    Rozetler satır sayısını, listenin kişiye özel mi paylaşılan mı olduğunu ve boş davranışını gösterir. Sarı not boş ya da eksik nedenini, kırmızı kutu tanımın neden çalışmadığını söyler. Çalışan sorgu (SQL) çalışan sorguyu açar.

Hesaplanmış veri seti kurmak

Gönderim anında çalıştırılamayacak kadar ağır bir tanımı düzenli olarak önceden hesaplatın.

  1. Firma düzeyinde bir tablo ya da olay veri seti açın

    Kapsamı Firma düzeyi yapın ve kaynak olarak Tablo ya da Olay seçin.

  2. Üretimi açın ve aralığı verin

    Düzenli ön hesapla anahtarını açın, Üretim aralığı seçin. Bayat sayılma boşsa aralıktan otomatik hesaplanır.

    Üretimi açın ve aralığı verin
  3. Şablonda okuyan veri setini kurun

    Şablona bağlı yeni bir veri setinde Hesaplanmış kaynağını seçip Üretici alanında üreticinin anahtarını belirleyin. Üreticinin kartındaki Okuyan veri setleri: satırı onu okuyan kayıtları gösterir.

JSON görünümünde düzenlemek

Formda olmayan alanlar (zenginleştirme, küme işlemleri, alt liste, özet değer, birleştirme, yedek tanım) JSON’da yazılır.

  1. JSON görünümüne geçin

    Tanım kartının sağındaki Form / JSON seçiminden JSON seçin.

  2. Tanımı düzenleyin

    Yazdıkça tanım denetlenir; sözdizimi hatası satır ve sütunuyla gösterilir. Kaydette sunucunun denetimleri de alanın altında görünür.

    now(), today(), rand(), random() tanımda kullanılamaz.
  3. Forma dönün

    Form seçince JSON’daki değerler forma aktarılır; formda olmayan alanlar tanımda aynen korunur. Geçersiz JSON’la forma dönülmez.

Kavramlar

Kaynak türü

Satırların hangi veriden geldiğini ve kişiye özel mi herkese aynı mı olduğunu belirler.

Ne zaman: Kişinin kendi hareketi gerekiyorsa tablo / olay / kişisel öneri; herkese aynı blok yeterse katalog / liste önerisi.

Sık hata: Olay adını yanlış büyük/küçük harfle yazmak: hata vermez, 0 satır döner.

Kaynak Tablo ve Tablo basketitem ve Zaman penceresi 30 gün

Son 30 günde sepete eklenen kalemleri kişi başına getirir.

Boş gelince

Kişi için satır çıkmadığında mesajın gidip gitmeyeceğini belirler.

Ne zaman: Blok mesajın konusuysa (sepet hatırlatma) gönderme; ek bir bölümse bloğu atla.

Sık hata: Herkese aynı listede boş sonuç herkes için boştur: gönderme seçiliyse kimseye gitmez.

Boş gelince Bloğu atla

Listesi boş kişiye de mesaj gider; yalnız bu blok çıkmaz.

Yedek liste

Ana kaynakta boş gelen kişiler için aynı istekte bir kez çalışan ikinci tanım.

Ne zaman: Kişisel öneri olmayan yeni kişilere genel popüler liste göstermek için.

Sık hata: Yedeğin kaynağını tablo yapmak: yedek de öneri olmalı ve iç içe tek kat olur.

Kaynak Kişisel öneri ve Boş gelince Yedek listeyle doldur ve fallback reco:list:popular

Önerisi olana kişisel liste, olmayana genel popüler liste basılır.

Tetik değeri

Koşul değeri olarak @trigger.<alan> yazılınca değer gönderimi başlatan olaydan gelir.

Ne zaman: Listenin tetikleyen ürüne ya da kategoriye göre değişmesi gerektiğinde.

Sık hata: Denemede tetik değerini vermemek: tanım “tetik değeri verilmedi” hatası verir.

sourceid eşit @trigger.category

Tetikleyen kategorinin popüler ürünlerini getirir.

Hesaplanmış üretici

Firma düzeyi bir tanım düzenli aralıkla herkes için hesaplanır; şablon hazır satırı computed:<anahtar> ile okur.

Ne zaman: Gönderim anında yavaş kalacak uzun pencereli tablo tanımlarında (ör. 180 günlük harcama).

Sık hata: Üreticiye tetik değeri ya da yedek yazmak: üretici bunları kabul etmez.

Kapsam Firma düzeyi ve Kaynak Tablo ve Üretim aralığı Günde bir

Her gece hesaplanan satırları sabah gönderimi hazır okur.

Şablona bağlı mı, firma düzeyi mi?

Sepet hatırlatma e-postası ve “sepette bekleyen” durum tanımı.

Şablona bağlıŞablonun okuduğu veriŞablon + anahtar → kampanyayla dondurulurE-postanın okuduğu sepet listesi şablona bağlıdır.
Firma düzeyiBaşka tanımların okuduğu veriAnahtar → durum tanımı / üretici okurDurumu ölçen satırlar firma düzeyindedir.

Firma düzeyi kayıt kampanya kopyasına girmez; her değerlendirmede güncel tanım okunur.

Gönderme mi, bloğu atla mı?

Sepet hatırlatması ve haftalık bültendeki öneri bloğu.

Bu kişiye göndermeBlok mesajın kendisiBoş → mesaj gitmezSepeti boş olana hatırlatma gitmez.
Bloğu atlaBlok mesajın bir bölümüBoş → blok çıkar, mesaj giderÖnerisi olmayan bülteni yine alır, öneri bloğu çıkmaz.

Yedek liste seçeneği yalnız öneri kaynaklarında vardır.

Örnek kullanımlar

Sepette bekleyen ürünler

Sepet hatırlatmasında kişinin son 30 günde sepete eklediği 4 ürünü göstermek.

  • Kaynak Tablo, tablo basketitem, zaman penceresi 30 gün.
  • Satır sayısı 4; ürün adı ve görseli için JSON’da enrich ile product360 eklenir.
  • Boş gelince “Bu kişiye gönderme”.

Şablonda data.<anahtar> ile döngü kurun ve kişiyle önizleyin.

Kişisel öneri, yoksa popüler

Bültende herkese bir öneri listesi göstermek; önerisi olmayana genel popüler liste.

  • Kaynak Kişisel öneri, kapsam personal, sıralama Sıra (rank), 4 satır.
  • JSON’da fallback: "source":"reco:list:popular","limit":4.
  • Boş gelince “Yedek listeyle doldur”.

Önerisi olmayan bir kişiyle çalıştırıp “Yedek liste kullanıldı” rozetini görün.

En çok alışveriş yapılan 3 kategori (önceden hesaplı)

Haftalık bültende her alıcıya en çok alışveriş yaptığı 3 kategoriyi hızlıca basmak.

  • Firma düzeyi, kaynak Tablo saleitem, pencere 180 gün, tekilleştir category, 3 satır; “Düzenli ön hesapla” açık, günde bir.
  • Anahtarı top_kategori gibi verip kaydedin.
  • Şablona bağlı ikinci veri setinde kaynak Hesaplanmış, üretici top_kategori, 3 satır, boş gelince Bloğu atla.

İlk üretim tamamlanınca okuyan veri setini kişiyle çalıştırın.

Sık sorulanlar

“Henüz yayında değil” uyarısı neden çıkıyor?

Veri seti kayıt servisi bu ortamda henüz yayına alınmadı. Liste boş açılır, kayıt ve silme yapılamaz; deneme çalıştırması çalışmaya devam edebilir. Servis açılınca ekran kendiliğinden çalışır.

Kaydederken “anahtar başka bir veri setinde kullanılıyor” diyor

Anahtar proje içinde tekildir; şablon farklı olsa da aynı anahtar ikinci kez kullanılamaz. Başka bir anahtar verin ya da var olan kaydı listeden açıp düzenleyin.

Çalıştır 0 satır döndürüyor, neden?

Sarı not varsa nedeni odur (öneri kitlesi bayat, firma kuralı tüm satırları eledi, dış veri bayat …). Not yoksa seçilen kişinin bu kaynakta verisi yoktur: tablo kaynağında “Örnek kişi bul” ile dolu bir kişi seçin; olay adının büyük/küçük harfini kontrol edin.

Bir şablona kaç veri seti bağlanabilir?

En çok 16. Şablon seçilince alanın altında kaçıncı veri seti olduğu yazar. Durum tanımları ya da üreticiler için Firma düzeyi kayıtlar bu sınıra girmez.

İçerik editörünün oluşturduğu veri setleri burada mı görünür?

Evet. İçerik kaydedilince editör şablonun veri setlerini içerikteki bloklarla eşitler: yeni blok eklenir, değişen güncellenir, içerikte olmayan anahtar silinir. Şablona elle bağladığınız bir veri seti içerikte okunmuyorsa bir sonraki içerik kaydında silinebilir; bağımsız kalması gerekenleri Firma düzeyi kapsamda tutun.

Formda olmayan bir alanı nasıl eklerim?

JSON görünümüne geçip tanıma yazın (ör. enrich, except, sub, aggregates, joins, fallback, window.nextDays). Forma döndüğünüzde bu alanlar silinmez.

İlgili ekranlar

Bu sayfa işine yaradı mı?