ویجت بازخورد

ویجت Feedback برای دریافت بازخورد سریع و مستقیم از کاربران داخل سایت طراحی شده است. این ویجت یک امتیاز از ۱ تا ۵ دریافت می‌کند و کاربر می‌تواند در کنار امتیاز، یک comment اختیاری هم ثبت کند.

مدیریت تنظیمات Feedback از مسیر زیر در داشبورد آلفانا انجام می‌شود:

/dashboard/widgets/feedback

از این بخش می‌توانید وضعیت فعال بودن Widget، متن‌ها، زمان نمایش و version فعلی را کنترل کنید.

چرخه نمایش#

چرخه نمایش Feedback از دریافت config تا ثبت پاسخ به این شکل انجام می‌شود:

1. SDK ابتدا runtime config فعال را از backend دریافت می‌کند و بررسی می‌کند Feedback برای سایت فعال است یا نه.

2. اگر Widget فعال باشد و شرایط نمایش فراهم باشد، پس از مدت مشخص‌شده در delaySeconds به کاربر نمایش داده می‌شود.

3. اگر کاربر Feedback را submit یا dismiss کند، وضعیت همان version در storage مرورگر ذخیره می‌شود تا همان نسخه دوباره برای همان visitor نمایش داده نشود.

4. در صورت ثبت پاسخ، امتیاز و comment کاربر از طریق endpoint زیر ارسال می‌شود:

POST /api/sdk/widget-responses

Feedback برخلاف Cookie Consent روی collection اصلی آلفانا اثر نمی‌گذارد. یعنی نمایش، submit یا dismiss شدن این Widget باعث توقف ثبت Sessionها، Eventها یا سایر داده‌های رفتاری نمی‌شود.

رفتار version#

وضعیت نمایش Feedback بر اساس version فعلی مدیریت می‌شود.

اگر یک visitor یک version مشخص را پاسخ داده یا بسته باشد، همان version دوباره برای او نمایش داده نمی‌شود. اگر محتوای Feedback به‌صورت معنادار تغییر کند و بخواهید همان کاربر دوباره فرصت ثبت بازخورد داشته باشد، می‌توانید version را از داشبورد افزایش دهید.

افزایش version عملاً Widget را به‌عنوان یک نسخه جدید در نظر می‌گیرد و امکان نمایش دوباره آن برای visitorهایی که نسخه قبلی را دیده‌اند فراهم می‌شود.

بهتر است version را فقط زمانی تغییر دهید که سؤال، متن، هدف یا context دریافت بازخورد واقعاً تغییر کرده باشد.

نکات اجرایی#

• delaySeconds را طوری انتخاب کنید که Feedback قبل از اینکه کاربر فرصت کافی برای دیدن و درک صفحه داشته باشد نمایش داده نشود.

• متن عنوان، توضیح و CTA را کوتاه و واضح نگه دارید تا کاربر بدون مکث اضافی متوجه شود چه بازخوردی از او خواسته می‌شود.

• از comment اختیاری برای گرفتن context بیشتر استفاده کنید، اما کاربر را مجبور به نوشتن توضیح نکنید مگر اینکه هدف مشخصی برای آن داشته باشید.

• اگر Feedback روی چند نوع صفحه استفاده می‌شود، زمان نمایش و متن آن را متناسب با context همان صفحه تنظیم کنید.

• قبل از انتشار، Widget را روی اندازه‌های مختلف صفحه، به‌خصوص موبایل، بررسی کنید تا متن‌ها، دکمه‌ها و حالت امتیازدهی بدون مشکل نمایش داده شوند.