ویجت نظرسنجی

ویجت Survey برای جمع‌آوری بازخورد ساختاریافته از کاربران طراحی شده است. این ویجت می‌تواند مجموعه‌ای از سؤال‌های مرتب‌شده را از نوع متن، rating، single-choice و multiple-choice نمایش دهد و ترتیب نمایش سؤال‌ها را بر اساس تنظیماتی که در داشبورد تعریف شده‌اند حفظ کند.

تنظیمات Survey از مسیر زیر در دسترس است:

/dashboard/widgets/survey

هر سؤال می‌تواند به‌صورت required تعریف شود. در این حالت، کاربر تا زمانی که پاسخ معتبر برای آن سؤال ثبت نکند، نمی‌تواند فرایند نظرسنجی را کامل کند. گزینه‌های مربوط به سؤال‌های انتخابی نیز از config عمومی ویجت دریافت می‌شوند تا ساختار سؤال‌ها و گزینه‌ها در یک نقطه مدیریت شود.

بعد از تکمیل Survey، پاسخ‌ها از طریق endpoint زیر ثبت می‌شوند:

POST /api/sdk/widget-responses

SDK وضعیت submit یا dismiss را برای version فعلی Survey ذخیره می‌کند. این رفتار باعث می‌شود همان نسخه از نظرسنجی برای یک کاربر دوباره نمایش داده نشود، مگر اینکه version آن تغییر کند.

چرخه Survey به‌صورت یک‌بار در هر version طراحی شده است. بنابراین اگر محتوای نظرسنجی بدون تغییر version ویرایش شود، کاربرانی که قبلاً آن نسخه را submit یا dismiss کرده‌اند دوباره Survey را نخواهند دید.

Survey به‌صورت مستقل از collection اصلی آلفانا عمل می‌کند و نمایش، submit یا dismiss شدن آن باعث block شدن فرایند اصلی جمع‌آوری داده‌های رفتاری نمی‌شود. ثبت Sessionها، Eventها و سایر داده‌های SDK بدون وابستگی به وضعیت Survey ادامه پیدا می‌کند.

توصیه اجرایی#

• سؤال‌ها را کوتاه، واضح و تک‌معنا نگه دارید. هر سؤال بهتر است فقط یک موضوع را بررسی کند تا پاسخ کاربر قابل‌تفسیرتر باشد.

• delaySeconds را طوری تنظیم کنید که Survey قبل از اینکه کاربر فرصت کافی برای دیدن و درک صفحه داشته باشد نمایش داده نشود. زمان نمایش باید با context صفحه و هدف نظرسنجی هماهنگ باشد.

• اگر سؤال‌ها، گزینه‌ها یا هدف اصلی Survey به‌صورت معنادار تغییر کرده‌اند، version را افزایش دهید. افزایش version باعث می‌شود نسخه جدید برای کاربرانی که نسخه قبلی را دیده‌اند نیز قابل نمایش باشد.

• از required کردن بیش از حد سؤال‌ها خودداری کنید. اجباری بودن فقط برای سؤال‌هایی مناسب است که بدون پاسخ آن‌ها، نتیجه Survey ارزش تحلیلی کافی ندارد.

• برای سؤال‌های single-choice و multiple-choice گزینه‌ها را تا جای ممکن مشخص، بدون هم‌پوشانی و قابل‌فهم تعریف کنید تا انتخاب کاربر نیاز به تفسیر اضافه نداشته باشد.

• پاسخ‌های واقعی کاربران را فقط از طریق داشبورد آلفانا و با سطح دسترسی مجاز بررسی کنید. MCP مستندات فقط به محتوای عمومی Docs دسترسی دارد و هیچ پاسخ visitor، داده Survey یا اطلاعات تحلیلی خصوصی را در اختیار client قرار نمی‌دهد.