דף זה תורגם על ידי Cloud Translation API.

חומר עזר של GPT

ההפניה הזו משתמשת בסימון TypeScript כדי לתאר סוגים. בטבלה הבאה מוסבר בקצרה דוגמה.

סוג ביטוי
`string`	סוג המחרוזת הפרימיטיבית.
`string[]`	סוג מערך, שבו ייתכן שהערכים יהיו רק מחרוזות.
`number \| string`	סוג איחוד, שבו הערך יכול להיות מספר או מחרוזת.
`Array<number \| string>`	סוג מערך שבו הערכים הם סוג מורכב (איחוד).
`[number, string]`	סוג גוון, שבו הערך הוא מערך בן שני רכיבים שחייב להכיל מספר ומחרוזת בסדר הזה.
`Slot`	סוג אובייקט, כאשר הערך הוא מופע של `googletag.Slot`.
`() => void`	סוג פונקציה ללא ארגומנטים מוגדרים וללא ערך החזרה.

מידע נוסף על הסוגים הנתמכים של ביטויים וסוגים נתמכים שלהם מפורט ב מדריך השימוש ב-TypeScript .

סוג ההערות

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

יש להקליד הערה
`param: string`	מציין ש-`param` מקבל או מחזיר ערך מחרוזת. התחביר משמש למשתנים, לפרמטרים, למאפיינים ולסוגי החזרה.
`param?: number \| string`	הסמל `param` מציין אופציונלי, אבל אפשר לציין בו מספר או מחרוזת אם יצוינו. תחביר זה משמש לפרמטרים ולמאפיינים.
`...params: Array<() => void>`	מציין שהשדה `params` הוא פרמטר מנוחה שמקבל פונקציות. פרמטרים של מנוחה מקבלים מספר לא מוגבל של ערכים מהסוג שצוין.

הגדרות סוגים

סוגים
`googletag.GeneralSize`	`SingleSize \| MultiSize`
הגדרת גודל חוקית של משבצת זמן, שיכולה להיות בגודל אחד או יותר.
`googletag.MultiSize`	`SingleSize[]`
רשימה של גדלים חוקיים בודדים.
`googletag.NamedSize`	`"fluid" \| ["fluid"]`
גדלים לפי שם שניתן לציין במשבצת. ברוב המקרים גודל הוא מלבן בגודל קבוע, אך יש מקרים שבהם אנחנו צריכים סוגים אחרים של מפרטי גודל. רק הגדלים הבאים תקפים בשם: נוזל: מאגר המודעות מקבל 100% רוחב של תיבת דו-שיח של הורה, ולאחר מכן משנה את גודלו כך שיתאים לתוכן הקריאייטיב. בדומה להתנהגות של אבני בניין רגילות בדף. משמש למודעות מותאמות (למידע נוסף, ניתן לעיין במאמר הקשור). שימו לב: גם `fluid` וגם `['fluid']` הם צורות קבילות להצהרה על גודל נוזל.
`googletag.SingleSize`	`SingleSizeArray \| NamedSize`
גודל חוקי אחד עבור משבצת זמן.
`googletag.SingleSizeArray`	`[number, number]`
מערך של שני מספרים שמייצג את [רוחב, גובה].
`googletag.SizeMapping`	`[SingleSizeArray, GeneralSize]`
מיפוי של גודל אזור התצוגה לגדלים של מודעות. משמש למודעות רספונסיביות.
`googletag.SizeMappingArray`	`SizeMapping[]`
רשימה של מיפויי גודל.
`googletag.secureSignals.SecureSignalProvider`	`BidderSignalProvider \| PublisherSignalProvider`
ממשק להחזרת אות מאובטח של מגיש הצעת מחיר או ספק ספציפיים. יש לספק אחד מתוך `id` או `networkCode`, אבל לא את שניהם.

סוגי Enum

Enums
`googletag.enums.OutOfPageFormat`	פורמטים מחוץ לדף הנתמכים על ידי GPT.
`googletag.enums.TrafficSource`	מקורות תנועה נתמכים על ידי GPT.

`googletag.enums.OutOfPageFormat`

פורמטים מחוץ לדף הנתמכים על ידי GPT.
כדאי לעיין גם בפרטים הבאים
- defineOutOfPageSlot

ערכים
`BOTTOM_ANCHOR`	פורמט העוגן שבו המשבצת נצמדת לתחתית של אזור התצוגה.
`INTERSTITIAL`	פורמט של קריאייטיב מעברון באינטרנט.
`REWARDED`	פורמט מודעה מתגמלת.
`TOP_ANCHOR`	פורמט העוגן שבו המשבצת נצמדת לחלק העליון של אזור התצוגה.

`googletag.enums.TrafficSource`

מקורות תנועה נתמכים על ידי GPT.
כדאי לעיין גם בפרטים הבאים
- PrivacySettingsConfig.trafficSource

ערכים
`ORGANIC`	כניסה ישירה לכתובת URL, חיפוש באתר או הורדת אפליקציה.
`PURCHASED`	תנועה שמפנה אל נכסים שאינם בבעלות (פעילות נרכשת או מתומרצת בדרך אחרת).

googletag

מרחב השמות הגלובלי שבו משתמש Google Publisher Tag API.

סיכום המשתנים
`apiReady`	סימון שמציין ש-API של GPT נטען ומוכן לקריאה.
`cmd`	הפניה לשורת פקודה גלובלית לביצוע אסינכרוני של קריאות הקשורות ל-GPT.
`pubadsReady`	סימון שמציין ש-`PubAdsService` מופעל, נטען ופועל באופן מלא.
`secureSignalProviders`	הפניה למערך של ספקי אותות מאובטחים.

סיכום הפונקציה
`companionAds`	מחזירה הפניה אל `CompanionAdsService`.
`defineOutOfPageSlot`	יוצר משבצת מודעה מחוץ לדף עם הנתיב הנתון של יחידת המודעות.
`defineSlot`	בונה משבצת מודעה עם נתיב וגודל של יחידת מודעות נתונה ומשייכת אותה למזהה של רכיב div בדף שיכיל את המודעה.
`destroySlots`	משמיד את משבצות הזמן, תוך הסרת כל האובייקטים וההפניות הקשורים אליהם מ-GPT.
`disablePublisherConsole`	השבתה של Google Publisher Console.
`display`	שירותים לשירותי רינדור לעיבוד המשבצת.
`enableServices`	הפעלת כל שירותי GPT שהוגדרו למיקומי מודעות בדף.
`getVersion`	מחזירה את הגרסה הנוכחית של GPT.
`openConsole`	פותח את Google Publisher Console.
`pubads`	מחזירה הפניה אל `PubAdsService`.
`setAdIframeTitle`	ההגדרה הזו קובעת את הכותרת לכל מסגרות ה-iframe של מאגר המודעות שנוצרו על ידי `PubAdsService`, ממועד זה ואילך.
`sizeMapping`	יצירת `SizeMappingBuilder` חדש.

googletag.apiReady

apiReady: boolean | undefined
סימון שמציין ש-API של GPT נטען ומוכן לקריאה. הנכס הזה יהיה undefined רק עד שה-API יהיה מוכן.
שימו לב שהדרך המומלצת להתמודד עם אסינכרוני היא להשתמש ב-googletag.cmd כדי להוסיף תורים לקריאה חוזרת (callback) כש-GPT מוכן. התקשרות חזרה זו לא מחייבת לבדוק את googletag.apiReady, מפני שסביר להניח שהן יופעלו לאחר הגדרת ה-API.

דוגמה

JavaScript

if (window.googletag && googletag.apiReady) {
  // GPT API can be called safely.
}

JavaScript (מדור קודם)

if (window.googletag && googletag.apiReady) {
  // GPT API can be called safely.
}

TypeScript

if (window.googletag && googletag.apiReady) {
  // GPT API can be called safely.
}

googletag.cmd

cmd: Array<(this: typeof globalThis) => void> | CommandArray
הפניה לשורת פקודה גלובלית לביצוע אסינכרוני של קריאות הקשורות ל-GPT.
המשתנה googletag.cmd מאותחל למערך JavaScript ריק על ידי התחביר של תג GPT בדף, ו-cmd.push היא השיטה הרגילה של Array.push שמוסיפה רכיב לסוף המערך. כאשר JavaScript של GPT נטען, הוא עובר על כל המערך ומפעיל את כל הפונקציות לפי הסדר. הסקריפט מחליף את cmd באובייקט CommandArray ששיטת הדחיפה שלו מוגדרת לביצוע ארגומנט הפונקציה שהועבר אליו. המנגנון הזה מאפשר ל-GPT להפחית את זמן האחזור הנתמך על ידי אחזור ה-JavaScript באופן אסינכרוני, תוך כדי שהוא מאפשר לדפדפן להמשיך לעבד את הדף.

דוגמה

JavaScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

JavaScript (מדור קודם)

googletag.cmd.push(function () {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

TypeScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
});

googletag.pubadsReady

pubadsReady: boolean | undefined
סימון שמציין ש-PubAdsService מופעל, נטען ופועל באופן מלא. הנכס הזה יהיה undefined עד שהמערכת תקרא ל-enableServices ותתבצע טעינה של PubAdsService.

googletag.secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined
הפניה למערך של ספקי אותות מאובטחים.
המערך של ספקי האותות המאובטחים מקבל רצף של פונקציות ליצירת אותות ומפעיל אותן לפי הסדר. היא מיועדת להחליף מערך סטנדרטי שמשמש להרצה של פונקציות ליצירת אותות אחרי טעינה של GPT.

דוגמה

JavaScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});

JavaScript (מדור קודם)

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    return Promise.resolve("signal");
  },
});

TypeScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});

כדאי לעיין גם בפרטים הבאים

שיתוף אותות מאובטחים עם מגישי הצעות מחיר

googletag.companionAds

companionAds(): CompanionAdsService
מחזירה הפניה אל CompanionAdsService.

החזרות
`CompanionAdsService`	השירות של מודעות נלוות.

googletag.הגדרה OutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
יוצר משבצת מודעה מחוץ לדף עם הנתיב הנתון של יחידת המודעות.
במודעות מותאמות אישית מחוץ לדף, div הוא המזהה של רכיב ה-div שיכיל את המודעה. אפשר למצוא פרטים נוספים במאמר על קריאייטיבים מחוץ לדף.

במודעות divשנתמכות על ידי GPT, נכס div נתמך.

דוגמה

JavaScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

JavaScript (מדור קודם)

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

TypeScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

כדאי לעיין גם בפרטים הבאים

פרמטרים
`adUnitPath: string`	נתיב מלא של יחידת מודעות עם קוד הרשת וקוד יחידת המודעות.
`div?: string \| OutOfPageFormat`	מזהה ה-div שיכיל את יחידת המודעות הזו או את OutOfPageFormat.

החזרות
`Slot \| null`	המשבצת החדשה שנוצרה, או `null` אם לא ניתן ליצור משבצת זמן.

googletag.ConfigureSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null
בונה משבצת מודעה עם נתיב וגודל של יחידת מודעות נתונה ומשייכת אותה למזהה של רכיב div בדף שיכיל את המודעה.

