ویجتهای داخل سایت
نمای کلی Cookie Consent، Feedback و Survey و نحوه کنترل آنها از طریق runtime config داشبورد آلفانا.
ویجتهای آلفانا برای جمعآوری رضایت، بازخورد و پاسخهای مستقیم کاربران داخل سایت طراحی شدهاند. تنظیمات عمومی این ویجتها از طریق SDK و با درخواست به endpoint زیر دریافت میشود:
POST /api/sdk/runtime-configمدیریت و ویرایش تنظیمات هر Widget از داخل داشبورد آلفانا انجام میشود و این بخش به احراز هویت با JWT نیاز دارد. Visitor به تنظیمات مدیریتی دسترسی ندارد و فقط config عمومی لازم برای نمایش Widget و endpoint مربوط به ثبت پاسخ را دریافت میکند.
این ساختار باعث میشود تنظیمات مدیریتی از اطلاعاتی که برای اجرای Widget در مرورگر لازم است جدا باقی بمانند.
| ویجت | رفتار |
|---|---|
| Cookie Consent | در صورت فعال بودن، collection دادههای رفتاری را تا زمان مشخص شدن رضایت کاربر متوقف میکند |
| Feedback | امتیاز ۱ تا ۵ دریافت میکند و امکان ثبت comment اختیاری را در اختیار کاربر قرار میدهد |
| Survey | مجموعهای از سؤالهای text، rating، single-choice و multi-choice را نمایش میدهد |
رفتار Widgetها#
Feedback و Survey مستقل از collection اصلی آلفانا اجرا میشوند. نمایش یا تعامل با این دو Widget باعث متوقف شدن ثبت Sessionها، Eventها و سایر دادههای رفتاری نمیشود.
زمان نمایش آنها با مقدار delaySeconds کنترل میشود. این مقدار مشخص میکند چند ثانیه بعد از آماده شدن شرایط نمایش، Widget به کاربر نشان داده شود. انتخاب زمان مناسب کمک میکند Widget قبل از اینکه کاربر فرصت کافی برای درک صفحه داشته باشد ظاهر نشود.
برای Feedback و Survey، وضعیت dismiss یا submit مربوط به هر version در مرورگر ذخیره میشود. در نتیجه، اگر کاربر یک نسخه مشخص از Widget را بسته یا پاسخ داده باشد، همان version دوباره به او نمایش داده نمیشود.
اگر محتوای Widget بهصورت معنادار تغییر کند و لازم باشد کاربران قبلی نیز نسخه جدید را ببینند، version آن باید افزایش پیدا کند.
تفاوت Cookie Consent با سایر Widgetها#
Cookie Consent برخلاف Feedback و Survey میتواند مستقیماً روی collection داده تأثیر بگذارد.
اگر Cookie Consent فعال باشد و تنظیمات آن نیاز به دریافت رضایت قبل از collection داشته باشد، SDK تا زمانی که کاربر انتخاب خود را ثبت نکند، جمعآوری دادههای رفتاری را شروع نمیکند.
پس از مشخص شدن وضعیت رضایت، رفتار collection بر اساس انتخاب کاربر و config فعلی ادامه پیدا میکند.
Feedback و Survey چنین نقشی ندارند و برای دریافت بازخورد طراحی شدهاند؛ بنابراین نمایش یا بسته شدن آنها collection اصلی آلفانا را block نمیکند.
مدیریت از داشبورد#
تنظیمات Widgetها در داشبورد آلفانا مدیریت میشوند. هر Widget صفحه و config مربوط به خود را دارد و میتوانید مواردی مثل فعال یا غیرفعال بودن، متنها، زمان نمایش و تنظیمات اختصاصی همان Widget را از آنجا کنترل کنید.
SDK در زمان اجرا فقط config عمومی موردنیاز را از runtime-config دریافت میکند و بر اساس همان تنظیمات تصمیم میگیرد کدام Widget باید نمایش داده شود و رفتار آن چگونه باشد.
این جداسازی باعث میشود تغییر تنظیمات Widgetها بدون نیاز به تغییر کد نصبشده روی سایت قابل اعمال باشد.
مستندات هر Widget#
برای جزئیات مربوط به تنظیمات و رفتار هر Widget، صفحه اختصاصی آن را ببینید: