دانلود @blotoutio/edgetag-sdk-browser ونشانی CDN ایرانی
@blotoutio/edgetag-sdk-browser کتابخونه سمت مرورگر EdgeTag از شرکت Blotout هست. باهاش می تونی رویدادهای سایتت مثل بازدید صفحه یا خرید رو از داخل صفحه به EdgeTag بفرستی و رضایت کاربر رو هم مدیریت کنی. یه بسته npm با مجوز MIT هست و برای پروژه های جاوااسکریپتی مناسبه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
درباره @blotoutio/edgetag-sdk-browser (ادج تگ (SDK مرورگر))
@blotoutio/edgetag-sdk-browser بخش مرورگر EdgeTag هست. EdgeTag محصول شرکت Blotout برای جمع آوری و ارسال داده های رویداده و بخش مهمی از کارش سمت سرور و لبه شبکه انجام می شه، نه فقط توی مرورگر. این SDK همون تکه کدیه که توی صفحه اجرا می شه، رویدادها رو برمی داره و به نقطه ورود EdgeTag که تنظیم کردی می فرسته.
مشکلی که حل می کنه آشناست. معمولاً هر ابزار تحلیلی یا تبلیغاتی یه اسکریپت جدا به صفحه اضافه می کنه و سایت کم کم سنگین و شلوغ می شه. اینجا صفحه فقط با یه نقطه ورود حرف می زنه و اینکه داده بعدش به کدوم ابزارها برسه، بیشتر توی تنظیمات سمت EdgeTag مشخص می شه. کتابخونه ابزارهایی هم برای کار با رضایت و اطلاعات کاربر داره. اسم و جزئیات دقیق هر تابع رو از مستندات رسمی Blotout بخون و از روی حدس کار نکن.
برای کی مناسبه؟ برای توسعه دهنده هایی که روی یه سایت یا برنامه وب با جاوااسکریپت کار می کنن، مثلاً پروژه ای با React یا Vue و یه باندلر معمولی. یه فروشگاه آنلاین رو در نظر بگیر که می خواد رویدادهایی مثل افزودن به سبد یا تکمیل خرید رو یکجا و مرتب بفرسته. اگه یه سایت وردپرسی ساده داری و فقط یه کد رهگیری می خوای، این بسته انتخاب راحتی نیست. اونجا افزونه یا کد آماده خود سرویس سریع تره. یه نکته دیگه هم هست: SDK به تنهایی کاری نمی کنه و برای کار کردن، یه نمونه EdgeTag تنظیم شده لازم داره.
قبل از شروع چند چیز رو بررسی کن. اول ببین نقطه ورود EdgeTag کجا قرار گرفته. اگه سرویسش روی زیرساخت خارج از ایرانه، توی روزهای محدودیت اینترنت بین الملل ممکنه ارسال رویدادها کند بشه یا قطع بشه. پس قبل از تحویل پروژه، توی شرایط واقعی تستش کن. دوم، رضایت کاربر رو جدی بگیر و ببین برای مخاطب هدفت چه رفتاری لازمه. سوم، نسخه رو توی پروژه قفل کن تا یه به روزرسانی ناخواسته رفتار رویدادها رو عوض نکنه. مجوز MIT معمولاً استفاده توی پروژه های تجاری رو هم آزاد می ذاره.
نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست، برای وقتی که دسترسی به npm یا اینترنت بین الملل درست کار نمی کنه.
راهنمای استفاده
کار با این کتابخونه چند قدم کلی داره. جزئیاتش رو توی مستندات رسمی EdgeTag ببین. قبلش مطمئن شو نمونه EdgeTag برای سایتت آماده است و نقطه ورودش رو داری.
بسته رو با نسخه مناسب از مخزن بگیر و توی پروژه نصب کن. اگه پروژه ات با npm کار می کنه، @blotoutio/edgetag-sdk-browser رو بهش اضافه کن. برای یه صفحه ساده بدون باندلر هم می تونی از کد آماده پایین همین صفحه استفاده کنی.
بعد از بارگذاری صفحه، SDK رو یک بار مقداردهی اولیه کن و نقطه ورود EdgeTag رو بهش بده. این کار باید قبل از ارسال هر رویدادی انجام بشه.
رضایت کاربر رو مشخص کن. اگه سایتت بنر رضایت داره، انتخاب کاربر رو به SDK بده تا بر اساسش رفتار کنه.
رویدادهای مهم سایتت رو بفرست، مثل بازدید صفحه، افزودن به سبد یا خرید، همراه با داده هایی که لازم داری.
توی ابزار توسعه مرورگر، تب Network رو باز کن و ببین درخواست ها واقعاً به نقطه ورود می رسن و پاسخ سالم برمی گردونن.
قبل از انتشار، یه بار هم توی شبکه ای تست کن که دسترسی به سرویس های خارجی توش محدوده. اینجوری می بینی سایت توی اون حالت چطور رفتار می کنه.
نشانی مستقیم فایل اصلی 0.30.1https://mirror.wbweb.ir/npm/@blotoutio/edgetag-sdk-browser@0.30.1/index.js
پرسش‌های رایج
این کتابخونه سمت مرورگر EdgeTag رو پیاده می کنه. توی صفحه اجرا می شه، رویدادهای سایت رو می گیره و به نقطه ورود EdgeTag می فرسته. اینکه داده بعدش به کدوم ابزارها برسه، به تنظیمات سمت EdgeTag بستگی داره و به SDK ربطی نداره.
عملاً نه. SDK فقط پیام رسان سمت مرورگره و برای کار کردن به یه نمونه EdgeTag تنظیم شده نیاز داره که رویدادها رو دریافت کنه. بدون اون، رویدادها جایی برای رسیدن ندارن و توی تب Network فقط درخواست های ناموفق می بینی. اول سمت سرور رو آماده کن، بعدش SDK رو به صفحه وصل کن.
می شه توی قالب یا یه افزونه سفارشی با جاوااسکریپت ازش استفاده کرد، ولی برای یه سایت وردپرسی معمولی انتخاب ساده ای نیست. اگه فقط رهگیری ساده می خوای، افزونه یا کد آماده خود سرویس راحت تره. این بسته بیشتر به درد پروژه های جاوااسکریپتی می خوره.
مجوز این بسته MIT هست و معمولاً استفاده توی پروژه های شخصی و تجاری رو آزاد می ذاره. فقط باید اعلام مجوز و حق نشر رو توی پروژه نگه داری. خود سرویس EdgeTag ممکنه شرایط جدایی داشته باشه که باید از Blotout بپرسی.
خود بسته رو می تونی از مخزن داخلی ما بگیری و نصب کنی، ولی ارسال رویدادها به نقطه ورود EdgeTag بستگی داره. اگه اون سرویس خارج از ایرانه، ممکنه ارتباطش مختل بشه. کدت رو جوری بنویس که اگه ارسال شکست خورد، سایت خراب نشه.
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 هست و به کتابخانه دیگه ای وابسته نیست.
آخرین نسخه
۳.۰.۸
نسخه‌ها
۸
به‌روزرسانی
چیزی که لازم دارید اینجا نیست؟
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.
