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

ग्लोबल नेमस्पेस, जिसका इस्तेमाल Google पब्लिशर टैग अपने एपीआई के लिए करता है.
नाम स्थान
config
पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
enums
यह नेमस्पेस है जिसका इस्तेमाल GPT, एनम टाइप के लिए करता है.
events
यह नेमस्पेस है जिसका इस्तेमाल GPT, इवेंट के लिए करता है.
secureSignals
यह नेमस्पेस है जिसका इस्तेमाल GPT, सुरक्षित सिग्नल मैनेज करने के लिए करता है.
इंटरफ़ेस
CommandArray
कमांड कलेक्शन, फ़ंक्शन के क्रम को स्वीकार करता है और उन्हें क्रम से लागू करता है.
CompanionAdsService
साथ में दिखने वाले विज्ञापनों की सेवा.
PrivacySettingsConfig
निजता सेटिंग के लिए कॉन्फ़िगरेशन ऑब्जेक्ट.
PubAdsService
पब्लिशर के लिए विज्ञापन सेवा.
ResponseInformation
एक विज्ञापन रिस्पॉन्स दिखाने वाला ऑब्जेक्ट.
RewardedPayload
इनाम वाले विज्ञापन से जुड़े इनाम को दिखाने वाला ऑब्जेक्ट.
SafeFrameConfig
SafeFrame कंटेनर के लिए कॉन्फ़िगरेशन ऑब्जेक्ट.
Service
बुनियादी सेवा क्लास, जिसमें सभी सेवाओं के लिए सामान्य मेथड होते हैं.
SizeMappingBuilder
साइज़ मैपिंग स्पेसिफ़िकेशन ऑब्जेक्ट के लिए बिल्डर.
Slot
स्लॉट, किसी पेज पर मौजूद एक विज्ञापन स्लॉट को दिखाने वाला ऑब्जेक्ट होता है.
कई एलियस
GeneralSize
स्लॉट के लिए साइज़ का मान्य कॉन्फ़िगरेशन, जो एक या एक से ज़्यादा साइज़ का हो सकता है.
MultiSize
मान्य साइज़ की सूची.
NamedSize
नाम वाले ऐसे साइज़ जो किसी स्लॉट में हो सकते हैं.
SingleSize
स्लॉट के लिए एक मान्य साइज़.
SingleSizeArray
[width, height] दिखाने वाले दो नंबरों का कलेक्शन.
SizeMapping
व्यूपोर्ट साइज़ को विज्ञापन साइज़ से मैप करना.
SizeMappingArray
साइज़ मैपिंग की सूची.
वैरिएबल
apiReady
यह फ़्लैग बताता है कि GPT API लोड हो गया है और उसे कॉल किया जा सकता है.
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
इस बिंदु से, PubAdsService से बनाए गए सभी विज्ञापन कंटेनर iframe के लिए टाइटल सेट करता है.
setConfig
पेज के लिए सामान्य कॉन्फ़िगरेशन के विकल्प सेट करता है.
sizeMapping
नया SizeMappingBuilder बनाता है.

कई एलियस

GeneralSize

GeneralSize: SingleSize | MultiSize
स्लॉट के लिए साइज़ का मान्य कॉन्फ़िगरेशन, जो एक या एक से ज़्यादा साइज़ का हो सकता है.

MultiSize

MultiSize: SingleSize[]
मान्य साइज़ की सूची.

NamedSize

NamedSize: "fluid" | ["fluid"]
नाम वाले ऐसे साइज़ जो किसी स्लॉट में हो सकते हैं. ज़्यादातर मामलों में, साइज़ एक तय साइज़ का रेक्टैंगल होता है. हालांकि, कुछ मामलों में हमें साइज़ की अन्य जानकारी की ज़रूरत होती है. नाम वाले सिर्फ़ ये साइज़ मान्य हैं:
  • फ़्लूइड: विज्ञापन कंटेनर, पैरंट div की 100% चौड़ाई लेता है. इसके बाद, क्रिएटिव कॉन्टेंट के हिसाब से अपनी ऊंचाई में बदलाव करता है. यह उसी तरह काम करता है जिस तरह किसी पेज पर सामान्य ब्लॉक एलिमेंट काम करते हैं. नेटिव विज्ञापनों के लिए इस्तेमाल किया जाता है (मिलता-जुलता लेख देखें). ध्यान दें कि स्लॉट साइज़ को फ़्लूइड के तौर पर दिखाने के लिए, fluid और ['fluid'], दोनों फ़ॉर्म इस्तेमाल किए जा सकते हैं.

SingleSize

स्लॉट के लिए एक मान्य साइज़.

SingleSizeArray

SingleSizeArray: [number, number]
[width, height] दिखाने वाले दो नंबरों का कलेक्शन.

SizeMapping

व्यूपोर्ट साइज़ को विज्ञापन साइज़ से मैप करना. इसका इस्तेमाल रिस्पॉन्सिव विज्ञापनों के लिए किया जाता है.

SizeMappingArray

SizeMappingArray: SizeMapping[]
साइज़ मैपिंग की सूची.

वैरिएबल

Const apiReady

apiReady: boolean | undefined
यह फ़्लैग बताता है कि GPT API लोड हो गया है और उसे कॉल किया जा सकता है. एपीआई के तैयार होने तक, यह प्रॉपर्टी सिर्फ़ undefined होगी.

ध्यान दें कि एक साथ काम नहीं करने वाली प्रोसेस (एसिंक) को मैनेज करने का सुझाया गया तरीका यह है कि GPT के तैयार होने पर कॉलबैक को कतार में लगाने के लिए, googletag.cmd का इस्तेमाल करें. इन कॉलबैक को googletag.apiReady की जांच करने की ज़रूरत नहीं है, क्योंकि एपीआई सेट अप होने के बाद ये कॉलबैक ज़रूर लागू होंगे.

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray
GPT से जुड़े कॉल को एसिंक्रोनस तरीके से लागू करने के लिए, ग्लोबल कमांड सूची का रेफ़रंस.

googletag.cmd वैरिएबल को पेज पर मौजूद GPT टैग सिंटैक्स की मदद से, खाली JavaScript कलेक्शन में शुरू किया जाता है. साथ ही, cmd.push स्टैंडर्ड Array.push तरीका है, जो कलेक्शन के आखिर में एक एलिमेंट जोड़ता है. GPT JavaScript लोड होने पर, यह ऐरे को देखता है और सभी फ़ंक्शन को क्रम से एक्ज़ीक्यूट करता है. इसके बाद, स्क्रिप्ट cmd को CommandArray ऑब्जेक्ट से बदल देती है. इस ऑब्जेक्ट के push तरीके को, उस फ़ंक्शन आर्ग्युमेंट को लागू करने के लिए तय किया जाता है जो उसे पास किया जाता है. इस तरीके से, जीपीटी, 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());
});

Const pubadsReady

pubadsReady: boolean | undefined
इस फ़्लैग से पता चलता है कि PubAdsService चालू है, लोड हो गया है, और पूरी तरह से काम कर रहा है. जब तक enableServices को कॉल नहीं किया जाता और PubAdsService लोड और शुरू नहीं हो जाता, तब तक यह प्रॉपर्टी सिर्फ़ undefined होगी.

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");
  },
});
इन्हें भी देखें

फ़ंक्शन

companionAds

companionAds(): CompanionAdsService
CompanionAdsService का रेफ़रंस दिखाता है.
रिटर्न
CompanionAdsServiceसाथी विज्ञापनों की सेवा.

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
दिए गए विज्ञापन यूनिट पाथ के साथ, पेज के बाहर दिखने वाला विज्ञापन स्लॉट बनाता है.

पसंद के मुताबिक पेज के बाहर दिखने वाले विज्ञापनों के लिए, div उस div एलिमेंट का आईडी होता है जिसमें विज्ञापन होगा. ज़्यादा जानकारी के लिए, पेज के बाहर दिखने वाले क्रिएटिव वाला लेख पढ़ें.

GPT की मदद से मैनेज किए जाने वाले पेज के बाहर दिखने वाले विज्ञापनों के लिए, div एक ऐसा OutOfPageFormat है जिसका इस्तेमाल किया जा सकता है.
उदाहरण

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नेटवर्क कोड और विज्ञापन यूनिट कोड के साथ पूरा विज्ञापन यूनिट पाथ.
Optional div: string | OutOfPageFormatउस div का आईडी जिसमें यह विज्ञापन यूनिट या OutOfPageFormat शामिल होगा.
रिटर्न
Slot | nullनया स्लॉट या null, अगर स्लॉट नहीं बनाया जा सकता.

defineSlot

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");
इन्हें भी देखें
पैरामीटर
adUnitPath: stringनेटवर्क कोड और यूनिट कोड के साथ विज्ञापन यूनिट का पूरा पाथ.
size: GeneralSizeजोड़े गए स्लॉट की चौड़ाई और ऊंचाई. अगर रिस्पॉन्सिव साइज़ मैपिंग नहीं दी गई है या व्यूपोर्ट का साइज़, मैपिंग में दिए गए सबसे छोटे साइज़ से छोटा है, तो विज्ञापन अनुरोध में इस साइज़ का इस्तेमाल किया जाता है.
Optional div: stringउस div का आईडी जिसमें यह विज्ञापन यूनिट होगी.
रिटर्न
Slot | nullनया स्लॉट या null, अगर स्लॉट नहीं बनाया जा सकता.

destroySlots

destroySlots(slots?: Slot[]): boolean
दिए गए स्लॉट को मिटा देता है. साथ ही, GPT से उन स्लॉट के सभी मिलते-जुलते ऑब्जेक्ट और रेफ़रंस हटा देता है. यह एपीआई, पासबैक स्लॉट और साथी स्लॉट के साथ काम नहीं करता.

किसी स्लॉट पर इस एपीआई को कॉल करने से, विज्ञापन हट जाता है और GPT के बनाए गए इंटरनल स्टेटस से स्लॉट ऑब्जेक्ट हट जाता है. स्लॉट ऑब्जेक्ट पर कोई और फ़ंक्शन कॉल करने पर, अनिश्चित व्यवहार होगा. ध्यान दें कि अगर पब्लिशर पेज पर उस स्लॉट का रेफ़रंस मौजूद है, तो हो सकता है कि ब्राउज़र उस स्लॉट से जुड़ी मेमोरी को अब भी खाली न करे. इस एपीआई को कॉल करने से, उस स्लॉट से जुड़ा डिव फिर से इस्तेमाल करने के लिए उपलब्ध हो जाता है.

खास तौर पर, किसी स्लॉट को नष्ट करने से विज्ञापन को 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();
पैरामीटर
Optional slots: Slot[]मिटाए जाने वाले स्लॉट का कलेक्शन. कलेक्शन की वैल्यू देना ज़रूरी नहीं है. अगर कलेक्शन की वैल्यू नहीं दी जाती है, तो सभी स्लॉट मिटा दिए जाएंगे.
रिटर्न
booleantrue अगर स्लॉट मिटा दिए गए हैं, तो false.

disablePublisherConsole

disablePublisherConsole(): void
Google Publisher Console को बंद कर देता है.
इन्हें भी देखें

डिसप्ले

