נתוני גרסה של GPT

בדף הזה מתועדים עדכונים בסביבת הייצור של ספריית Google Publisher Tag‏ (GPT). מומלץ לבדוק את הדף הזה מדי פעם כדי לקבל עדכונים על תכונות חדשות או מעודכנות, תיקוני באגים, בעיות ידועות ופונקציות שהוצאו משימוש.

כדי לקבל עדכונים, מוסיפים את כתובת ה-URL של הדף הזה לקורא הפיד שבחרתם, או משתמשים בקישור ישיר אל פיד הערות המוצר בפורמט Atom 1.0סמל הפיד או בפורמט RSS 2.0סמל הפיד.

הסבר על תאריכי השקה

כל השינויים בספריית ה-GPT נבדקים לעומק לפני שהם משוחררים. בנוסף, אנחנו משיקים את הגרסאות למשתמשים בהדרגה כדי להגן עליהם מפני נסיגות לא צפויות. אם תזוהה נסיגה כלשהי בשלב כלשהו במהלך ההשקה, תוכלו לבטל את ההשקה כולה במהירות לפני שהיא תגיע לכל המשתמשים.

לכן, תאריכי הפרסום לא מדויקים. תהליך ההשקה של גרסה יכול להימשך בין כמה ימים לכמה שבועות. כלומר, המשתמשים יראו את השינויים בזמנים שונים. התאריכים שמפורטים בהמשך משקפים את תחילת השבוע שבו השינויים הושקו לכל המשתמשים.

השבוע של 27 בינואר 2025

השמות של המאפיינים הבאים ComponentAuctionConfig.auctionConfig שונו בהתאם למפרט של Protected Audience API .

השם הקודם של הנכס השם החדש של המאפיין
decisionLogicUrl decisionLogicURL
trustedScoringSignalsUrl trustedScoringSignalsURL

השבוע של 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'});, או להחיל אותה על כל המודעות, ללא קשר למיקום שלהן ביחס למסך התצוגה, באמצעות googletag.setConfig({threadYield: 'ENABLED_ALL_SLOTS'});.

העדכון בוצע ב-GPT
נכס googletag.config.PageSettingsConfig.threadYield

השבוע של 29 ביולי 2024

GPT מעביר עכשיו את שרשור ה-JS באמצעות Scheduler.postTask (אם הוא זמין) עם העדיפות 'חסימת משתמשים', ממש לפני עיבוד הקריאייטיב. נמצא שההשפעה על החשיפות היא זניחה, אבל יש לכך השפעה משמעותית על מדדי הליבה לבדיקת חוויית המשתמש באתר. כברירת מחדל, מודעות GPT יוצגו רק אם המקום שלהן במודעה נמצא מחוץ לאזור התצוגה.

אפשר להשבית את התנהגות ברירת המחדל באמצעות googletag.setConfig({adYield: 'DISABLED'}); או להחיל אותה על כל המודעות, ללא קשר למיקום שלהן ביחס למסך התצוגה, באמצעות 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

השבוע של 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 לא יציג יותר גרסאות מיושנות של ספריית ה-JavaScript שלו, וגם לא יציג מודעות בגרסאות האלה. פרטים נוספים זמינים בהודעה הקודמת.

בעלי תוכן דיגיטלי שמוצגים מהכתובת www.googletagservices.com/tag/js/gpt.js יכולים להמשיך לעשות זאת. עם זאת, מומלץ לעבור לדומיין המועדף, כי הוא עשוי לשפר את הביצועים, ויכול להיות שהצגת gpt.js בכתובת www.googletagservices.com תופסק בעתיד.

השבוע של 6 ביוני 2023

החל מ-5 ביולי 2023 או לאחר מכן, GPT לא יציג יותר גרסאות מיושנות של ספריית JavaScript שלו. אין השפעה על בעלי תוכן דיגיטלי שוטעים GPT מכתובת URL רשמית. בעלי תוכן דיגיטלי שמציגים גרסה שנשמרה במטמון של gpt.js,‏ pubads_impl.js או כל ספרייה שהם טוענים, צריכים לעדכן את הדפים שלהם כך שישתמשו בכתובות ה-URL הרשמיות. מידע נוסף זמין במדריך תחילת העבודה.

