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

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

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

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

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

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

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

هفته ۱۹ اکتبر ۲۰۲۶

ویژگی

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

جدید در GPT
روش	PubAdsService.registerRequestHook()
دارایی	PageSettingsConfig.requestHookTimeoutMs

تغییر

اکنون GPT وقتی پیمایش‌های سمت کارخواه در برنامه‌های تک‌صفحه‌ای (SPA) رخ می‌دهد، همبسته‌ساز صفحه را به‌طور خودکار به‌روز می‌کند. این کار تضمین می‌کند که درخواست‌های آگهی ایجادشده پس‌از انتقال مسیر به‌عنوان بازدید صفحه جدید درنظر گرفته شود، بدون اینکه ناشران نیاز داشته باشند به‌طور دستی PubAdsService.updateCorrelator() را فراخوانی کنند.

هفته ۳۱ اوت ۲۰۲۶

ویژگی

اکنون Google Publisher Tag (GPT) به‌طور خودکار اسکریپت پیاده‌سازی اصلی خود (pubads_impl.js) را با اولویت واکشی بالا با تنظیم fetchpriority="high" روی عنصر اسکریپت درج‌شده پویا درخواست می‌کند. این کار به زمان‌بندهای شبکه مرورگر دستور می‌دهد که واکشی کتابخانه پیاده‌سازی را در اولویت قرار دهند، تأخیر بارگیری آگهی را در مسیر رندرینگ بحرانی کاهش دهند، و ظهورها و کلیک‌ها را با کمترین تأثیر بر سنجه‌های «معیار کلیدی اصلی وب» افزایش دهند.

ناشران می‌توانند با افزودن مستقیم مشخصه fetchpriority به برچسب gpt.js بارکننده<script> در صفحه‌هایشان، این رفتار را پیکربندی یا لغو کنند. اسکریپت پیاده‌سازی که به‌طور پویا تزریق شده است، به‌طور خودکار مقدار مشخصه fetchpriority را که در اسکریپت بارکننده مشخص شده است (برای مثال، fetchpriority="low" یا fetchpriority="auto") به ارث می‌برد.

هفته ۲۴ اوت ۲۰۲۶

اعلامیه

از ۸ سپتامبر ۲۰۲۶، «برچسب ناشر Google»‏ (GPT) به‌طور خودکار جایگاه‌های آگهی فعال را وقتی کاربر ازطریق ناوبری حافظه نهان ناوبری بین صفحات (bfcache) به صفحه برمی‌گردد، بازآوری می‌کند. با بازآوری خودکار این جایگاه‌ها، ناشران می‌توانند به‌طور یکپارچه ظهورها را دوباره به‌دست آورند که این امر می‌تواند به افزایش درآمد آگهی کمک کند. ناشرانی که نیاز به غیرفعال کردن بازآوری خودکار در ناوبری حافظه نهان ناوبری بین صفحات دارند می‌توانند این کار را ازطریق GPT AutoRefreshConfig API انجام دهند.

ویژگی

جدید در GPT
دارایی	AutoRefreshConfig.backForwardCache

هفته ۱۸ مه ۲۰۲۶

اعلامیه

توقف راه‌انداز بینابینی وب «برگشت»

از ۱۵ ژوئن ۲۰۲۶، پیمایش به عقب بااستفاده از دکمه برگشت مرورگر دیگر باعث راه‌اندازی آگهی بینابینی وب Ad Manager در هیچ‌یک از مرورگرهای پشتیبانی‌شده (ازجمله Chrome،‏ Edge، و Opera) نخواهد شد. این به‌روزرسانی به‌طور خودکار برای همه ناشرانی که راه‌انداز «عقب‌گرد» را انتخاب کرده‌اند اعمال می‌شود و نیازی به اقدام ناشر ندارد. این تغییر برای اطمینان از رعایت خط‌مشی جدید «جستجوی Google» درخصوص «ربودن دکمه برگشت» انجام شده است. https://developers.google.com/search/blog/2026/04/back-button-hijacking

هفته ۲۷ آوریل ۲۰۲۶

رفع‌شده

مشکلی را در ویژگی بازآوری خودکار برطرف کرده‌ایم که در آن آگهی‌ها می‌توانستند چندین بار به‌طور متوالی و سریع پس‌از «مداخله آگهی سنگین» Chrome بازآوری شوند. برای محدود کردن بازآوری‌ها، اقدام کاهشی انجام شده است و ما به‌طور فعال روی راه‌حل دائمی‌تری کار می‌کنیم تا از این رفتار جلوگیری کنیم و استحکام این ویژگی را بهبود بخشیم.

هفته ۲۰ آوریل ۲۰۲۶

ویژگی

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

