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

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

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

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

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

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

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

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

השבוע של 22 במאי 2023

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

השבוע של 18 במאי 2023

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הוספת אפשרות הגדרה שבה SafeFrame צריך להשתמש במאפיין ה-Sandbox של 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.