display(divOrSlot: string | Element | Slot): void
स्लॉट को रेंडर करने के लिए, स्लॉट सेवाओं को निर्देश देता है. हर विज्ञापन स्लॉट को हर पेज पर सिर्फ़ एक बार दिखाया जाना चाहिए. सभी स्लॉट को दिखाने से पहले, उन्हें तय करना ज़रूरी है. साथ ही, उनसे जुड़ी कोई सेवा भी होनी चाहिए. जब तक एलिमेंट डीओएम में मौजूद नहीं होता, तब तक डिसप्ले कॉल नहीं होना चाहिए. ऐसा करने का सामान्य तरीका यह है कि इसे, मेथड कॉल में नाम वाले div एलिमेंट में स्क्रिप्ट ब्लॉक में डालें.

अगर सिंगल रिक्वेस्ट आर्किटेक्चर (एसआरए) का इस्तेमाल किया जा रहा है, तो इस तरीके को कॉल करने के समय, फ़ेच नहीं किए गए सभी विज्ञापन स्लॉट एक साथ फ़ेच हो जाएंगे. किसी विज्ञापन स्लॉट को दिखाने से रोकने के लिए, पूरे div को हटाना होगा.
इन्हें भी देखें
पैरामीटर
divOrSlot: string | Element | Slotविज्ञापन स्लॉट वाले div एलिमेंट का आईडी या div एलिमेंट या स्लॉट ऑब्जेक्ट. अगर कोई div एलिमेंट दिया गया है, तो उसमें 'id' एट्रिब्यूट होना चाहिए, जो defineSlot में पास किए गए आईडी से मेल खाता हो.

enableServices

enableServices(): void
पेज पर विज्ञापन स्लॉट के लिए तय की गई सभी GPT सेवाओं को चालू करता है.

getVersion

getVersion(): string
GPT का मौजूदा वर्शन दिखाता है.
इन्हें भी देखें
रिटर्न
stringफ़िलहाल, GPT के जिस वर्शन का इस्तेमाल किया जा रहा है उसकी स्ट्रिंग.

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();
इन्हें भी देखें
पैरामीटर
Optional div: stringविज्ञापन स्लॉट का div आईडी. यह वैल्यू देना ज़रूरी नहीं है. विज्ञापन स्लॉट की जानकारी देने पर, Publisher Console उस विज्ञापन स्लॉट की जानकारी के साथ खुलेगा.

pubads

pubads(): PubAdsService
PubAdsService का रेफ़रंस दिखाता है.
रिटर्न
PubAdsServiceपब्लिशर के विज्ञापन की सेवा.

setAdIframeTitle

setAdIframeTitle(title: string): void
इस बिंदु से, PubAdsService से बनाए गए सभी विज्ञापन कंटेनर iframe के लिए शीर्षक सेट करता है.
उदाहरण

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (लेगसी)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");
पैरामीटर
title: stringसभी विज्ञापन कंटेनर iframes का नया टाइटल.

setConfig

setConfig(config: PageSettingsConfig): void
पेज के लिए सामान्य कॉन्फ़िगरेशन के विकल्प सेट करता है.
पैरामीटर
config: PageSettingsConfig

sizeMapping

sizeMapping(): SizeMappingBuilder
यह एक नया SizeMappingBuilder बनाता है.
इन्हें भी देखें
रिटर्न
SizeMappingBuilderनया बिल्डर.

googletag.CommandArray

कमांड कलेक्शन, फ़ंक्शन के क्रम को स्वीकार करता है और उन्हें क्रम से लागू करता है. इसका मकसद, स्टैंडर्ड कलेक्शन को बदलना है. इसका इस्तेमाल, GPT लोड होने के बाद, फ़ंक्शन को सूची में शामिल करने के लिए किया जाता है.
तरीके
push
आर्ग्युमेंट में दिए गए फ़ंक्शन के क्रम को क्रम से लागू करता है.

तरीके

पुश

push(...f: ((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());
});
पैरामीटर
Rest ...f: ((this: typeof globalThis) => void)[]ऐसा JavaScript फ़ंक्शन जिसे लागू करना है. रनटाइम बाइंडिंग हमेशा globalThis होगी. लैक्सिकल कॉन्टेक्स्ट में मौजूद this वैल्यू को बनाए रखने के लिए, ऐरो फ़ंक्शन का इस्तेमाल करें.
रिटर्न
numberअब तक प्रोसेस किए गए निर्देशों की संख्या. यह Array.push की रिटर्न वैल्यू (कलेक्शन की मौजूदा लंबाई) के साथ काम करता है.

googletag.CompanionAdsService

बढ़ाता है Service
साथ में दिखने वाले विज्ञापनों की सेवा. वीडियो विज्ञापनों में इस सेवा का इस्तेमाल, साथ में दिखने वाले विज्ञापन दिखाने के लिए किया जाता है.
तरीके
addEventListener
एक लिसनर को रजिस्टर करता है. इससे, पेज पर कोई खास GPT इवेंट होने पर, JavaScript फ़ंक्शन को सेट अप और कॉल किया जा सकता है.
getSlots
इस सेवा से जुड़े स्लॉट की सूची पाएं.
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: booleantrue, खाली स्लॉट को अपने-आप बैकफ़िल करने के लिए, false, उन्हें बिना किसी बदलाव के छोड़ने के लिए.

googletag.PrivacySettingsConfig

निजता सेटिंग के लिए कॉन्फ़िगरेशन ऑब्जेक्ट.
प्रॉपर्टी
childDirectedTreatment?
इससे पता चलता है कि पेज को बच्चों के लिए बनाया गया माना जाना चाहिए या नहीं.
limitedAds?
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, सीमित तौर पर विज्ञापन दिखाए जाने की सुविधा मोड में विज्ञापन दिखाने की सुविधा चालू करता है.
nonPersonalizedAds?
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, लोगों के हिसाब से न दिखाए जाने वाले विज्ञापन मोड में विज्ञापन दिखाने की सुविधा चालू करता है.
restrictDataProcessing?
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, विज्ञापन दिखाने की सुविधा को सीमित प्रोसेसिंग मोड में चलाने की अनुमति देता है.
trafficSource?
इससे पता चलता है कि अनुरोध, खरीदे गए या ऑर्गैनिक ट्रैफ़िक से जुड़े हैं.
underAgeOfConsent?
इससे पता चलता है कि विज्ञापन अनुरोधों को सहमति देने की कानूनी उम्र से कम के उपयोगकर्ताओं से मिले अनुरोधों के तौर पर मार्क करना है या नहीं.
इन्हें भी देखें

प्रॉपर्टी

Optional childDirectedTreatment

childDirectedTreatment?: null | boolean
इससे पता चलता है कि पेज को बच्चों के लिए माना जाना चाहिए या नहीं. कॉन्फ़िगरेशन मिटाने के लिए, null पर सेट करें.

Optional limitedAds

limitedAds?: boolean
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, सीमित तौर पर विज्ञापन दिखाने की सुविधा को चालू करता है.

सीमित तौर पर विज्ञापन दिखाने का अनुरोध करने के लिए, GPT को दो तरीकों से निर्देश दिया जा सकता है:
  • IAB टीसीएफ़ के 2.0 वर्शन वाले सहमति मैनेजमेंट प्लैटफ़ॉर्म से मिले सिग्नल का इस्तेमाल करके, अपने-आप.
  • मैन्युअल तरीके से, इस फ़ील्ड की वैल्यू को true पर सेट करके.
सीमित तौर पर दिखाए जाने वाले विज्ञापनों को मैन्युअल तरीके से कॉन्फ़िगर करने की सुविधा सिर्फ़ तब उपलब्ध होती है, जब GPT को सीमित तौर पर दिखाए जाने वाले विज्ञापनों के यूआरएल से लोड किया जाता है. अगर GPT को स्टैंडर्ड यूआरएल से लोड किया गया है, तो इस सेटिंग में बदलाव करने पर पब्लिशर कंसोल से चेतावनी मिलेगी.

ध्यान दें कि सीएमपी का इस्तेमाल होने पर, सीमित विज्ञापनों को मैन्युअल तरीके से चालू करने की ज़रूरत नहीं है.
उदाहरण

JavaScript

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

JavaScript (लेगसी)

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

TypeScript

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});
इन्हें भी देखें

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, लोगों के हिसाब से न दिखाए जाने वाले विज्ञापन मोड में विज्ञापन दिखाने की सुविधा चालू करता है.

Optional restrictDataProcessing

restrictDataProcessing?: boolean
पब्लिशर को नियमों का पालन करने में मदद करने के लिए, विज्ञापन दिखाने की सुविधा को सीमित प्रोसेसिंग मोड में चलाने की अनुमति देता है.

Optional 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,
});

Optional underAgeOfConsent

underAgeOfConsent?: null | boolean
इससे पता चलता है कि विज्ञापन अनुरोधों को सहमति देने की कानूनी उम्र से कम के उपयोगकर्ताओं से मिले अनुरोधों के तौर पर मार्क करना है या नहीं. कॉन्फ़िगरेशन मिटाने के लिए, null पर सेट करें.

googletag.PubAdsService