ناشران اکنون می‌توانند از تنظیم tagForAgeTreatment در PrivacySettingsConfig برای اعمال رفتار مناسب با کودکان (معادل TFCD) یا رفتار مناسب با نوجوانان (معادل TAP) استفاده کنند.

جدید در GPT
شمارشی	TagForAgeTreatment
دارایی	PrivacySettingsConfig.tagForAgeTreatment

هفته ۹ مارس ۲۰۲۶

اعلامیه

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

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

هفته ۶ اکتبر ۲۰۲۵

اعلامیه

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

هفته ۲۸ ژوئیه ۲۰۲۵

اعلامیه

تعدادی از تنظیمات موجود در سطح صفحه و جایگاه به میانای برنامه‌سازی کاربردی پیکربندی 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 پیکربندی آن‌ها فهرست می‌کند.

روش(های) پیکربندی قدیمی	جایگزینی میانای برنامه‌سازی کاربردی پیکربندی 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 به‌روزرسانی شده است تا قبل‌از تولید نشانی وب درخواست آگهی، برای درخواست‌هایی که فقط شامل جایگاه‌های زیر خط تا هستند، رشته JS را نیز ارائه دهد. نشان داده شده است که این کار تأثیر مثبتی بر هسته‌های حیاتی وب دارد، بدون اینکه تأثیر منفی بر ظهورها داشته باشد.

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

هفته ۲ ژوئن ۲۰۲۵

اعلامیه

آگهی‌های بینابینی وب اکنون به‌طور کامل از برنامه‌های تک‌صفحه‌ای (SPA) پشتیبانی می‌کنند

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

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

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

هفته ۲۶ مه ۲۰۲۵

اعلامیه

حدگذاری بسامد برای آگهی‌های بینابینی بازی H5 از ۱۲۰ به ۳۰ ثانیه کاهش یافته است.

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

ویژگی

جدید در GPT
دارایی	SlotRenderEndedEvent.responseIdentifier

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

بریکینگ

ویژگی‌های زیر ComponentAuctionConfig.auctionConfig تغییر نام داده‌اند تا با مشخصات Protected Audience API مطابقت داشته باشند.

نام دارایی قدیمی	نام دارایی جدید
decisionLogicUrl	decisionLogicURL
trustedScoringSignalsUrl	trustedScoringSignalsURL

هفته ۲۱ اکتبر ۲۰۲۴

تغییر

‫threadYield را اصلاح کنید تا درصورت دردسترس بودن، از Scheduler.yield به‌جای Scheduler.postTask استفاده کند. برای جزئیات بیشتر، مستندسازی بازده را ببینید.

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

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

ویژگی

پشتیبانی از آگهی‌های بینابینی بازی اضافه شد.

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

هفته ۱۹ اوت ۲۰۲۴

تغییر

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

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

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

هفته ۲۹ ژوئیه ۲۰۲۴

ویژگی

GPT اکنون رشته JS را بااستفاده از Scheduler.postTask (درصورت دردسترس بودن) با اولویت: «مسدود کردن کاربر» درست قبل‌از ارائه طرح‌های آگهی واگذار می‌کند. نشان داده شده است که این کار تأثیر بسیار کمی بر ظهورها دارد، درحالی‌که به‌طور معناداری برای معیارهای کلیدی اصلی وب مفید است. به‌طور پیش‌فرض، GPT فقط درصورتی واگذار می‌کند که جایگاه خارج از ناحیه نمایش باشد.

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

جدید در 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، عدم تکمیل را تقلید می‌کنند. برای نمونه‌ای از نحوه گوش دادن به این رویداد، شنوندگان رویداد آگهی را ببینید. تغییر شامل جمع شدن خودکار جایگاه هنگام استفاده از 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

ویژگی

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

هفته ۲۳ اکتبر ۲۰۲۳

ویژگی

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

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

هفته ۲۴ ژوئیه ۲۰۲۳

اعلامیه

‫Protected Audience API (که قبلاً با نام FLEDGE شناخته می‌شد) با انتشار نسخه ژوئیه Chrome به‌سمت دردسترس بودن عمومی درحال گذار است. با این کار، عملکرد مربوط به مزایده مؤلفه در GPT اکنون پایدار درنظر گرفته می‌شود.

تغییر

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

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

اعلامیه

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

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

هفته ۶ ژوئن ۲۰۲۳

اعلامیه

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

هفته ۲۲ مه ۲۰۲۳

تغییر

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

هفته ۱۸ مه ۲۰۲۳

رفع‌شده

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

هفته ۱ مه ۲۰۲۳

رفع‌شده

اشکالی که باعث می‌شد طرح آگهی هنگام بازآوری جایگاه‌های لنگر چنداندازه‌ای به‌صورت بریده‌شده نشان داده شود برطرف شد.

هفته ۲۷ مارس ۲۰۲۳

تغییر

GPT دیگر از ویژگی‌های مبتنی بر رؤیت‌پذیری در مرورگرهایی که به‌طور بومی از Intersection Observer 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