דוגמה

JavaScript

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");

JavaScript (מדור קודם)

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");

TypeScript

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");

כדאי לעיין גם בפרטים הבאים

תחילת העבודה עם תגי Google Publisher

פרמטרים
`adUnitPath: string`	נתיב מלא של יחידת מודעות עם קוד הרשת וקוד היחידה.
`size: GeneralSize`	הרוחב והגובה של החריץ שנוסף. זהו הגודל המשמש בבקשה למודעה אם לא סופק מיפוי של גודל רספונסיבי, או אם הגודל של אזור התצוגה קטן מהגודל הקטן ביותר שצוין במיפוי.
`div?: string`	מזהה ה-div שיכיל את יחידת המודעות הזו.

החזרות
`Slot \| null`	המשבצת החדשה שנוצרה, או `null` אם לא ניתן ליצור משבצת זמן.

googletag.destroySlots

destroySlots(slots?: Slot[]): boolean
משמיד את משבצות הזמן, תוך הסרת כל האובייקטים וההפניות הקשורים אליהם מ-GPT. ממשק ה-API הזה לא תומך במשבצות גישה חוזרות ובמשבצות נלוות.
קריאה ל-API הזה במשבצת גורמת להסרת המודעה ולהסרת אובייקט המיקום מהמצב הפנימי שנשמר על ידי GPT. קריאה לפונקציות נוספות באובייקט המיקום תגרום להתנהגות בלתי מוגדרת. הערה: יכול להיות שהדפדפן עדיין לא ישחרר את הזיכרון שמשויך למשבצת הזו, אם דף ההפניה של אותו אתר מנוהל. קריאה ל-API הזה הופכת את ה-div המשויך למשבצת זו לזמין לשימוש חוזר.

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

דוגמה

JavaScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();

JavaScript (מדור קודם)

// The calls to construct an ad and display contents.
var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();

TypeScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

// This call to destroy both slot1 and slot2.
googletag.destroySlots([slot1, slot2]);

// This call to destroy all slots.
googletag.destroySlots();

פרמטרים
`slots?: Slot[]`	מערך המשבצות להשמדה. המערך הוא אופציונלי. כל המשבצות יושמדו אם לא יצויין.

החזרות
`boolean`	`true` אם מכונות נהרסו, `false` במקום זאת.

googletag.השבתה של בעל תוכן דיגיטלי

disablePublisherConsole(): void
השבתה של Google Publisher Console.
כדאי לעיין גם בפרטים הבאים
- מסוף Google לבעלי תוכן דיגיטלי

googletag.תצוגה

display(divOrSlot: string | Element | Slot): void
שירותים לשירותי רינדור לעיבוד המשבצת. יש להציג כל מיקום מודעה פעם אחת בלבד בכל דף. כל המשבצות צריכות להיות מוגדרות ולהיות משויכות לשירות לפני שהן יוצגו. יש לבצע את הקריאה לתצוגה עד שהרכיב יוצג ב-DOM. הדרך הרגילה להשיג זאת היא להציב אותו בתוך קטע סקריפט בתוך הרכיב div שמופיע בקריאת השיטה.
אם נעשה שימוש בארכיטקטורה של בקשה יחידה (SRA), כל מיקומי המודעות שלא אוחזרו בזמן שמתבצעת קריאה לשיטה הזו אוחזרו יחד. כדי לאלץ משבצת מודעה לא להופיע, יש להסיר את ה-div כולו.
דוגמה
JavaScript

googletag.cmd.push(() => { googletag.display("div-1"); });
JavaScript (מדור קודם)

googletag.cmd.push(function () { googletag.display("div-1"); });
TypeScript

googletag.cmd.push(() => { googletag.display("div-1"); });
כדאי לעיין גם בפרטים הבאים

פרמטרים
`divOrSlot: string \| Element \| Slot`	המזהה של רכיב div שמכיל את משבצת המודעה או רכיב ה-div, או את האובייקט של מיקום המודעה. אם צוין רכיב div, חייב להיות לו מאפיין 'id' שתואם למזהה שהועבר אל `defineSlot`.

googletag.enableServices

enableServices(): void
הפעלת כל שירותי GPT שהוגדרו למיקומי מודעות בדף.

googletag.getVersion

getVersion(): string
מחזירה את הגרסה הנוכחית של GPT.
כדאי לעיין גם בפרטים הבאים
- היסטוריית גרסאות של GPT

החזרות
`string`	מחרוזת ה-GPT המופעלת כעת.

googletag.openConsole

openConsole(div?: string): void
פותח את Google Publisher Console.

דוגמה

JavaScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

JavaScript (מדור קודם)

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

TypeScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

כדאי לעיין גם בפרטים הבאים

מסוף Google לבעלי תוכן דיגיטלי

פרמטרים
`div?: string`	מזהה div של משבצת מודעה. הערך הזה הוא אופציונלי. כשהוא מצוין, המסוף לבעלי אתרים ינסה לפתוח עם פרטים על מיקום המודעה שצוין.

googletag.מפרסמים

pubads(): PubAdsService
מחזירה הפניה אל PubAdsService.

החזרות
`PubAdsService`	שירות מודעות בתכנים של בעלי תוכן דיגיטלי.

googletag.setAdIframeTitle

setAdIframeTitle(title: string): void
ההגדרה הזו קובעת את הכותרת לכל מסגרות ה-iframe של מאגר המודעות שנוצרו על ידי PubAdsService, ממועד זה ואילך.

דוגמה

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (מדור קודם)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

פרמטרים
`title: string`	הכותרת החדשה לכל מסגרות ה-iframe של מאגר המודעות.

googletag.sizeמיפוי

sizeMapping(): SizeMappingBuilder
יצירת SizeMappingBuilder חדש.
כדאי לעיין גם בפרטים הבאים
- גדלים של מודעות: מודעות רספונסיביות

החזרות
`SizeMappingBuilder`	בונה חדש.

googletag.CommandArray

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

סיכום השיטה
`push`	ביצוע רצף הפונקציות שצוינו בארגומנטים לפי הסדר.

דחיפה

push(...f: Array<(this: typeof globalThis) => void>): number
ביצוע רצף הפונקציות שצוינו בארגומנטים לפי הסדר.

דוגמה

JavaScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

JavaScript (מדור קודם)

googletag.cmd.push(function () {
  googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
});

TypeScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
});

פרמטרים
`...f: Array<(this: typeof globalThis) => void>`	פונקציית JavaScript להרצה. הקישור לזמן הריצה יהיה תמיד `globalThis`. כדאי לשקול להעביר פונקציית חץ כדי לשמור על הערך `this` של ההקשר המילולי שמסביב.

החזרות
`number`	מספר הפקודות שעובדו עד כה. הוא תואם לערך ההחזרה של `Array.push` (האורך הנוכחי של המערך).

googletag.CompanionAdsService

מרחיב Service

שירות מודעות נלוות. השירות הזה משתמש במודעות וידאו כדי להציג מודעות נלוות.

סיכום השיטה
`addEventListener`	רישום מאזינים שמאפשר להגדיר פונקציית JavaScript ולהתקשר אליה כשאירוע GPT ספציפי מתרחש בדף. עוברת בירושה מהיחידה הארגונית `googletag.Service.addEventListener`
`getSlots`	אפשר לקבל את רשימת המשבצות המשויכות לשירות הזה. עוברת בירושה מהיחידה הארגונית `googletag.Service.getSlots`
`removeEventListener`	הסרה של מאזינים שנרשמו בעבר. עוברת בירושה מהיחידה הארגונית `googletag.Service.removeEventListener`
`setRefreshUnfilledSlots`	הגדרה זו קובעת אם משבצות נלוות שלא מולאו באופן אוטומטי ימולאו.

כדאי לעיין גם בפרטים הבאים

מודעות נלוות לווידאו ואודיו

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void
הגדרה זו קובעת אם משבצות נלוות שלא מולאו באופן אוטומטי ימולאו.
ניתן לקרוא לשיטה הזו מספר פעמים בכל משך החיים של הדף כדי להפעיל או להשבית את המילוי החוזר. רק מכונות מזל רשומות גם עם PubAdsService ימולאו לאחור. בגלל הגבלות מדיניות, שיטה זו לא מיועדת למלא מיקומים ריקים ריקים בעת הצגת סרטון Ad Exchange.

דוגמה

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (מדור קודם)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

פרמטרים
`value: boolean`	`true` למילוי אוטומטי של משבצות שלא מולאו. `false` כדי להשאיר אותן ללא שינוי.

googletag.PrivacySettingsConfig

אובייקט להגדרות פרטיות.

סיכום נכס
`childDirectedTreatment`	מציין אם יש להתייחס לדף כמיועד לילדים.
`limitedAds`	מאפשר הצגה במצב מודעות מוגבלות כדי לסייע בצורכי רגולציה.
`nonPersonalizedAds`	מאפשר להציג במצב מודעות ללא התאמה אישית כדי לסייע לצורכי התאימות הרגולטוריים של בעלי תוכן דיגיטלי.
`restrictDataProcessing`	מאפשר את הפעלת המודעות במצב עיבוד מוגבל כדי לעמוד בדרישות הרגולטור של בעלי תוכן דיגיטלי.
`trafficSource`	מציין אם הבקשות מייצגות תנועה אורגנית או רכישה.
`underAgeOfConsent`	מציין אם לסמן בקשות להצגת מודעות כמגיעות ממשתמשים מתחת לגיל ההסכמה.

כדאי לעיין גם בפרטים הבאים

קביעת הגדרות פרטיות

צאצאים לילדים

childDirectedTreatment: null | boolean
מציין אם יש להתייחס לדף כמיועד לילדים. כדי להסיר את התצורה צריך להגדיר את null.

מודעות מוגבלות

limitedAds: boolean
מאפשר הצגה במצב מודעות מוגבלות כדי לסייע בצורכי רגולציה. כשהמדיניות הזו מופעלת, אפשר לבקש ספריית GPT עצמה מכתובת URL ללא מודעות ללא קובצי cookie.
כדאי לעיין גם בפרטים הבאים
- הצגת מודעה מוגבלת

nonpersonalizedAds

nonPersonalizedAds: boolean
מאפשר להציג במצב מודעות ללא התאמה אישית כדי לסייע לצורכי התאימות הרגולטוריים של בעלי תוכן דיגיטלי.

הגבלת עיבוד נתונים

restrictDataProcessing: boolean
מאפשר את הפעלת המודעות במצב עיבוד מוגבל כדי לעמוד בדרישות הרגולטור של בעלי תוכן דיגיטלי.

trafficSource

trafficSource: TrafficSource
מציין אם הבקשות מייצגות תנועה אורגנית או רכישה. הערך הזה מאכלס את המאפיין מקור תנועה בדוחות של Ad Manager. אם המדיניות לא מוגדרת, מקור התנועה יוגדר כברירת מחדל לדיווח על undefined.

דוגמה

JavaScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

JavaScript (מדור קודם)

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

TypeScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

מתחת לגיל ההסכמה

