یادداشت های انتشار GPT

این صفحه به‌روزرسانی‌های تولید کتابخانه Google Publisher Tag (GPT) را مستند می‌کند. می‌توانید به‌طور دوره‌ای این صفحه را برای اطلاعیه‌های مربوط به ویژگی‌های جدید یا به‌روزرسانی‌شده، رفع اشکالات، مشکلات شناخته‌شده و قابلیت‌های منسوخ‌شده بررسی کنید.

برای دریافت به‌روزرسانی‌ها، آدرس اینترنتی این صفحه را به فیدخوان دلخواه خود اضافه کنید، یا از لینک مستقیم به فید یادداشت‌های انتشار در Atom 1.0 استفاده کنید. یا RSS 2.0 فرمت

توجه: فقط نسخه‌هایی که شامل تغییرات قابل مشاهده توسط کاربر هستند در اینجا مستند شده‌اند. برای مشاهده لیست کامل نسخه‌های GPT، از جمله نسخه‌های نگهداری، به صفحه تاریخچه نسخه‌ها مراجعه کنید.

درباره تاریخ‌های انتشار

تمام تغییرات در کتابخانه GPT قبل از انتشار به طور کامل آزمایش می‌شوند. علاوه بر این، نسخه‌ها به تدریج برای کاربران منتشر می‌شوند تا در برابر رگرسیون‌های غیرمنتظره محافظت بیشتری ایجاد شود. اگر در هر مرحله‌ای از انتشار، رگرسیون مشاهده شود، می‌توان کل نسخه را قبل از رسیدن به همه کاربران، به سرعت کنار گذاشت.

به همین دلیل، تاریخ‌های انتشار دقیق نیستند؛ یک نسخه می‌تواند از چند روز تا چند هفته طول بکشد تا به طور کامل منتشر شود. این بدان معناست که کاربران در زمان‌های مختلف با تغییرات مواجه خواهند شد. تاریخ‌های ارائه شده در این یادداشت‌های انتشار، نشان دهنده شروع هفته‌ای است که در آن یک تغییر برای همه کاربران به پایان رسیده است.

هفته منتهی به ۹ مارس ۲۰۲۶

اطلاعیه

وقتی ویژگی Heavy Ad Intervention کروم، تبلیغی را به دلیل استفاده بیش از حد از منابع حذف می‌کند، GPT اکنون به طور خودکار فضای خالی را با تبلیغ دیگری رفرش می‌کند. این امر به اطمینان از استفاده از فضای تبلیغ کمک می‌کند. انتظار می‌رود این رفتار، به ویژه در محیط‌های کروم دسکتاپ، باعث افزایش نمایش تبلیغات شود.

نکته‌ای در مورد هدف‌گیری و مقادیر کلیدی: این به‌روزرسانی خودکار، از پیکربندی هدف‌گیری موجود اسلات دوباره استفاده می‌کند. اگر ادغام شما به به‌روزرسانی مقادیر کلیدی قبل از هر به‌روزرسانی متکی باشد، ممکن است منجر به ارسال داده‌های هدف‌گیری قدیمی شود. ناشرانی که ترجیح می‌دهند این منطق را به صورت دستی مدیریت کنند، می‌توانند با استفاده از googletag.config.AutoRefreshConfig از این امر انصراف دهند.

هفته منتهی به ۶ اکتبر ۲۰۲۵

اطلاعیه

تبلیغات بینابینی اکنون به صورت فرضی، مقاصد همان سایت را برای محرک‌های ناوبری در کروم از قبل رندر می‌کنند . این امر با فعال کردن بارگذاری سریع‌تر صفحه هنگام رد شدن تبلیغات بینابینی، تجربه کاربری را بهبود می‌بخشد.

هفته منتهی به ۲۸ ژوئیه ۲۰۲۵

اطلاعیه

تعدادی از تنظیمات موجود در سطح صفحه و اسلات به API پیکربندی GPT جدید و یکپارچه منتقل شده‌اند. این انتقال چندین بهبود را به همراه دارد:

• بهبود کشف : تنظیمات در مستندات و تعاریف نوع گروه‌بندی می‌شوند.
• بصری‌تر : می‌توانید تنظیمات را به‌صورت جداگانه یا همه را به‌طور همزمان با استفاده از یک رابط واحد پیکربندی کنید.
• خطاهای واضح‌تر : خطاهای پیکربندی جزئیات بیشتری را ارائه می‌دهند و از زبان استاندارد برای ساده‌سازی عیب‌یابی استفاده می‌کنند.

روش‌های پیکربندی قدیمی همچنان به کار خود ادامه می‌دهند، اما برای استفاده از چارچوب پیکربندی جدید به صورت داخلی به‌روزرسانی شده‌اند. در نتیجه، حتی هنگام استفاده از روش‌های قدیمی، ممکن است با پیام‌های خطایی که به ویژگی‌های API پیکربندی جدید اشاره می‌کنند، مواجه شوید.

ویژگی

