FormXen
فرم را در سایت خودتان امبد کنید
دو راه انتشار
لینک تکمیل عمومی
هر فرم منتشرشده لینکی دارد که هرکسی میتواند باز کند و بدون حساب ثبت کند. وقتی مقصدی که کاربر را به آن میفرستید خود فرم است — ثبتنام، درخواست، نظرسنجی — از این استفاده کنید.
ویجت امبد
یک تگ اسکریپت ویجت بازخورد را روی صفحه شما سوار میکند. وقتی پاسخدادن نباید کار کاربر را قطع کند و میخواهید ثبت به کاربر واردشده وصل باشد، از این استفاده کنید.
امبد کردن یک فرم
امبد ساده
یک تگ اسکریپت، یک توکن. آن را در صفحهای بگذارید که ویجت باید ظاهر شود.
<script
src="https://app.formxen.com/embed/feedback-widget.js"
data-feedback-token="YOUR_FEEDBACK_TOKEN"
async
></script>شناسه امن ثبتکننده
اگر ثبت باید به کاربر واردشده نسبت داده شود، شناسه خام کاربر را از مرورگر نفرستید — هرکسی میتواند آن را تغییر دهد. HMAC شناسه را روی سرور خودتان با کلید مخفی حساب کنید، دایجست را بفرستید و شناسه ساده را هم کنارش بفرستید تا سرور تطابق را بررسی کند.
<script
src="https://app.formxen.com/embed/feedback-widget.js"
data-feedback-token="YOUR_FEEDBACK_TOKEN"
data-user-id="HMAC_HEX_DIGEST"
data-user-id-plain="YOUR_LOGGED_IN_USER_ID"
async
></script>فیلدهای پنهان از پیش پرشده
مقادیر را مستقیم به فیلدهای پنهان فرم بدهید — پلن کاربر، صفحهای که میدیده، کمپینی که او را آورده. مثل هر پاسخ دیگری همراه ثبت ذخیره میشوند.
<script
src="https://app.formxen.com/embed/feedback-widget.js"
data-feedback-token="YOUR_FEEDBACK_TOKEN"
data-initial-values='{"hidden-field-id":"campaign-42"}'
async
></script>ویژگیهای اسکریپت
- data-feedback-token
- اجباری. مشخص میکند ویجت برای کدام فرم منتشرشده جمعآوری میکند.
- data-user-id
- اختیاری. دایجست HMAC شناسه کاربر که روی سرور شما حساب شده. هرگز شناسه خام.
- data-user-id-plain
- اختیاری و فقط در کنار data-user-id. شناسه ساده کاربر تا سرور بتواند دایجست را بررسی کند.
- data-initial-values
- اختیاری. یک شیء JSON که شناسه فیلدهای پنهان را به مقادیرشان نگاشت میکند.
- async
- توصیهشده. جلوی مسدود شدن بقیه صفحه هنگام بارگذاری ویجت را میگیرد.
روش راهاندازی
- فرم را بسازید و منتشر کنید، سپس تمی اعمال کنید تا با سایتی که در آن مینشیند هماهنگ شود.
- توکن بازخورد آن فرم را از اپ کپی کنید.
- تگ اسکریپت را با توکن تنظیمشده به صفحه خود اضافه کنید.
- اگر ثبت باید به کاربر واردشده نسبت داده شود، HMAC را روی سرور حساب کنید و هم دایجست و هم شناسه ساده را بفرستید.
- هر فیلد پنهانی را که میخواهید از پیش پر شود اضافه کنید و مقدارش را با data-initial-values تعیین کنید.