underAgeOfConsent: null | boolean
מציין אם לסמן בקשות להצגת מודעות כמגיעות ממשתמשים מתחת לגיל ההסכמה. כדי להסיר את התצורה צריך להגדיר את null.

googletag.PubAdsService

מרחיב Service

שירות מודעות בתכנים של בעלי תוכן דיגיטלי. השירות הזה משמש לאחזור והצגת מודעות מחשבון Google Ad Manager שלך.

סיכום השיטה
`addEventListener`	רישום מאזינים שמאפשר להגדיר פונקציית JavaScript ולהתקשר אליה כשאירוע GPT ספציפי מתרחש בדף. עוברת בירושה מהיחידה הארגונית `googletag.Service.addEventListener`
`clear`	הסרה של המודעות ממשבצות זמן והחלפתן בתוכן ריק.
`clearCategoryExclusions`	ניקוי כל התוויות של אי הכללות של קטגוריות מודעות ברמת הדף.
`clearTargeting`	מנקה פרמטרים של טירגוט בהתאמה אישית למפתח מסוים או לכל המפתחות.
`collapseEmptyDivs`	מאפשרת כיווץ div של משבצות, כדי שהן לא יתפסו מקום בדף כאשר אין תוכן מודעה להצגה.
`disableInitialLoad`	השבתה של בקשות להצגת מודעות בזמן טעינת הדף, אבל התרה של בקשת מודעה באמצעות שיחה ב-`PubAdsService.refresh`.
`display`	בונה ומציג מיקום מודעה עם הנתיב והגודל של יחידת המודעות.
`enableLazyLoad`	מאפשר טעינה מדורגת ב-GPT כפי שהוגדר על ידי אובייקט התצורה.
`enableSingleRequest`	מאפשר מצב בקשה בודדת לאחזור מודעות מרובות בו-זמנית.
`enableVideoAds`	אותות של GPT שמודעת וידאו יוצגו בדף.
`get`	מחזירה את הערך של מאפיין AdSense המשויך למפתח הנתון.
`getAttributeKeys`	הפונקציה מחזירה את מפתחות המאפיינים שהוגדרו בשירות הזה.
`getSlots`	אפשר לקבל את רשימת המשבצות המשויכות לשירות הזה. עוברת בירושה מהיחידה הארגונית `googletag.Service.getSlots`
`getTargeting`	מחזירה פרמטר ספציפי של טירגוט בהתאמה אישית שהוגדר ברמת השירות.
`getTargetingKeys`	הפונקציה הזו מחזירה את הרשימה של כל המפתחות לטירגוט בהתאמה אישית שהוגדרו לשירות.
`isInitialLoadDisabled`	מחזירה אם הבקשות הראשוניות למודעות הושבתו בהצלחה באמצעות קריאה קודמת ל-`PubAdsService.disableInitialLoad`.
`refresh`	מאחזר ומציג מודעות חדשות עבור מיקומים ספציפיים או עבור כל המיקומים בדף.
`removeEventListener`	הסרה של מאזינים שנרשמו בעבר. עוברת בירושה מהיחידה הארגונית `googletag.Service.removeEventListener`
`set`	מגדירים ערכים למאפייני AdSense שחלים על כל מיקומי המודעות בשירות מודעות לבעלי תוכן דיגיטלי.
`setCategoryExclusion`	מגדיר החרגה של קטגוריית מודעות ברמת הדף עבור שם התווית הנתון.
`setCentering`	הפעלה והשבתה של מרכוז אופקי של מודעות.
`setForceSafeFrame`	המדיניות הזו קובעת אם יהיה צורך לעבד את כל המודעות בדף באמצעות מאגר תגים של SafeFrame.
`setLocation`	העברה של פרטי מיקום מאתרים כך שתוכלו לטרגט פריטים גיאוגרפיים למיקומים ספציפיים.
`setPrivacySettings`	המדיניות הזו מאפשרת להגדיר את כל הגדרות הפרטיות מ-API אחד באמצעות אובייקט config.
`setPublisherProvidedId`	מגדיר את הערך של המזהה שסופק על ידי בעל האתר.
`setSafeFrameConfig`	מגדירה את ההעדפות ברמת הדף לתצורה של SafeFrame.
`setTargeting`	מגדיר פרמטרים מותאמים אישית של מיקוד למפתח נתון, החלים על כל מיקומי המודעות בשירות בעלי אתרים של מודעות.
`setVideoContent`	מגדיר את פרטי תוכן הסרטון שיישלחו ביחד עם הבקשות למודעות לצורך טירגוט והחרגת תוכן.
`updateCorrelator`	משנה את המתאם שנשלח עם בקשות להצגת מודעות, ומתחיל בפועל צפייה חדשה בדף.

ברור

clear(slots?: Slot[]): boolean
הסרה של המודעות ממשבצות זמן והחלפתן בתוכן ריק. המשבצות יסומנו כ'לא אחזור'.
באופן ספציפי, ניקוי של מיקום מודעה גורם להסרת המודעה מצפייה בדף לטווח ארוך של GPT, ולכן בקשות עתידיות לא יושפעו ממחסומים או מהחרגות תחרותיות הקשורות למודעה הזו.

דוגמה

JavaScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();

JavaScript (מדור קודם)

var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();

TypeScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

// This call to clear both slot1 and slot2.
googletag.pubads().clear([slot1, slot2]);

// This call to clear all slots.
googletag.pubads().clear();

פרמטרים
`slots?: Slot[]`	מערך המשבצות הפנוי לניקוי. המערך הוא אופציונלי. כל המשבצות ינוקו אם לא יצוינו.

החזרות
`boolean`	מחזירה `true` אם המשבצות נוקו, אחרת `false`.

ניקוי קטגוריה

clearCategoryExclusions(): PubAdsService
ניקוי כל התוויות של אי הכללות של קטגוריות מודעות ברמת הדף. פעולה זו שימושית אם ברצונך לרענן את החריץ.

דוגמה

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.

JavaScript (מדור קודם)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.pubads().setCategoryExclusion("AirlineAd");

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.pubads().clearCategoryExclusions();

// Make ad requests. Any ad can be returned.

כדאי לעיין גם בפרטים הבאים

תוויות מותאמות אישית לחסימת מודעות

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

ניקוי הגדרות טירגוט

clearTargeting(key?: string): PubAdsService
מנקה פרמטרים של טירגוט בהתאמה אישית למפתח מסוים או לכל המפתחות.

דוגמה

JavaScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

JavaScript (מדור קודם)

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

TypeScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

כדאי לעיין גם בפרטים הבאים

טירגוט לפי ערך מפתח

פרמטרים
`key?: string`	מפתח פרמטר של מיקוד. המפתח הוא אופציונלי. אם לא מציינים את הפרמטר, כל נתוני הטירגוט נמחקים.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
מאפשרת כיווץ div של משבצות, כדי שהן לא יתפסו מקום בדף כאשר אין תוכן מודעה להצגה. יש להפעיל את המצב הזה לפני שהשירות יופעל.
כדאי לעיין גם בפרטים הבאים
- כיווץ מיקומי מודעות ריקים
- צמצום הפריסה בפריסה

פרמטרים
`collapseBeforeAdFetch?: boolean`	בחירה אם לכווץ את המיקומים עוד לפני אוחזרו המודעות. הפרמטר הזה הוא אופציונלי. אם לא מספקים אותו, `false` ישמש כערך ברירת המחדל.

החזרות
`boolean`	מחזירה `true` אם מצב כיווץ div הופעל ו-`false` אם לא ניתן להפעיל את מצב הכיווץ כי השיטה הופעלה לאחר הפעלת השירות.

DisabledfirstLoad

disableInitialLoad(): void
השבתה של בקשות להצגת מודעות בזמן טעינת הדף, אבל התרה של בקשת מודעה באמצעות שיחה ב-PubAdsService.refresh. יש להגדיר זאת לפני הפעלת השירות. יש להשתמש במצב אסינכרוני, אחרת לא ניתן יהיה לבקש מודעות באמצעות refresh.
כדאי לעיין גם בפרטים הבאים
- שליטה ברענון וברענון של המודעות
- שליטה בקבוצות של SRA

תצוגה

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
בונה ומציג מיקום מודעה עם הנתיב והגודל של יחידת המודעות. השיטה הזו לא פועלת במצב בקשה יחידה.
הערה: כשמפעילים את השיטה הזו, המערכת יוצרת תמונת מצב של מיקום המודעה ושל הדף כדי להבטיח שההצגה של הבקשה למודעה ורינדור התגובה יהיו עקביות. כל שינוי שמתבצע במשבצת החומה או במצב הדף אחרי קריאה לשיטה הזו (כולל הגדרות הטירגוט, הגדרות הפרטיות, אילוץ SafeFrame וכו') יחול רק על בקשות display() או refresh() שיתרחשו לאחר מכן.

דוגמה

JavaScript

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");

JavaScript (מדור קודם)

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");

TypeScript

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");

כדאי לעיין גם בפרטים הבאים

פרמטרים
`adUnitPath: string`	הנתיב של יחידת המודעות שמיועד להצגה.
`size: GeneralSize`	הרוחב והגובה של המשבצת.
`div?: string \| Element`	המזהה של ה-div המכיל את המשבצת או את הרכיב div עצמו.
`clickUrl?: string`	כתובת ה-URL לקליקים במשבצת הזו.

enableLazyLoad

enableLazyLoad(config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }): void
מאפשר טעינה מדורגת ב-GPT כפי שהוגדר על ידי אובייקט התצורה. כדי לקבל דוגמאות מפורטות יותר, אפשר לעיין בדוגמה לטעינה מדורגת.
הערה: אחזור מדורגת ב-SRA פועל רק אם כל המיקומים נמצאים מחוץ לשולי האחזור.

דוגמה

JavaScript

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});

JavaScript (מדור קודם)

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});

TypeScript

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});

כדאי לעיין גם בפרטים הבאים

פרמטרים

פרמטרים
`config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }`	אובייקט התצורה מאפשר התאמה אישית של ההתנהגות העצלה. כל ההגדרות שהושמטו ישתמשו בהגדרות ברירת מחדל ש-Google תגדיר. כדי להשבית הגדרה מסוימת, כמו שולי אחזור, יש להגדיר את הערך כ-`-1`. `fetchMarginPercent` המרחק המינימלי מאזור התצוגה הנוכחי של המשבצת חייב להיות לפני שאנו מאחזרים את המודעה כאחוז מהגודל של אזור התצוגה. המשמעות של הערך 0 היא "כשהמשבצת מגיעה לאזור התצוגה", 100 פירושו "כשהמודעה נמצאת באזור תצוגה אחד" וכן הלאה. `renderMarginPercent` המרחק המינימלי מאזור התצוגה הנוכחי כמשבצת זמן חייב להיות לפני עיבוד המודעה. כך ניתן לבצע שליפה מראש של המודעה, אך בהמתנה לעיבוד ולהורדה של משאבי משנה אחרים. הערך פועל בדיוק כמו `fetchMarginPercent` כאחוז של אזור התצוגה. `mobileScaling` מכפיל שחל על שוליים במכשירים ניידים. כך אפשר להגדיר שוליים שונים בניידים לעומת שוליים. לדוגמה, ערך של 2.0 יכפיל את כל השוליים ב-2 במכשירים ניידים, מה שיגדיל את המרחק המינימלי שחריץ יכול להיות לפני האחזור והרינדור.

