rating
Uygulamanızın bir şeyin nasıl gittiğine dair kendi sorusu, tek bir dokunuşla yanıtlanır.
Nasıl geçti? rating, son kullanıcıdan beş yıldız, başparmak veya 0–10 ölçeğinde bir şeyi — teslimatı, ziyareti, az önce aldığı yardımı — ve isterse birkaç kelimeyle puanlamasını ister.
Yanıt, modele geri dönmeden anında kaydedilir: SDK, bloğun id bilgisi ve puanla birlikte POST /v1/ratings isteği gönderir ve sunucu puanı bloğun kendi ölçeğine göre kontrol eder. Blok başına cihaz başına tek yanıt; ikinci bir dokunuş bunu değiştirir.
Ekran görüntüsü değildir; tarayıcınızda SDK'nın kendi boyut ve renkleriyle canlı olarak çizilir.
Flutter SDK ile 0.42.0 ve Web SDK ile 0.19.0 sürümünden itibaren yerel olarak render edilir. Bunu bildirmeyen bir derlemeye asla sunulmaz.
Rendel ne zaman sorar
Bir sohbette en fazla bir kez, yalnızca son kullanıcının işi bittiğinde ve asla yanıtın tamamı olarak değil. Sunucu bunu bu kurala tabi tutar: bir sohbetteki ya da aynı yanıttaki ikinci bir puanlama veya son kullanıcıdan hâlâ bir şey isteyen bir sayfadaki (bir form, bir seçim, bir varyant seçici, zaman dilimleri) puanlama, bunun yerine kendi fallback_text değeri olarak çizilir.
Props
Her blok ayrıca type ve 1 ila 300 karakterlik zorunlu bir fallback_text taşır.
| Prop | Tür | Zorunlu | Kısıtlamalar |
|---|---|---|---|
question | string | Evet | 1 ila 120 karakter. |
scale | stars_5 | thumbs | nps_11 | Evet | Yok |
low_label | string | Hayır | En fazla 30 karakter. |
high_label | string | Hayır | En fazla 30 karakter. |
comment | object | Hayır | Yok |
comment.placeholder | string | Hayır | En fazla 80 karakter. |
Ağ üzerinde
{
"id": "blk_85",
"type": "rating",
"fallback_text": "How did we do with your return today?",
"props": {
"question": "How did we do with your return today?",
"scale": "stars_5",
"low_label": "Poor",
"high_label": "Great",
"comment": { "placeholder": "Anything we could do better?" }
}
}Yanıtı kaydetme
X-Rendel-Key ve X-Rendel-Device ile POST /v1/ratings, gövde { message_id, block_id, score, comment? }. score, stars_5 için 1–5, thumbs (aşağı, yukarı) için 0 veya 1 ve nps_11 için 0–10 değerindedir. comment 500 karaktere kadardır ve sohbet gibi maskelenir. Aynı cihazdan gelen daha sonraki bir yanıt puanı değiştirir ve hiç yorum göndermezse önceki yorumu korur. Bilinmeyen bir cihaz, mesaj veya blok 404 invalid_request alır; ölçek dışı bir puan 400 invalid_request alır. Yerleşik render ediciler tüm bunları yapar ve bir Flutter alternatif render edicisi dispatch.onRate çağırır; uç noktaya yalnızca API'yi bir SDK olmadan çağırdığınızda ihtiyaç duyarsınız.
Yanıtlar sohbetin mesajlarıyla birlikte tutulur ve onlarla birlikte silinir. Bu 404, bilinmeyen bir cihaz, mesaj veya blok için aynıdır, bu nedenle uç nokta id değerlerini yoklamak için kullanılamaz.