yandex-metrica-watch یه بسته npm از خود Yandex با مجوز MIT است که کد سمت مرورگر آمارگیر Yandex Metrica رو بهت می ده. اگه می خوای بازدید و رفتار کاربرهای سایتت رو با این سرویس ردیابی کنی و کد رو از مسیر npm مدیریت کنی، همین بسته به کارت می آد.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
yandex-metrica-watch رو خود Yandex منتشر کرده و توضیح رسمی اش هم کوتاهه: کد مرورگر برای Metrica. Yandex Metrica یه سرویس آمارگیر وبه، مثل Google Analytics. تعداد بازدید، منبع ترافیک، صفحه های پربازدید و رفتار کاربر رو نشونت می ده. نقشه گرمایی و ضبط جلسه بازدیدکننده هم از امکانات شناخته شده اش هست. این بسته بخش مرورگر ماجرا رو به شکل یه وابستگی npm می ده. یعنی لازم نیست تکه کد رو از پنل کپی کنی و وسط قالب بچسبونی.
چرا بعضی سایت های ایرانی سراغ Metrica می رن؟ چون وقتی کار کردن با آمارگیرهای دیگه دردسر داره، این سرویس یه گزینه جایگزینه. ولی یه نکته رو از اول جدی بگیر. این بسته فقط کد سمت مرورگر رو می ده و داده های بازدید از مرورگر کاربر به سرورهای خود سرویس می رن. پس کار کردنش به دسترسی مرورگر بازدیدکننده به اون سرورها بستگی داره. روزهایی که اینترنت بین الملل محدوده، ممکنه آمار ناقص ثبت بشه یا اصلا ثبت نشه. قبل از اینکه روی عددها حساب باز کنی، تو شرایط واقعی خودت امتحانش کن.
برای کی مناسبه؟ برای توسعه دهنده ای که پروژه اش با باندلری مثل webpack یا Vite ساخته می شه و می خواد وابستگی ها رو یکجا با package.json مدیریت کنه. برای کی نه؟ اگه سایت وردپرسی ساده داری و فقط آمار می خوای، گذاشتن کد مستقیم از پنل Metrica یا یه افزونه آماده خیلی راحت تره و به npm نیازی نداری. اگه هم داده بازدیدکننده ها باید حتما روی سرور داخلی بمونه، این راه حل به دردت نمی خوره، چون داده ها برای پردازش به سرورهای خود سرویس می رن.
چند نکته موقع استفاده: اول، برای شروع یه حساب و شناسه شمارنده از پنل Metrica لازم داری. دوم، آمارگیر یعنی جمع کردن اطلاعات کاربر. پس موضوع رو تو صفحه حریم خصوصی سایتت بنویس و اطلاعات حساس، مثل محتوای فرم های پرداخت، رو ضبط نکن. سوم، افزونه های مسدودکننده تبلیغ و ردیاب خیلی وقت ها این کدها رو می بندن، پس عددهایی که می بینی معمولا از واقعیت کمترن. نسخه های رسمی و بدون تغییر این بسته تو مخزن داخلی ما هم در دسترسه. وقتی دسترسی مستقیم به منبع اصلی سخت می شه، به کارت می آد.
راهنمای استفاده
راه انداختن این بسته چند قدم ساده داره، ولی ریزه کاری ها رو باید با مستندات خود Yandex Metrica تطبیق بدی.
اول تو پنل Yandex Metrica یه شمارنده برای سایتت بساز و شناسه اش رو یادداشت کن. بدون این شناسه هیچ آماری ثبت نمی شه.
اگه پروژه ات با npm و باندلر ساخته می شه، بسته رو با نام yandex-metrica-watch به وابستگی های پروژه اضافه کن و تو فایل ورودی جاوااسکریپت بارش کن.
اگه پروژه ات باندلر نداره، فایل بسته رو از همین صفحه بگیر و با کد آماده پایین همین صفحه تو قالب یا صفحه ات اضافه کن. تو وردپرس معمولا جاش فایل footer یا بخش اسکریپت های قالبه.
بعدش شمارنده رو با شناسه خودت راه اندازی کن. گزینه هایی مثل ردیابی کلیک ها یا لینک های خروجی رو هم طبق مستندات سرویس تنظیم کن.
سایت رو باز کن و تو بخش بازدید لحظه ای پنل Metrica ببین بازدید خودت ثبت شده یا نه. اگه نشده بود، اول شناسه شمارنده رو چک کن و بعدش مسدودکننده تبلیغ مرورگرت رو.
قبل از انتشار روی سایت اصلی، یه بار روی نسخه آزمایشی امتحانش کن و مطمئن شو سرعت بارگذاری صفحه ها خراب نشده.
نشانی مستقیم فایل اصلی 1.306.0https://mirror.wbweb.ir/npm/yandex-metrica-watch@1.306.0/tag.js
پرسش‌های رایج
یه بسته npm از Yandex که کد سمت مرورگر آمارگیر Yandex Metrica رو شامل می شه. با اون می تونی بازدید و رفتار کاربرها رو تو سایتت ثبت کنی و گزارشش رو تو پنل خود Metrica ببینی. خودش پنل یا گزارش ساز نیست و فقط بخش مرورگر رو تامین می کنه. شناسه شمارنده رو هم باید از پنل بگیری.
بله، ولی معمولا لازم نیست از مسیر npm بری. تو وردپرس راحت تره کد شمارنده رو از پنل Metrica بگیری و توی قالب یا با یه افزونه اضافه کنی. این بسته بیشتر به درد پروژه هایی می خوره که با باندلر ساخته می شن و وابستگی ها رو با npm مدیریت می کنن.
مجوز خود بسته MIT هست که یکی از آزادترین مجوزهاست و استفاده تجاری رو هم اجازه می ده. ولی خود سرویس Yandex Metrica شرایط استفاده جدا خودش رو داره. قبل از بستن قرارداد یا استفاده تو پروژه مشتری، اون شرایط رو هم یه بار بخون.
بستگی داره. این بسته کد مرورگر رو می ده، ولی داده ها از مرورگر بازدیدکننده به سرورهای خود سرویس فرستاده می شن. اگه مرورگر کاربر به اون سرورها دسترسی نداشته باشه، آمار ناقص ثبت می شه یا اصلا ثبت نمی شه. بهتره تو شرایط واقعی خودت تستش کنی.
prebid-universal-creative یه بسته جاوااسکریپتیه که تبلیغ برنده رو توی سایت هایی با Prebid و هدر بیدینگ نشون می ده. این کد توی کریتیو اد سرور قرار می گیره و بعد از تموم شدن مزایده، تبلیغ رو توی جایگاه نشون می ده. مجوزش Apache هست و نسخه رسمی ش توی مخزن ما موجوده.
workbox-cdn یه بسته آماده از کتابخونه Workbox گوگله که بدون ابزار build و فقط با بارگذاری یه اسکریپت می تونی توی سایتت استفاده کنی. با Workbox سرویس ورکر رو راحت تر می نویسی، کش و حالت آفلاین رو مدیریت می کنی و بازدیدهای بعدی سایتت سریع تر باز می شن.
mathjax یه کتابخانه متن باز جاوااسکریپته که فرمول های ریاضی رو توی مرورگر نمایش می ده. فرمولی که با LaTeX، MathML یا AsciiMath نوشتی رو به متن تیز، قابل انتخاب و قابل دسترس تبدیل می کنه، پس لازم نیست از فرمول ها عکس بگیری. مجوزش Apache هست و بسته npm هم داره.
sweetalert2 یه کتابخانه جاوااسکریپته که به جای پنجره های پیش فرض مرورگر، یعنی alert و confirm و prompt، پنجره های پیام، تایید و ورودی تمیز و ریسپانسیو نشون می ده. ظاهرش قابل تنظیمه و طبق معرفی رسمی از دسترس پذیری WAI-ARIA پشتیبانی می کنه. سازنده اش Limon Monte و مجوزش MIT هست.
search-insights یه کتابخانه جاوااسکریپت از Algolia با مجوز MIT هست که کلیک، تبدیل و بازدید کاربرها روی نتیجه های جستجو رو به Insights API خود Algolia گزارش می ده. اگه جستجوی سایتت با Algolia کار می کنه، با این بسته می تونی رفتار کاربرها رو ثبت کنی و کیفیت جستجو رو بهتر کنی.
js-cookie یه کتابخانه جاوااسکریپت ساده و خیلی سبکه که کار با کوکی های مرورگر رو راحت می کنه. با چند تا متد کوتاه می تونی کوکی بسازی، بخونی و پاک کنی و لازم نیست با رشته خام document.cookie سروکله بزنی. مجوزش MIT هست و به کتابخانه دیگه ای وابسته نیست.
آخرین نسخه
۳.۰.۸
نسخه‌ها
۸
به‌روزرسانی
چیزی که لازم دارید اینجا نیست؟
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.