جدید در GPT
شیء	googletag.config.AdSenseAttributesConfig googletag.config.LazyLoadConfig googletag.config.VideoAdsConfig
ملک	PageSettingsConfig.adsenseAttributes PageSettingsConfig.categoryExclusion PageSettingsConfig.centering PageSettingsConfig.collapseDiv PageSettingsConfig.disableInitialLoad PageSettingsConfig.lazyLoad PageSettingsConfig.location PageSettingsConfig.safeFrame PageSettingsConfig.singleRequest PageSettingsConfig.targeting PageSettingsConfig.videoAds SafeFrameConfig.forceSafeFrame SlotSettingsConfig.adsenseAttributes SlotSettingsConfig.categoryExclusion SlotSettingsConfig.clickUrl SlotSettingsConfig.collapseDiv SlotSettingsConfig.safeFrame SlotSettingsConfig.targeting

تغییر

شیء SafeFrameConfig از فضای نام googletag به فضای نام googletag.config منتقل شده است.

منسوخ شده

جدول زیر روش‌های پیکربندی قدیمی منسوخ‌شده را به همراه جایگزین‌های API پیکربندی پیشنهادی آنها فهرست می‌کند.

روش(های) پیکربندی قدیمی	جایگزینی API پیکربندی GPT
PubAdsService.set()	PageSettingsConfig.adsenseAttributes
PubAdsService.clearCategoryExclusions() PubAdsService.setCategoryExclusion()	PageSettingsConfig.categoryExclusion
PubAdsService.setCentering()	PageSettingsConfig.centering
PubAdsService.collapseEmptyDivs()	PageSettingsConfig.collapseDiv
PubAdsService.disableInitialLoad()	PageSettingsConfig.disableInitialLoad
PubAdsService.enableLazyLoad()	PageSettingsConfig.lazyLoad
PubAdsService.setLocation()	PageSettingsConfig.location
PubAdsService.setForceSafeFrame() PubAdsService.setSafeFrameConfig()	PageSettingsConfig.safeFrame
PubAdsService.enableSingleRequest()	PageSettingsConfig.singleRequest
PubAdsService.clearTargeting() PubAdsService.setTargeting()	PageSettingsConfig.targeting
PubAdsService.enableVideoAds() PubAdsService.setVideoContent()	PageSettingsConfig.videoAds
PubAdsService.isInitialLoadDisabled() PubAdsService.get() PubAdsService.getAttributeKeys() PubAdsService.getTargeting() PubAdsService.getTargetingKeys()	googletag.getConfig()
Slot.set()	SlotSettingsConfig.adsenseAttributes
Slot.clearCategoryExclusions() Slot.setCategoryExclusion()	SlotSettingsConfig.categoryExclusion
Slot.setClickUrl()	SlotSettingsConfig.clickUrl
Slot.setCollapseEmptyDiv()	SlotSettingsConfig.collapseDiv
Slot.setForceSafeFrame() Slot.setSafeFrameConfig()	SlotSettingsConfig.safeFrame
Slot.clearTargeting() Slot.setTargeting() Slot.updateTargetingFromMap()	SlotSettingsConfig.targeting
Slot.get() Slot.getAttributeKeys() Slot.getCategoryExclusions() Slot.getTargeting() Slot.getTargetingKeys()	Slot.getConfig()

هفته منتهی به ۲۱ ژوئیه ۲۰۲۵

تغییر

ویژگی threadYield به‌روزرسانی شده است تا قبل از تولید URL درخواست تبلیغ، برای درخواست‌هایی که فقط شامل بخش‌های پایین صفحه هستند، رشته JS را نیز تولید کند. نشان داده شده است که این امر تأثیر مثبتی بر Core Web Vitals دارد، بدون اینکه تأثیر منفی بر نمایش‌ها داشته باشد.

در GPT به‌روزرسانی شد
ملک	googletag.config.PageSettingsConfig.threadYield

هفته منتهی به ۲ ژوئن ۲۰۲۵

اطلاعیه

تبلیغات بینابینی وب اکنون کاملاً از برنامه‌های تک صفحه‌ای (SPA) پشتیبانی می‌کنند.

کاربران GPT اکنون می‌توانند بدون نیاز به بارگذاری مجدد کامل صفحه، تبلیغات بینابینی وب را به طور یکپارچه در وب‌سایت‌های دارای قابلیت SPA نمایش دهند. این پیشرفت می‌تواند:

• بهبود تجربه کاربری: تبلیغات را در نقاط شکست طبیعی در SPA خود ارائه دهید، که منجر به انتقال روان و اختلال کمتر می‌شود.
• افزایش درآمدزایی: با ارائه مؤثر تبلیغات بینابینی در محتوای پویا و مبتنی بر SPA، فرصت‌های درآمدی جدیدی را ایجاد کنید.
• حفظ استانداردهای بهتر تبلیغات: با پایبندی به بهترین شیوه‌های صنعت، به ارائه تجربیات تبلیغاتی با کیفیت بالا با گزینه‌های خروج واضح و سقف‌های فرکانس قابل تنظیم ادامه دهید.

هیچ تغییری در پیاده‌سازی SPA موجود شما لازم نیست. GPT به طور خودکار نمایش بینابینی را برای تغییرات صفحه در SPA شما شناسایی و مدیریت می‌کند. برای جزئیات بیشتر در مورد پیاده‌سازی بینابینی‌های وب مدیریت‌شده توسط GPT و محرک‌های بینابینی اختیاری، به نمونه نمایش یک تبلیغ بینابینی وب مراجعه کنید.