השבוע של 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

ממשק ה-API של ContentService הוצא משימוש. כיום, קריאה לפונקציה 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 מקשרת עכשיו באופן מפורש את הפונקציות שסופקו ל-globalThis במקום לאובייקט arguments שלה.

השבוע של 8 בדצמבר 2021

Enums חושפים עכשיו גם מיפוי הפוך של ערכים למפתחות, כדי להתאים להתנהגות של enums ב-TypeScript. ממשקי ה-API שמקבלים ערכים של enum לא ישתנו, ואין להשתמש במיפויים ההפוכים החדשים האלה.

השבוע של 9 באוגוסט 2021

נוספה השיטה removeEventListener.

קריאה ל- addEventListener כמה פעמים עם אותו אירוע וסוג פונקציית קריאה חוזרת היא עכשיו פעולה ללא תוצאה. במילים אחרות, אם מופע יחיד של פונקציית קריאה חוזרת רשום n פעמים לאותו סוג אירוע, הוא יבוצע רק פעם אחת כשהאירוע מתרחש, ולא n פעמים.

השבוע של 29 ביולי 2021

אירועי החשיפה של GPT: ImpressionViewableEvent ו-SlotVisibilityChangedEvent ימשיכו לפעול עכשיו בסשנים ארוכים בדפים. בעבר, הן נסגרו שעה אחת אחרי טעינת הדף.

השבוע של 3 במאי 2021

מערכת GPT לא מגדירה יותר מקום לחללים לפני אחזור המודעות. השינוי הזה מפחית את הזזת הפריסה המצטברת (CLS) באתרים שלא הוקצה להם מקום באמצעות CSS. כדי לצמצם עוד יותר את הערך של CLS באתר, מומלץ להקצות לאזור של המודעה שטח לא אפס באמצעות CSS. מידע נוסף

השבוע של 22 במרץ 2021

עדכנו את ההתנהגות של enableLazyLoad() כדי לעכב גם את הרינדור של משבצות מתחת לקצה המסך בכרטיסיות ברקע.

השבוע של 23 בפברואר 2021

עכשיו אפשר להפעיל את השיטות googletag.pubads().set ו-Slot.set בכל שלב לפני display או refresh. בעבר, set הוחל רק כשהקריאה בוצעה לפני googletag.enableServices.

השבוע של 16 בפברואר 2021

עכשיו אפשר להפעיל את ממשק ה-API של googletag.pubads().setPublisherProvidedId בכל שלב. בעבר, הפונקציה פעלה רק אם הקריאה אליה בוצעה לפני googletag.enableServices.

השבוע של 4 בינואר 2021

יכול להיות שמערכת ה-API של googletag.pubads().collapseEmptyDivs תופעל שוב ושוב כדי לשנות הגדרות. המערכת תתעלם מהפעלות חוזרות של קריאות קודמות.

השבוע של 12 באוקטובר 2020

השקנו גרסת בטא פתוחה של מודעות וידאו מעברון לאינטרנט. מידע נוסף זמין במרכז העזרה.

השבוע של 31 באוגוסט 2020

הוצאו משימוש definePassback() ו-defineOutOfPagePassback(). במאמר מסמכים בנושא העברה חוזרת (passback) מוסבר איך יוצרים העברה חוזרת בצורה נכונה.

השבוע של 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 יהיה עכשיו תמיד true מיד אחרי הקריאה ל-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

כשמשתמשים במצב עיבוד אסינכרוני: מבקשים מודעות באמצעות XMLHttpRequest עם השיטה HTTP GET, במידת האפשר, לכל בקשות המודעות, עד למגבלת 8,192 התווים. בעבר, השיטה HTTP POST הייתה משמשת לבקשות להצגת מודעות שכוללות יותר מ-4,096 תווים, עד למגבלה של 8,192 תווים.