config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }

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

fetchMarginPercent
המרחק המינימלי מאזור התצוגה הנוכחי של המשבצת חייב להיות לפני שאנו מאחזרים את המודעה כאחוז מהגודל של אזור התצוגה. המשמעות של הערך 0 היא "כשהמשבצת מגיעה לאזור התצוגה", 100 פירושו "כשהמודעה נמצאת באזור תצוגה אחד" וכן הלאה.
renderMarginPercent
המרחק המינימלי מאזור התצוגה הנוכחי כמשבצת זמן חייב להיות לפני עיבוד המודעה. כך ניתן לבצע שליפה מראש של המודעה, אך בהמתנה לעיבוד ולהורדה של משאבי משנה אחרים. הערך פועל בדיוק כמו fetchMarginPercent כאחוז של אזור התצוגה.
mobileScaling
מכפיל שחל על שוליים במכשירים ניידים. כך אפשר להגדיר שוליים שונים בניידים לעומת שוליים. לדוגמה, ערך של 2.0 יכפיל את כל השוליים ב-2 במכשירים ניידים, מה שיגדיל את המרחק המינימלי שחריץ יכול להיות לפני האחזור והרינדור.

הפעלה של SingleRequest

enableSingleRequest(): boolean
מאפשר מצב בקשה בודדת לאחזור מודעות מרובות בו-זמנית. לפני שמגדירים את השירות, צריך להגדיר את כל מיקומי המודעות של בעלי תוכן דיגיטלי ולהוסיף אותם ל-PubAdsService. יש להגדיר מצב בקשה יחידה לפני הפעלת השירות.
כדאי לעיין גם בפרטים הבאים
- שיטות מומלצות לעבודה עם מודעות: שימוש נכון בארכיטקטורה של בקשה יחידה
- שליטה בקבוצות של SRA

החזרות
`boolean`	מחזירה `true` אם מצב בקשה בודדת הופעל ו-`false` אם לא ניתן להפעיל מצב בקשה בודדת מפני שהשיטה הופעלה לאחר הפעלת השירות.

אפשר להפעיל מודעות וידאו

enableVideoAds(): void
אותות של GPT שמודעת וידאו יוצגו בדף. כך ניתן להגדיר אילוצים להחרגה במודעות וידאו ובמודעות לרשת המדיה. אם ידוע שתוכן הסרטון הוא PubAdsService.setVideoContent, ניתן להשתמש בהחרגת תוכן במודעות לרשת המדיה.

קבלה

get(key: string): null | string
מחזירה את הערך של מאפיין AdSense המשויך למפתח הנתון.

דוגמה

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (מדור קודם)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

כדאי לעיין גם בפרטים הבאים

המאפיינים של AdSense

פרמטרים
`key: string`	שם המאפיין שיש לחפש.

החזרות
`null \| string`	הערך הנוכחי של מפתח המאפיין, או `null` אם המפתח לא נמצא.

getAttributeKeys

getAttributeKeys(): string[]
הפונקציה מחזירה את מפתחות המאפיינים שהוגדרו בשירות הזה.

דוגמה

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (מדור קודם)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

החזרות
`string[]`	מערך של מפתחות מאפיינים שהוגדרו בשירות הזה. סדר לא מוגדר.

getטירגוט

getTargeting(key: string): string[]
מחזירה פרמטר ספציפי של טירגוט בהתאמה אישית שהוגדר ברמת השירות.

דוגמה

JavaScript

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).

JavaScript (מדור קודם)

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).

TypeScript

googletag.pubads().setTargeting("interests", "sports");

googletag.pubads().getTargeting("interests");
// Returns ['sports'].

googletag.pubads().getTargeting("age");
// Returns [] (empty array).

פרמטרים
`key: string`	מפתח המיקוד שיש לחפש.

החזרות
`string[]`	הערכים המשויכים למפתח הזה, או מערך ריק אם אין מפתח כזה.

getטירגוטKeys

getTargetingKeys(): string[]
הפונקציה הזו מחזירה את הרשימה של כל המפתחות לטירגוט בהתאמה אישית שהוגדרו לשירות.

דוגמה

JavaScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

JavaScript (מדור קודם)

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

TypeScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

החזרות
`string[]`	מערך של מפתחות טירגוט. סדר לא מוגדר.

isfirstLoadDisabled

isInitialLoadDisabled(): boolean
מחזירה אם הבקשות הראשוניות למודעות הושבתו בהצלחה באמצעות קריאה קודמת ל-PubAdsService.disableInitialLoad.

החזרות
`boolean`	פונקציה זו מחזירה את הערך `true` אם קריאה קודמת אל `PubAdsService.disableInitialLoad` בוצעה בהצלחה, אחרת `false`.

רענון

refresh(slots?: null | Slot[], options?: { changeCorrelator: boolean }): void
מאחזר ומציג מודעות חדשות עבור מיקומים ספציפיים או עבור כל המיקומים בדף. פועל רק במצב רינדור אסינכרוני.
כדי להבטיח התנהגות הולמת בכל הדפדפנים, יש להוסיף קריאה ל-display במיקום המודעה עבור הקריאה ל-refresh. אם לא תתבצע קריאה ל-display, ייתכן שהרענון יפעל באופן בלתי צפוי. אם רוצים, אפשר להשתמש בשיטה PubAdsService.disableInitialLoad כדי להפסיק את הצגת המודעה ב-display.

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

דוגמה

JavaScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });

JavaScript (מדור קודם)

var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });

TypeScript

const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to refresh fetches a new ad for slot1 only.
googletag.pubads().refresh([slot1]);

// This call to refresh fetches a new ad for both slot1 and slot2.
googletag.pubads().refresh([slot1, slot2]);

// This call to refresh fetches a new ad for each slot.
googletag.pubads().refresh();

// This call to refresh fetches a new ad for slot1, without changing
// the correlator.
googletag.pubads().refresh([slot1], { changeCorrelator: false });

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });

כדאי לעיין גם בפרטים הבאים

פרמטרים

פרמטרים
`slots?: null \| Slot[]`	המשבצות שיש לרענן. המערך אופציונלי, אם הוא לא צוין, יתבצע רענון של כל המשבצות.
`options?: { changeCorrelator: boolean }`	אפשרויות ההגדרה שמשויכות לשיחת הרענון הזו. `changeCorrelator` מציין אם יש ליצור מתאם חדש לאחזור מודעות. שרתי המודעות שלנו שומרים על ערך המתאם הזה לזמן קצר (כרגע למשך 30 שניות, אך עשויים להשתנות), כך שבקשות עם אותו מתאם שהתקבל בצמוד יחשבו כצפייה בדף יחיד. כברירת מחדל, נוצר מתאם חדש עבור כל רענון. הערה: לאפשרות הזו אין השפעה על צפייה בדף לטווח ארוך של GPT, שמשקפת באופן אוטומטי את המודעות שמוצגות כרגע בדף, ללא זמן תפוגה.

slots?: null | Slot[]

המשבצות שיש לרענן. המערך אופציונלי, אם הוא לא צוין, יתבצע רענון של כל המשבצות.

options?: { changeCorrelator: boolean }

אפשרויות ההגדרה שמשויכות לשיחת הרענון הזו.

changeCorrelator
מציין אם יש ליצור מתאם חדש לאחזור מודעות. שרתי המודעות שלנו שומרים על ערך המתאם הזה לזמן קצר (כרגע למשך 30 שניות, אך עשויים להשתנות), כך שבקשות עם אותו מתאם שהתקבל בצמוד יחשבו כצפייה בדף יחיד. כברירת מחדל, נוצר מתאם חדש עבור כל רענון.

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

הוגדר

set(key: string, value: string): PubAdsService
מגדירים ערכים למאפייני AdSense שחלים על כל מיקומי המודעות בשירות מודעות לבעלי תוכן דיגיטלי.
קריאה נוספת לאותו מפתח יותר מפעם אחת תגרום לביטול הערכים שכבר הוגדרו למפתח הזה. יש להגדיר את כל הערכים לפני ההתקשרות אל display או אל refresh.

דוגמה

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");

JavaScript (מדור קודם)

googletag.pubads().set("adsense_background_color", "#FFFFFF");

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");

כדאי לעיין גם בפרטים הבאים

המאפיינים של AdSense

פרמטרים
`key: string`	שם המאפיין.
`value: string`	ערך המאפיין.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setCategoryהחרגה

setCategoryExclusion(categoryExclusion: string): PubAdsService
מגדיר החרגה של קטגוריית מודעות ברמת הדף עבור שם התווית הנתון.

דוגמה

JavaScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

JavaScript (מדור קודם)

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

TypeScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

כדאי לעיין גם בפרטים הבאים

תוויות מותאמות אישית לחסימת מודעות

פרמטרים
`categoryExclusion: string`	תווית אי-ההכללה של קטגוריות מודעות להוספה.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setCentering

setCentering(centerAds: boolean): void
הפעלה והשבתה של מרכוז אופקי של מודעות. אפשרות המרכז מושבתת כברירת מחדל. בגרסה הקודמת של gpt_mobile.js, האפשרות למרכז פועלת כברירת מחדל.
יש להפעיל שיטה זו לפני הקריאה ל-display או ל-refresh מפני שרק מודעות שהתבקשו לאחר ביצוע קריאה לשיטה זו יהיו ממורכזות.

דוגמה

JavaScript

// Make ads centered.
googletag.pubads().setCentering(true);

JavaScript (מדור קודם)

// Make ads centered.
googletag.pubads().setCentering(true);

TypeScript

// Make ads centered.
googletag.pubads().setCentering(true);

פרמטרים
`centerAds: boolean`	`true` כדי למרכז את המודעות, `false` כדי ליישר אותן שמאלה.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
המדיניות הזו קובעת אם יהיה צורך לעבד את כל המודעות בדף באמצעות מאגר תגים של SafeFrame.
חשוב לזכור את הפרטים הבאים בזמן השימוש ב-API הזה:
- ההגדרה הזו תחול רק על בקשות להצגת מודעות בהמשך שיתקבלו, עבור המשבצות המתאימות.
- אם נקבעה הגדרה ברמת המיקום, היא תמיד תבטל את ההגדרה ברמת הדף.
- אם המודעה מוגדרת לערך true (ברמת המיקום או ברמת הדף), המודעה תמיד תעובד באמצעות מאגר תגים של SafeFrame, ללא קשר לאפשרות שבחרתם בממשק המשתמש של Google Ad Manager.
- עם זאת, אם המדיניות מוגדרת כ-false או אינה מוגדרת, המודעה תוצג באמצעות מאגר תגים של SafeFrame, בהתאם לסוג הקריאייטיב ולאפשרות שנבחרה בממשק המשתמש של Google Ad Manager.
- יש להשתמש ב-API הזה בזהירות מכיוון שהוא עלול להשפיע על ההתנהגות של קריאייטיבים שמנסים לפרוץ את ה-iFrame שלהם או להסתמך על הרינדור שלהם ישירות בדף של בעל התוכן הדיגיטלי.