बढ़ाता है Service
पब्लिशर के लिए विज्ञापन सेवा. इस सेवा का इस्तेमाल, आपके Google Ad Manager खाते से विज्ञापनों को फ़ेच करने और दिखाने के लिए किया जाता है.
तरीके
addEventListener
एक लिसनर रजिस्टर करता है, जिसकी मदद से पेज पर कोई खास GPT इवेंट होने पर, JavaScript फ़ंक्शन को सेट अप और कॉल किया जा सकता है.
clear
यह दिए गए स्लॉट से विज्ञापन हटा देता है और उन्हें खाली कॉन्टेंट से बदल देता है.
clearCategoryExclusions
पेज-लेवल पर, विज्ञापन कैटगरी एक्सक्लूज़न के सभी लेबल मिटा देता है.
clearTargeting
किसी खास बटन या सभी बटन के लिए, कस्टम टारगेटिंग पैरामीटर मिटाता है.
collapseEmptyDivs
स्लॉट डिव को छोटा करने की सुविधा चालू करता है, ताकि विज्ञापन कॉन्टेंट न होने पर वे पेज पर कोई जगह न ले सकें.
disableInitialLoad
पेज लोड होने पर विज्ञापनों के अनुरोधों को बंद कर देता है. हालांकि, PubAdsService.refresh कॉल की मदद से विज्ञापनों का अनुरोध किया जा सकता है.
display
दिए गए विज्ञापन यूनिट पाथ और साइज़ के साथ विज्ञापन स्लॉट बनाता है और दिखाता है.
enableLazyLoad
कॉन्फ़िगरेशन ऑब्जेक्ट के मुताबिक, जीपीटी में लेज़ी लोडिंग की सुविधा चालू करता है.
enableSingleRequest
एक ही समय पर कई विज्ञापनों को फ़ेच करने के लिए, एक अनुरोध मोड चालू करता है.
enableVideoAds
GPT को सिग्नल भेजता है कि पेज पर वीडियो विज्ञापन मौजूद होंगे.
get
किसी कीवर्ड से जुड़े AdSense एट्रिब्यूट की वैल्यू दिखाता है.
getAttributeKeys
इस सेवा पर सेट की गई एट्रिब्यूट कुंजियां दिखाता है.
getSlots
इस सेवा से जुड़े स्लॉट की सूची पाएं.
getTargeting
सेट किया गया कोई खास कस्टम सेवा-लेवल टारगेटिंग पैरामीटर दिखाता है.
getTargetingKeys
सेट की गई सभी कस्टम सेवा-लेवल टारगेटिंग कुंजियों की सूची दिखाता है.
isInitialLoadDisabled
इससे पता चलता है कि PubAdsService.disableInitialLoad कॉल की मदद से, विज्ञापनों के लिए किए गए शुरुआती अनुरोधों को बंद किया गया था या नहीं.
refresh
यह पेज पर किसी खास या सभी स्लॉट के लिए नए विज्ञापन फ़ेच और दिखाता है.
removeEventListener
पहले से रजिस्टर किए गए लिसनर को हटाता है.
set
AdSense के उन एट्रिब्यूट की वैल्यू सेट करता है जो पब्लिशर विज्ञापन सेवा के तहत सभी विज्ञापन स्लॉट पर लागू होते हैं.
setCategoryExclusion
दिए गए लेबल के नाम के लिए, पेज-लेवल पर विज्ञापन कैटगरी एक्सक्लूज़न सेट करता है.
setCentering
इससे विज्ञापनों को हॉरिज़ॉन्टल सेंटर में दिखाने की सुविधा चालू या बंद होती है.
setForceSafeFrame
इससे यह कॉन्फ़िगर होता है कि पेज पर मौजूद सभी विज्ञापनों को, सेफ़फ़्रेम कंटेनर का इस्तेमाल करके रेंडर किया जाना चाहिए या नहीं.
setLocation
वेबसाइटों से जगह की जानकारी पास करता है, ताकि आप लाइन आइटम को खास जगहों पर जियो-टारगेट कर सकें.
setPrivacySettings
कॉन्फ़िगरेशन ऑब्जेक्ट का इस्तेमाल करके, किसी एक एपीआई से सभी निजता सेटिंग कॉन्फ़िगर करने की अनुमति देता है.
setPublisherProvidedId
पब्लिशर के दिए गए आईडी की वैल्यू सेट करता है.
setSafeFrameConfig
SafeFrame कॉन्फ़िगरेशन के लिए, पेज-लेवल की प्राथमिकताएं सेट करता है.
setTargeting
किसी कीवर्ड के लिए कस्टम टारगेटिंग पैरामीटर सेट करता है. ये पैरामीटर, Publisher Ads की सेवा के सभी विज्ञापन स्लॉट पर लागू होते हैं.
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();
पैरामीटर
Optional slots: Slot[]खाली करने के लिए स्लॉट का कलेक्शन. कलेक्शन की वैल्यू देना ज़रूरी नहीं है. अगर कलेक्शन की वैल्यू नहीं दी जाती है, तो सभी स्लॉट हटा दिए जाएंगे.
रिटर्न
booleanअगर स्लॉट खाली कर दिए गए हैं, तो true दिखाता है. अगर ऐसा नहीं है, तो false दिखाता है.

clearCategoryExclusions

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

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.
इन्हें भी देखें
पैरामीटर
Optional key: stringटारगेटिंग पैरामीटर की कुंजी. कुंजी देना ज़रूरी नहीं है. अगर कुंजी नहीं दी जाती है, तो सभी टारगेटिंग पैरामीटर हटा दिए जाएंगे.
रिटर्न
PubAdsServiceवह सेवा ऑब्जेक्ट जिस पर तरीका कॉल किया गया था.

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
स्लॉट डिव को छोटा करने की सुविधा चालू करता है, ताकि विज्ञापन कॉन्टेंट न होने पर वे पेज पर कोई जगह न ले सकें. सेवा चालू करने से पहले, यह मोड सेट करना ज़रूरी है.
इन्हें भी देखें
पैरामीटर
Optional collapseBeforeAdFetch: booleanविज्ञापन फ़ेच होने से पहले ही स्लॉट को छोटा करना है या नहीं. यह पैरामीटर ज़रूरी नहीं है. अगर यह नहीं दिया जाता है, तो डिफ़ॉल्ट वैल्यू के तौर पर false का इस्तेमाल किया जाएगा.
रिटर्न
booleanअगर div collapse mode चालू है, तो true दिखाता है. अगर collapse mode चालू नहीं किया जा सकता, तो false दिखाता है. ऐसा तब होता है, जब सेवा चालू होने के बाद इस तरीके को कॉल किया गया हो.

disableInitialLoad

disableInitialLoad(): void
पेज लोड होने पर विज्ञापनों के अनुरोधों को बंद कर देता है. हालांकि, PubAdsService.refresh कॉल की मदद से विज्ञापनों का अनुरोध किया जा सकता है. इसकी सेटिंग, सेवा चालू करने से पहले सेट करनी चाहिए. एसिंक मोड का इस्तेमाल करना ज़रूरी है. ऐसा न करने पर, refresh का इस्तेमाल करके विज्ञापनों का अनुरोध नहीं किया जा सकेगा.
इन्हें भी देखें

डिसप्ले

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
दिए गए विज्ञापन यूनिट पाथ और साइज़ के साथ विज्ञापन स्लॉट बनाता है और दिखाता है. यह तरीका, सिंगल रिक्वेस्ट मोड के साथ काम नहीं करता.

ध्यान दें: इस तरीके को कॉल करने पर, स्लॉट और पेज की स्थिति का स्नैपशॉट बनाया जाता है. इससे, विज्ञापन अनुरोध भेजने और जवाब रेंडर करने के दौरान, एक जैसी परफ़ॉर्मेंस बनी रहती है. इस तरीके को कॉल करने के बाद, स्लॉट या पेज की स्थिति में किए गए किसी भी बदलाव (जैसे, टारगेटिंग, निजता सेटिंग, फ़ोर्स सेफ़फ़्रेम वगैरह) का असर सिर्फ़ आने वाले समय में किए जाने वाले 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स्लॉट की चौड़ाई और ऊंचाई.
Optional div: string | Elementस्लॉट वाले div का आईडी या div एलिमेंट.
Optional clickUrl: stringइस स्लॉट पर इस्तेमाल करने के लिए क्लिक यूआरएल.

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void
कॉन्फ़िगरेशन ऑब्जेक्ट के मुताबिक, जीपीटी में लेज़ी लोडिंग की सुविधा चालू करता है. ज़्यादा जानकारी वाले उदाहरणों के लिए, लेज़ी लोडिंग का सैंपल देखें.

ध्यान दें: एसआरए में लेज़ी फ़ेचिंग सिर्फ़ तब काम करती है, जब सभी स्लॉट फ़ेचिंग मार्जिन से बाहर हों.
उदाहरण

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,
});
इन्हें भी देखें
पैरामीटर
Optional config: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}		कॉन्फ़िगरेशन ऑब्जेक्ट की मदद से, लेज़ी लोडिंग के व्यवहार को पसंद के मुताबिक बनाया जा सकता है. जिन कॉन्फ़िगरेशन को शामिल नहीं किया गया है उनके लिए, Google के डिफ़ॉल्ट सेट का इस्तेमाल किया जाएगा. इस सेट को समय के साथ बेहतर बनाया जाएगा. किसी खास सेटिंग को बंद करने के लिए, वैल्यू को -1 पर सेट करें. जैसे, फ़ेचिंग मार्जिन.
  • fetchMarginPercent

    विज्ञापन को व्यूपोर्ट के साइज़ के प्रतिशत के तौर पर फ़ेच करने से पहले, स्लॉट को मौजूदा व्यूपोर्ट से कम से कम कितनी दूरी पर होना चाहिए. 0 वैल्यू का मतलब है कि "जब स्लॉट व्यूपोर्ट में आता है", 100 का मतलब है कि "जब विज्ञापन एक व्यूपोर्ट दूर है" वगैरह.
  • renderMarginPercent

    विज्ञापन रेंडर करने से पहले, स्लॉट को मौजूदा व्यूपोर्ट से कम से कम कितनी दूरी पर होना चाहिए. इससे विज्ञापन को पहले से लोड करने की सुविधा मिलती है. हालांकि, अन्य सब-रिसॉर्स को रेंडर और डाउनलोड करने के लिए इंतज़ार करना पड़ता है. यह वैल्यू, व्यूपोर्ट के प्रतिशत के तौर पर fetchMarginPercent की तरह ही काम करती है.
  • mobileScaling

    मोबाइल डिवाइसों पर मार्जिन पर लागू होने वाला मल्टीप्लायर. इसकी मदद से, मोबाइल और डेस्कटॉप पर अलग-अलग मार्जिन तय किए जा सकते हैं. उदाहरण के लिए, 2.0 की वैल्यू से मोबाइल डिवाइसों पर सभी मार्जिन को दो से गुणा कर दिया जाएगा. इससे, फ़ेच और रेंडर करने से पहले, स्लॉट की कम से कम दूरी बढ़ जाएगी.

enableSingleRequest

enableSingleRequest(): boolean
एक ही समय पर कई विज्ञापनों को फ़ेच करने के लिए, एक अनुरोध मोड चालू करता है. इसके लिए, सेवा चालू करने से पहले सभी पब्लिशर विज्ञापन स्लॉट तय करने और उन्हें PubAdsService में जोड़ने की ज़रूरत होती है. सेवा चालू करने से पहले, एक बार अनुरोध करने का मोड सेट करना ज़रूरी है.
इन्हें भी देखें
रिटर्न
booleanअगर सिंगल रिक्वेस्ट मोड चालू है, तो यह true दिखाता है. अगर सिंगल रिक्वेस्ट मोड चालू नहीं किया जा सकता, क्योंकि सेवा चालू होने के बाद इस तरीके को कॉल किया गया था, तो यह false दिखाता है.

enableVideoAds

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'.
इन्हें भी देखें
पैरामीटर
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[]इस सेवा पर सेट की गई एट्रिब्यूट कुंजियों का कलेक्शन. ऑर्डर करने का तरीका तय नहीं है.

getTargeting

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[]इस कुंजी से जुड़ी वैल्यू या कोई कुंजी न होने पर खाली कलेक्शन.

getTargetingKeys

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[]टारगेटिंग कुंजियों का कलेक्शन. ऑर्डर करने का तरीका तय नहीं है.

isInitialLoadDisabled

isInitialLoadDisabled(): boolean
इससे पता चलता है कि PubAdsService.disableInitialLoad कॉल की मदद से, विज्ञापनों के लिए किए गए शुरुआती अनुरोधों को बंद किया गया था या नहीं.
रिटर्न
booleanअगर PubAdsService.disableInitialLoad को पहले कॉल किया गया था और वह सफल रहा था, तो true दिखाता है. अगर ऐसा नहीं हुआ था, तो false दिखाता है.

रीफ़्रेश करें

refresh(slots?: null | Slot[], options?: {
  changeCorrelator: boolean;
}): void
यह पेज पर किसी खास या सभी स्लॉट के लिए नए विज्ञापन फ़ेच और दिखाता है. यह सिर्फ़ असाइनोक्रोनस रेंडरिंग मोड में काम करता है.

