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

این صفحه به‌روزرسانی‌های تولید را در کتابخانه 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

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

هفته 29 ژانویه 2024

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

هفته 11 دسامبر 2023

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

جدید در GPT
Enum OutOfPageFormat.LEFT_SIDE_RAIL
OutOfPageFormat.RIGHT_SIDE_RAIL

هفته 13 نوامبر 2023

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

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

پشتیبانی برای پیش‌اجرای 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

هفته 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

هفته 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() ).

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

هفته 12 اکتبر 2015

هفته 31 آگوست 2015

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

پشتیبانی از اندازه مایع در GPT.