هفته منتهی به ۲۶ مه ۲۰۲۵

اطلاعیه

محدودیت فرکانس برای تبلیغات بینابینی بازی‌های H5 از ۱۲۰ به ۳۰ ثانیه کاهش یافته است.

هفته منتهی به ۲۸ آوریل ۲۰۲۵

ویژگی

جدید در GPT
ملک	SlotRenderEndedEvent.responseIdentifier

هفته منتهی به ۲۷ ژانویه ۲۰۲۵

شکستن

ویژگی‌های ComponentAuctionConfig.auctionConfig زیر تغییر نام داده‌اند تا با مشخصات API مخاطبان محافظت‌شده همسو شوند.

نام ملک قدیمی	نام جدید ملک
decisionLogicUrl	decisionLogicURL
trustedScoringSignalsUrl	trustedScoringSignalsURL

هفته منتهی به ۲۱ اکتبر ۲۰۲۴

تغییر

threadYield طوری تغییر دهید که در صورت وجود، از Scheduler.yield به جای Scheduler.postTask استفاده کند. برای جزئیات بیشتر به مستندات yield مراجعه کنید.

در GPT به‌روزرسانی شد
ملک	googletag.config.PageSettingsConfig.threadYield

هفته منتهی به ۲ سپتامبر ۲۰۲۴

ویژگی

پشتیبانی از تبلیغات بینابینی بازی‌ها اضافه شد.

جدید در GPT
شمارشی	OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
رویداد	GameManualInterstitialSlotClosedEvent GameManualInterstitialSlotReadyEvent
روش	GameManualInterstitialSlotReadyEvent.makeGameManualInterstitialVisible()
ملک	EventTypeMap.gameManualInterstitialSlotClosed EventTypeMap.gameManualInterstitialSlotReady

هفته منتهی به ۱۹ آگوست ۲۰۲۴

تغییر

تنظیمات مربوط به کنترل رفتار بازدهی نخ GPT از adYield به threadYield تغییر نام داده شده است تا مشخص شود که این ویژگی بر بازدهی نخ JS تمرکز دارد نه بهینه‌سازی بازدهی تبلیغات. رفتار این ویژگی و API مرتبط با آن (به غیر از نام) بدون تغییر باقی می‌ماند. ویژگی adYield در نسخه آینده GPT حذف خواهد شد.

رفتار پیش‌فرضِ بازده نخ را می‌توان با googletag.setConfig({threadYield: 'DISABLED'}); غیرفعال کرد یا با googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'}); روی همه اسلات‌ها، مستقل از موقعیتشان نسبت به viewport، اعمال کرد.

در GPT به‌روزرسانی شد
ملک	googletag.config.PageSettingsConfig.threadYield

هفته منتهی به ۲۹ ژوئیه ۲۰۲۴

ویژگی

GPT اکنون رشته JS را با استفاده از Scheduler.postTask (در صورت وجود) با اولویت: 'user-blocking' درست قبل از رندر کردن محتوای خلاقانه، ارائه می‌دهد. نشان داده شده است که این امر تأثیر بسیار کمی بر نمایش‌ها دارد در حالی که به طور معناداری به Core Web Vitals کمک می‌کند. به طور پیش‌فرض، GPT فقط در صورتی ارائه می‌دهد که اسلات خارج از نمای دید باشد.

رفتار پیش‌فرض را می‌توان با googletag.setConfig({adYield: 'DISABLED'}); غیرفعال کرد یا با googletag.setConfig({adYield: 'ENABLED_ALL_SLOTS'}); روی همه اسلات‌ها، مستقل از موقعیتشان نسبت به viewport، اعمال کرد.

جدید در GPT
ملک	googletag.config.PageSettingsConfig.adYield

هفته منتهی به ۱۲ فوریه ۲۰۲۴

ویژگی

پشتیبانی برای پیکربندی سیگنال‌های ارائه شده توسط ناشر (PPS) اضافه شد.

جدید در GPT
شیء	googletag.config.PublisherProvidedSignalsConfig googletag.config.TaxonomyData
ملک	googletag.config.PageSettingsConfig.pps googletag.config.PublisherProvidedSignalsConfig.taxonomies googletag.config.TaxonomyData.values
نوع	googletag.config.Taxonomy

ثابت

اشکالی که باعث می‌شد SlotRenderEndedEvent.slotContentChanged همیشه true داشته باشد، برطرف شد. از این به بعد، این ویژگی فقط در صورتی true خواهد بود که محتوای اسلات تغییر کند و در غیر این صورت false (برای مثال، اگر یک تبلیغ پر نشده باشد).

هفته منتهی به ۲۹ ژانویه ۲۰۲۴

ویژگی

خرابی‌های شبکه برای درخواست‌های تبلیغات، با اجرای googletag.events.SlotRenderEndedEvent با isEmpty تنظیم شده روی true ، یک خطای عدم پر شدن را تقلید می‌کنند. برای مثال، نحوه گوش دادن به این رویداد را در شنونده‌های رویداد Ad ببینید. تغییر شامل جمع شدن خودکار اسلات هنگام استفاده از collapseEmptyDivs می‌شود.

