کتابخانه
@snowplow/javascript-tracker یه کتابخونه جاوااسکریپت برای جمع کردن داده های رفتار کاربر روی سایت و وب اپه که رویدادها رو برای سیستم تحلیلی Snowplow می فرسته. بازدید صفحه و رویدادهای دلخواه رو ثبت می کنه و برای تیم هایی مناسبه که می خوان داده های تحلیلی روی زیرساخت خودشون بمونه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز BSD-3-Clause؛ هش هر فایل با منبع بررسی شده است.
۱۴۱ کیلوبایت· ۴ فایل· انتشار
SHA-256: 81600932ef0b2910a41b7c2817c6b5fc2942356ae57432305f9c4de9d39dfa55
@snowplow/javascript-tracker ردیاب سمت مرورگر پروژه Snowplow هست. Snowplow یه پلتفرم متن باز برای جمع آوری داده های رفتاری کاربره. این کتابخونه توی صفحه های سایتت اجرا می شه، رویدادها رو جمع می کنه و برای یه سرور جمع کننده (collector) می فرسته. خودش گزارش و داشبورد نداره و فقط کار ارسال داده رو انجام می ده. دریافت، ذخیره و تحلیل با بقیه اجزای زیرساخت Snowplow ه.
چرا کسی سراغش می ره؟ خیلی از سایت های ایرانی با ابزارهای تحلیلی خارجی مشکل دارن: دسترسی قطع و وصل می شه و نگرانی هم هست که داده کاربرها بیرون از کشور بمونه. Snowplow رو می شه روی سرور خودت راه انداخت، برای همین کنترل داده ها معمولا دست خودته. البته این یه امکانه، نه تضمین. نتیجه به نحوه راه اندازی تو بستگی داره.
برای کی مناسبه؟ برای توسعه دهنده ها و تیم های داده، فروشگاه های بزرگ و اپ هایی که می خوان رویدادهای خودشون رو تعریف کنن، مثلا «افزودن به سبد» یا «شروع پرداخت»، و همه رو یه جا داشته باشن. برای یه وبلاگ وردپرسی ساده که فقط تعداد بازدید روزانه رو می خواد، انتخاب خوبی نیست. بدون collector و بقیه اجزای Snowplow هیچ داده ای جایی دیده نمی شه. راه اندازی و نگهداریش هم وقت و دانش فنی می خواد.
موقع انتخاب چند نکته رو یادت نگه دار. اول اینکه نسخه های جدیدتر ساختار ماژولار دارن و بعضی قابلیت ها به شکل افزونه جدا عرضه می شن. پس مستندات رو دقیقا مطابق نسخه ای که برمی داری بخون. دوم اینکه ردیاب برای شناسایی بازدیدکننده معمولا از کوکی استفاده می کنه، پس رضایت و حریم خصوصی کاربر رو از اول در نظر بگیر. مجوزش BSD-3-Clause هست و استفاده توی پروژه های تجاری رو، به شرط حفظ اعلان مالکیت، اجازه می ده.
اگه اینترنت بین الملل مشکل داره و رجیستری npm در دسترس نیست، نسخه های رسمی و بدون تغییر این کتابخونه توی مخزن داخلی ما هم هست و می تونی از همین صفحه برداری.
کار با این ردیاب چند قدم کلی داره و ترتیبش مهمه:
اگه سایتت وردپرسیه، کد رو با wp_enqueue_script از داخل قالب یا یه افزونه کوچک سفارشی بارگذاری کن. مستقیم توی فایل های قالب اصلی دست نبر، چون با به روزرسانی قالب پاک می شه. اگه پروژه ات با npm و bundler ساخته می شه، بسته رو نصب کن و طبق مستند همون نسخه ایمپورتش کن.
این کتابخونه توی مرورگر بازدیدکننده اجرا می شه، رویدادهایی مثل بازدید صفحه یا رویدادهای سفارشی رو جمع می کنه و برای collector Snowplow می فرسته. خودش گزارش نمی سازه. ذخیره و تحلیل داده ها با بقیه اجزای Snowplow ه که باید جداگانه راه بندازی.
نه. ردیاب فقط داده رو جمع و ارسال می کنه و برای دریافتش به یه collector نیاز داره. می تونی collector رو خودت روی سرور راه بندازی یا اگه براتون مناسبه، سراغ سرویس مدیریت شده خود Snowplow بری. بدون این بخش، فقط درخواست های بی جواب از مرورگر می ره.
بله، چون یه کتابخونه جاوااسکریپته و به وردپرس وابسته نیست. کافیه با wp_enqueue_script یا یه افزونه کوچک سفارشی توی صفحه ها بارگذاری و راه اندازیش کنی. فقط یادت باشه collector هم لازمه و برای سایت های کوچک، راه اندازیش ممکنه سنگین باشه.
معمولا بله. این مجوز استفاده تجاری و تغییر کد رو اجازه می ده، به شرطی که اعلان مالکیت و متن مجوز رو نگه داری و بدون اجازه از نام نویسنده ها برای تبلیغ محصولت استفاده نکنی. برای اطمینان کامل، متن مجوز رو خودت بخون.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.