prebid.js یه کتابخانه جاوااسکریپت متن باز برای مدیریت هدر بیدینگ (Header Bidding) هست. باهاش می تونی چند شبکه یا پلتفرم تبلیغاتی رو همزمان وارد یه مزایده کنی و قبل از رسیدن به سرور تبلیغات، بهترین پیشنهاد قیمت رو برای جایگاه تبلیغ سایتت پیدا کنی. مجوزش از نوع آپاچی هست.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
اگه سایتت تبلیغ نمایش می ده، احتمالا این مشکل رو دیدی: سرور تبلیغات شبکه ها رو به ترتیب اولویت صدا می زنه و اولین شبکه ای که تبلیغ داشته باشه برنده می شه، حتی اگه شبکه بعدی قیمت بالاتری می داد. هدر بیدینگ این ترتیب رو کنار می ذاره. prebid.js کتابخانه ای متن باز برای همین کاره. توی مرورگر بازدیدکننده از چند خریدار تبلیغ همزمان قیمت می گیره و بالاترین پیشنهاد رو وارد رقابت نهایی می کنه.
طرز کارش سرراسته. جایگاه های تبلیغ (ad unit) رو تعریف می کنی، یعنی اندازه ها و اینکه کدوم خریدارها (bidder) باید برای هر جایگاه قیمت بدن. هر خریدار یه آداپتور داره که درخواست رو به زبان خودش می فرسته. کتابخانه تا یه مهلت مشخص منتظر جواب ها می مونه و بعدش نتیجه رو به سرور تبلیغات تحویل می ده. این سرور معمولا Google Ad Manager هست، ولی prebid.js فقط به اون وابسته نیست. ماژول هایی هم برای مدیریت رضایت کاربر و گزارش گیری داره که بسته به نیازت اضافه می شن.
این کتابخانه به درد سایت هایی می خوره که ترافیک جدی دارن، با چند شریک تبلیغاتی کار می کنن و می خوان درآمد جایگاه هاشون رو شفاف تر ببینن. اگه یه وبلاگ داری که فقط کد بنر یه شبکه داخلی رو توش گذاشتی، احتمالا به prebid.js نیازی نداری. هر خریدار اضافه، یه مقدار درخواست و جاوااسکریپت بیشتر به صفحه می ده و روی سرعت اثر می ذاره.
یه نکته هم برای سایت های ایرانی هست: اول ببین شبکه تبلیغاتی ای که باهاش کار می کنی اصلا آداپتور prebid داره یا نه. دسترسی و پرداخت بعضی شبکه های خارجی هم برای کاربران ایرانی محدودیت داره، پس قبل از شروع شرایطشون رو بررسی کن.
موقع انتخاب و استفاده چند چیز رو یادت باشه. فقط آداپتورها و ماژول هایی رو توی بیلد بذار که واقعا لازم داری، چون بیلد سفارشی کوچیک تر هست و سریع تر لوود می شه. مهلت پاسخ خریدارها رو با تست تنظیم کن، نه حدسی. قبل از انتشار روی سایت اصلی هم اول روی یه محیط آزمایشی امتحانش کن. نسخه های رسمی و بدون تغییر prebid.js توی مخزن داخلی ما هم در دسترسه. اگه به منابع بین المللی دسترسی نداشتی، می تونی از همین جا برداری.
راهنمای استفاده
prebid.js یه کتابخانه سمت مرورگره و برای وردپرس افزونه جدا نداره. فایل رو توی صفحه لوود می کنی و تنظیمات رو خودت می نویسی. کد آماده اضافه کردن به صفحه پایین همین صفحه هست. قدم های کلی کار این طوریه:
اول مشخص کن کدوم خریدارها رو می خوای و آداپتورشون توی بیلدت هست یا نه. اگه از بسته npm استفاده می کنی، یه بیلد سفارشی فقط با همون آداپتورها بساز.
فایل رو توی head صفحه یا قالب وردپرست لوود کن. توی وردپرس می تونی از header.php قالب فرزند یا یه افزونه مخصوص افزودن اسکریپت استفاده کنی.
جایگاه های تبلیغ رو تعریف کن: اندازه ها، شناسه هر جایگاه و پارامترهای هر خریدار.
کدهای تنظیمات رو توی صف pbjs.que بذار تا قبل از لود کامل فایل اجرا نشن.
درخواست پیشنهاد قیمت رو با یه مهلت مناسب بفرست و وقتی جواب ها رسید، نتیجه رو به سرور تبلیغات بده.
توی صفحه برای هر جایگاه یه المان با شناسه درست بذار تا تبلیغ برنده همون جا نمایش داده بشه.
حالت دیباگ رو روشن کن و ببین درخواست ها و پیشنهادها درست رد و بدل می شن یا نه. بعدش روی سایت اصلی منتشر کن.
اگه سایتت کش داره، بعد از تغییر فایل ها کش رو پاک کن تا نسخه قدیمی نمونه.
نشانی مستقیم فایل اصلی 8.30.0https://mirror.wbweb.ir/npm/prebid.js@8.30.0/dist/prebid-core.js
پرسشهای رایج
هدر بیدینگ یعنی چند خریدار تبلیغ همزمان برای یه جایگاه قیمت می دن، نه یکی یکی و به ترتیب اولویت. prebid.js این مزایده رو توی مرورگر برگزار می کنه و بهترین پیشنهاد رو به سرور تبلیغات می ده تا با بقیه پیشنهادها رقابت کنه.
رایج ترین ترکیب با Google Ad Manager هست، ولی کتابخانه فقط به اون محدود نیست و برای سرورهای تبلیغاتی دیگه هم راه حل هایی وجود داره. نحوه راه اندازی فرق می کنه، پس مستندات رسمی سرور تبلیغاتی ات رو هم بخون.
بله. چون یه کتابخانه جاوااسکریپته، به وردپرس وابسته نیست. فقط باید فایل رو توی صفحه لوود کنی، جایگاه های تبلیغ رو تعریف کنی و المان های مربوط رو توی قالب یا محتوا بذاری. برای افزودن اسکریپت می تونی از قالب فرزند یا یه افزونه مخصوص کدگذاری استفاده کنی.
ممکنه، چون درخواست و جاوااسکریپت بیشتری به صفحه اضافه می شه. برای کنترلش فقط آداپتورهای لازم رو بیلد کن، تعداد خریدارها رو معقول نگه دار و مهلت پاسخ رو با تست تنظیم کن. لود غیرهمزمان فایل هم کمک می کنه.
بستگی داره شبکه آداپتور سازگار با prebid داشته باشه یا نه. بعضی شبکه های داخلی کد اختصاصی خودشون رو می دن و عملا به این کتابخانه نیازی نیست. قبل از شروع از پشتیبانی شبکه بپرس که prebid رو پشتیبانی می کنن یا نه.
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 هست و به کتابخانه دیگه ای وابسته نیست.
آخرین نسخه
۳.۰.۸
نسخهها
۸
بهروزرسانی
چیزی که لازم دارید اینجا نیست؟
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخههای رسمی آن به مخزن اضافه میشود.