ویژگی

پشتیبانی از پیکربندی گسترش تبلیغات در دسکتاپ/تبلت و وب موبایل (بخشی از صفحه نمایش) اضافه شد.

جدید در GPT
شیء	googletag.config.AdExpansionConfig
ملک	googletag.config.AdExpansionConfig.enabled googletag.config.PageSettingsConfig.adExpansion googletag.config.SlotSettingsConfig.adExpansion

هفته منتهی به ۱۱ دسامبر ۲۰۲۳

ویژگی

پشتیبانی از تبلیغات لنگرگاه کنار ریل اضافه شد.

جدید در GPT
شمارشی	OutOfPageFormat.LEFT_SIDE_RAIL OutOfPageFormat.RIGHT_SIDE_RAIL

هفته منتهی به ۱۳ نوامبر ۲۰۲۳

ویژگی

پشتیبانی برای پیکربندی روش‌های حفظ حریم خصوصی ناشر اضافه شد.

جدید در GPT
عملکرد	googletag.setConfig()
شیء	googletag.config.PageSettingsConfig googletag.config.PrivacyTreatmentsConfig
ملک	googletag.config.PageSettingsConfig.privacyTreatments googletag.config.PrivacyTreatmentsConfig.treatments
نوع	googletag.config.PrivacyTreatment

ویژگی

پشتیبانی از پیش‌رندرینگ کروم اضافه شد. وقتی GPT تشخیص دهد که صفحه در حالت پیش‌رندر است، درخواست تبلیغ تا زمانی که صفحه برای کاربر قابل مشاهده شود، به تأخیر می‌افتد.

هفته منتهی به ۲۳ اکتبر ۲۰۲۳

ویژگی

پشتیبانی از محرک‌های بینابینی وب اختیاری اضافه شد.

جدید در GPT
شیء	googletag.config.InterstitialConfig
ملک	googletag.config.SlotSettingsConfig.interstitial
نوع	googletag.config.InterstitialTrigger

هفته منتهی به ۲۴ ژوئیه ۲۰۲۳

اطلاعیه

رابط برنامه‌نویسی کاربردی (API) مخاطبان محافظت‌شده (که قبلاً با نام FLEDGE شناخته می‌شد) با انتشار نسخه جولای کروم به طور عمومی در دسترس قرار می‌گیرد . با این کار، عملکرد مربوط به حراج اجزا در GPT اکنون پایدار در نظر گرفته می‌شود.

تغییر

از حالت آزمایشی به حالت پایدار منتقل شد
شیء	googletag.config.ComponentAuctionConfig
ملک	googletag.config.SlotSettingsConfig.componentAuction

هفته منتهی به ۱۹ ژوئن ۲۰۲۳

اطلاعیه

به‌روزرسانی: از تاریخ ۵ جولای ۲۰۲۳ یا بعد از آن، GPT دیگر نسخه‌های قدیمی کتابخانه جاوا اسکریپت خود را ارائه نمی‌دهد و همچنین تبلیغات را به این نسخه‌ها نمایش نمی‌دهد . برای جزئیات بیشتر به اطلاعیه قبلی مراجعه کنید.

ناشرانی که از www.googletagservices.com/tag/js/gpt.js سرویس می‌دهند، ممکن است به این کار ادامه دهند. با این حال، تغییر به دامنه ترجیحی توصیه می‌شود، زیرا ممکن است عملکرد را بهبود بخشد و سرویس gpt.js در www.googletagservices.com ممکن است در آینده متوقف شود.

هفته منتهی به ۶ ژوئن ۲۰۲۳

اطلاعیه

از تاریخ ۵ جولای ۲۰۲۳ یا بعد از آن، GPT دیگر نسخه‌های قدیمی کتابخانه جاوا اسکریپت خود را ارائه نخواهد داد. هیچ تاثیری بر ناشرانی که GPT را از یک URL رسمی بارگذاری می‌کنند، نخواهد داشت. ناشرانی که از نسخه ذخیره شده gpt.js، pubads_impl.js یا هر کتابخانه‌ای که بارگذاری می‌کنند، استفاده می‌کنند، باید صفحات خود را برای استفاده از URLهای رسمی به‌روزرسانی کنند. برای اطلاعات بیشتر، به راهنمای شروع به کار مراجعه کنید.

هفته منتهی به ۲۲ مه ۲۰۲۳

تغییر

مقادیر منفی و صفر اندازه ارائه شده به googletag.defineSlot() و SizeMappingBuilder.addSize() اکنون به طور خودکار حذف می‌شوند، زیرا نامعتبر هستند. در نتیجه، ادغام‌های موجود که چنین مقادیر نامعتبری را ارائه می‌دهند، ممکن است شاهد افزایش پیام‌های کنسول ناشر باشند. با این حال، این هیچ تاثیری بر درخواست‌های تبلیغاتی موجود و معتبر نخواهد داشت.

هفته منتهی به ۱۸ مه ۲۰۲۳

ثابت