सभी ब्राउज़र पर सही तरीके से काम करने के लिए, refresh को कॉल करने से पहले, विज्ञापन स्लॉट display को कॉल करना ज़रूरी है. अगर display को कॉल नहीं किया जाता है, तो हो सकता है कि रीफ़्रेश करने पर, पेज का व्यवहार अचानक बदल जाए. अगर ज़रूरत हो, तो display को विज्ञापन फ़ेच करने से रोकने के लिए, PubAdsService.disableInitialLoad तरीके का इस्तेमाल किया जा सकता है.

किसी स्लॉट को रीफ़्रेश करने से, 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 });
इन्हें भी देखें
पैरामीटर
Optional slots: null | Slot[]रीफ़्रेश करने के लिए स्लॉट. ऐरे की वैल्यू देना ज़रूरी नहीं है. अगर कोई वैल्यू नहीं दी जाती है, तो सभी स्लॉट रीफ़्रेश हो जाएंगे.
Optional options: {
  changeCorrelator: boolean;
}		रीफ़्रेश कॉल से जुड़े कॉन्फ़िगरेशन के विकल्प.
  • changeCorrelator

    इससे पता चलता है कि विज्ञापनों को फ़ेच करने के लिए, नया कोरेलेटर जनरेट करना है या नहीं. हमारे विज्ञापन सर्वर, इस कोरेलेटर वैल्यू को कुछ समय के लिए सेव रखते हैं. फ़िलहाल, यह समय 30 सेकंड है, लेकिन इसमें बदलाव हो सकता है. ऐसा इसलिए किया जाता है, ताकि एक ही कोरेलेटर वाले एक-दूसरे के करीब आने वाले अनुरोधों को एक पेज व्यू माना जा सके. हर रीफ़्रेश के लिए, डिफ़ॉल्ट रूप से एक नया कोरेलेटर जनरेट होता है.

    ध्यान दें: इस विकल्प का GPT के लंबे समय तक बने रहने वाले पेज व्यू पर कोई असर नहीं पड़ता. यह विकल्प, पेज पर मौजूद विज्ञापनों को अपने-आप दिखाता है और इसकी समयसीमा खत्म नहीं होती.

सेट करें

set(key: string, value: string): PubAdsService
Publisher Ads सेवा के तहत सभी विज्ञापन स्लॉट पर लागू होने वाले 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");
इन्हें भी देखें
पैरामीटर
key: stringएट्रिब्यूट का नाम.
value: stringएट्रिब्यूट की वैल्यू.
रिटर्न
PubAdsServiceवह सेवा ऑब्जेक्ट जिस पर तरीका कॉल किया गया था.

setCategoryExclusion

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: booleantrue विज्ञापनों को बीच में रखने के लिए, false उन्हें बाईं ओर अलाइन करने के लिए.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
यह कॉन्फ़िगर करता है कि पेज पर मौजूद सभी विज्ञापनों को, SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाना चाहिए या नहीं.

इस एपीआई का इस्तेमाल करते समय, कृपया इन बातों का ध्यान रखें:
  • यह सेटिंग, सिर्फ़ उन स्लॉट के लिए किए गए बाद के विज्ञापन अनुरोधों पर लागू होगी.
  • अगर स्लॉट लेवल की सेटिंग तय की गई है, तो वह हमेशा पेज लेवल की सेटिंग को बदल देगी.
  • अगर इसे स्लॉट-लेवल या पेज-लेवल पर true पर सेट किया जाता है, तो विज्ञापन हमेशा SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाएगा. इस बात से कोई फ़र्क़ नहीं पड़ता कि Google Ad Manager के यूज़र इंटरफ़ेस (यूआई) में क्या चुना गया है.
  • हालांकि, अगर इसकी वैल्यू false पर सेट की जाती है या इसे बिना किसी वैल्यू के छोड़ दिया जाता है, तो विज्ञापन को SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाएगा. यह विज्ञापन के टाइप और Google Ad Manager के यूज़र इंटरफ़ेस (यूआई) में चुने गए विकल्प के आधार पर होगा.
  • इस एपीआई का इस्तेमाल सावधानी से करना चाहिए, क्योंकि इससे उन क्रिएटिव के व्यवहार पर असर पड़ सकता है जो अपने 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");
इन्हें भी देखें
पैरामीटर
forceSafeFrame: booleantrue, ताकि पेज पर मौजूद सभी विज्ञापनों को SafeFrames में रेंडर किया जा सके. साथ ही, 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
कॉन्फ़िगरेशन ऑब्जेक्ट का इस्तेमाल करके, किसी एक एपीआई से सभी निजता सेटिंग को कॉन्फ़िगर करने की सुविधा देता है.
उदाहरण

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 कॉन्फ़िगरेशन के लिए, पेज-लेवल की प्राथमिकताएं सेट करता है. कॉन्फ़िगरेशन ऑब्जेक्ट में मौजूद ऐसी सभी कुंजियों को अनदेखा कर दिया जाएगा जिनकी पहचान नहीं की जा सकी. अगर किसी पहचानी गई कुंजी के लिए अमान्य वैल्यू दी जाती है, तो पूरे कॉन्फ़िगरेशन को अनदेखा कर दिया जाएगा.

अगर स्लॉट-लेवल की प्राथमिकताएं तय की गई हैं, तो पेज-लेवल की इन प्राथमिकताओं को बदल दिया जाएगा.
उदाहरण

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");
इन्हें भी देखें
पैरामीटर
config: SafeFrameConfigकॉन्फ़िगरेशन ऑब्जेक्ट.
रिटर्न
PubAdsServiceवह सेवा ऑब्जेक्ट जिस पर तरीका कॉल किया गया था.

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService
किसी कीवर्ड के लिए कस्टम टारगेटिंग पैरामीटर सेट करता है. ये पैरामीटर, Publisher Ads की सेवा के सभी विज्ञापन स्लॉट पर लागू होते हैं. एक ही कुंजी के लिए इसे कई बार कॉल करने पर, पुरानी वैल्यू ओवरराइट हो जाएंगी. ये कुंजियां आपके 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 की कॉन्टेंट डालने की सेवा को दी गई वैल्यू का इस्तेमाल करें.
इन्हें भी देखें
पैरामीटर
videoContentId: stringवीडियो का Content ID.
videoCmsId: stringवीडियो का सीएमएस आईडी.

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
लाइन आइटम का आईडी.
इन्हें भी देखें

प्रॉपर्टी

advertiserId

advertiserId: null | number
विज्ञापन देने वाले का आईडी.

campaignId

campaignId: null | number
कैंपेन का आईडी.

creativeId

creativeId: null | number
क्रिएटिव का आईडी.

creativeTemplateId

creativeTemplateId: null | number
विज्ञापन का टेंप्लेट आईडी.

lineItemId

lineItemId: null | number
लाइन आइटम का आईडी.

googletag.RewardedPayload

इनाम वाले विज्ञापन से जुड़े इनाम को दिखाने वाला ऑब्जेक्ट
प्रॉपर्टी
amount
इनाम में शामिल आइटम की संख्या.
type
इनाम में शामिल आइटम का टाइप (उदाहरण के लिए, "सिक्का").
इन्हें भी देखें

प्रॉपर्टी

amount

amount: number
इनाम में शामिल आइटम की संख्या.

टाइप

type: string
इनाम में शामिल आइटम का टाइप (उदाहरण के लिए, "सिक्का").

googletag.SafeFrameConfig

SafeFrame कंटेनर के लिए कॉन्फ़िगरेशन ऑब्जेक्ट.
प्रॉपर्टी
allowOverlayExpansion?
क्या SafeFrame को पेज के कॉन्टेंट को ओवरले करके, विज्ञापन कॉन्टेंट को बड़ा करने की अनुमति देनी चाहिए.
allowPushExpansion?
क्या SafeFrame को पेज के कॉन्टेंट को पुश करके, विज्ञापन कॉन्टेंट को बड़ा करने की अनुमति देनी चाहिए.
sandbox?
क्या SafeFrame को उपयोगकर्ता के इंटरैक्शन के बिना टॉप लेवल नेविगेशन को रोकने के लिए, HTML5 सैंडबॉक्स एट्रिब्यूट का इस्तेमाल करना चाहिए.
useUniqueDomain?
अब काम नहीं करता. क्या SafeFrame को रिज़र्वेशन क्रिएटिव के लिए, रैंडम किए गए सबडोमेन का इस्तेमाल करना चाहिए.
इन्हें भी देखें

प्रॉपर्टी

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean
क्या SafeFrame को पेज के कॉन्टेंट को ओवरले करके, विज्ञापन कॉन्टेंट को बड़ा करने की अनुमति देनी चाहिए.

Optional allowPushExpansion

allowPushExpansion?: boolean
क्या SafeFrame को पेज के कॉन्टेंट को पुश करके, विज्ञापन कॉन्टेंट को बड़ा करने की अनुमति देनी चाहिए.

Optional सैंडबॉक्स

sandbox?: boolean
क्या SafeFrame को उपयोगकर्ता के इंटरैक्शन के बिना टॉप लेवल नेविगेशन को रोकने के लिए, HTML5 सैंडबॉक्स एट्रिब्यूट का इस्तेमाल करना चाहिए. सिर्फ़ true ही मान्य वैल्यू है. इसे false पर सेट नहीं किया जा सकता. ध्यान दें कि सैंडबॉक्स एट्रिब्यूट, प्लग इन (जैसे, फ़्लैश) को बंद कर देता है.

Optional useUniqueDomain

useUniqueDomain?: null | boolean
SafeFrame को रिज़र्वेशन क्रिएटिव के लिए, रैंडम किए गए सबडोमेन का इस्तेमाल करना चाहिए या नहीं. सेव की गई वैल्यू मिटाने के लिए, null डालें.

ध्यान दें: यह सुविधा डिफ़ॉल्ट रूप से चालू होती है.
इन्हें भी देखें

googletag.Service

बुनियादी सेवा क्लास, जिसमें सभी सेवाओं के लिए सामान्य मेथड होते हैं.
तरीके
addEventListener
एक लिसनर रजिस्टर करता है, जिसकी मदद से पेज पर कोई खास GPT इवेंट होने पर, JavaScript फ़ंक्शन को सेट अप और कॉल किया जा सकता है.
getSlots
इस सेवा से जुड़े स्लॉट की सूची पाएं.
removeEventListener
पहले से रजिस्टर किए गए लिसनर को हटाता है.

तरीके

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service
एक लिसनर को रजिस्टर करता है. इससे, पेज पर कोई खास GPT इवेंट होने पर, JavaScript फ़ंक्शन को सेट अप और कॉल किया जा सकता है. ये इवेंट काम करते हैं: जब इवेंट टाइप के हिसाब से ऑब्जेक्ट को कॉल किया जाता है, तो उसे लिसनर को पास कर दिया जाता है.
उदाहरण

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: KGPT से जनरेट किए गए इवेंट के टाइप की जानकारी देने वाली स्ट्रिंग. इवेंट टाइप केस-सेंसिटिव होते हैं.
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: KGPT से जनरेट किए गए इवेंट के टाइप की जानकारी देने वाली स्ट्रिंग. इवेंट टाइप केस-सेंसिटिव होते हैं.
listener: ((event: EventTypeMap[K]) => void)ऐसा फ़ंक्शन जो एक इवेंट ऑब्जेक्ट आर्ग्युमेंट लेता है.

googletag.SizeMappingBuilder