דוגמה

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (מדור קודם)

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setForceSafeFrame(false)
  .addService(googletag.pubads());

// The following slot will have SafeFrame forced.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

כדאי לעיין גם בפרטים הבאים

עיבוד קריאייטיבים באמצעות SafeFrame

פרמטרים
`forceSafeFrame: boolean`	`true` כדי לאלץ את כל המודעות בדף לעבור רינדור ב-SafeFrames ואת ה`false` כדי לשנות את ההגדרה הקודמת ל-False. אם מגדירים את הערך `false` כהודעה שלא צוינה קודם, לא יחול שינוי.

החזרות
`PubAdsService`	אובייקט השירות שנקרא לו הפונקציה.

setLocation

setLocation(address: string): PubAdsService
העברה של פרטי מיקום מאתרים כך שתוכלו לטרגט פריטים גיאוגרפיים למיקומים ספציפיים.

דוגמה

JavaScript

// Postal code:
googletag.pubads().setLocation("10001,US");

JavaScript (מדור קודם)

// Postal code:
googletag.pubads().setLocation("10001,US");

TypeScript

// Postal code:
googletag.pubads().setLocation("10001,US");

פרמטרים
`address: string`	כתובת בפורמט חופשי

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService
המדיניות הזו מאפשרת להגדיר את כל הגדרות הפרטיות מ-API אחד באמצעות אובייקט config.

דוגמה

JavaScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

JavaScript (מדור קודם)

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

TypeScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

כדאי לעיין גם בפרטים הבאים

פרמטרים
`privacySettings: PrivacySettingsConfig`	אובייקט שמכיל את ההגדרות של הגדרות הפרטיות.

החזרות
`PubAdsService`	אובייקט השירות שנקרא לו הפונקציה.

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService
מגדיר את הערך של המזהה שסופק על ידי בעל האתר.

דוגמה

JavaScript

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");

JavaScript (מדור קודם)

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");

TypeScript

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");

כדאי לעיין גם בפרטים הבאים

מידע על מזהים שניתנים על ידי בעל התוכן הדיגיטלי

פרמטרים
`ppid: string`	מזהה אלפאנומרי שסופק על ידי בעל האתר. הטקסט צריך להיות באורך של 32 עד 150 תווים.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService
מגדירה את ההעדפות ברמת הדף לתצורה של SafeFrame. המערכת תתעלם ממפתחות לא מזוהים באובייקט config. המערכת תתעלם מהתצורה כולה אם יועבר ערך לא חוקי למפתח מזוהה.
אם תציינו העדפות ברמת הדף, המערכת תבטל את ההעדפות האלה ברמת המיקום.

דוגמה

JavaScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (מדור קודם)

googletag.pubads().setForceSafeFrame(true);

var pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

כדאי לעיין גם בפרטים הבאים

עיבוד קריאייטיבים באמצעות SafeFrame

פרמטרים
`config: SafeFrameConfig`	האובייקט של ההגדרה.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setTarget

setTargeting(key: string, value: string | string[]): PubAdsService
מגדיר פרמטרים מותאמים אישית של מיקוד למפתח נתון, החלים על כל מיקומי המודעות בשירות בעלי אתרים של מודעות. קריאה חוזרת לאותו מפתח מספר פעמים תגרום להחלפת ערכים ישנים. המפתחות האלה מוגדרים בחשבון Google Ad Manager.

דוגמה

JavaScript

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);

JavaScript (מדור קודם)

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);

TypeScript

// Example with a single value for a key.
googletag.pubads().setTargeting("interests", "sports");

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);

כדאי לעיין גם בפרטים הבאים

טירגוט לפי ערך מפתח

פרמטרים
`key: string`	מפתח פרמטר של מיקוד.
`value: string \| string[]`	טירגוט של מערך פרמטרים או ערכים.

החזרות
`PubAdsService`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void
מגדיר את פרטי תוכן הסרטון שיישלחו ביחד עם הבקשות למודעות לצורך טירגוט והחרגת תוכן. מודעות וידאו יופעלו באופן אוטומטי כשמפעילים את השיטה הזו. עבור videoContentId ו-videoCmsId, יש להשתמש בערכים שסופקו לשירות הטמעת התוכן של Google Ad Manager.
כדאי לעיין גם בפרטים הבאים
- פרמטרים של כתובות URL של תג מודעה מסוג VAST

פרמטרים
`videoContentId: string`	מזהה תוכן הסרטון.
`videoCmsId: string`	מזהה ה-CMS של הסרטון.

updateCorrelator

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

דוגמה

JavaScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

JavaScript (מדור קודם)

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

TypeScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

החזרות
`PubAdsService`	אובייקט השירות שנקרא לו הפונקציה.

googletag.ResponseInformation

אובייקט שמייצג תגובה אחת למודעה.

סיכום נכס
`advertiserId`	המזהה של המפרסם.
`campaignId`	המזהה של הקמפיין.
`creativeId`	מזהה הקריאייטיב.
`creativeTemplateId`	מזהה התבנית של המודעה.
`lineItemId`	המזהה של הפריט.

כדאי לעיין גם בפרטים הבאים

Slot.getResponseInformation

מזהה מפרסם

advertiserId: null | number
המזהה של המפרסם.

campaignId

campaignId: null | number
המזהה של הקמפיין.

creativeId (מזהה קריאייטיב)

creativeId: null | number
מזהה הקריאייטיב.

creativeTemplateId (מזהה תבנית)

creativeTemplateId: null | number
מזהה התבנית של המודעה.

lineItemId

lineItemId: null | number
המזהה של הפריט.

googletag.REWARDPayload

אובייקט שמייצג את התגמול המשויך למודעה מתגמלת

סיכום נכס
`amount`	מספר הפריטים שכלולים בפרס.
`type`	סוג הפריט שנכלל בפרס (לדוגמה, "מטבע").

כדאי לעיין גם בפרטים הבאים

הצגת מודעה מתגמלת

סכום

amount: number
מספר הפריטים שכלולים בפרס.

סוג

type: string
סוג הפריט שנכלל בפרס (לדוגמה, "מטבע").

googletag.SafeFrameConfig

אובייקט תצורה של קונטיינרים של SafeFrame.

סיכום נכס
`allowOverlayExpansion`	האם SafeFrame אמורה לאפשר הרחבה של תוכן מודעה באמצעות שכבת-על של תוכן דף.
`allowPushExpansion`	קביעה אם ה-SafeFrame מאפשר הרחבה של תוכן מודעה על ידי דחיפת תוכן הדף.
`sandbox`	האם SafeFrame צריך להשתמש במאפיין ארגז החול HTML5 כדי למנוע ניווט ברמה העליונה ללא אינטראקציה של המשתמש.
`useUniqueDomain`	הוצאה משימוש. אם SafeFrame צריך להשתמש בתת-דומיינים אקראיים עבור קריאייטיב בהזמנה.

כדאי לעיין גם בפרטים הבאים

PubAdsService.setSafeFrameConfig

allowLayerExpansion

allowOverlayExpansion: boolean
האם SafeFrame אמורה לאפשר הרחבה של תוכן מודעה באמצעות שכבת-על של תוכן דף.

allowPushExpanion

allowPushExpansion: boolean
קביעה אם ה-SafeFrame מאפשר הרחבה של תוכן מודעה על ידי דחיפת תוכן הדף.

ארגז חול

sandbox: boolean
האם SafeFrame צריך להשתמש במאפיין ארגז החול HTML5 כדי למנוע ניווט ברמה העליונה ללא אינטראקציה של המשתמש. הערך החוקי היחיד הוא true (אי אפשר לאלץ את false). חשוב לשים לב שמאפיין ארגז החול משבית יישומי פלאגין (לדוגמה, Flash).

שימוש ב-ייחודי

useUniqueDomain: null | boolean
אם SafeFrame צריך להשתמש בתת-דומיינים אקראיים עבור קריאייטיב בהזמנה. עליך לעבור בעוד null כדי לנקות את הערך השמור.
הערה: תכונה זו מופעלת כברירת מחדל.

הוצא משימוש: לא ניתן יותר להשבית את התכונה הזו. להגדרה useUniqueDomain אין השפעה.

כדאי לעיין גם בפרטים הבאים
- עיבוד קריאייטיבים באמצעות SafeFrame

googletag.שירות

מחלקת שירות בסיסי שמכילה שיטות הנפוצות לכל השירותים.

סיכום השיטה
`addEventListener`	רישום מאזינים שמאפשר להגדיר פונקציית JavaScript ולהתקשר אליה כשאירוע GPT ספציפי מתרחש בדף.
`getSlots`	אפשר לקבל את רשימת המשבצות המשויכות לשירות הזה.
`removeEventListener`	הסרה של מאזינים שנרשמו בעבר.

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (arg: EventTypeMap[K]) => void): Service
רישום מאזינים שמאפשר להגדיר פונקציית JavaScript ולהתקשר אליה כשאירוע GPT ספציפי מתרחש בדף. האירועים הבאים נתמכים:
אובייקט מסוג האירוע המתאים מועבר למאזין כשהוא נקרא.

דוגמה

JavaScript

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", (event) => {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", function (event) {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// 1. Adding an event listener for the PubAdsService.
googletag.pubads().addEventListener("slotOnload", (event) => {
  console.log("Slot has been loaded:");
  console.log(event);
});

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

פרמטרים
`eventType: K`	מחרוזת המייצגת את סוג האירוע שנוצר על ידי GPT. סוגי האירועים הם תלויי אותיות רישיות (case-sensitive).
`listener: (arg: EventTypeMap[K]) => void`	פונקציה שמקבלת ארגומנט אובייקט אירוע יחיד.

החזרות
`Service`	אובייקט השירות שעבורו בוצעה קריאה לשיטה.

getSlots

getSlots(): Slot[]
אפשר לקבל את רשימת המשבצות המשויכות לשירות הזה.

החזרות
`Slot[]`	המשבצות הבאות שבהן נוספו לשירות.

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (event: EventTypeMap[K]) => void): void
הסרה של מאזינים שנרשמו בעבר.

דוגמה

JavaScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

JavaScript (מדור קודם)