نصب اسکریپت‌های پیشنهاد دهنده سیگنال‌های امن توسط GPT اکنون در مراحل اولیه اجرای GPT انجام خواهد شد. این امر ممکن است منجر به بهبود پوشش سیگنال در درخواست‌های تبلیغاتی شود.

هفته منتهی به ۱ مه ۲۰۲۳

ثابت

اشکالی که باعث می‌شد هنگام به‌روزرسانی اسلات‌های لنگر چند سایزه، متن‌های خلاقانه کوتاه به نظر برسند، برطرف شد.

هفته منتهی به ۲۷ مارس ۲۰۲۳

تغییر

GPT دیگر از ویژگی‌های مبتنی بر قابلیت مشاهده در مرورگرهایی که به طور بومی از Intersection Observer API پشتیبانی نمی‌کنند، پشتیبانی نمی‌کند. توجه داشته باشید که همه مرورگرهای پشتیبانی شده به طور بومی از این API پشتیبانی می‌کنند.

روش یا رویداد
googletag.events.ImpressionViewableEvent
googletag.events.SlotVisibilityChangedEvent
googletag.pubads().enableLazyLoad()

هفته منتهی به ۶ فوریه ۲۰۲۳

ویژگی

پشتیبانی برای اشتراک‌گذاری سیگنال‌های امن اضافه شد.

جدید در GPT
شیء	BidderSignalProvider PublisherSignalProvider SecureSignalProvidersArray
نوع	SecureSignalProvider
متغیر	googletag.secureSignalProviders

هفته منتهی به ۳۰ ژانویه ۲۰۲۳

ثابت

رفتار Service.addEventListener() تغییر کرده است به طوری که وقتی یک رویداد رخ می‌دهد، تمام شنونده‌های مرتبط قبل از پردازش رویداد بعدی اجرا می‌شوند. قبل از این تغییر، شنونده‌های رویداد شروع و پایان رندر اسلات برای همان اسلات می‌توانستند خارج از ترتیب اجرا شوند.

هفته منتهی به ۱۵ آگوست ۲۰۲۲

تغییر

نوع بازگشتی Service.removeEventListener() از boolean به void تغییر یافته است.

هفته منتهی به ۲۵ ژوئیه ۲۰۲۲

ویژگی

پشتیبانی آزمایشی برای حراج‌های قطعات FLEDGE اضافه شد تا آزمایش اولیه FLEDGE با چندین فروشنده امکان‌پذیر شود.

جدید در GPT
روش	Slot.setConfig()
شیء	ComponentAuctionConfig SlotSettingsConfig

هفته منتهی به ۱۸ ژوئیه ۲۰۲۲

منسوخ شده

API ContentService دیگر قابل استفاده نیست. فراخوانی googletag.content().setContent اکنون هیچ تاثیری جز ثبت یک هشدار ندارد. ویژگی googletag.content به زودی به طور کامل حذف خواهد شد؛ پس از آن، تلاش برای فراخوانی آن یک استثنا ایجاد می‌کند. به جای آن، از APIهای DOM داخلی مرورگر برای اضافه کردن مستقیم محتوا به عناصر div استفاده کنید.

هفته منتهی به ۲۳ مه ۲۰۲۲

ویژگی

پشتیبانی برای پیکربندی منبع ترافیک درخواست تبلیغات اضافه شد.

پشتیبانی از GPT برای منبع ترافیک
شمارشی	TrafficSource.ORGANIC TrafficSource.PURCHASED
ملک	PrivacySettingsConfig.trafficSource

هفته منتهی به ۷ مارس ۲۰۲۲

اطلاعیه

تبلیغات جایزه‌دار برای وب راه‌اندازی شده‌اند. برای جزئیات بیشتر به مرکز راهنمای مدیر تبلیغات مراجعه کنید.

ویژگی

پشتیبانی از GPT برای تبلیغات جایزه‌دار تحت وب
شمارشی	OutOfPageFormat.REWARDED
رویداد	RewardedSlotClosedEvent
رویداد	RewardedSlotGrantedEvent
رویداد	RewardedSlotReadyEvent
شیء	RewardedPayload

هفته منتهی به ۲۸ فوریه ۲۰۲۲

تغییر

CommandArray.push اکنون توابع ارائه شده را به جای شیء arguments خود، به طور صریح به globalThis متصل می‌کند.

هفته منتهی به ۸ دسامبر ۲۰۲۱

ویژگی

Enumها اکنون یک نگاشت معکوس از مقادیر به کلیدها را نیز نمایش می‌دهند تا با رفتار enumهای TypeScript مطابقت داشته باشند. APIهایی که مقادیر enum را می‌پذیرند بدون تغییر باقی می‌مانند و این نگاشت‌های معکوس جدید نباید استفاده شوند.

هفته منتهی به ۹ آگوست ۲۰۲۱

ویژگی

متد removeEventListener اضافه شد.

تغییر

فراخوانی چندین باره addEventListener با eventType و نمونه تابع callback یکسان، اکنون بدون عملیات است. به عبارت دیگر، اگر یک نمونه تابع callback واحد n بار برای نوع رویداد یکسان ثبت شود، به جای n بار، فقط یک بار در زمان وقوع رویداد اجرا می‌شود.