साइज़ मैपिंग स्पेसिफ़िकेशन ऑब्जेक्ट के लिए बिल्डर. यह बिल्डर, साइज़ की खास बातों को आसानी से बनाने में मदद करने के लिए उपलब्ध कराया गया है.
तरीके
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 &lt; 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 &lt; 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 &lt; 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(): null | SizeMappingArray
इस बिल्डर में जोड़ी गई मैपिंग से, साइज़ मैप की खास जानकारी बनाता है.

अगर कोई अमान्य मैपिंग दी गई है, तो यह तरीका null दिखाएगा. अगर ऐसा नहीं होता है, तो यह Slot.defineSizeMapping को पास करने के लिए, सही फ़ॉर्मैट में खास जानकारी दिखाता है.

ध्यान दें: इस तरीके को कॉल करने के बाद, बिल्डर का व्यवहार तय नहीं होता.
रिटर्न
null | SizeMappingArrayइस बिल्डर से मिला नतीजा. अगर साइज़ मैपिंग अमान्य हैं, तो यह वैल्यू शून्य हो सकती है.

googletag.Slot

स्लॉट, किसी पेज पर मौजूद एक विज्ञापन स्लॉट को दिखाने वाला ऑब्जेक्ट होता है.
तरीके
addService
इस स्लॉट में सेवा जोड़ता है.
clearCategoryExclusions
इस स्लॉट के लिए, विज्ञापन कैटगरी एक्सक्लूज़न के सभी स्लॉट-लेवल लेबल मिटा देता है.
clearTargeting
इस स्लॉट के लिए, कस्टम स्लॉट-लेवल के खास या सभी टारगेटिंग पैरामीटर मिटा देता है.
defineSizeMapping
इस स्लॉट के लिए, व्यूपोर्ट के कम से कम साइज़ से स्लॉट साइज़ तक मैपिंग का कलेक्शन सेट करता है.
get
इस स्लॉट के लिए, दी गई कुंजी से जुड़े AdSense एट्रिब्यूट की वैल्यू दिखाता है.
getAdUnitPath
नेटवर्क कोड और विज्ञापन यूनिट पाथ के साथ, विज्ञापन यूनिट का पूरा पाथ दिखाता है.
getAttributeKeys
इस स्लॉट पर सेट की गई एट्रिब्यूट की सूची दिखाता है.
getCategoryExclusions
इस स्लॉट के लिए, विज्ञापन कैटगरी एक्सक्लूज़न लेबल दिखाता है.
getResponseInformation
विज्ञापन के जवाब की जानकारी दिखाता है.
getSlotElementId
स्लॉट तय करते समय दिया गया स्लॉट div का आईडी दिखाता है.
getTargeting
इस स्लॉट पर सेट किया गया कोई खास कस्टम टारगेटिंग पैरामीटर दिखाता है.
getTargetingKeys
इस स्लॉट पर सेट की गई सभी कस्टम टारगेटिंग कुंजियों की सूची दिखाता है.
set
इस विज्ञापन स्लॉट पर, AdSense एट्रिब्यूट की वैल्यू सेट करता है.
setCategoryExclusion
इस स्लॉट पर, विज्ञापन कैटगरी के लिए स्लॉट-लेवल का एक्सक्लूज़न लेबल सेट करता है.
setClickUrl
क्लिक यूआरएल सेट करता है. इस पर विज्ञापन पर क्लिक करने के बाद, उपयोगकर्ताओं को रीडायरेक्ट किया जाएगा.
setCollapseEmptyDiv
इससे यह तय होता है कि स्लॉट में कोई विज्ञापन न होने पर, स्लॉट div को छिपाया जाना चाहिए या नहीं.
setConfig
इस स्लॉट के लिए सामान्य कॉन्फ़िगरेशन विकल्प सेट करता है.
setForceSafeFrame
इससे यह कॉन्फ़िगर होता है कि इस स्लॉट में मौजूद विज्ञापनों को, SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाना चाहिए या नहीं.
setSafeFrameConfig
SafeFrame कॉन्फ़िगरेशन के लिए, स्लॉट-लेवल की प्राथमिकताएं सेट करता है.
setTargeting
इस स्लॉट के लिए कस्टम टारगेटिंग पैरामीटर सेट करता है.
updateTargetingFromMap
JSON ऑब्जेक्ट में मौजूद, कुंजी:वैल्यू मैप से, इस स्लॉट के लिए कस्टम टारगेटिंग पैरामीटर सेट करता है.

तरीके

addService

addService(service: Service): Slot
इस स्लॉट में सेवा जोड़ता है.
उदाहरण

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

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

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.
इन्हें भी देखें
पैरामीटर
Optional key: stringटारगेटिंग पैरामीटर की कुंजी. कुंजी देना ज़रूरी नहीं है. अगर कुंजी नहीं दी जाती है, तो सभी टारगेटिंग पैरामीटर हटा दिए जाएंगे.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

defineSizeMapping

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'.
इन्हें भी देखें
पैरामीटर
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[]एट्रिब्यूट की कुंजियों का कलेक्शन. ऑर्डर करने का तरीका तय नहीं है.

getCategoryExclusions

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'.

JavaScript (लेगसी)

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

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

TypeScript

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

slot.getSlotElementId();
// Returns 'div'.
रिटर्न
stringस्लॉट div आईडी.

getTargeting

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[]इस कुंजी से जुड़ी वैल्यू या कोई कुंजी न होने पर खाली कलेक्शन.

getTargetingKeys

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());
इन्हें भी देखें
पैरामीटर
key: stringएट्रिब्यूट का नाम.
value: stringएट्रिब्यूट की वैल्यू.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

setCategoryExclusion

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
क्लिक यूआरएल सेट करता है, जिस पर उपयोगकर्ताओं को विज्ञापन पर क्लिक करने के बाद रीडायरेक्ट किया जाएगा.

क्लिक यूआरएल बदलने के बावजूद, Google Ad Manager सर्वर अब भी क्लिक रिकॉर्ड करते हैं. दिखाए जा रहे क्रिएटिव से जुड़ा कोई भी लैंडिंग पेज यूआरएल, दी गई वैल्यू में जोड़ दिया जाता है. इसके बाद के कॉल, वैल्यू को ओवरराइट कर देते हैं. यह सुविधा सिर्फ़ ऐसे अनुरोधों के लिए काम करती है जो एसआरए के तहत नहीं आते.
उदाहरण

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सेट किया जाने वाला क्लिक यूआरएल.
रिटर्न
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अगर कोई विज्ञापन नहीं मिलता है, तो स्लॉट को छोटा करना है या नहीं.
Optional collapseBeforeAdFetch: booleanविज्ञापन फ़ेच होने से पहले ही स्लॉट को छोटा करना है या नहीं. अगर collapse की वैल्यू true नहीं है, तो इसे अनदेखा कर दिया जाता है.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

setConfig

setConfig(slotConfig: SlotSettingsConfig): void
इस स्लॉट के लिए सामान्य कॉन्फ़िगरेशन विकल्प सेट करता है.
पैरामीटर
slotConfig: SlotSettingsConfigकॉन्फ़िगरेशन ऑब्जेक्ट.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot
यह कॉन्फ़िगर करता है कि इस स्लॉट में मौजूद विज्ञापनों को, SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाना चाहिए या नहीं.

इस एपीआई का इस्तेमाल करते समय, कृपया इन बातों का ध्यान रखें:
  • यह सेटिंग, सिर्फ़ उन स्लॉट के लिए किए गए बाद के विज्ञापन अनुरोधों पर लागू होगी.
  • अगर स्लॉट लेवल की सेटिंग तय की गई है, तो वह हमेशा पेज लेवल की सेटिंग को बदल देगी.
  • अगर इसे स्लॉट-लेवल या पेज-लेवल पर true पर सेट किया जाता है, तो विज्ञापन हमेशा SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाएगा. इस बात से कोई फ़र्क़ नहीं पड़ता कि Google Ad Manager के यूज़र इंटरफ़ेस (यूआई) में क्या चुना गया है.
  • हालांकि, अगर इसकी वैल्यू false पर सेट की जाती है या इसे बिना किसी वैल्यू के छोड़ दिया जाता है, तो विज्ञापन को SafeFrame कंटेनर का इस्तेमाल करके रेंडर किया जाएगा. यह विज्ञापन के टाइप और Google Ad Manager के यूज़र इंटरफ़ेस (यूआई) में चुने गए विकल्प के आधार पर होगा.
  • इस एपीआई का इस्तेमाल सावधानी से करना चाहिए, क्योंकि इससे उन क्रिएटिव के व्यवहार पर असर पड़ सकता है जो अपने 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());
इन्हें भी देखें
पैरामीटर
forceSafeFrame: booleantrue, इस स्लॉट में मौजूद सभी विज्ञापनों को SafeFrames में रेंडर करने के लिए और false, पेज-लेवल की सेटिंग (अगर मौजूद हो) से ऑप्ट-आउट करने के लिए. अगर पेज-लेवल पर कोई वैल्यू नहीं दी गई है, तो इसे false पर सेट करने से कुछ नहीं बदलेगा.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot
SafeFrame कॉन्फ़िगरेशन के लिए, स्लॉट-लेवल की प्राथमिकताएं सेट करता है. कॉन्फ़िगरेशन ऑब्जेक्ट में मौजूद ऐसी सभी कुंजियों को अनदेखा कर दिया जाएगा जिनकी पहचान नहीं की जा सकी. अगर किसी पहचानी गई कुंजी के लिए अमान्य वैल्यू दी जाती है, तो पूरे कॉन्फ़िगरेशन को अनदेखा कर दिया जाएगा.

अगर स्लॉट-लेवल की ये प्राथमिकताएं तय की जाती हैं, तो वे पेज-लेवल की सभी प्राथमिकताओं को बदल देंगी.
उदाहरण

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");
इन्हें भी देखें
पैरामीटर
config: null | SafeFrameConfigकॉन्फ़िगरेशन ऑब्जेक्ट.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

setTargeting

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वह स्लॉट ऑब्जेक्ट जिस पर तरीका लागू किया गया था.

updateTargetingFromMap

updateTargetingFromMap(map: {
  [adUnitPath: string]: string | string[];
}): Slot
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

पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
इंटरफ़ेस
AdExpansionConfig
विज्ञापन के साइज़ को कंट्रोल करने की सेटिंग.
ComponentAuctionConfig
डिवाइस पर होने वाली विज्ञापन नीलामी में, एक कॉम्पोनेंट की नीलामी को दिखाने वाला ऑब्जेक्ट.
InterstitialConfig
एक ऐसा ऑब्जेक्ट जो किसी इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को तय करता है.
PageSettingsConfig
पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
PrivacyTreatmentsConfig
पब्लिशर की निजता से जुड़े तरीकों को कंट्रोल करने के लिए सेटिंग.
PublisherProvidedSignalsConfig
पब्लिशर से मिले सिग्नल (पीपीएस) कॉन्फ़िगरेशन ऑब्जेक्ट.
SlotSettingsConfig
स्लॉट-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
TaxonomyData
एक टैक्सोनॉमी की वैल्यू वाला ऑब्जेक्ट.
कई एलियस
InterstitialTrigger
इंटरस्टीशियल विज्ञापन के लिए इस्तेमाल किए जा सकने वाले ट्रिगर.
PrivacyTreatment
पब्लिशर की निजता से जुड़ी ज़रूरी शर्तें.
Taxonomy
पब्लिशर से मिले सिग्नल (पीपीएस) के लिए इस्तेमाल की जा सकने वाली टैक्सोनॉमी.