הפסיקו להסיר תוכן קיים בתוך משבצות לפני הרענון, אם התוכן הזה לא הוטמע על ידי 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() ב-Service לאחזור רשימת המקומות שמשויכים לשירות.

השבוע של 17 באוקטובר 2016

שינינו את Slot.clearTargeting() ואת PubAdsService.clearTargeting() כך שיקבלו פרמטר מפתח אופציונלי.

השבוע של 5 בספטמבר 2016

שגיאות שזוהו ב-googletag.cmd.push() כבר לא יהיו בלתי נראות, והן יודפסו במסוף.

השבוע של 8 באוגוסט 2016

השקנו את ממשק ה-API SlotOnloadEvent שמאפשר להמתין לסיום הטעינה של נכס קריאייטיב.

השבוע של 25 ביולי 2016

השקנו את ממשקי ה-API getTargeting() ו-getTargetingKeys() ב-PubAdsService, לצורך אחזור של פרמטרים מותאמים אישית של טירגוט ברמת השירות.

השבוע של 20 ביוני 2016

השקנו את ממשק ה-API openConsole() כדי לפתוח את Google Publisher Console בלי צורך לרענן את הדף.

השבוע של 6 ביוני 2016

השקנו את ממשקי ה-API getTargeting() ו-getTargetingKeys() לאחזור פרמטרים מותאמים אישית של טירגוט.

הוספת אפשרות הגדרה שבה Safeframe יאפשר להרחיב את התמונה על ידי דחיפת התוכן: allowPushExpansion.

השבוע של 16 במאי 2016

תמיכה בגודל גמיש בבקשות להצגת מודעות בגדלים שונים.

השבוע של 18 באפריל 2016

השקנו את ה-API getResponseInformation שמחזיר מידע על תגובות למודעות במקום המודעה.

השקנו את ה-API setAdIframeTitle שמגדיר את הקלט ככותרת של כל iframe של מאגר מודעות שנוצר לאחר מכן.

השבוע של 4 באפריל 2016

הגדלת האורך המקסימלי של בקשת מודעה מסוג HTTP GET ל-4,096 תווים.

השבוע של 28 במרץ 2016

הוספת אפשרות הגדרה שבה Safeframe יאפשר להרחיב את התמונה על ידי שכבת-על של תוכן: allowOverlayExpansion.

הוספת אפשרות תצורה שבה SafeFrame צריך להשתמש במאפיין ארגז החול של HTML5 כדי למנוע ניווט ברמה העליונה: sandbox.

השבוע של 22 בפברואר 2016

הוספנו את האפשרות להגדיר שמות למסגרות iframe של מאגרי מודעות: setAdIframeTitle().

הוספת API להגדרת מאפייני SafeFrame ברמת הדף והתצוגה: setSafeFrameConfig().

השבוע של 15 בפברואר 2016

הוספה של היכולת להשמיד חריץ ולהשתמש שוב ב-div: ‏ destroySlots().

הוספת API כדי לאלץ שימוש ב-Safeframe במיקומי מודעות עם אמצעי בקרה מפורטים: setForceSafeFrame().

השבוע של 7 בדצמבר 2015

הוספת אירועים של חשיפה של מודעות במודעות לרשת המדיה (SlotVisibilityChangedEvent).

השבוע של 26 באוקטובר 2015

הוספת ניראות החשיפות (ImpressionViewableEvent).

מעדכנים את הטירגוט של ההעברה החוזרת (passback) ממפת JSON (Passback.updateTargetingFromMap()).

תמיכה במאפיין page_url של AdSense ב-set() וב-get() עבור משבצות של העברה חוזרת (passback).

השבוע של 12 באוקטובר 2015

השבוע של 31 באוגוסט 2015

שינוי המבנה של ארכיטקטורת GPT למטען דק ולהטמעה גדולה יותר.

תמיכה בגודל גמיש ב-GPT.