هفته منتهی به ۲۹ ژوئیه ۲۰۲۱

تغییر

رویدادهای مربوط به قابلیت مشاهده در GPT: ImpressionViewableEvent و SlotVisibilityChangedEvent اکنون در جلسات طولانی صفحه به اجرا ادامه می‌دهند. پیش از این، آنها پس از یک ساعت از بارگذاری صفحه خاموش می‌شدند.

هفته منتهی به ۳ مه ۲۰۲۱

تغییر

GPT دیگر قبل از دریافت تبلیغات، فضایی برای اسلات‌ها تعیین نمی‌کند. این تغییر، تغییر چیدمان تجمعی (CLS) را در سایت‌هایی که با استفاده از CSS فضا رزرو نکرده‌اند، کاهش می‌دهد. برای کاهش بیشتر CLS در سایت خود، توصیه می‌کنیم با استفاده از CSS، فضای غیر صفر را برای تبلیغ رزرو کنید. اطلاعات بیشتر

هفته منتهی به ۲۲ مارس ۲۰۲۱

تغییر

رفتار تابع enableLazyLoad() نیز به‌روزرسانی شد تا رندر شدن بخش‌های پایین صفحه در تب‌های پس‌زمینه نیز به تأخیر بیفتد.

هفته منتهی به ۲۳ فوریه ۲۰۲۱

تغییر

متدهای googletag.pubads().set و Slot.set اکنون می‌توانند در هر زمانی قبل از display یا refresh فراخوانی شوند. قبلاً set فقط زمانی اعمال می‌شد که قبل از googletag.enableServices فراخوانی می‌شد.

هفته منتهی به ۱۶ فوریه ۲۰۲۱

تغییر

اکنون می‌توان API مربوط به googletag.pubads().setPublisherProvidedId در هر زمانی فراخوانی کرد. پیش از این، این API فقط در صورتی کار می‌کرد که قبل از googletag.enableServices فراخوانی شود.

هفته منتهی به ۴ ژانویه ۲۰۲۱

تغییر

اکنون می‌توان API مربوط به googletag.pubads().collapseEmptyDivs بارها و بارها برای تغییر تنظیمات فراخوانی کرد. فراخوانی‌های مکرر قبلی نادیده گرفته می‌شوند.

هفته منتهی به ۱۲ اکتبر ۲۰۲۰

ویژگی

نسخه بتای عمومی بینابینی وب راه‌اندازی شد، به مرکز راهنما مراجعه کنید.

هفته منتهی به ۳۱ آگوست ۲۰۲۰

منسوخ شده

definePassback() و defineOutOfPagePassback() منسوخ شده‌اند. برای نحوه‌ی صحیح ایجاد یک passback به مستندات passback مراجعه کنید.

هفته منتهی به ۱۵ ژوئن ۲۰۲۰

ثابت

رفتار تابع enableLazyLoad() به‌روزرسانی شد تا با collapseEmptyDivs(true) سازگار باشد.

هفته منتهی به ۲۵ مه ۲۰۲۰

تغییر

GPT دیگر از موقعیت مکانی دقیق GPS که توسط ناشران تعیین می‌شود، پشتیبانی نخواهد کرد. به طور خاص، googletag.pubads().setLocation() دیگر از پارامترهای عرض جغرافیایی، طول جغرافیایی یا شعاع پشتیبانی نمی‌کند، بلکه در عوض یک آدرس آزاد را می‌پذیرد.

هفته منتهی به ۲۷ آوریل ۲۰۲۰

اطلاعیه

منطق رندر GPT دیگر به فایل‌های جداگانه ماژولار نمی‌شود. این بدان معناست که GPT در اجرای خود فایل‌های کمتری را دریافت می‌کند و بنابراین تأخیر را کمی کاهش می‌دهد، اما هیچ تأثیر خالصی بر پهنای باند کاربر ندارد.

تغییر

وقتی یک درخواست در GPT فعال می‌شود (با فراخوانی googletag.display() یا googletag.pubads().refresh() )، ما اکنون تمام وضعیت‌های ارائه شده توسط ناشر را به صورت داخلی مسدود می‌کنیم تا قبل از ارسال درخواست، قابل تغییر نباشند. بنابراین، وقتی یک درخواست فعال می‌شود، فقط وضعیتی که تا آن نقطه جمع شده است برای آن درخواست استفاده می‌شود. هر وضعیتی که پس از آن تغییر کند، فقط برای درخواست‌های بعدی اعمال خواهد شد.

هفته منتهی به ۱۱ نوامبر ۲۰۱۹

اطلاعیه

اکنون یک قطعه کد جدید برای ایجاد GPT passbacks توصیه شده است. استفاده از definePassback() و defineOutOfPagePassback() توصیه نمی‌شود، زیرا این توابع به صورت همزمان عمل می‌کنند و ممکن است توسط برخی مرورگرها مسدود شوند. اطلاعات بیشتر .

ویژگی

متد Slot.updateTargetingFromMap() اضافه شد.

ویژگی