कई एलियस

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"
इंटरस्टीशियल विज्ञापन के लिए इस्तेमाल किए जा सकने वाले ट्रिगर.

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"
पब्लिशर की निजता से जुड़ी ज़रूरी शर्तें.

टैक्सोनॉमी

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"
पब्लिशर से मिले सिग्नल (पीपीएस) के लिए इस्तेमाल की जा सकने वाली टैक्सोनॉमी.
इन्हें भी देखें

googletag.config.AdExpansionConfig

विज्ञापन के साइज़ को कंट्रोल करने की सेटिंग.
प्रॉपर्टी
enabled?
विज्ञापन एक्सपैंशन की सुविधा चालू है या बंद.
उदाहरण

JavaScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

JavaScript (लेगसी)

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

TypeScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

प्रॉपर्टी

Optional चालू है

enabled?: null | boolean
विज्ञापन एक्सपैंशन की सुविधा चालू है या बंद.

इस वैल्यू को सेट करने पर, Google Ad Manager में कॉन्फ़िगर की गई डिफ़ॉल्ट सेटिंग बदल जाती है.
इन्हें भी देखें

googletag.config.ComponentAuctionConfig

डिवाइस पर होने वाली विज्ञापन नीलामी में, एक कॉम्पोनेंट की नीलामी को दिखाने वाला ऑब्जेक्ट.
प्रॉपर्टी
auctionConfig
इस कॉम्पोनेंट की नीलामी के लिए ऑक्शन कॉन्फ़िगरेशन ऑब्जेक्ट.
configKey
इस कॉम्पोनेंट की नीलामी से जुड़ी कॉन्फ़िगरेशन कुंजी.
इन्हें भी देखें

प्रॉपर्टी

auctionConfig

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,
    },
  ],
});
इन्हें भी देखें

configKey

configKey: string
इस कॉम्पोनेंट की नीलामी से जुड़ी कॉन्फ़िगरेशन कुंजी.

यह वैल्यू खाली नहीं होनी चाहिए और यह यूनीक होनी चाहिए. अगर दो ComponentAuctionConfig ऑब्जेक्ट में एक ही configKey वैल्यू है, तो आखिर में सेट की गई वैल्यू, पिछले कॉन्फ़िगरेशन को बदल देगी.

googletag.config.InterstitialConfig

एक ऐसा ऑब्जेक्ट जो किसी इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को तय करता है.
प्रॉपर्टी
requireStorageAccess?
इस इंटरस्टीशियल विज्ञापन को दिखाने के लिए, स्थानीय स्टोरेज की सहमति की ज़रूरत है या नहीं.
triggers?
इस इंटरस्टीशियल विज्ञापन के लिए इंटरस्टीशियल ट्रिगर कॉन्फ़िगरेशन.

प्रॉपर्टी

Optional requireStorageAccess

requireStorageAccess?: null | boolean
इस इंटरस्टीशियल विज्ञापन को दिखाने के लिए, स्थानीय स्टोरेज की सहमति ज़रूरी है या नहीं.

GPT, इंटरस्टीशियल विज्ञापनों के लिए फ़्रीक्वेंसी कैप लागू करने के लिए, स्थानीय स्टोरेज का इस्तेमाल करता है. हालांकि, जिन उपयोगकर्ताओं ने लोकल स्टोरेज की सहमति नहीं दी है उन्हें अब भी इंटरस्टीशियल विज्ञापन दिखाए जा सकते हैं. इस प्रॉपर्टी को true पर सेट करने से, डिफ़ॉल्ट तरीके से काम करने की सुविधा से ऑप्ट आउट हो जाता है. साथ ही, यह पक्का किया जाता है कि इंटरस्टीशियल विज्ञापन सिर्फ़ उन उपयोगकर्ताओं को दिखाए जाएं जिन्होंने लोकल स्टोरेज की सहमति दी है.
उदाहरण

JavaScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

JavaScript (लेगसी)

// Opt out of showing interstitials to users
// without local storage consent.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

TypeScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});
इन्हें भी देखें

Optional ट्रिगर

triggers?: null | Partial<Record<InterstitialTrigger, boolean>>
इस इंटरस्टीशियल विज्ञापन के लिए इंटरस्टीशियल ट्रिगर कॉन्फ़िगरेशन.

इंटरस्टीशियल ट्रिगर की वैल्यू को true पर सेट करने से, वह चालू हो जाएगा और false पर सेट करने से वह बंद हो जाएगा. इससे, Google Ad Manager में कॉन्फ़िगर की गई डिफ़ॉल्ट वैल्यू बदल जाएंगी.
उदाहरण

JavaScript

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

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

JavaScript (लेगसी)

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

// Enable optional interstitial triggers.
// Change this value to false to disable.
var enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

TypeScript

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

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});
इन्हें भी देखें

googletag.config.PageSettingsConfig

पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.

इसकी मदद से, एक ही एपीआई कॉल से कई सुविधाएं सेट की जा सकती हैं.

यहां दी गई सभी प्रॉपर्टी, उदाहरण हैं. इनमें setConfig का इस्तेमाल करने वाली असल सुविधाएं नहीं दिखती हैं. सुविधाओं के सेट के लिए, नीचे दिए गए PageSettingsConfig टाइप में फ़ील्ड देखें.

उदाहरण:
  • googletag.setConfig कॉल में बताई गई सुविधाओं में ही बदलाव किया जाता है. 
      // Configure feature alpha.
  googletag.setConfig({
      alpha: {...}
  });

  // Configure feature bravo. Feature alpha is unchanged.
  googletag.setConfig({
     bravo: {...}
  });
  • किसी सुविधा की सभी सेटिंग, googletag.setConfig को हर बार कॉल करने पर अपडेट हो जाती हैं. 
      // Configure feature charlie to echo = 1, foxtrot = true.
  googletag.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  googletag.setConfig({
      charlie: {
          echo: 2
      }
  });
  • किसी सुविधा की सभी सेटिंग को मिटाने के लिए, null भेजें. 
      // Configure features delta, golf, and hotel.
  googletag.setConfig({
      delta: {...},
      golf: {...},
      hotel: {...},
  });

  // Feature delta and hotel are cleared, but feature golf remains set.
  googletag.setConfig({
      delta: null,
      hotel: null,
  });
प्रॉपर्टी
adExpansion?
विज्ञापन के साइज़ को कंट्रोल करने की सेटिंग.
adYield?
अब काम नहीं करता. 
pps?
पब्लिशर से मिले सिग्नल (पीपीएस) को कंट्रोल करने की सेटिंग.
privacyTreatments?
पब्लिशर की निजता से जुड़ी सेटिंग को कंट्रोल करने के लिए सेटिंग.
threadYield?
क्रिएटिव रेंडर करते समय, GPT को JS थ्रेड जनरेट करना चाहिए या नहीं, यह कंट्रोल करने के लिए सेटिंग.

प्रॉपर्टी

Optional adExpansion

adExpansion?: null | AdExpansionConfig
विज्ञापन के साइज़ को कंट्रोल करने की सेटिंग.

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

Optional pps

पब्लिशर से मिले सिग्नल (पीपीएस) को कंट्रोल करने की सेटिंग.

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig
पब्लिशर की निजता से जुड़े तरीकों को कंट्रोल करने के लिए सेटिंग.

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
क्रिएटिव रेंडर करते समय, GPT को JS थ्रेड को जनरेट करना चाहिए या नहीं, यह कंट्रोल करने के लिए सेटिंग.

GPT सिर्फ़ उन ब्राउज़र के लिए जनरेट होगा जो Scheduler.postTask या Scheduler.yield API के साथ काम करते हैं.

इस्तेमाल की जा सकने वाली वैल्यू:
  • null (डिफ़ॉल्ट): GPT, व्यूपोर्ट के बाहर मौजूद स्लॉट के लिए JS थ्रेड जनरेट करेगा.
  • ENABLED_ALL_SLOTS: GPT, सभी स्लॉट के लिए JS थ्रेड जनरेट करेगा. भले ही, स्लॉट व्यूपोर्ट में हो या नहीं.
  • DISABLED: GPT, JS थ्रेड नहीं दिखाएगा.
उदाहरण

JavaScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

JavaScript (लेगसी)

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

TypeScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });
इन्हें भी देखें

googletag.config.PrivacyTreatmentsConfig

पब्लिशर की निजता से जुड़ी सेटिंग को कंट्रोल करने के लिए सेटिंग.
प्रॉपर्टी
treatments
पब्लिशर की निजता बनाए रखने के लिए, कई तरह के तरीके.

प्रॉपर्टी

इलाज

treatments: null | "disablePersonalization"[]
पब्लिशर की निजता से जुड़ी कई सुविधाएं चालू करने के लिए.
उदाहरण

JavaScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

JavaScript (लेगसी)

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

TypeScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

googletag.config.PublisherProvidedSignalsConfig

पब्लिशर से मिले सिग्नल (पीपीएस) कॉन्फ़िगरेशन ऑब्जेक्ट.
प्रॉपर्टी
taxonomies
टैक्सनॉमी मैपिंग वाला ऑब्जेक्ट.
उदाहरण

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

JavaScript (लेगसी)

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

TypeScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});
इन्हें भी देखें

प्रॉपर्टी

टैक्सोनॉमी

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>
टैक्सनॉमी मैपिंग वाला ऑब्जेक्ट.

googletag.config.SlotSettingsConfig

स्लॉट-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.

इसकी मदद से, किसी एक स्लॉट के लिए एक ही एपीआई कॉल से कई सुविधाएं सेट की जा सकती हैं.

यहां दी गई सभी प्रॉपर्टी, उदाहरण हैं. इनमें setConfig का इस्तेमाल करने वाली असल सुविधाएं नहीं दिखती हैं. सुविधाओं के सेट के लिए, नीचे दिए गए SlotSettingsConfig टाइप में फ़ील्ड देखें.

उदाहरण:
  • Slot.setConfig कॉल में बताई गई सुविधाओं में ही बदलाव किया जाता है. 
      const slot = googletag.defineSlot("/1234567/example", [160, 600]);

  // Configure feature alpha.
  slot.setConfig({
      alpha: {...}
  });

  // Configure feature bravo. Feature alpha is unchanged.
  slot.setConfig({
     bravo: {...}
  });
  • किसी सुविधा की सभी सेटिंग, Slot.setConfig को हर बार कॉल करने पर अपडेट हो जाती हैं. 
      // Configure feature charlie to echo = 1, foxtrot = true.
  slot.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  slot.setConfig({
      charlie: {
          echo: 2
      }
  });
  • किसी सुविधा की सभी सेटिंग को मिटाने के लिए, null भेजें. 
      // Configure features delta, golf, and hotel.
  slot.setConfig({
      delta: {...},
      golf: {...},
      hotel: {...},
  });

  // Feature delta and hotel are cleared, but feature golf remains set.
  slot.setConfig({
      delta: null,
      hotel: null,
  });
