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