این صفحه بهروزرسانیهای تولید را در کتابخانه Google Publisher Tag (GPT) مستند میکند. میتوانید بهطور دورهای این صفحه را برای اطلاعیههایی درباره ویژگیهای جدید یا بهروزشده، رفع اشکالها، مشکلات شناختهشده و عملکرد منسوخ بررسی کنید.
برای اینکه بهروزرسانیها به شما تحویل داده شود، نشانی اینترنتی این صفحه را به فیدخوان انتخابی خود اضافه کنید یا از پیوند مستقیم به فید یادداشتهای انتشار در Atom 1.0 استفاده کنید. یا RSS 2.0 قالب
درک تاریخ انتشار
همه تغییرات در کتابخانه GPT قبل از انتشار به طور کامل آزمایش می شوند. علاوه بر این، نسخهها به تدریج در اختیار کاربران قرار میگیرند تا بیشتر در برابر رگرسیونهای غیرمنتظره محافظت شوند. اگر یک رگرسیون در هر نقطه در طول عرضه مشاهده شود، کل نسخه را می توان به سرعت قبل از رسیدن به همه کاربران رها کرد.
با توجه به این، تاریخ انتشار دقیق نیست. انتشار کامل یک نسخه می تواند از چند روز تا چند هفته طول بکشد. این بدان معناست که کاربران در زمان های مختلف با تغییرات مواجه خواهند شد. تاریخهای ارائهشده در زیر نشاندهنده شروع هفتهای است که در آن تغییرات برای همه کاربران به پایان رسید.
هفته 21 اکتبر 2024
threadYield
تغییر دهید تا در صورت وجود از Scheduler.yield روی Scheduler.postTask استفاده کنید. برای جزئیات به اسناد عملکرد مراجعه کنید.
به روز شده در GPT | |
---|---|
اموال | googletag.config.PageSettingsConfig.threadYield |
هفته 2 سپتامبر 2024
پشتیبانی از تبلیغات بینابینی بازی اضافه شده است.
هفته 19 آگوست 2024
تنظیم برای کنترل رفتار بازده رشته GPT از adYield
به threadYield
تغییر نام داده است تا مشخص شود این ویژگی به جای بهینهسازی بازده آگهی، بر بازده رشته JS متمرکز است. رفتار ویژگی و API مرتبط با آن (به غیر از نام) بدون تغییر باقی می ماند. ویژگی adYield
در نسخه GPT آینده حذف خواهد شد.
رفتار پیشفرض بازده رشته ممکن است با googletag.setConfig({threadYield: 'DISABLED'});
یا برای همه اسلات ها مستقل از موقعیت مکانی آنها نسبت به viewport با googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});
.
به روز شده در GPT | |
---|---|
اموال | googletag.config.PageSettingsConfig.threadYield |
هفته 29 جولای 2024
GPT اکنون رشته JS را با استفاده از Scheduler.postTask (در صورت وجود) با اولویت: 'user-blocking' درست قبل از ارائه خلاقیت ها ارائه می دهد. نشان داده شده است که این تأثیر بسیار کمی بر نمایشها دارد در حالی که به طور معناداری از Core Web Vitals سود میبرد. بهطور پیشفرض، GPT تنها زمانی نمایش داده میشود که شکاف خارج از پورت دید باشد.
رفتار پیشفرض ممکن است با googletag.setConfig({adYield: 'DISABLED'});
یا برای همه اسلات ها مستقل از موقعیت مکانی آنها نسبت به viewport با googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'});
.
جدید در GPT | |
---|---|
اموال | googletag.config.PageSettingsConfig.adYield |
هفته 12 فوریه 2024
پشتیبانی برای پیکربندی سیگنال های ارائه شده توسط ناشر (PPS) اضافه شده است.
رفع اشکالی که در آن SlotRenderEndedEvent.slotContentChanged
همیشه true
بود. در آینده، این ویژگی فقط در صورتی true
است که محتوای اسلات تغییر کند و در غیر این صورت false
(مثلاً اگر آگهی پر نشده باشد).
هفته 29 ژانویه 2024
شکستهای شبکه برای درخواستهای تبلیغاتی با شلیک یک googletag.events.SlotRenderEndedEvent
با isEmpty
که روی true
تنظیم شده است، بدون پر کردن تقلید میکند. برای مثال نحوه گوش دادن به این رویداد ، شنوندگان رویداد آگهی را ببینید. تغییر شامل جمع کردن خودکار شکاف هنگام استفاده از collapseEmptyDivs
است.
پشتیبانی اضافه شده برای پیکربندی گسترش تبلیغات در دسکتاپ/تبلت و وب موبایل (صفحه نمایش جزئی) .
جدید در GPT | |
---|---|
شیء | googletag.config.AdExpansionConfig |
اموال | googletag.config.AdExpansionConfig.enabled googletag.config.PageSettingsConfig.adExpansion googletag.config.SlotSettingsConfig.adExpansion |
هفته 11 دسامبر 2023
پشتیبانی از تبلیغات لنگر ریل جانبی اضافه شده است.
جدید در GPT | |
---|---|
Enum | OutOfPageFormat.LEFT_SIDE_RAIL OutOfPageFormat.RIGHT_SIDE_RAIL |
هفته 13 نوامبر 2023
پشتیبانی برای پیکربندی روشهای حریم خصوصی ناشر اضافه شد.
پشتیبانی برای پیشاجرای Chrome اضافه شد. هنگامی که GPT تشخیص دهد صفحه در حالت پیش اجرا قرار دارد، درخواست تبلیغ تا زمانی که صفحه برای کاربر قابل مشاهده شود به تأخیر می افتد.
هفته 23 اکتبر 2023
پشتیبانی از محرک های بینابینی وب اختیاری اضافه شده است.
جدید در GPT | |
---|---|
شیء | googletag.config.InterstitialConfig |
اموال | googletag.config.SlotSettingsConfig.interstitial |
تایپ کنید | googletag.config.InterstitialTrigger |
هفته 24 جولای 2023
Protected Audience API (که قبلاً با نام FLEDGE شناخته می شد) با انتشار Chrome در ماه ژوئیه در حال انتقال به در دسترس بودن عمومی است. با این کار، عملکرد مرتبط با حراج مؤلفه در GPT اکنون پایدار در نظر گرفته می شود.
از آزمایشی به پایدار منتقل شد | |
---|---|
شیء | googletag.config.ComponentAuctionConfig |
اموال | googletag.config.SlotSettingsConfig.componentAuction |
هفته 19 ژوئن 2023
بهروزرسانی: از تاریخ 5 ژوئیه 2023 یا پس از آن، GPT دیگر نسخههای قدیمی کتابخانه جاوا اسکریپت خود را ارائه نمیکند و تبلیغاتی را برای آن نسخهها ارائه نمیکند . برای جزئیات بیشتر به اطلاعیه قبلی مراجعه کنید.
ناشرینی که از www.googletagservices.com/tag/js/gpt.js خدمات ارائه می دهند ممکن است به این کار ادامه دهند. با این حال، جابهجایی به دامنه ترجیحی توصیه میشود، زیرا ممکن است عملکرد را بهبود بخشد و ارائه gpt.js در www.googletagservices.com ممکن است در آینده متوقف شود.
هفته 6 ژوئن 2023
از ۵ ژوئیه ۲۰۲۳ یا پس از آن، GPT دیگر نسخههای قدیمی کتابخانه جاوا اسکریپت خود را ارائه نخواهد کرد. بارگیری GPT از یک URL رسمی برای ناشران تأثیری ندارد. ناشرانی که نسخه ذخیرهشده gpt.js، pubads_impl.js یا هر کتابخانهای را که بارگیری میکنند ارائه میکنند، باید صفحات خود را برای استفاده از نشانیهای اینترنتی رسمی بهروزرسانی کنند. برای اطلاعات بیشتر، راهنمای شروع را ببینید.
هفته 22 می 2023
مقادیر اندازه منفی و صفر ارائه شده به googletag.defineSlot()
و SizeMappingBuilder.addSize()
اکنون به طور خودکار حذف می شوند، زیرا نامعتبر هستند. در نتیجه، ادغامهای موجود که چنین مقادیر نامعتبری را ارائه میکنند، ممکن است شاهد افزایش پیامهای کنسول ناشر باشند. با این حال، این هیچ تاثیری بر درخواستهای تبلیغاتی موجود و معتبر نخواهد داشت.
هفته 18 مه 2023
نصب اسکریپت های پیشنهاد دهنده Secure Signals توسط GPT اکنون قبل از اجرای GPT انجام می شود. این ممکن است منجر به بهبود پوشش سیگنال در سراسر درخواست های تبلیغاتی شود.
هفته 1 می 2023
رفع اشکالی که در آن خلاقیت میتوانست هنگام تازهسازی اسلاتهای لنگر چند اندازه کوتاه به نظر برسد.
هفته 27 مارس 2023
GPT دیگر از ویژگیهای مبتنی بر قابلیت مشاهده در مرورگرهایی که به طور بومی از Intersection Observer API پشتیبانی نمیکنند، پشتیبانی نمیکند. توجه داشته باشید که تمام مرورگرهای پشتیبانی شده به صورت بومی از این API پشتیبانی می کنند.
روش یا رویداد | |
---|---|
googletag.events.ImpressionViewableEvent | |
googletag.events.SlotVisibilityChangedEvent | |
googletag.pubads().enableLazyLoad() |
هفته 6 فوریه 2023
پشتیبانی برای به اشتراک گذاری سیگنال های ایمن اضافه شده است.
جدید در GPT | |
---|---|
شیء | BidderSignalProvider PublisherSignalProvider SecureSignalProvidersArray |
تایپ کنید | SecureSignalProvider |
متغیر | googletag.secureSignalProviders |
هفته 30 ژانویه 2023
رفتار Service.addEventListener() تغییر کرده است به طوری که وقتی یک رویداد رخ می دهد، تمام شنوندگان مرتبط قبل از پردازش یک رویداد بعدی اجرا می شوند. قبل از این تغییر، شنوندگان رویداد شروع و پایان رندر اسلات برای همان اسلات میتوانستند بدون ترتیب اجرا شوند.
هفته 15 آگوست 2022
نوع برگشتی Service.removeEventListener() از boolean
به void
تغییر کرده است.
هفته 25 جولای 2022
اضافه شدن پشتیبانی آزمایشی برای حراج قطعات FLEDGE ، برای فعال کردن آزمایش زودهنگام FLEDGE با چند فروشنده .
جدید در GPT | |
---|---|
روش | Slot.setConfig() |
شیء | ComponentAuctionConfig SlotSettingsConfig |
هفته 18 جولای 2022
ContentService
API غروب شده است. اکنون فراخوانی googletag.content().setContent
علاوه بر ثبت هشدار، تأثیری ندارد. ویژگی googletag.content
به زودی به طور کامل حذف خواهد شد. پس از آن، تلاش برای فراخوانی یک استثنا ایجاد می کند. به جای آن از APIهای داخلی DOM مرورگر برای افزودن مستقیم محتوا به عناصر div استفاده کنید.
هفته 23 مه 2022
پشتیبانی برای پیکربندی منبع ترافیک درخواست آگهی اضافه شده است.
پشتیبانی از GPT برای منبع ترافیک | |
---|---|
Enum | TrafficSource.ORGANIC TrafficSource.PURCHASED |
اموال | PrivacySettingsConfig.trafficSource |
هفته 7 مارس 2022
تبلیغات پاداش برای وب راه اندازی شده است. برای جزئیات بیشتر به مرکز راهنمای Ad Manager مراجعه کنید.
پشتیبانی از GPT برای تبلیغات با پاداش برای وب | |
---|---|
Enum | OutOfPageFormat.REWARDED |
رویداد | RewardedSlotClosedEvent |
رویداد | RewardedSlotGrantedEvent |
رویداد | RewardedSlotReadyEvent |
شیء | RewardedPayload |
هفته 28 فوریه 2022
CommandArray.push اکنون به طور واضح توابع ارائه شده را به جای شیء arguments
خود به globalThis
متصل می کند.
هفته 8 دسامبر 2021
Enums اکنون همچنین نگاشت معکوس مقادیر را برای کلیدها به منظور مطابقت با رفتار enums TypeScript نشان می دهد. API هایی که مقادیر enum را می گیرند بدون تغییر باقی می مانند و این نگاشت های معکوس جدید نباید استفاده شوند.
هفته 9 آگوست 2021
متد removeEventListener اضافه شد.
فراخوانی چندباره addEventListener با یک eventType و نمونه تابع callback یکسان است. به عبارت دیگر، اگر یک نمونه تابع پاسخ به تماس منفرد n بار برای همان نوع رویداد ثبت شود، به جای n بار، فقط یک بار در هنگام وقوع رویداد اجرا می شود.
هفته 29 جولای 2021
رویدادهای قابلیت نمایش GPT: ImpressionViewableEvent
و SlotVisibilityChangedEvent
اکنون در جلسات طولانی صفحه فعال خواهند شد. قبلاً بعد از یک ساعت از بارگذاری صفحه خاموش شده بودند.
هفته 03 مه 2021
GPT دیگر قبل از واکشی تبلیغات فضایی را برای اسلات تعیین نمی کند. این تغییر ، تغییر چیدمان تجمعی (CLS) را در سایتهایی که با استفاده از CSS فضا رزرو نکردهاند، کاهش میدهد. برای کاهش بیشتر CLS در سایت خود، توصیه می کنیم با استفاده از CSS منطقه غیر صفر را برای تبلیغ رزرو کنید. بیشتر بدانید
هفته 22 مارس 2021
رفتار enableLazyLoad()
را بهروزرسانی کرد تا رندر شکافهای پایینتر روی برگههای پسزمینه را نیز به تأخیر بیندازد.
هفته 23 فوریه 2021
متدهای googletag.pubads().set
و Slot.set
اکنون میتوانند در هر زمانی قبل از display
یا refresh
فراخوانی شوند. set
قبلی فقط در صورت فراخوانی قبل از googletag.enableServices
اعمال میشود.
هفته 16 فوریه 2021
googletag.pubads().setPublisherProvidedId
API اکنون ممکن است در هر زمانی فراخوانی شود. قبلاً فقط در صورت فراخوانی قبل از googletag.enableServices
کار می کرد.
هفته 4 ژانویه 2021
API googletag.pubads().collapseEmptyDivs
ممکن است اکنون مکرراً برای تغییر تنظیمات فراخوانی شود. تماسهای تکراری قبلی نادیده گرفته میشوند.
هفته 12 اکتبر 2020
بتای باز بینابینی وب راه اندازی شد، به مرکز راهنمایی مراجعه کنید.
هفته 31 آگوست 2020
definePassback()
و defineOutOfPagePassback()
منسوخ شده است. برای نحوه درست ایجاد یک پسبازگشت به اسناد بازپسگیری مراجعه کنید.
هفته 15 ژوئن 2020
رفتار enableLazyLoad()
را به روز کرد تا با collapseEmptyDivs(true)
سازگار باشد.
هفته 25 می 2020
GPT دیگر از موقعیت مکانی GPS دقیق تنظیم شده توسط ناشران پشتیبانی نخواهد کرد. به طور خاص، googletag.pubads().setLocation()
دیگر پارامترهای طول و عرض جغرافیایی، یا شعاع را پشتیبانی نخواهد کرد، اما در عوض یک آدرس آزاد می گیرد.
هفته 27 آوریل 2020
منطق رندر GPT دیگر در فایل های جداگانه مدولار نمی شود. این بدان معنی است که GPT فایل های کمتری را در اجرای خود دریافت می کند و بنابراین تأخیر را اندکی کاهش می دهد، اما تأثیر خالصی بر پهنای باند کاربر ندارد.
هنگامی که درخواستی در GPT (با فراخوانی googletag.display()
یا googletag.pubads().refresh()
) راهاندازی میشود، اکنون تمام وضعیت ارائهشده ناشر را بهطور داخلی مسدود میکنیم تا قبل از ارسال درخواست جهش داده نشود. بنابراین، زمانی که یک درخواست راهاندازی میشود، تنها حالتی که تا آن نقطه جمع میشود برای آن درخواست استفاده میشود. هر حالتی که پس از آن اصلاح شود فقط برای درخواست های زیر اعمال می شود.
هفته 11 نوامبر 2019
اکنون یک قطعه پیشنهادی جدید برای ایجاد گذرنامه GPT وجود دارد. استفاده از definePassback()
و defineOutOfPagePassback()
ممنوع است، زیرا این توابع به صورت همزمان عمل می کنند و ممکن است توسط مرورگرهای خاصی مسدود شوند. بیشتر بدانید .
متد Slot.updateTargetingFromMap()
اضافه شد.
PubAdsService.setPrivacySettings()
را به عنوان روشی جدید برای فعال کردن تنظیمات حریم خصوصی اضافه کرد. تنظیمات اضافی در آینده در اینجا در دسترس خواهد بود.
هفته 25 مارس 2019
سرویس Pubads بلافاصله پس از فراخوانی googletag.enableServices()
به جای اینکه به صورت ناهمزمان مقداردهی اولیه شود، اکنون کاملاً عملیاتی می شود. این بدان معنی است که googletag.pubadsReady
اکنون پس از فراخوانی googletag.enableServices()
درست است. نظرسنجی برای بررسی مقدار googletag.pubadsReady
دیگر لازم نیست.
هفته 4 فوریه 2019
رفتار enableLazyLoad()
را بهروزرسانی کرد تا پس از فراخوانی enableServices()
تغییراتی در پیکربندی بارگذاری تنبل ایجاد کند، با پیکربندی بارگذاری تنبل برای هر شکافی که آن اسلات نمایش داده میشود، ثابت میشود.
هفته 21 ژانویه 2019
یک رویداد پشتیبانیشده جدید اضافه شد، SlotResponseReceived
، که با دریافت پاسخ آگهی برای یک اسلات فعال میشود.
یک فیلد جدید creativeTemplateId
به googleTag.ResponseInformation
اضافه کرد.
هفته 14 ژانویه 2019
یک رویداد پشتیبانیشده جدید اضافه شد، SlotRequestedEvent
، که وقتی درخواست تبلیغ برای یک اسلات ارسال میشود فعال میشود.
هفته 27 آگوست 2018
googletag.display()
را برای پذیرش googletag.Slot
به عنوان آرگومان تغییر داد.
هفته 6 آگوست 2018
googletag.PubAdsService.enableLazyLoad()
را برای بارگذاری تنبل تبلیغات در GPT اضافه می کند.
هفته 18 ژوئن 2018
رفع اشکالی که باعث میشد googletag.events.SlotOnloadEvent
فعال نشود.
هفته 30 آوریل 2018
googletag.PubAdsService.setTagForUnderAgeOfConsent()
را برای کنترل تبلیغات برای کاربران زیر سن رضایت، و googletag.PassbackSlot.setTagForUnderAgeOfConsent()
را برای علامتگذاری شکاف پسانداز بهعنوان یک کاربر زیر سن رضایت اضافه میکند.
هفته 23 آوریل 2018
googletag.PubAdsService.setRequestNonPersonalizedAds()
را برای کنترل شخصی سازی تبلیغات اضافه می کند.
هفته 12 مارس 2018
تغییر برگشت داده شد که حذف محتوای موجود داخل اسلاتها قبل از بازخوانی متوقف شد، اگر آن محتوا توسط GPT در آنجا قرار نگرفته باشد. اکنون محتوا پاک خواهد شد.
هفته 19 فوریه 2018
هنگامی که از حالت رندر ناهمزمان استفاده میشود: در صورت امکان برای همه درخواستهای تبلیغاتی، تا سقف 8192 کاراکتر، با استفاده از XMLHttpRequest با روش HTTP GET
، درخواست تبلیغات کنید. قبلاً، روش HTTP POST
برای درخواست های تبلیغاتی بیش از 4096 کاراکتر تا سقف 8192 کاراکتر استفاده می شد.
حذف محتوای موجود در داخل اسلات ها قبل از بازخوانی متوقف شد، اگر آن محتوا توسط GPT در آنجا قرار داده نشده بود. این یادداشت نادرست است. ورودی هفته 12 مارس 2018 را ببینید
هفته 8 ژانویه 2018
از دستور متناوب [..., ['fluid'], ...]
به عنوان NamedSized
در یک آرایه چند اندازه پشتیبانی کنید. قبلاً فقط [..., 'fluid', ...]
معتبر در نظر گرفته می شد.
هفته 10 جولای 2017
فیلد labelIds از googleTag.ResponseInformation حذف شد.
هفته 5 ژوئن 2017
googletag.display()
و googletag.pubads().display
برای پذیرش عنصر div و همچنین شناسه div تغییر داد. این اجازه می دهد تا اسلات ها را در داخل div هایی که در یک DOM سایه قرار دارند رندر کنید.
هفته 27 فوریه 2017
sourceAgnosticCreativeId
و sourceAgnosticLineItemId
به SlotRenderEndedEvent
اضافه شد.
هفته 7 نوامبر 2016
API getSlots()
در سرویس برای بازیابی لیست اسلات های مرتبط با یک سرویس منتشر شد.
هفته 17 اکتبر 2016
Slot.clearTargeting()
و PubAdsService.clearTargeting()
را برای گرفتن یک پارامتر کلید اختیاری تغییر داد.
هفته 5 سپتامبر 2016
خطاهای شناسایی شده در googletag.cmd.push()
دیگر قابل مشاهده نیستند و در کنسول چاپ می شوند.
هفته 8 آگوست 2016
SlotOnloadEvent
API را منتشر کرد تا امکان گوش دادن به یک خلاقیت را فراهم کند تا بارگذاری به پایان برسد.
هفته 25 جولای 2016
API های getTargeting()
و getTargetingKeys()
در PubAdsService برای بازیابی پارامترهای هدف گذاری در سطح سرویس سفارشی منتشر شد.
هفته 20 ژوئن 2016
API openConsole()
برای باز کردن کنسول Google Publisher بدون نیاز به بازخوانی صفحه منتشر شد.
هفته 6 ژوئن 2016
API های getTargeting()
و getTargetingKeys()
برای بازیابی پارامترهای هدف گذاری سفارشی منتشر شد.
افزودن گزینه پیکربندی که در آن Safeframe باید با فشار دادن محتوا اجازه گسترش دهد: allowPushExpansion
.
هفته 16 می 2016
پشتیبانی از اندازه مایع در درخواست های تبلیغات چند اندازه.
هفته 18 آوریل 2016
getResponseInformation
API منتشر شد که اطلاعات پاسخ آگهی را برای جایگاه آگهی برمی گرداند.
API setAdIframeTitle
منتشر شد که ورودی را به عنوان عنوان هر iframe کانتینر تبلیغاتی که بعد از آن ایجاد میشود، تنظیم میکند.
هفته 4 آوریل 2016
حداکثر طول درخواست تبلیغ HTTP GET
را به 4096 کاراکتر افزایش داد.
هفته 28 مارس 2016
افزودن گزینه پیکربندی که در آن Safeframe باید با همپوشانی محتوا اجازه گسترش دهد: allowOverlayExpansion
.
افزودن گزینه پیکربندی که در آن SafeFrame باید از ویژگی HTML5 sandbox برای جلوگیری از ناوبری سطح بالا استفاده کند: sandbox
.
هفته 22 فوریه 2016
افزودن قابلیت تنظیم عناوین برای iframes کانتینر تبلیغات: setAdIframeTitle()
.
افزودن یک API برای پیکربندی ویژگیهای SafeFrame در صفحه و سطح شکاف: setSafeFrameConfig()
.
هفته 15 فوریه 2016
افزودن قابلیت تخریب یک اسلات و استفاده مجدد از div: destroySlots()
.
افزودن یک API برای اجبار استفاده از safeframe در اسلات های تبلیغاتی با کنترل های دانه ای: setForceSafeFrame()
.
هفته 7 دسامبر 2015
افزودن رویدادهای دید اسلات ( SlotVisibilityChangedEvent
).
هفته 26 اکتبر 2015
افزودن قابلیت نمایش Impression ( ImpressionViewableEvent
).
هدف گذاری پس انداز را از نقشه JSON به روز کنید ( Passback.updateTargetingFromMap()
).
هفته 12 اکتبر 2015
پشتیبانی از بازپسگیری خارج از صفحه
هفته 31 آگوست 2015
بازسازی معماری GPT به یک لودر نازک و یک پیاده سازی بزرگتر.
پشتیبانی از اندازه مایع در GPT.