प्रॉपर्टी
adExpansion?
विज्ञापन को बड़ा करने की सेटिंग.
componentAuction?
डिवाइस पर होने वाली विज्ञापन नीलामी में शामिल की जाने वाली कॉम्पोनेंट नीलामियों का कलेक्शन.
interstitial?
इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को कंट्रोल करने वाली सेटिंग.

प्रॉपर्टी

Optional adExpansion

adExpansion?: null | AdExpansionConfig
विज्ञापन को बड़ा करने की सेटिंग.

Optional componentAuction

componentAuction?: null | ComponentAuctionConfig[]
डिवाइस पर होने वाली विज्ञापन नीलामी में शामिल की जाने वाली कॉम्पोनेंट नीलामियों का कलेक्शन.

Optional इंटरस्टीशियल विज्ञापन

interstitial?: null | InterstitialConfig
इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को कंट्रोल करने वाली सेटिंग.

googletag.config.TaxonomyData

एक टैक्सोनॉमी की वैल्यू वाला ऑब्जेक्ट.
प्रॉपर्टी
values
टैक्सोनॉमी वैल्यू की सूची.

प्रॉपर्टी

values

values: string[]
टैक्सोनॉमी वैल्यू की सूची.

googletag.enums

यह नेमस्पेस है जिसका इस्तेमाल GPT, एनम टाइप के लिए करता है.
एनुमरेशन
OutOfPageFormat
GPT के साथ काम करने वाले पेज के बाहर के फ़ॉर्मैट.
TrafficSource
GPT के साथ काम करने वाले ट्रैफ़िक सोर्स.

एनुमरेशन

OutOfPageFormat

OutOfPageFormat
GPT के साथ काम करने वाले, पेज से बाहर के फ़ॉर्मैट.
इन्हें भी देखें
इन्यूमरेशन में शामिल सदस्य
BOTTOM_ANCHOR
ऐंकर फ़ॉर्मैट, जहां स्लॉट व्यूपोर्ट के सबसे नीचे दिखता है.
GAME_MANUAL_INTERSTITIAL
गेम मैन्युअल इंटरस्टीशियल फ़ॉर्मैट.

ध्यान दें: गेम मैन्युअल इंटरस्टीशियल, सीमित ऐक्सेस वाला फ़ॉर्मैट है.
INTERSTITIAL
वेब इंटरस्टीशियल क्रिएटिव फ़ॉर्मैट.
LEFT_SIDE_RAIL
बाईं ओर की साइड रेल का फ़ॉर्मैट.
REWARDED
इनाम वाला फ़ॉर्मैट.
RIGHT_SIDE_RAIL
दाईं साइड रेल का फ़ॉर्मैट.
TOP_ANCHOR
एंकर फ़ॉर्मैट, जहां स्लॉट व्यूपोर्ट के सबसे ऊपर चिपक जाता है.

TrafficSource

TrafficSource
GPT के साथ काम करने वाले ट्रैफ़िक सोर्स.
इन्हें भी देखें
इन्यूमरेशन में शामिल सदस्य
ORGANIC
सीधे तौर पर यूआरएल डालने, साइट पर खोज करने या ऐप्लिकेशन डाउनलोड करने से.
PURCHASED
मालिकाना हक वाली प्रॉपर्टी (हासिल की गई या कोई अन्य फ़ायदा देने वाली गतिविधि) के अलावा, दूसरी प्रॉपर्टी से रीडायरेक्ट किया गया ट्रैफ़िक.

googletag.events

यह नेमस्पेस है जिसका इस्तेमाल GPT, इवेंट के लिए करता है. आपका कोड, Service.addEventListener का इस्तेमाल करके इन इवेंट पर प्रतिक्रिया दे सकता है.
इंटरफ़ेस
Event
सभी GPT इवेंट के लिए बुनियादी इंटरफ़ेस.
EventTypeMap
यह एक स्यूडो-टाइप है, जो Service.addEventListener और Service.removeEventListener के लिए, किसी इवेंट के नाम को उसके संबंधित इवेंट ऑब्जेक्ट टाइप से मैप करता है.
GameManualInterstitialSlotClosedEvent
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता गेम के मैन्युअल इंटरस्टीशियल स्लॉट को बंद कर देता है.
GameManualInterstitialSlotReadyEvent
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता को गेम का मैन्युअल इंटरस्टीशियल स्लॉट दिखाने के लिए तैयार हो.
ImpressionViewableEvent
यह इवेंट तब ट्रिगर होता है, जब कोई इंप्रेशन ऐक्टिव व्यू की शर्तों के मुताबिक दिखने लगता है.
RewardedSlotClosedEvent
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता इनाम वाले विज्ञापन स्लॉट को बंद करता है.
RewardedSlotGrantedEvent
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला विज्ञापन देखने पर इनाम दिया जाता है.
RewardedSlotReadyEvent
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला विज्ञापन दिखाने के लिए तैयार हो जाता है.
SlotOnloadEvent
यह इवेंट तब ट्रिगर होता है, जब क्रिएटिव का iframe अपना लोड इवेंट ट्रिगर करता है.
SlotRenderEndedEvent
यह इवेंट तब ट्रिगर होता है, जब क्रिएटिव कोड को किसी स्लॉट में इंजेक्ट किया जाता है.
SlotRequestedEvent
यह इवेंट तब ट्रिगर होता है, जब किसी खास स्लॉट के लिए विज्ञापन का अनुरोध किया गया हो.
SlotResponseReceived
यह इवेंट तब ट्रिगर होता है, जब किसी खास स्लॉट के लिए विज्ञापन का जवाब मिलता है.
SlotVisibilityChangedEvent
जब भी किसी विज्ञापन स्लॉट के एरिया का ऑन-स्क्रीन प्रतिशत बदलता है, तब यह इवेंट ट्रिगर होता है.

googletag.events.Event

सभी GPT इवेंट के लिए बुनियादी इंटरफ़ेस. नीचे दिए गए सभी GPT इवेंट में ये फ़ील्ड होंगे.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
इन्हें भी देखें

प्रॉपर्टी

serviceName

serviceName: string
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.

slot

slot: Slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.

googletag.events.EventTypeMap

यह एक स्यूडो-टाइप है, जो Service.addEventListener और Service.removeEventListener के लिए, इवेंट के नाम को उसके संबंधित इवेंट ऑब्जेक्ट टाइप से मैप करता है. इसे सिर्फ़ रेफ़रंस और टाइप सेफ़्टी के लिए दस्तावेज़ में शामिल किया गया है.
प्रॉपर्टी
gameManualInterstitialSlotClosed
events.GameManualInterstitialSlotClosedEvent का दूसरा नाम.
gameManualInterstitialSlotReady
events.GameManualInterstitialSlotReadyEvent का दूसरा नाम.
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 का दूसरा नाम.

प्रॉपर्टी

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent
events.GameManualInterstitialSlotClosedEvent का दूसरा नाम.

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent
events.GameManualInterstitialSlotReadyEvent का दूसरा नाम.

impressionViewable

impressionViewable: ImpressionViewableEvent
events.ImpressionViewableEvent का दूसरा नाम.

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent
events.RewardedSlotClosedEvent का दूसरा नाम.

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent
events.RewardedSlotGrantedEvent का उपनाम.

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent
events.RewardedSlotReadyEvent का दूसरा नाम.

slotOnload

slotOnload: SlotOnloadEvent
events.SlotOnloadEvent का उपनाम.

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent
events.SlotRenderEndedEvent का दूसरा नाम.

slotRequested

slotRequested: SlotRequestedEvent
events.SlotRequestedEvent का उपनाम.

slotResponseReceived

slotResponseReceived: SlotResponseReceived
events.SlotResponseReceived का उपनाम.

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent
events.SlotVisibilityChangedEvent का दूसरा नाम.

googletag.events.GameManualInterstitialSlotClosedEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता गेम मैन्युअल इंटरस्टीशियल स्लॉट को बंद कर देता है.

ध्यान दें: गेम मैन्युअल इंटरस्टीशियल एक सीमित ऐक्सेस वाला फ़ॉर्मैट है.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
उदाहरण

JavaScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

JavaScript (लेगसी)

// This listener is called when a game manual interstitial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
    var slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

    if (slot === targetSlot) {
      // Slot specific logic.
    }
  });
}
इन्हें भी देखें

googletag.events.GameManualInterstitialSlotReadyEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता को गेम मैन्युअल इंटरस्टीशियल स्लॉट दिखाने के लिए तैयार हो.

ध्यान दें: गेम मैन्युअल इंटरस्टीशियल एक सीमित ऐक्सेस वाला फ़ॉर्मैट है.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
तरीके
makeGameManualInterstitialVisible
उपयोगकर्ता को गेम मैन्युअल का इंटरस्टीशियल विज्ञापन दिखाता है.
उदाहरण

JavaScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
    const slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

JavaScript (लेगसी)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
    var slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

TypeScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
    const slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

    if (slot === targetSlot) {
      // Slot specific logic.
    }
  });
}
इन्हें भी देखें

तरीके

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void
उपयोगकर्ता को गेम मैन्युअल का इंटरस्टीशियल विज्ञापन दिखाता है.

googletag.events.ImpressionViewableEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब कोई इंप्रेशन ऐक्टिव व्यू की शर्तों के मुताबिक दिखने लगता है.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
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.events.RewardedSlotClosedEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता इनाम वाले विज्ञापन स्लॉट को बंद करता है. यह इनाम मिलने से पहले या बाद में ट्रिगर हो सकता है. यह पता लगाने के लिए कि इनाम दिया गया है या नहीं, इसके बजाय events.RewardedSlotGrantedEvent का इस्तेमाल करें.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
उदाहरण

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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 (लेगसी)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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.events.RewardedSlotGrantedEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला विज्ञापन देखने पर इनाम दिया जाता है. अगर इनाम देने की शर्तें पूरी होने से पहले विज्ञापन बंद हो जाता है, तो यह इवेंट ट्रिगर नहीं होगा.
प्रॉपर्टी
payload
ऐसा ऑब्जेक्ट जिसमें दिए गए इनाम के बारे में जानकारी होती है.
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
उदाहरण

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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 (लेगसी)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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: null | RewardedPayload
ऐसा ऑब्जेक्ट जिसमें दिए गए इनाम के बारे में जानकारी होती है.

googletag.events.RewardedSlotReadyEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला विज्ञापन दिखाने के लिए तैयार हो जाता है. पब्लिशर की ज़िम्मेदारी है कि वह उपयोगकर्ता को विज्ञापन दिखाने से पहले, उसे विज्ञापन देखने का विकल्प दे.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
slot
वह स्लॉट जिसने इवेंट को ट्रिगर किया.
तरीके
makeRewardedVisible
इनाम वाला विज्ञापन दिखाता है.
उदाहरण

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

makeRewardedVisible(): void
इनाम वाला विज्ञापन दिखाता है. इस तरीके को तब तक नहीं बुलाया जाना चाहिए, जब तक उपयोगकर्ता ने विज्ञापन देखने की सहमति नहीं दी है.

