کتابخانه
prebid-universal-creative یه بسته جاوااسکریپتیه که تبلیغ برنده رو توی سایت هایی با Prebid و هدر بیدینگ نشون می ده. این کد توی کریتیو اد سرور قرار می گیره و بعد از تموم شدن مزایده، تبلیغ رو توی جایگاه نشون می ده. مجوزش Apache هست و نسخه رسمی ش توی مخزن ما موجوده.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۴۲۴ کیلوبایت· ۶۰ فایل· انتشار
SHA-256: 546ce863d00799e98ed25846b4a711be2473fd2a6efc550b99c9ab15d8c77618
prebid-universal-creative بخشی از اکوسیستم Prebid هست و یه کار مشخص انجام می ده: وقتی مزایده هدر بیدینگ تموم شد و برنده معلوم شد، تبلیغ برنده رو توی جایگاه نشون می ده. Prebid.js پیشنهادها رو از چند خریدار می گیره و برنده رو انتخاب می کنه، ولی نمایش خودِ تبلیغ باید از سمت اد سرور انجام بشه. کریتیو عمومی دقیقاً همین جا وارد کار می شه.
مشکلی که حل می کنه ساده هست. بدون این کتابخانه باید برای هر خریدار یا هر قالب تبلیغ یه کد جدا بنویسی و نگه داری. با کریتیو عمومی یه کد ثابت داری که اطلاعات برنده رو از اد سرور می گیره و بقیه کار رو خودش انجام می ده. مسیر کار برای سایت معمولی، صفحه AMP و اپ موبایل کمی فرق داره و کتابخانه برای همین حالت ها بخش های جدا داره. جزئیات دقیق هر حالت رو از مستندات رسمی Prebid چک کن، چون با نسخه ها تغییر می کنه.
این بسته برای ناشرها و توسعه دهنده هایی مناسبه که هدر بیدینگ رو راه انداختن یا می خوان راه بندازن. اگه فقط یه کد تبلیغ آماده از یه شبکه تبلیغاتی داخلی یا خارجی توی سایتت می ذاری، بهش نیازی نداری. افزونه وردپرس هم نیست که از پیشخوان نصبش کنی؛ یه کتابخانه جاوااسکریپتیه و باید توی زنجیره اد سرور و کریتیو جاش بدی. چون دسترسی به بعضی سرویس های خارجی از ایران گاهی مشکل داره، شاید بخوای فایل ها رو روی هاست خودت نگه داری و به CDN بیرونی وابسته نباشی.
موقع انتخاب و استفاده چند نکته رو یادت باشه. نسخه کریتیو و Prebid.js صفحه باید با هم سازگار باشن، پس هر وقت یکی رو عوض کردی، اون یکی رو هم تست کن. فایل رو دست کاری نکن و اگه چیزی لازم داشتی، از تنظیمات و راهکارهای رسمی استفاده کن. قبل از انتشار روی سایت اصلی هم تبلیغ رو توی حالت پیش نمایش اد سرور، روی موبایل و دسکتاپ ببین. نسخه های رسمی و بدون تغییر این بسته توی مخزن داخلی ما هم هست، پس اگه اینترنت بین الملل قطع یا کند بود، می تونی از همین جا برداری.
این کتابخانه معمولاً همون جایی استفاده می شه که اد سرور کریتیو می خواد، نه به شکل یه افزونه ساده روی صفحه. مسیر کلی کار این شکلیه:
کد آماده پایین همین صفحه نشون می ده فایل رو چطور توی یه صفحه لود کنی. ولی اگه هدفت کریتیو اد سرور هست، فایل رو همون جا استفاده کن و مستندات رسمی رو هم کنارش داشته باش.
یه کریتیو عمومی برای هدر بیدینگ با Prebid هست. بعد از اینکه مزایده تموم شد و برنده معلوم شد، این کد تبلیغ برنده رو توی جایگاه نشون می ده. به جای نوشتن کد جدا برای هر خریدار، یه کد ثابت داری که با اطلاعات برنده کار می کنه.
بله، این کتابخانه برای کار توی همین اکوسیستم ساخته شده. اول باید هدر بیدینگ با Prebid روی سایتت راه افتاده باشه و اطلاعات برنده به اد سرور برسه. اگه فقط یه تگ تبلیغاتی ساده داری، به این بسته نیازی نداری.
نه، افزونه وردپرس نیست. یه بسته جاوااسکریپتیه که معمولاً توی کریتیو اد سرور یا با یه فایل هاست شده استفاده می شه. اگه سایتت وردپرسیه، باید فایل یا کد رو توی زنجیره تبلیغات بذاری، نه از بخش افزونه ها. یعنی نصب با ZIP از پیشخوان اینجا جواب نمی ده و باید سمت اد سرور کارت رو راه بندازی.
برای سایت های ایرانی معمولاً هاست خودت مطمئن تره، چون اگه دسترسی به سرویس های خارجی کند یا قطع بشه، تبلیغ هات از کار نمی افتن. فقط باید نسخه رو با Prebid.js هماهنگ نگه داری و بعد از هر تغییر، پیش نمایش رو تست کنی.
Apache یه مجوز متن باز هست و معمولاً استفاده تجاری رو هم اجازه می ده، به شرطی که اعلان مجوز و حق نشر رو حفظ کنی. برای شرایط دقیق، متن مجوز همراه بسته رو بخون. اگه فایل رو تغییر دادی یا توی پروژه خودت منتشرش کردی، اعلان تغییرها و اشاره به مجوز اصلی هم لازمه.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.