کتابخانه
search-insights یه کتابخانه جاوااسکریپت از Algolia با مجوز MIT هست که کلیک، تبدیل و بازدید کاربرها روی نتیجه های جستجو رو به Insights API خود Algolia گزارش می ده. اگه جستجوی سایتت با Algolia کار می کنه، با این بسته می تونی رفتار کاربرها رو ثبت کنی و کیفیت جستجو رو بهتر کنی.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۱۲۳ کیلوبایت· ۱۳ فایل· انتشار
SHA-256: 567d43c2e562796860f77e503b4c8a17f4858f0493fae43aacdf07ddaaa30c1d
وقتی سایتت جستجوی خوبی داره، سؤال بعدی همیشه یکیه: کاربرها واقعاً چی رو می بینن و روی چی کلیک می کنن؟ search-insights برای جواب دادن به همین سؤاله. Algolia این کتابخانه کوچیک جاوااسکریپت رو ساخته و کارش اینه که رویدادهای کلیک، تبدیل (مثل افزودن به سبد یا خرید) و نمایش آیتم ها رو از مرورگر کاربر به Insights API بفرسته. خودش موتور جستجو نیست و نتیجه ای نشون نمی ده. فقط رفتار کاربر رو گزارش می ده.
داده ای که می فرستی به Algolia کمک می کنه آنالیتیکس دقیق تری از جستجوی سایتت داشته باشی. بعضی قابلیت های Algolia هم که به رفتار کاربر تکیه دارن، از همین رویدادها استفاده می کنن. اینکه کدوم قابلیت ها توی پلن تو فعاله به حساب و تنظیمات خود Algolia برمی گرده، پس قبل از شروع پنلت رو چک کن.
این بسته به درد کی می خوره؟ فروشگاه اینترنتی، سایت محتوایی یا وب اپی که جستجوش رو با Algolia ساخته، معمولاً با InstantSearch. اگه از جستجوی پیش فرض وردپرس یا موتور دیگه ای مثل Elasticsearch استفاده می کنی، سراغش نرو. بدون حساب Algolia و ایندکس فعال هم هیچ کاری نمی کنه.
یه نکته برای سایت های ایرانی: Algolia سرویس خارجیه و رویدادها به سرورهای بیرون از کشور می رن. دسترسی به این سرویس از ایران ممکنه محدودیت داشته باشه، پس قبل از اینکه جستجوی کل سایتت رو روش بذاری، یه بار تستش کن. حریم خصوصی هم مهمه. برای شناسه کاربر یه مقدار ناشناس بساز و شماره موبایل یا ایمیل رو توش نذار.
موقع استفاده یه چیز رو یادت بمونه: رویدادهای بعد از جستجو معمولاً به شناسه کوئری همون جستجو نیاز دارن، پس توی درخواست جستجو گزینه کلیک آنالیتیکس رو فعال کن. نسخه رسمی و بدون تغییر این کتابخانه توی مخزن داخلی ما هم هست، برای روزهایی که دسترسی به npm و منابع بین المللی مشکل داره.
استفاده ازش سخت نیست، ولی ترتیب کارها مهمه. قدم های کلی اینه:
آخرش تب Network مرورگر رو باز کن و ببین درخواست ها بدون خطا می رن یا نه. بعد از چند دقیقه رویدادها باید توی بخش Insights پنل Algolia دیده بشن.
search-insights یه کتابخانه جاوااسکریپته که رویدادهای کلیک، تبدیل و بازدید رو به Insights API خود Algolia می فرسته. بدون حساب و ایندکس Algolia فایده ای نداره، چون مقصدی برای دریافت رویدادها وجود نداره. اگه از موتور جستجوی دیگه ای استفاده می کنی، سراغ ابزار همون موتور برو.
فقط کلید جستجو (search-only) رو بذار، چون کد توی مرورگر کاربر اجرا می شه و هر کسی می تونه ببینتش. کلید ادمین یا هر کلیدی که اجازه نوشتن و تغییر ایندکس داره باید فقط سمت سرور بمونه. اگه اشتباهی لو رفت، همون لحظه کلید رو توی پنل Algolia عوض کن.
InstantSearch برای ارسال رویداد می تونه از این کتابخانه استفاده کنه، ولی جزئیاتش به نسخه و روش راه اندازی پروژه ات بستگی داره. بهتره مستندات رسمی InstantSearch رو برای نسخه ای که داری بخونی. اگه رویدادها رو دستی می فرستی، خود کتابخانه رو مستقیم هم می شه استفاده کرد.
اول تب Network مرورگر رو باز کن و ببین درخواست های ارسال رویداد با پاسخ موفق برمی گردن یا نه. بعد توی پنل Algolia سراغ بخش Insights یا رویدادها برو. ممکنه چند دقیقه طول بکشه تا داده ها نمایش داده بشن، پس همون لحظه نگران نشو.
آره، به شرطی که جستجوی سایتت با Algolia کار کنه. کتابخانه رو می شه با کد آماده به قالب یا صفحه اضافه کرد و رویدادها رو از اسکریپت های جستجو فرستاد. اگه جستجوی وردپرس همون پیش فرضه و Algolia توش نیست، این بسته کاری برات انجام نمی ده.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.