googletag.events.SlotOnloadEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब क्रिएटिव का iframe अपना लोड इवेंट ट्रिगर करता है. सिंक रेंडरिंग मोड में रिच मीडिया विज्ञापनों को रेंडर करते समय, किसी iframe का इस्तेमाल नहीं किया जाता है. इसलिए, कोई SlotOnloadEvent ट्रिगर नहीं होगा.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
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.events.SlotRenderEndedEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब क्रिएटिव कोड को किसी स्लॉट में इंजेक्ट किया जाता है. यह इवेंट, क्रिएटिव के संसाधनों को फ़ेच करने से पहले होगा. इसलिए, हो सकता है कि क्रिएटिव अभी न दिखे. अगर आपको यह जानना है कि किसी स्लॉट के लिए सभी क्रिएटिव संसाधन कब लोड हो गए, तो इसके बजाय events.SlotOnloadEvent का इस्तेमाल करें.
प्रॉपर्टी
advertiserId
रेंडर किए गए विज्ञापन का विज्ञापन देने वाले का आईडी.
campaignId
रेंडर किए गए विज्ञापन का कैंपेन आईडी.
companyIds
रेंडर किए गए बैकफ़िल विज्ञापन पर बिड करने वाली कंपनियों के आईडी.
creativeId
बुकिंग के लिए रेंडर किए गए विज्ञापन का क्रिएटिव आईडी.
creativeTemplateId
बुकिंग के विज्ञापन के क्रिएटिव टेंप्लेट का आईडी.
isBackfill
विज्ञापन, बैकफ़िल विज्ञापन था या नहीं.
isEmpty
स्लॉट के लिए कोई विज्ञापन दिखाया गया था या नहीं.
labelIds
अब काम नहीं करता. 
lineItemId
रेंडर किए गए, आरक्षण वाले विज्ञापन का लाइन आइटम आईडी.
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
size
रेंडर किए गए क्रिएटिव का पिक्सल साइज़ दिखाता है.
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("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("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("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

advertiserId: null | number
रेंडर किए गए विज्ञापन का विज्ञापन देने वाले का आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null है.

campaignId

campaignId: null | number
रेंडर किए गए विज्ञापन का कैंपेन आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null है.

companyIds

companyIds: null | number[]
रेंडर किए गए बैकफ़िल विज्ञापन पर बिड करने वाली कंपनियों के आईडी. खाली स्लॉट, बुकिंग विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null होती है.

creativeId

creativeId: null | number
बुकिंग के लिए रेंडर किए गए विज्ञापन का क्रिएटिव आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null है.

creativeTemplateId

creativeTemplateId: null | number
बुकिंग के विज्ञापन के क्रिएटिव टेंप्लेट का आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null है.

isBackfill

isBackfill: boolean
विज्ञापन, बैकफ़िल विज्ञापन था या नहीं. अगर विज्ञापन बैकफ़िल विज्ञापन था, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी.

isEmpty

isEmpty: boolean
स्लॉट के लिए कोई विज्ञापन दिखाया गया था या नहीं. अगर कोई विज्ञापन नहीं दिखाया गया है, तो वैल्यू true होगी. अगर कोई विज्ञापन दिखाया गया है, तो वैल्यू false होगी.

labelIds

labelIds: null | number[]

lineItemId

lineItemId: null | number
रेंडर किए गए, आरक्षण वाले विज्ञापन का लाइन आइटम आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null है.

size

size: null | string | number[]
रेंडर किए गए क्रिएटिव का पिक्सल साइज़ दिखाता है. उदाहरण: [728, 90]. खाली विज्ञापन स्लॉट के लिए वैल्यू null होती है.

slotContentChanged

slotContentChanged: boolean
क्या रेंडर किए गए विज्ञापन के साथ स्लॉट कॉन्टेंट बदला गया था. अगर कॉन्टेंट बदला गया है, तो वैल्यू true होगी. अगर कॉन्टेंट नहीं बदला गया है, तो वैल्यू false होगी.

sourceAgnosticCreativeId

sourceAgnosticCreativeId: null | number
रेंडर किए गए रिज़र्वेशन या बैकफ़िल विज्ञापन का क्रिएटिव आईडी. अगर विज्ञापन, रिज़र्वेशन या लाइन आइटम का बैकफ़िल नहीं है या क्रिएटिव को PubAdsService के अलावा किसी दूसरी सेवा से रेंडर किया जाता है, तो वैल्यू null होती है.

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number
रेंडर किए गए रिज़र्वेशन या बैकफ़िल विज्ञापन का लाइन आइटम आईडी. अगर विज्ञापन, रिज़र्वेशन या लाइन आइटम का बैकफ़िल नहीं है या क्रिएटिव को PubAdsService के अलावा किसी दूसरी सेवा से रेंडर किया जाता है, तो वैल्यू null होती है.

yieldGroupIds

yieldGroupIds: null | number[]
रेंडर किए गए बैकफ़िल विज्ञापन के लिए, यील्ड ग्रुप के आईडी. खाली स्लॉट, बुकिंग विज्ञापनों, और PubAdsService से अलग सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null होती है.

googletag.events.SlotRequestedEvent

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब किसी खास स्लॉट के लिए विज्ञापन का अनुरोध किया गया हो.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
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.events.SlotResponseReceived

बढ़ाता है Event
यह इवेंट तब ट्रिगर होता है, जब किसी खास स्लॉट के लिए विज्ञापन का जवाब मिलता है.
प्रॉपर्टी
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
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.events.SlotVisibilityChangedEvent

बढ़ाता है Event
जब भी विज्ञापन स्लॉट के एरिया का ऑन-स्क्रीन प्रतिशत बदलता है, तब यह इवेंट ट्रिगर होता है. इवेंट को कम किया गया है और यह हर 200 मिलीसेकंड में एक से ज़्यादा बार ट्रिगर नहीं होगा.
प्रॉपर्टी
inViewPercentage
विज्ञापन के दिखने वाले हिस्से का प्रतिशत.
serviceName
उस सेवा का नाम जिसने इवेंट को ट्रिगर किया.
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

यह नेमस्पेस है जिसका इस्तेमाल GPT, सुरक्षित सिग्नल मैनेज करने के लिए करता है.
इंटरफ़ेस
BidderSignalProvider
किसी बिडर के लिए सुरक्षित सिग्नल दिखाता है.
PublisherSignalProvider
किसी पब्लिशर के लिए सुरक्षित सिग्नल दिखाता है.
SecureSignalProvidersArray
सुरक्षित सिग्नल मैनेज करने के लिए इंटरफ़ेस.
कई एलियस
SecureSignalProvider
किसी बिडर या सेवा देने वाली कंपनी के लिए सुरक्षित सिग्नल दिखाने वाला इंटरफ़ेस.

कई एलियस

SecureSignalProvider

किसी बिडर या सेवा देने वाली कंपनी के लिए सुरक्षित सिग्नल दिखाने वाला इंटरफ़ेस. id या networkCode में से कोई एक दिया जाना चाहिए, लेकिन दोनों नहीं.

googletag.secureSignals.BidderSignalProvider

किसी बिडर के लिए सुरक्षित सिग्नल दिखाता है.

बिडर के सुरक्षित सिग्नल की सेवा देने वाली कंपनी के दो हिस्से होते हैं:

  1. कलेक्टर फ़ंक्शन, जो Promise दिखाता है. यह एक सुरक्षित सिग्नल है.
  2. एक id, जो सिग्नल से जुड़े बिडर की पहचान करता है.
किसी पब्लिशर के लिए सुरक्षित सिग्नल दिखाने के लिए, secureSignals.PublisherSignalProvider का इस्तेमाल करें.
प्रॉपर्टी
collectorFunction
ऐसा फ़ंक्शन जो Promise दिखाता है, जो सुरक्षित सिग्नल में बदल जाता है.
id
इस सुरक्षित सिग्नल से जुड़े कलेक्टर के लिए यूनीक आइडेंटिफ़ायर, जैसा कि Google Ad Manager में रजिस्टर किया गया है.
उदाहरण

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");
  },
});
इन्हें भी देखें

प्रॉपर्टी

collectorFunction

collectorFunction: (() => Promise<string>)
ऐसा फ़ंक्शन जो Promise दिखाता है, जो सुरक्षित सिग्नल में बदल जाता है.

id

id: string
इस सुरक्षित सिग्नल से जुड़े कलेक्टर के लिए यूनीक आइडेंटिफ़ायर, जैसा कि Google Ad Manager में रजिस्टर किया गया है.

googletag.secureSignals.PublisherSignalProvider

किसी पब्लिशर के लिए सुरक्षित सिग्नल दिखाता है.

पब्लिशर सिग्नल की सुविधा देने वाली कंपनी के दो हिस्से होते हैं:

  1. कलेक्टर फ़ंक्शन, जो Promise दिखाता है. यह एक सुरक्षित सिग्नल है.
  2. एक networkCode, जो सिग्नल से जुड़े पब्लिशर की पहचान करता है.
किसी बिडर के लिए सुरक्षित सिग्नल दिखाने के लिए, secureSignals.BidderSignalProvider का इस्तेमाल करें.
प्रॉपर्टी
collectorFunction
ऐसा फ़ंक्शन जो Promise दिखाता है, जो सुरक्षित सिग्नल में बदल जाता है.
networkCode
इस सुरक्षित सिग्नल से जुड़े पब्लिशर का नेटवर्क कोड (जैसा कि विज्ञापन यूनिट के पाथ में दिखता है).
उदाहरण

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");
  },
});
इन्हें भी देखें

प्रॉपर्टी

collectorFunction

collectorFunction: (() => Promise<string>)
ऐसा फ़ंक्शन जो Promise दिखाता है, जो सुरक्षित सिग्नल में बदल जाता है.

networkCode

networkCode: string
इस सुरक्षित सिग्नल से जुड़े पब्लिशर का नेटवर्क कोड (जैसा कि विज्ञापन यूनिट के पाथ में दिखता है).

googletag.secureSignals.SecureSignalProvidersArray

सुरक्षित सिग्नल मैनेज करने के लिए इंटरफ़ेस.
तरीके
clearAllCache
कैश मेमोरी से सभी कलेक्टर के सभी सिग्नल मिटाता है.
push
सिग्नल देने वाले ऐरे में एक नया secureSignals.SecureSignalProvider जोड़ता है और सिग्नल जनरेट करने की प्रोसेस शुरू करता है.

तरीके

clearAllCache

clearAllCache(): void
कैश मेमोरी से सभी कलेक्टर के सभी सिग्नल मिटा देता है.

इस तरीके को कॉल करने से, मौजूदा और आने वाले समय में होने वाले पेज व्यू के लिए, विज्ञापन अनुरोधों में सिग्नल शामिल होने की संभावना कम हो सकती है. इस वजह से, इसे सिर्फ़ तब कॉल किया जाना चाहिए, जब स्टेटस में कोई अहम बदलाव हो. जैसे, नए उपयोगकर्ता से जुड़े इवेंट (लॉग इन, लॉग आउट, साइन अप वगैरह).

पुश

push(provider: SecureSignalProvider): void
सिग्नल उपलब्ध कराने वाले ऐरे में एक नया secureSignals.SecureSignalProvider जोड़ता है और सिग्नल जनरेट करने की प्रोसेस शुरू करता है.
पैरामीटर
provider: SecureSignalProvidersecureSignals.SecureSignalProvider ऑब्जेक्ट, जिसे कलेक्शन में जोड़ना है.