googletag.cmd.push(function () {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  var onViewableListener = function (event) {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(function () {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

TypeScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag
    .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")!
    .addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event: googletag.events.ImpressionViewableEvent) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

פרמטרים
`eventType: K`	מחרוזת המייצגת את סוג האירוע שנוצר על ידי GPT. סוגי האירועים הם תלויי אותיות רישיות (case-sensitive).
`listener: (event: EventTypeMap[K]) => void`	פונקציה שמקבלת ארגומנט אובייקט אירוע יחיד.

googletag.SizeMapspingBuilder

כלי ליצירת אובייקטים במפרטים של מיפוי גדלים. הכלי הזה יעזור לכם ליצור בקלות מפרטי גודל.

סיכום השיטה
`addSize`	הפונקציה מוסיפה מיפוי ממערך בגודל יחיד (מייצג את אזור התצוגה) למערך בגודל יחיד או גדול יותר, שמייצג את המשבצת.
`build`	בניית מפרט של גודל מפה מהמיפויים שנוספו לבנאי זה.

כדאי לעיין גם בפרטים הבאים

גדלים של מודעות: מודעות רספונסיביות

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
הפונקציה מוסיפה מיפוי ממערך בגודל יחיד (מייצג את אזור התצוגה) למערך בגודל יחיד או גדול יותר, שמייצג את המשבצת.

דוגמה

JavaScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

JavaScript (מדור קודם)

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

TypeScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

פרמטרים
`viewportSize: SingleSizeArray`	גודל אזור התצוגה של רשומת המיפוי הזו.
`slotSize: GeneralSize`	הגדלים של מיקום החריץ עבור רשומת המיפוי הזו.

החזרות
`SizeMappingBuilder`	אזכור ליוצר זה.

גרסת build

build(): null | SizeMappingArray
בניית מפרט של גודל מפה מהמיפויים שנוספו לבנאי זה.
אם סופקו מיפויים לא חוקיים, השיטה הזו תחזיר את הערך null. אחרת, מוחזר המפרט בפורמט הנכון, כך שיועבר אל Slot.defineSizeMapping.

הערה: אופן הפעולה של הכלי להגדרת שיטה זו מוגדר באופן לא מוגדר.

החזרות
`null \| SizeMappingArray`	זו תוצאה שהיוצר הזה יצר. המספר יכול להיות null אם סופקו מיפויים לא חוקיים של גודל.

googletag.חריץ

משבצת היא אובייקט המייצג מיקום מודעה אחד בדף.

סיכום השיטה
`addService`	הוספת `Service` למשבצת הזו.
`clearCategoryExclusions`	מנקה את כל התוויות לאי הכללה של קטגוריות מודעות ברמת המיקום עבור משבצת זו.
`clearTargeting`	מנקה פרמטרים ספציפיים או מותאמים אישית של טירגוט ברמת המשבצת הזו.
`defineSizeMapping`	מגדיר מערך של מיפויים מגודל אזור תצוגה מינימלי לגודל חריץ מתאים.
`get`	הפונקציה מחזירה את הערך של המאפיין ב-AdSense שמשויך למפתח הנתון של המשבצת הזו.
`getAdUnitPath`	מחזירה את הנתיב המלא של יחידת המודעות, באמצעות קוד הרשת והנתיב של יחידת המודעות.
`getAttributeKeys`	מחזיר רשימה של מפתחות המאפיינים שהוגדרו במשבצת הזו.
`getCategoryExclusions`	החזרה של תוויות ההחרגה של קטגוריות מודעות למיקום המודעה הזה.
`getResponseInformation`	מחזיר את פרטי התגובה למודעה.
`getSlotElementId`	מחזירה את המזהה של המשבצת `div` שסופקה בזמן שהמשבצת הוגדרה.
`getTargeting`	פונקציה זו מחזירה פרמטר ספציפי של טירגוט מותאם אישית שהוגדר במשבצת זו.
`getTargetingKeys`	פונקציה זו מחזירה את הרשימה של כל מפתחות הטירגוט המותאמים אישית שהוגדרו במשבצת זו.
`set`	מגדיר ערך של מאפיין AdSense במשבצת מודעה זו.
`setCategoryExclusion`	הגדרת תווית אי-הכללה של קטגוריית מודעות ברמת המיקום במשבצת זו.
`setClickUrl`	מגדירה את כתובת ה-URL לקליקים שאליה המשתמשים יופנו אחרי שילחצו על המודעה.
`setCollapseEmptyDiv`	המדיניות הזו קובעת אם מיקום המשבצת `div` יוסתר כשאין מודעה במיקום המודעה.
`setConfig`	קביעת אפשרויות תצורה כלליות למשבצת זו.
`setForceSafeFrame`	המדיניות קובעת אם יש לאלץ הצגה של מודעות במשבצת הזו באמצעות מאגר של פריים.
`setSafeFrameConfig`	מגדירה את ההעדפות ברמת המיקום לתצורת SafeFrame.
`setTargeting`	מגדיר פרמטר מותאם אישית של טירגוט למשבצת הזו.
`updateTargetingFromMap`	מגדיר פרמטרים מותאמים אישית של מיקוד למשבצת זו, ממפת key:value באובייקט JSON.

addService

addService(service: Service): Slot
הוספת Service למשבצת הזו.

דוגמה

JavaScript

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

JavaScript (מדור קודם)

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

TypeScript

googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());

כדאי לעיין גם בפרטים הבאים

פרמטרים
`service: Service`	השירות להוספה.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

ניקוי קטגוריה

clearCategoryExclusions(): Slot
מנקה את כל התוויות לאי הכללה של קטגוריות מודעות ברמת המיקום עבור משבצת זו.

דוגמה

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.

JavaScript (מדור קודם)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

// Clear category exclusions so all ads can be returned.
slot.clearCategoryExclusions();

// Make an ad request. Any ad can be returned for the slot.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

ניקוי הגדרות טירגוט

clearTargeting(key?: string): Slot
מנקה פרמטרים ספציפיים או מותאמים אישית של טירגוט ברמת המשבצת הזו.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

כדאי לעיין גם בפרטים הבאים

טירגוט לפי ערך מפתח

פרמטרים
`key?: string`	מפתח פרמטר של מיקוד. המפתח הוא אופציונלי. אם לא מציינים את הפרמטר, כל נתוני הטירגוט נמחקים.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setSizeMapsping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot
מגדיר מערך של מיפויים מגודל אזור תצוגה מינימלי לגודל חריץ מתאים.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ]
  )
  .build();

slot.defineSizeMapping(mapping);

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

var mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ]
  )
  .build();

slot.defineSizeMapping(mapping);

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ]
  )
  .build();

slot.defineSizeMapping(mapping!);

כדאי לעיין גם בפרטים הבאים

גדלים של מודעות: מודעות רספונסיביות

פרמטרים
`sizeMapping: SizeMappingArray`	מערך של מיפויי גדלים. כדי ליצור אותו, אפשר להשתמש באפליקציה `SizeMappingBuilder`. כל מיפוי של גודל הוא מערך של שני רכיבים: `SingleSizeArray` ו-`GeneralSize`.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

קבלה

get(key: string): null | string
הפונקציה מחזירה את הערך של המאפיין ב-AdSense שמשויך למפתח הנתון של המשבצת הזו. כדי לראות מאפיינים ברמת השירות שעברו בירושה במשבצת הזו, יש להשתמש בפונקציה PubAdsService.get.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

כדאי לעיין גם בפרטים הבאים

המאפיינים של AdSense

פרמטרים
`key: string`	שם המאפיין שיש לחפש.

החזרות
`null \| string`	הערך הנוכחי של מפתח המאפיין, או `null` אם המפתח לא נמצא.

getAdUnitPath

getAdUnitPath(): string
מחזירה את הנתיב המלא של יחידת המודעות, באמצעות קוד הרשת והנתיב של יחידת המודעות.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

החזרות
`string`	נתיב של יחידת מודעות.

getAttributeKeys

getAttributeKeys(): string[]
מחזיר רשימה של מפתחות המאפיינים שהוגדרו במשבצת הזו. כדי לראות את המפתחות של המאפיינים ברמת השירות שעברו בירושה במשבצת הזו, יש להשתמש בפונקציה PubAdsService.getAttributeKeys.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

החזרות
`string[]`	מערך של מפתחות מאפיינים. סדר לא מוגדר.

getCategoryהחרגות

getCategoryExclusions(): string[]
החזרה של תוויות ההחרגה של קטגוריות מודעות למיקום המודעה הזה.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

החזרות
`string[]`	תוויות ההחרגה של קטגוריות מודעות עבור מיקום זה, או מערך ריק אם לא הוגדרו כאלו.

getResponseInformation

getResponseInformation(): null | ResponseInformation
מחזיר את פרטי התגובה למודעה. מבוסס על תגובת המודעה האחרונה למיקום המודעה. אם מפעילים את הפיצ'ר הזה כשהקריאה לא מוצגת במשבצת של המודעה, מחזירה null.

החזרות
`null \| ResponseInformation`	המידע העדכני ביותר לגבי תגובת המודעה, או `null` אם המיקום אינו כולל מודעה.

getSlotElementId

getSlotElementId(): string
מחזירה את המזהה של המשבצת div שסופקה בזמן שהמשבצת הוגדרה.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div-1'.

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div-1'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div-1'.

החזרות
`string`	מזהה משבצת `div`.

getטירגוט

getTargeting(key: string): string[]
פונקציה זו מחזירה פרמטר ספציפי של טירגוט מותאם אישית שהוגדר במשבצת זו. פרמטרים של טירגוט ברמת השירות אינם כלולים.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

slot.getTargeting("age");
// Returns [] (empty array).

פרמטרים
`key: string`	מפתח המיקוד שיש לחפש.

החזרות
`string[]`	הערכים המשויכים למפתח הזה, או מערך ריק אם אין מפתח כזה.

getטירגוטKeys

getTargetingKeys(): string[]
פונקציה זו מחזירה את הרשימה של כל מפתחות הטירגוט המותאמים אישית שהוגדרו במשבצת זו. מפתחות טירגוט ברמת השירות אינם כלולים.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

החזרות
`string[]`	מערך של מפתחות טירגוט. סדר לא מוגדר.

הוגדר

set(key: string, value: string): Slot
מגדיר ערך של מאפיין AdSense במשבצת מודעה זו. הוא יבטל את הערכים שהוגדרו ברמת השירות למפתח הזה.
קריאה לשיטה זו יותר מפעם אחת עבור אותו מפתח תחליף ערכים שהוגדרו בעבר למפתח זה. יש להגדיר את כל הערכים לפני ההתקשרות אל display או אל refresh.

דוגמה

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

JavaScript (מדור קודם)

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

כדאי לעיין גם בפרטים הבאים

המאפיינים של AdSense

פרמטרים
`key: string`	שם המאפיין.
`value: string`	ערך המאפיין.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setCategoryהחרגה

setCategoryExclusion(categoryExclusion: string): Slot
הגדרת תווית אי-הכללה של קטגוריית מודעות ברמת המיקום במשבצת זו.

דוגמה

JavaScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

JavaScript (מדור קודם)

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

כדאי לעיין גם בפרטים הבאים

תוויות מותאמות אישית לחסימת מודעות

פרמטרים
`categoryExclusion: string`	תווית אי-ההכללה של קטגוריות מודעות להוספה.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setClickUrl

setClickUrl(value: string): Slot
מגדירה את כתובת ה-URL לקליקים שאליה המשתמשים יופנו אחרי שילחצו על המודעה.
השרתים של Google Ad Manager עדיין מתעדים קליק, גם אם כתובת ה-URL של הקליק מוחלפת. כל כתובת דף נחיתה המשויכת לקריאייטיב המוצג מצורפת לערך שצוין. הקריאות הבאות יחליפו את הערך. האפשרות הזו רלוונטית רק לבקשות שאינן מסוג SRA.