PubAdsService.setPrivacySettings() به عنوان روشی جدید برای فعال کردن تنظیمات حریم خصوصی اضافه شد. تنظیمات بیشتر در آینده در اینجا در دسترس خواهند بود.

هفته منتهی به ۲۵ مارس ۲۰۱۹

ثابت

سرویس Pubads اکنون بلافاصله پس از فراخوانی googletag.enableServices() به طور کامل عملیاتی می‌شود، به جای اینکه به صورت ناهمگام مقداردهی اولیه شود. این بدان معناست که googletag.pubadsReady اکنون تضمین می‌کند که درست پس از فراخوانی googletag.enableServices() مقداردهی می‌شود. دیگر نیازی به نمونه‌برداری برای بررسی مقدار googletag.pubadsReady نیست.

هفته منتهی به ۴ فوریه ۲۰۱۹

تغییر

رفتار تابع enableLazyLoad() به‌روزرسانی شد تا پس از فراخوانی enableServices() امکان تغییر در پیکربندی بارگذاری تنبل فراهم شود، به طوری که پیکربندی بارگذاری تنبل برای هر اسلات، هنگام نمایش آن اسلات، ثابت می‌ماند.

هفته منتهی به ۲۱ ژانویه ۲۰۱۹

ویژگی

یک رویداد پشتیبانی‌شده جدید به SlotResponseReceived اضافه شد که هنگام دریافت پاسخ تبلیغ برای یک اسلات فعال می‌شود.

ویژگی

یک فیلد جدید به creativeTemplateId به googleTag.ResponseInformation اضافه شد.

هفته منتهی به ۱۴ ژانویه ۲۰۱۹

ویژگی

یک رویداد پشتیبانی‌شده جدید به SlotRequestedEvent اضافه شد که هنگام درخواست تبلیغ برای یک اسلات اجرا می‌شود.

هفته منتهی به ۲۷ آگوست ۲۰۱۸

تغییر

تابع googletag.display() ‎ اصلاح شد تا googletag.Slot را به عنوان آرگومان بپذیرد.

هفته منتهی به ۶ آگوست ۲۰۱۸

ویژگی

googletag.PubAdsService.enableLazyLoad() را برای بارگذاری تنبل تبلیغات در GPT اضافه می‌کند.

هفته منتهی به ۱۸ ژوئن ۲۰۱۸

ثابت

اشکالی که باعث می‌شد googletag.events.SlotOnloadEvent فعال نشود، برطرف شد.

هفته منتهی به ۳۰ آوریل ۲۰۱۸

ویژگی

googletag.PubAdsService.setTagForUnderAgeOfConsent() را برای کنترل تبلیغات برای کاربران زیر سن قانونی، و googletag.PassbackSlot.setTagForUnderAgeOfConsent() را برای علامت‌گذاری جایگاه بازگشت به عنوان کاربر زیر سن قانونی اضافه می‌کند.

هفته منتهی به ۲۳ آوریل ۲۰۱۸

ویژگی

googletag.PubAdsService.setRequestNonPersonalizedAds() را برای کنترل شخصی‌سازی تبلیغات اضافه می‌کند.

هفته منتهی به ۱۲ مارس ۲۰۱۸

ثابت

تغییر به حالت قبل برگردانده شد که حذف محتوای موجود درون اسلات‌ها را قبل از رفرش متوقف می‌کرد، اگر آن محتوا توسط GPT در آنجا قرار نگرفته باشد. اکنون محتوا پاک خواهد شد.

هفته منتهی به ۱۹ فوریه ۲۰۱۸

اطلاعیه

وقتی از حالت رندر ناهمزمان استفاده می‌شود: در صورت امکان، برای همه درخواست‌های تبلیغاتی، تا سقف ۸۱۹۲ کاراکتر، از روش HTTP GET با استفاده از XMLHttpRequest درخواست تبلیغات کنید. پیش از این، از روش HTTP POST برای درخواست‌های تبلیغاتی بیش از ۴۰۹۶ کاراکتر، تا سقف ۸۱۹۲ کاراکتر، استفاده می‌شد.

تغییر

حذف محتوای موجود درون اسلات‌ها قبل از رفرش متوقف شد، اگر آن محتوا توسط GPT در آنجا قرار نگرفته باشد. این یادداشت نادرست است؛ به مدخل هفته ۱۲ مارس ۲۰۱۸ مراجعه کنید.

هفته منتهی به ۸ ژانویه ۲۰۱۸

تغییر

از سینتکس جایگزین [..., ['fluid'], ...] به عنوان یک NamedSized در یک آرایه چند اندازه‌ای پشتیبانی می‌کند. قبلاً فقط [..., 'fluid', ...] معتبر در نظر گرفته می‌شد.

هفته منتهی به ۱۰ ژوئیه ۲۰۱۷

منسوخ شده

فیلد labelIds از googleTag.ResponseInformation حذف شد.

هفته منتهی به ۵ ژوئن ۲۰۱۷

تغییر

googletag.display() و googletag.pubads().display اصلاح شدند تا یک عنصر div و همچنین یک شناسه div را بپذیرند. این امکان رندر کردن اسلات‌ها را درون divهایی که در DOM سایه قرار دارند، فراهم می‌کند.