هفته ۱۸ ژوئیه ۲۰۲۲

منسوخ

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

هفته ۲۳ مه ۲۰۲۲

ویژگی

پشتیبانی از پیکربندی درخواست آگهی منبع ترافیک اضافه شد.

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

هفته ۷ مارس ۲۰۲۲

اعلامیه

آگهی‌های پاداش‌دار برای وب راه‌اندازی شده است. برای جزئیات بیشتر، به مرکز راهنمایی Ad Manager مراجعه کنید.

ویژگی

پشتیبانی GPT از آگهی‌های پاداش‌دار برای وب
شمارشی	OutOfPageFormat.REWARDED
رویداد	RewardedSlotClosedEvent
رویداد	RewardedSlotGrantedEvent
رویداد	RewardedSlotReadyEvent
شیء	RewardedPayload

هفته ۲۸ فوریه ۲۰۲۲

تغییر

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

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

ویژگی

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

هفته ۹ اوت ۲۰۲۱

ویژگی

روش removeEventListener اضافه شد.

تغییر

فراخوانی addEventListener به‌دفعات با همان نمونه تابع بازخوانی و eventType اکنون یک عملیات بی‌تأثیر است. به‌عبارت دیگر، اگر یک نمونه تابع بازخوانی 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 را در هر زمانی فراخوانی کرد. قبلاً فقط درصورتی کار می‌کرد که قبل‌از googletag.enableServices فراخوانی می‌شد.

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

تغییر

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

هفته ۱۲ اکتبر ۲۰۲۰

ویژگی

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

هفته ۳۱ اوت ۲۰۲۰

منسوخ

‫definePassback() و defineOutOfPagePassback() منسوخ شده است. برای نحوه ایجاد صحیح بازگشت، اسناد بازگشت را ببینید.

هفته ۱۵ ژوئن ۲۰۲۰

رفع‌شده

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

هفته ۲۵ مه ۲۰۲۰

تغییر

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

هفته ۲۷ آوریل ۲۰۲۰

اعلامیه

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

تغییر

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

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

اعلامیه

اکنون گزیده توصیه‌شده جدیدی برای ایجاد بازگشت GPT وجود دارد. استفاده از 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 در آنجا قرار نگرفته بود) برگرداندیم. اکنون محتوا پاک می‌شود.

هفته ۱۹ فوریه ۲۰۱۸

اعلامیه

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

تغییر

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

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

تغییر

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

هفته ۱۰ ژوئیه ۲۰۱۷

منسوخ

فیلد labelIds از googleTag.ResponseInformation برداشته شد.

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

تغییر

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

هفته ۲۷ فوریه ۲۰۱۷

ویژگی

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

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

ویژگی

میانای برنامه‌سازی کاربردی getSlots() در «سرویس» برای بازیابی فهرست جایگاه‌های مرتبط با سرویس منتشر شد.

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

تغییر

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

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

تغییر

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

هفته ۸ اوت ۲۰۱۶

ویژگی

میانای برنامه‌سازی کاربردی SlotOnloadEvent منتشر شد تا امکان گوش دادن به طرح‌آگهی برای تکمیل بارگیری فراهم شود.

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

ویژگی

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

هفته ۲۰ ژوئن ۲۰۱۶

ویژگی

میانای برنامه‌سازی کاربردی openConsole() برای باز کردن «کنسول ناشر Google» بدون نیاز به بازآوری صفحه منتشر شد.

هفته ۶ ژوئن ۲۰۱۶

ویژگی

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

ویژگی

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

هفته ۱۶ مه ۲۰۱۶

ویژگی

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

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

ویژگی

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

ویژگی

setAdIframeTitle API منتشر شد که ورودی را به‌عنوان عنوان هر iframe محفظه آگهی که بعداً ایجاد می‌شود تنظیم می‌کند.

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

اعلامیه

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

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

ویژگی

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

ویژگی

افزودن گزینه پیکربندی که در آن SafeFrame باید از مشخصه جعبه امن HTML5 برای جلوگیری از پیمایش سطح بالا استفاده کند: sandbox.

هفته ۲۲ فوریه ۲۰۱۶

ویژگی

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

ویژگی

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

هفته ۱۵ فوریه ۲۰۱۶

ویژگی

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

ویژگی

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

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

ویژگی

درحال افزودن رویدادهای رؤیت‌پذیری جایگاه (SlotVisibilityChangedEvent).

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

ویژگی

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

ویژگی

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

ویژگی

پشتیبانی از مشخصه AdSense set() و get() page_url برای جایگاه‌های بازگشتی.

هفته ۱۲ اکتبر ۲۰۱۵

ویژگی

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

هفته ۳۱ اوت ۲۰۱۵

اعلامیه

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

ویژگی

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