דוגמה

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

JavaScript (מדור קודם)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

פרמטרים
`value: string`	כתובת ה-URL לקליקים.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setcollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
המדיניות הזו קובעת אם מיקום המשבצת div יוסתר כשאין מודעה במיקום המודעה. הפעולה הזו מבטלת את ההגדרות ברמת השירות.

דוגמה

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

JavaScript (מדור קודם)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

כדאי לעיין גם בפרטים הבאים

פרמטרים
`collapse: boolean`	האם לכווץ את המשבצת אם לא מוחזרת מודעה.
`collapseBeforeAdFetch?: boolean`	בחירה אם לכווץ את מיקום המודעה גם לפני אחזור המודעה. המערכת תתעלם מהמאפיין אם הכיווץ אינו `true`.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setConfig

setConfig(slotConfig: SlotSettingsConfig): void
קביעת אפשרויות תצורה כלליות למשבצת זו.

פרמטרים
`slotConfig: SlotSettingsConfig`	האובייקט של ההגדרה.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot
המדיניות קובעת אם יש לאלץ הצגה של מודעות במשבצת הזו באמצעות מאגר של פריים.
חשוב לזכור את הפרטים הבאים בזמן השימוש ב-API הזה:
- ההגדרה הזו תחול רק על בקשות להצגת מודעות בהמשך שיתקבלו, עבור המשבצות המתאימות.
- אם נקבעה הגדרה ברמת המיקום, היא תמיד תבטל את ההגדרה ברמת הדף.
- אם המודעה מוגדרת לערך true (ברמת המיקום או ברמת הדף), המודעה תמיד תעובד באמצעות מאגר תגים של SafeFrame, ללא קשר לאפשרות שבחרתם בממשק המשתמש של Google Ad Manager.
- עם זאת, אם המדיניות מוגדרת כ-false או אינה מוגדרת, המודעה תוצג באמצעות מאגר תגים של SafeFrame, בהתאם לסוג הקריאייטיב ולאפשרות שנבחרה בממשק המשתמש של Google Ad Manager.
- יש להשתמש ב-API הזה בזהירות מכיוון שהוא עלול להשפיע על ההתנהגות של קריאייטיבים שמנסים לפרוץ את ה-iFrame שלהם או להסתמך על הרינדור שלהם ישירות בדף של בעל התוכן הדיגיטלי.

דוגמה

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

JavaScript (מדור קודם)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

כדאי לעיין גם בפרטים הבאים

עיבוד קריאייטיבים באמצעות SafeFrame

פרמטרים
`forceSafeFrame: boolean`	`true` כדי לאלץ עיבוד של כל המודעות במשבצת הזו ב-SafeFrames ושל `false` כדי לבטל את ההסכמה להגדרה ברמת הדף (אם היא קיימת). אם המדיניות הזו מוגדרת כ-`false` כשהיא לא מוגדרת ברמת הדף, לא ישתנה דבר.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot
מגדירה את ההעדפות ברמת המיקום לתצורת SafeFrame. המערכת תתעלם ממפתחות לא מזוהים באובייקט config. המערכת תתעלם מהתצורה כולה אם יועבר ערך לא חוקי למפתח מזוהה.
אם תציינו את ההעדפות האלה ברמת המיקום, הן יבטלו את ההעדפות ברמת הדף.

דוגמה

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

JavaScript (מדור קודם)

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

TypeScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

googletag.display("div-1");
googletag.display("div-2");

כדאי לעיין גם בפרטים הבאים

עיבוד קריאייטיבים באמצעות SafeFrame

פרמטרים
`config: null \| SafeFrameConfig`	האובייקט של ההגדרה.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

setTarget

setTargeting(key: string, value: string | string[]): Slot
מגדיר פרמטר מותאם אישית של טירגוט למשבצת הזו. קריאה לשיטה זו עבור אותו מפתח מספר פעמים תגרום להחלפת ערכים ישנים. הערכים שמוגדרים כאן יחליפו את הפרמטרים של הטירגוט שהוגדרו ברמת השירות. המפתחות האלה מוגדרים בחשבון Google Ad Manager.

דוגמה

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);

JavaScript (מדור קודם)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);

כדאי לעיין גם בפרטים הבאים

טירגוט לפי ערך מפתח

פרמטרים
`key: string`	מפתח פרמטר של מיקוד.
`value: string \| string[]`	טירגוט של מערך פרמטרים או ערכים.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

updateTargetFromמפה

updateTargetingFromMap(map: { [adUnitPath: string]: string | string[] }): Slot
מגדיר פרמטרים מותאמים אישית של מיקוד למשבצת זו, ממפת key:value באובייקט JSON. מצב זה זהה לקריאה ל-Slot.setTargeting עבור כל ערכי המפתח של האובייקט. המפתחות האלה מוגדרים בחשבון Google Ad Manager.
הערות:
- במקרה של החלפה, רק הערך האחרון יישמר.
- אם הערך הוא מערך, כל הערכים הקודמים יוחלפו, ולא ימוזגו.
- הערכים שמוגדרים כאן יחליפו את הפרמטרים של הטירגוט שהוגדרו ברמת השירות.

דוגמה

JavaScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

JavaScript (מדור קודם)

var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

TypeScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div")!;

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

פרמטרים
`map: { [adUnitPath: string]: string \| string[] }`	מפת פרמטרים של מפתח:ערך.

החזרות
`Slot`	אובייקט החריץ שבו בוצעה קריאה לשיטה.

googletag.config.ComponentauctionConfig

אובייקט שמייצג מכרז רכיב יחיד במכרז מודעות במכשיר.

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

כדאי לעיין גם בפרטים הבאים

FLEDGE: אתרי מכירה מריצים מכרזים במכשיר

מכרז

auctionConfig: null | { auctionSignals: unknown, decisionLogicUrl: string, interestGroupBuyers: string[], perBuyerExperimentGroupIds: { [buyer: string]: number }, perBuyerGroupLimits: { [buyer: string]: number }, perBuyerSignals: { [buyer: string]: unknown }, perBuyerTimeouts: { [buyer: string]: number }, seller: string, sellerExperimentGroupId: number, sellerSignals: unknown, sellerTimeout: number, trustedScoringSignalsUrl: string }
אובייקט הגדרה של מכרז עבור המכרז של הרכיב הזה.
אם הערך הזה מקבל את הערך null, כל ההגדרות הקיימות של configKey יימחקו.

דוגמה

JavaScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

JavaScript (מדור קודם)

var componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

var auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

TypeScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600])!;

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

כדאי לעיין גם בפרטים הבאים

FLEDGE: ביצוע מכרז במכשיר

configKey

configKey: string
מפתח ההגדרה שמשויך למכרז הרכיב הזה.
הערך הזה לא יכול להיות ריק, צריך להיות ייחודי. אם שני אובייקטים של ComponentAuctionConfig חולקים את אותו ערך של configKey, הפריט האחרון שיוגדר יחליף את ההגדרות הקודמות.

googletag.config.SlotSettingsConfig

סיכום נכס
`componentAuction`	נסיוני. מגוון מכרזים של רכיבים שייכללו במכרז של מודעות במכשיר.

מכרז רכיבים

componentAuction: ComponentAuctionConfig[]
מגוון מכרזים של רכיבים שייכללו במכרז של מודעות במכשיר.

googletag.אירועים.אירוע

ממשק בסיס לכל אירועי GPT. לכל אירועי GPT שבהמשך יש את השדות הבאים.

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע.
`slot`	המיקום שהפעיל את האירוע.

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

serviceName

serviceName: string
שם השירות שהפעיל את האירוע.

משבצת זמן

slot: Slot
המיקום שהפעיל את האירוע.

googletag.אירועים.EventTypeMaps

זהו סוג פסאודו הממופה שם של אירוע לסוג אובייקט האירוע המתאים לו Service.addEventListener ו-Service.removeEventListener. היא מתועדת לצורכי בטיחות ועיון בלבד.

סיכום נכס
`impressionViewable`	כינוי עבור `events.ImpressionViewableEvent`.
`rewardedSlotClosed`	כינוי עבור `events.RewardedSlotClosedEvent`.
`rewardedSlotGranted`	כינוי עבור `events.RewardedSlotGrantedEvent`.
`rewardedSlotReady`	כינוי עבור `events.RewardedSlotReadyEvent`.
`slotOnload`	כינוי עבור `events.SlotOnloadEvent`.
`slotRenderEnded`	כינוי עבור `events.SlotRenderEndedEvent`.
`slotRequested`	כינוי עבור `events.SlotRequestedEvent`.
`slotResponseReceived`	כינוי עבור `events.SlotResponseReceived`.
`slotVisibilityChanged`	כינוי עבור `events.SlotVisibilityChangedEvent`.

googletag.אירועים.impressionViewableEvent

מרחיב Event

האירוע הזה מופעל כשחשיפה הופכת לניתנת לצפייה, בהתאם לקריטריונים ל-Active View.

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when an impression becomes viewable.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", function (event) {
  var slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

googletag.אירועים.REWARDSlotClosedEvent

מרחיב Event

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

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when the user closes a rewarded ad slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

googletag.אירועים.REWARDSlotGrantedEvent

מרחיב Event

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

סיכום נכס
`payload`	אובייקט שמכיל מידע על הפרס שהוענק.
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called whenever a reward is granted for a
// rewarded ad.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", function (event) {
  var _a, _b;
  var slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", (_a = event.payload) === null || _a === void 0 ? void 0 : _a.type);
  console.log(
    "Reward amount:",
    (_b = event.payload) === null || _b === void 0 ? void 0 : _b.amount
  );
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מטען ייעודי (payload)

payload: null | RewardedPayload
אובייקט שמכיל מידע על הפרס שהוענק.

googletag.אירועים.REWARDSlotReadyEvent

מרחיב Event

האירוע הזה מופעל כאשר מודעה מתגמלת מוכנה להצגה. בעל האתר אחראי להציג בפני המשתמש את האפשרות להציג את המודעה לפני הצגתה.

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

סיכום השיטה
`makeRewardedVisible`	הצגת המודעה המתגמלת.

דוגמה

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  var userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

הגדרה של מודעות מתגמלות

makeRewardedVisible(): void
הצגת המודעה המתגמלת. אין להשתמש בשיטה הזו עד שהמשתמש הביע הסכמה לצפות במודעה.

googletag.אירועים.SlotOnloadEvent

מרחיב Event

האירוע הזה מופעל כאשר ה-iframe של הקריאייטיב מפעיל את אירוע הטעינה שלו. כשהמערכת מעבדת מודעות מדיה עשירה במצב רינדור סנכרון, לא נעשה שימוש ב-iframe ולכן לא יופעל SlotOnloadEvent.

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when a creative iframe load event fires.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  var slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

googletag.אירועים.SlotRenderEndedEvent

מרחיב Event

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