هفته منتهی به ۲۷ فوریه ۲۰۱۷

ویژگی

sourceAgnosticCreativeId و sourceAgnosticLineItemId به SlotRenderEndedEvent اضافه شد.

هفته منتهی به ۷ نوامبر ۲۰۱۶

ویژگی

API مربوط به getSlots() روی سرویس برای بازیابی لیست اسلات‌های مرتبط با یک سرویس منتشر شد.

هفته منتهی به ۱۷ اکتبر ۲۰۱۶

تغییر

هر دو Slot.clearTargeting() و PubAdsService.clearTargeting() را طوری تغییر دادیم که یک پارامتر کلیدی اختیاری بگیرند.

هفته منتهی به ۵ سپتامبر ۲۰۱۶

تغییر

خطاهای ثبت‌شده در googletag.cmd.push() دیگر نامرئی نیستند و در کنسول چاپ می‌شوند.

هفته منتهی به ۸ آگوست ۲۰۱۶

ویژگی

رابط برنامه‌نویسی کاربردی SlotOnloadEvent منتشر شد تا امکان گوش دادن به یک فایل خلاق برای اتمام بارگذاری فراهم شود.

هفته منتهی به ۲۵ ژوئیه ۲۰۱۶

ویژگی

APIهای getTargeting() و getTargetingKeys() روی PubAdsService برای بازیابی پارامترهای هدف‌گیری سفارشی در سطح سرویس منتشر شدند.

هفته منتهی به ۲۰ ژوئن ۲۰۱۶

ویژگی

API openConsole() منتشر شد تا کنسول Google Publisher را بدون نیاز به رفرش صفحه باز کند.

هفته منتهی به ۶ ژوئن ۲۰۱۶

ویژگی

APIهای getTargeting() و getTargetingKeys() برای بازیابی پارامترهای هدف‌گیری سفارشی منتشر شدند.

ویژگی

اضافه کردن گزینه پیکربندی که در آن Safeframe باید با فشار دادن محتوا، گسترش را مجاز کند: allowPushExpansion .

هفته منتهی به ۱۶ مه ۲۰۱۶

ویژگی

پشتیبانی از اندازه سیال در درخواست‌های تبلیغاتی چند سایزی.

هفته منتهی به ۱۸ آوریل ۲۰۱۶

ویژگی

API getResponseInformation منتشر شد که اطلاعات پاسخ به تبلیغ را برای جایگاه تبلیغ برمی‌گرداند.

ویژگی

API setAdIframeTitle منتشر شد که ورودی را به عنوان عنوان هر iframe مربوط به محفظه تبلیغاتی که پس از آن ایجاد می‌شود، تنظیم می‌کند.

هفته منتهی به ۴ آوریل ۲۰۱۶

اطلاعیه

حداکثر طول درخواست تبلیغات HTTP GET به ۴۰۹۶ کاراکتر افزایش یافت.

هفته منتهی به ۲۸ مارس ۲۰۱۶

ویژگی

اضافه کردن گزینه پیکربندی که در آن Safeframe باید اجازه گسترش با همپوشانی محتوا را بدهد: allowOverlayExpansion .

ویژگی

اضافه کردن گزینه پیکربندی که در آن SafeFrame باید از ویژگی sandbox HTML5 برای جلوگیری از ناوبری سطح بالا استفاده کند: sandbox .

هفته منتهی به ۲۲ فوریه ۲۰۱۶

ویژگی

افزودن قابلیت تنظیم عناوین برای آی‌فریم‌های محفظه تبلیغات: setAdIframeTitle() .

ویژگی

افزودن یک API برای پیکربندی ویژگی‌های SafeFrame در سطح صفحه و اسلات: setSafeFrameConfig() .

هفته منتهی به ۱۵ فوریه ۲۰۱۶

ویژگی

اضافه کردن قابلیت از بین بردن یک اسلات و استفاده مجدد از div: destroySlots() .

ویژگی

افزودن یک API برای اجبار استفاده از safeframe در جایگاه‌های تبلیغاتی با کنترل‌های جزئی: setForceSafeFrame() .

هفته منتهی به ۷ دسامبر ۲۰۱۵

ویژگی

اضافه کردن رویدادهای مربوط به نمایش اسلات ( SlotVisibilityChangedEvent ).

هفته منتهی به ۲۶ اکتبر ۲۰۱۵

ویژگی

افزودن قابلیت مشاهده‌ی ایمپرشن ( ImpressionViewableEvent ).

ویژگی

به‌روزرسانی هدف‌گیری پس‌گرد از یک نقشه JSON ( Passback.updateTargetingFromMap() ).

ویژگی

پشتیبانی از ویژگی page_url ادسنس از set() و get() برای اسلات‌های پس‌پس.

هفته منتهی به ۱۲ اکتبر ۲۰۱۵

ویژگی

پشتیبانی از پس زدن خارج از صفحه .

هفته منتهی به ۳۱ آگوست ۲۰۱۵

اطلاعیه

بازسازی معماری GPT به یک لودر نازک و یک پیاده‌سازی بزرگتر.

ویژگی

پشتیبانی از اندازه سیال در GPT.