סיכום נכס
`advertiserId`	מזהה המפרסם של המודעה שעברה עיבוד.
`campaignId`	מזהה הקמפיין של המודעה שעברה עיבוד.
`companyIds`	המזהים של החברות שמגישים הצעות מחיר למודעת המילוי החוזר.
`creativeId`	מזהה הקריאייטיב של המודעה שעברה עיבוד הזמנה.
`creativeTemplateId`	מזהה תבנית הקריאייטיב של המודעה בהזמנה המעובדת.
`isBackfill`	האם מודעה זו הייתה מודעת גיבוי?
`isEmpty`	כאן מצוין אם מודעה הוחזרה למשבצת הזו.
`labelIds`	מזהי התוויות של המודעה שעברה עיבוד.
`lineItemId`	מזהה הפריט של המודעה בהזמנה המעובדת.
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`size`	מציין את גודל הפיקסל של הקריאייטיב לאחר עיבוד.
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`
`slotContentChanged`	האם התוכן של מיקום המודעה השתנה ביחד עם המודעה שעברה עיבוד.
`sourceAgnosticCreativeId`	מזהה הקריאייטיב של המודעה בהזמנה או המודעה למילוי חוזר.
`sourceAgnosticLineItemId`	מזהה הפריט של המודעה בהזמנה או המודעה למילוי חוזר.
`yieldGroupIds`	מזהי קבוצות התפוקה של מודעת המילוי החוזר.

דוגמה

JavaScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when a slot has finished rendering.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", function (event) {
  var slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

מזהה מפרסם

advertiserId: null | number
מזהה המפרסם של המודעה שעברה עיבוד. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

campaignId

campaignId: null | number
מזהה הקמפיין של המודעה שעברה עיבוד. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

companyIds

companyIds: null | number[]
המזהים של החברות שמגישים הצעות מחיר למודעת המילוי החוזר. הערך הוא null עבור מיקומים ריקים, מודעות בהזמנה ומודעות קריאייטיב המוצגות על ידי שירותים שאינם PubAdsService.

creativeId (מזהה קריאייטיב)

creativeId: null | number
מזהה הקריאייטיב של המודעה שעברה עיבוד הזמנה. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

creativeTemplateId (מזהה תבנית)

creativeTemplateId: null | number
מזהה תבנית הקריאייטיב של המודעה בהזמנה המעובדת. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

isBackfill

isBackfill: boolean
האם מודעה זו הייתה מודעת גיבוי? הערך הוא true אם המודעה הייתה מודעת גיבוי, אחרת false.

ריקה

isEmpty: boolean
כאן מצוין אם מודעה הוחזרה למשבצת הזו. הערך הוא true אם לא הוחזרה מודעה. אחרת, false.

מזהי תוויות

labelIds: null | number[]
מזהי התוויות של המודעה שעברה עיבוד. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

lineItemId

lineItemId: null | number
מזהה הפריט של המודעה בהזמנה המעובדת. הערך הוא null עבור מיקומים ריקים, מודעות מילוי חוסרים ומודעות קריאייטיב שנוצרו על ידי שירותים שאינם PubAdsService.

גודל

size: null | string | number[]
מציין את גודל הפיקסל של הקריאייטיב לאחר עיבוד. דוגמה: [728, 90] הערך הוא null עבור מיקומי מודעות ריקים.

slotContentChanged

slotContentChanged: boolean
האם התוכן של מיקום המודעה השתנה ביחד עם המודעה שעברה עיבוד. הערך הוא true אם התוכן השתנה. false אם לא.

sourceAgnosticCreativeId

sourceAgnosticCreativeId: null | number
מזהה הקריאייטיב של המודעה בהזמנה או המודעה למילוי חוזר. הערך הוא null אם המודעה אינה הזמנה או מילוי חוזר של פריט, או שהקריאייטיב מוצג על ידי שירותים שאינם PubAdsService.

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number
מזהה הפריט של המודעה בהזמנה או המודעה למילוי חוזר. הערך הוא null אם המודעה אינה הזמנה או מילוי חוזר של פריט, או שהקריאייטיב מוצג על ידי שירותים שאינם PubAdsService.

yieldGroupIds

yieldGroupIds: null | number[]
מזהי קבוצות התפוקה של מודעת המילוי החוזר. הערך הוא null עבור מיקומים ריקים, מודעות בהזמנה ומודעות קריאייטיב המוצגות על ידי שירותים שאינם PubAdsService.

googletag.אירועים.SlotRequestEvent

מרחיב Event

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

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", function (event) {
  var slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

googletag.אירועים.SlotResponseReceived

מרחיב Event

האירוע הזה מופעל כאשר התקבלה תגובה למודעה במיקום ספציפי.

סיכום נכס
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called when an ad response has been received
// for a slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", function (event) {
  var slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

googletag.אירועים.חריץ/שינוי של אירוע

מרחיב Event

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

סיכום נכס
`inViewPercentage`	אחוז השטח המוצג של המודעה.
`serviceName`	שם השירות שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.serviceName`
`slot`	המיקום שהפעיל את האירוע. עוברת בירושה מהיחידה הארגונית `googletag.events.Event.slot`

דוגמה

JavaScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

JavaScript (מדור קודם)

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", function (event) {
  var slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", "".concat(event.inViewPercentage, "%"));
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

כדאי לעיין גם בפרטים הבאים

מאזינים של אירועי מודעות

inViewPercentage

inViewPercentage: number
אחוז השטח המוצג של המודעה. הערך הוא מספר בין 0 ל-100.

googletag.secureSignals.BidderSignalProvider

מחזירה אות מאובטח עבור מגיש הצעות מחיר ספציפי.

ספק אותות מאובטחים של מגיש הצעות מחיר מורכב מ-2 חלקים:

פונקציית אספן, שמחזירה Promise, שמקבלת אות מאובטח.
id שמזהה את מגיש הצעות המחיר המשויך לאות.

כדי להחזיר אות מאובטח לבעל אפליקציה, יש להשתמש ב-secureSignals.PublisherSignalProvider במקום זאת.

סיכום נכס
`id`	מזהה ייחודי לאספן המשויך לאות המאובטח הזה, כפי שהוא רשום ב-Google Ad Manager.

סיכום השיטה
`collectorFunction`	פונקציה המחזירה `Promise` שמחזירה אות מאובטח.

דוגמה

JavaScript

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (מדור קודם)

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// id is provided
googletag.secureSignalProviders!.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

כדאי לעיין גם בפרטים הבאים

שיתוף אותות מאובטחים עם מגישי הצעות מחיר

מזהה

id: string
מזהה ייחודי לאספן המשויך לאות המאובטח הזה, כפי שהוא רשום ב-Google Ad Manager.

collectionorFunction

collectorFunction(): Promise<string>
פונקציה המחזירה Promise שמחזירה אות מאובטח.

החזרות
`Promise<string>`	הבטחה שמובילה לאות מאובטח.

googletag.secureSignals.PublisherSignalProvider

מחזירה אות מאובטח עבור בעל אתר ספציפי.

ספק אותות של בעלי תוכן דיגיטלי מורכב מ-2 חלקים:

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

כדי להחזיר אות מאובטח למגיש הצעות המחיר, צריך להשתמש במקום זאת ברכיב secureSignals.BidderSignalProvider.

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

סיכום השיטה
`collectorFunction`	פונקציה המחזירה `Promise` שמחזירה אות מאובטח.

דוגמה

JavaScript

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (מדור קודם)

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// networkCode is provided
googletag.secureSignalProviders!.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

כדאי לעיין גם בפרטים הבאים

שיתוף אותות מאובטחים עם מגישי הצעות מחיר

networkCode

networkCode: string
קוד הרשת (כפי שמוצג בנתיב של יחידת המודעות) של בעל האתר המשויך לאות המאובטח הזה.

collectionorFunction

collectorFunction(): Promise<string>
פונקציה המחזירה Promise שמחזירה אות מאובטח.

החזרות
`Promise<string>`	הבטחה שמובילה לאות מאובטח.

googletag.secureSignals.SecureSignalProvidersArray

ממשק לניהול אותות מאובטחים.

סיכום השיטה
`clearAllCache`	כל האותות השמורים במטמון ינוקו מהאחסון המקומי.
`push`	מוסיף `secureSignals.SecureSignalProvider` חדש למערך של ספק האות ומתחיל את תהליך יצירת האות.

ClearAllCache

clearAllCache(): void
כל האותות השמורים במטמון ינוקו מהאחסון המקומי.

דחיפה

push(provider: SecureSignalProvider): void
מוסיף secureSignals.SecureSignalProvider חדש למערך של ספק האות ומתחיל את תהליך יצירת האות.

פרמטרים
`provider: SecureSignalProvider`	האובייקט `secureSignals.SecureSignalProvider` שיתווסף למערך.

חומר עזר של GPT

סוג ההערות

הגדרות סוגים

googletag.GeneralSize

googletag.MultiSize

googletag.NamedSize

googletag.SingleSize

googletag.SingleSizeArray

googletag.SizeMapping

googletag.SizeMappingArray

googletag.secureSignals.SecureSignalProvider

סוגי Enum

googletag.enums.OutOfPageFormat

googletag.enums.TrafficSource

googletag

googletag.apiReady

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.cmd

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.pubadsReady

googletag.secureSignalProviders

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.companionAds

googletag.הגדרה OutOfPageSlot

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.ConfigureSlot

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.destroySlots

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.השבתה של בעל תוכן דיגיטלי

googletag.תצוגה

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.enableServices

googletag.getVersion

googletag.openConsole

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.מפרסמים

googletag.setAdIframeTitle

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.sizeמיפוי

googletag.CommandArray

דחיפה

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.CompanionAdsService

עוברת בירושה מהיחידה הארגונית googletag.Service.addEventListener

עוברת בירושה מהיחידה הארגונית googletag.Service.getSlots

עוברת בירושה מהיחידה הארגונית googletag.Service.removeEventListener

setRefreshUnfilledSlots

JavaScript

JavaScript (מדור קודם)

TypeScript

googletag.PrivacySettingsConfig

צאצאים לילדים

מודעות מוגבלות

nonpersonalizedAds

הגבלת עיבוד נתונים

trafficSource

JavaScript

JavaScript (מדור קודם)

TypeScript

`googletag.GeneralSize`

`googletag.MultiSize`

`googletag.NamedSize`

`googletag.SingleSize`

`googletag.SingleSizeArray`

`googletag.SizeMapping`

`googletag.SizeMappingArray`

`googletag.secureSignals.SecureSignalProvider`

`googletag.enums.OutOfPageFormat`

`googletag.enums.TrafficSource`

עוברת בירושה מהיחידה הארגונית `googletag.Service.addEventListener`

עוברת בירושה מהיחידה הארגונית `googletag.Service.getSlots`

עוברת בירושה מהיחידה הארגונית `googletag.Service.removeEventListener`

עוברת בירושה מהיחידה הארגונית `googletag.Service.addEventListener`

עוברת בירושה מהיחידה הארגונית `googletag.Service.getSlots`

עוברת בירושה מהיחידה הארגונית `googletag.Service.removeEventListener`