GPT संदर्भ

इस रेफ़रंस में, टाइप के बारे में बताने के लिए TypeScript नोटेशन का इस्तेमाल किया गया है. यहां दी गई टेबल में, उदाहरण के साथ कम शब्दों में जानकारी दी गई है.

टाइप एक्सप्रेशन
string यह प्रिमिटिव स्ट्रिंग टाइप है.
string[] यह एक ऐरे टाइप है, जिसमें वैल्यू सिर्फ़ स्ट्रिंग हो सकती हैं.
number | string यह एक यूनीयन टाइप है, जिसमें वैल्यू कोई संख्या या स्ट्रिंग हो सकती है.
Array<number | string> यह एक ऐरे टाइप है, जिसमें वैल्यू एक कॉम्प्लेक्स (यूनियन) टाइप होती हैं.
[number, string] यह एक टपल टाइप है. इसमें वैल्यू, दो एलिमेंट वाला एक ऐसा अरे होता है जिसमें एक संख्या और एक स्ट्रिंग शामिल होती है.
Slot यह एक ऑब्जेक्ट टाइप है, जहां वैल्यू googletag.Slot का इंस्टेंस होती है.
() => void यह एक फ़ंक्शन टाइप है, जिसमें न तो कोई आर्ग्युमेंट तय किया गया है और न ही कोई वैल्यू दिखाई गई है.

साथ काम करने वाले टाइप और टाइप एक्सप्रेशन के बारे में ज़्यादा जानने के लिए, टाइपस्क्रिप्ट हैंडबुक देखें.

टाइप एनोटेशन

वैरिएबल, पैरामीटर के नाम, प्रॉपर्टी के नाम या फ़ंक्शन के सिग्नेचर के बाद मौजूद कोलन, टाइप एनोटेशन को दिखाता है. टाइप एनोटेशन से पता चलता है कि कोलन के बाईं ओर मौजूद एलिमेंट, किस तरह के टाइप स्वीकार कर सकता है या किस तरह के टाइप दिखा सकता है. यहां दी गई टेबल में, टाइप एनोटेशन के उदाहरण दिए गए हैं. ये उदाहरण आपको इस रेफ़रंस में दिख सकते हैं.

टाइप एनोटेशन
param: string इससे पता चलता है कि param, स्ट्रिंग वैल्यू स्वीकार करता है या दिखाता है. इस सिंटैक्स का इस्तेमाल वैरिएबल, पैरामीटर, प्रॉपर्टी, और रिटर्न टाइप के लिए किया जाता है.
param?: number | string इससे पता चलता है कि param को शामिल करना ज़रूरी नहीं है. हालांकि, अगर इसे शामिल किया जाता है, तो यह संख्या या स्ट्रिंग, दोनों में से किसी एक को स्वीकार करता है. इस सिंटैक्स का इस्तेमाल पैरामीटर और प्रॉपर्टी के लिए किया जाता है.
...params: Array<() => void> इससे पता चलता है कि params एक रेस्ट पैरामीटर है, जो फ़ंक्शन स्वीकार करता है. रेस्ट पैरामीटर, तय किए गए टाइप की वैल्यू की कोई भी संख्या स्वीकार करते हैं.

googletag

यह ग्लोबल नेमस्पेस है. इसका इस्तेमाल Google पब्लिशर टैग, अपने एपीआई के लिए करता है.
नाम स्थान
config
पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
enums
यह नेमस्पेस है, जिसका इस्तेमाल GPT, enum टाइप के लिए करता है.
events
यह वह नेमस्पेस है जिसका इस्तेमाल GPT, इवेंट के लिए करता है.
secureSignals
यह नेमस्पेस है. इसका इस्तेमाल GPT, सुरक्षित सिग्नल को मैनेज करने के लिए करता है.
इंटरफ़ेस
CommandArray
कमांड ऐरे, फ़ंक्शन के क्रम को स्वीकार करता है और उन्हें क्रम से लागू करता है.
CompanionAdsService
कंपैनियन विज्ञापन सेवा.
PrivacySettingsConfig
निजता सेटिंग के लिए कॉन्फ़िगरेशन ऑब्जेक्ट.
PubAdsService
Publisher Ads सेवा.
ResponseInformation
एक विज्ञापन रिस्पॉन्स को दिखाने वाला ऑब्जेक्ट.
RewardedPayload
यह ऑब्जेक्ट, इनाम वाले विज्ञापन से जुड़े इनाम को दिखाता है.
Service
यह बुनियादी सेवा क्लास है. इसमें सभी सेवाओं के लिए सामान्य तरीके शामिल होते हैं.
SizeMappingBuilder
साइज़ मैपिंग स्पेसिफ़िकेशन ऑब्जेक्ट के लिए बिल्डर.
Slot
स्लॉट, पेज पर मौजूद किसी विज्ञापन स्लॉट को दिखाता है.
टाइप एलियस
GeneralSize
किसी स्लॉट के लिए साइज़ का मान्य कॉन्फ़िगरेशन. यह एक या उससे ज़्यादा साइज़ हो सकता है.
MultiSize
मान्य साइज़ की सूची.
NamedSize
ऐसे साइज़ के नाम जिन्हें स्लॉट में इस्तेमाल किया जा सकता है.
SingleSize
किसी स्लॉट के लिए एक मान्य साइज़.
SingleSizeArray
दो संख्याओं की ऐसी ऐरे जो [चौड़ाई, ऊंचाई] को दिखाती है.
SizeMapping
व्यूपोर्ट के साइज़ के हिसाब से विज्ञापन के साइज़ की मैपिंग.
SizeMappingArray
साइज़ मैपिंग की सूची.
वैरिएबल
apiReady
इस फ़्लैग से पता चलता है कि GPT API लोड हो गया है और इसे कॉल किया जा सकता है.
cmd
GPT से जुड़े कॉल को एसिंक्रोनस तरीके से एक्ज़ीक्यूट करने के लिए, ग्लोबल कमांड लाइन में रेफ़रंस.
pubadsReady
इस फ़्लैग से पता चलता है कि PubAdsService चालू है, लोड हो गई है, और पूरी तरह से काम कर रही है.
secureSignalProviders
सुरक्षित सिग्नल उपलब्ध कराने वाली कंपनियों के कलेक्शन का रेफ़रंस.
फ़ंक्शन
companionAds
CompanionAdsService का रेफ़रंस दिखाता है.
defineOutOfPageSlot
यह फ़ंक्शन, दिए गए विज्ञापन यूनिट पाथ के साथ पेज से बाहर दिखने वाला विज्ञापन स्लॉट बनाता है.
defineSlot
यह फ़ंक्शन, विज्ञापन यूनिट के दिए गए पाथ और साइज़ के हिसाब से विज्ञापन स्लॉट बनाता है. साथ ही, इसे पेज पर मौजूद div एलिमेंट के उस आईडी से जोड़ता है जिसमें विज्ञापन दिखेगा.
destroySlots
यह फ़ंक्शन, दिए गए स्लॉट को डिस्ट्रॉय करता है. साथ ही, उन स्लॉट से जुड़े सभी ऑब्जेक्ट और रेफ़रंस को GPT से हटा देता है.
disablePublisherConsole
यह कुकी, Google Publisher Console को बंद करती है.
display
यह कुकी, स्लॉट सेवाओं को स्लॉट रेंडर करने का निर्देश देती है.
enableServices
इससे पेज पर मौजूद विज्ञापन स्लॉट के लिए तय की गई सभी GPT सेवाएं चालू हो जाती हैं.
getConfig
यह कुकी, पेज के लिए सामान्य कॉन्फ़िगरेशन के विकल्प हासिल करती है. इन्हें setConfig फ़ंक्शन सेट करता है.
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]
दो संख्याओं की ऐसी ऐरे जो [चौड़ाई, ऊंचाई] को दिखाती है.

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

JavaScript

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

JavaScript (लेगसी)

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

TypeScript

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

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 की ओर से मैनेज की जा रही इंटरनल स्टेट से स्लॉट ऑब्जेक्ट हट जाता है. स्लॉट ऑब्जेक्ट पर अन्य फ़ंक्शन कॉल करने से, अनडिफ़ाइंड व्यवहार होगा. ध्यान दें कि अगर पब्लिशर पेज उस स्लॉट का रेफ़रंस बनाए रखता है, तो ब्राउज़र उससे जुड़ी मेमोरी को अब भी खाली नहीं कर सकता. इस एपीआई को कॉल करने पर, उस स्लॉट से जुड़ा div फिर से इस्तेमाल किया जा सकता है.

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

JavaScript

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

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

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

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

JavaScript (लेगसी)

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

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

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

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

TypeScript

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

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

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

// This call to destroy all slots.
googletag.destroySlots();
पैरामीटर
Optional slots: Slot[]हटाए जाने वाले स्लॉट की कैटगरी. ऐरे का इस्तेमाल करना ज़रूरी नहीं है. अगर इसका इस्तेमाल नहीं किया जाता है, तो सभी स्लॉट मिटा दिए जाएंगे.
रिटर्न
booleanअगर स्लॉट हटा दिए गए हैं, तो true दिखाता है. अगर स्लॉट हटाए नहीं गए हैं, तो false दिखाता है.

disablePublisherConsole

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

display

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

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

enableServices

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

getConfig

getConfig(keys: string | string[]): Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">
यह फ़ंक्शन, setConfig फ़ंक्शन से सेट किए गए पेज के लिए, कॉन्फ़िगरेशन के सामान्य विकल्प देता है.

इस तरीके से, सभी setConfig() प्रॉपर्टी काम नहीं करती हैं. इन प्रॉपर्टी का इस्तेमाल किया जा सकता है:
उदाहरण

JavaScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

JavaScript (लेगसी)

// Get the value of the `targeting` setting.
var targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
var config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

TypeScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);
पैरामीटर
keys: string | string[]कॉन्फ़िगरेशन के उन विकल्पों की कुंजियां जिन्हें पाना है.
रिटर्न
Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">स्लॉट के लिए कॉन्फ़िगरेशन के विकल्प.

getVersion

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

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 का रेफ़रंस दिखाता है.
रिटर्न
PubAdsServicePublisher Ads सेवा.

setAdIframeTitle

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

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (लेगसी)

googletag.setAdIframeTitle("title");

TypeScript

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

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?: boolean
इस कुकी से पता चलता है कि पेज को बच्चों के लिए लक्षित कॉन्टेंट के तौर पर माना जाना चाहिए या नहीं. कॉन्फ़िगरेशन मिटाने के लिए, null पर सेट करें.

Optional limitedAds

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

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

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

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

googletag.PubAdsService

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

disableInitialLoad

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

display

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 का मतलब है "जब विज्ञापन व्यूपोर्ट से 100 पिक्सल दूर होता है" वगैरह.
  • renderMarginPercent

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

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

enableSingleRequest

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

enableVideoAds

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

get

get(key: string): 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उस एट्रिब्यूट का नाम जिसे ढूंढना है.
रिटर्न
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

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

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

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

JavaScript

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

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

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

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

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

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

JavaScript (लेगसी)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });
इन्हें भी देखें
पैरामीटर
Optional slots: Slot[]रीफ़्रेश करने के लिए स्लॉट. ऐरे का इस्तेमाल करना ज़रूरी नहीं है. अगर इसका इस्तेमाल नहीं किया जाता है, तो सभी स्लॉट रीफ़्रेश हो जाएंगे.
Optional options: {
  changeCorrelator: boolean;
}
इस रीफ़्रेश कॉल से जुड़े कॉन्फ़िगरेशन के विकल्प.
  • changeCorrelator

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

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

set

set(key: string, value: string): PubAdsService
यह फ़ंक्शन, AdSense एट्रिब्यूट के लिए वैल्यू सेट करता है. ये वैल्यू, Publisher Ads service के तहत आने वाले सभी विज्ञापन स्लॉट पर लागू होती हैं.

एक ही कुंजी के लिए इस फ़ंक्शन को एक से ज़्यादा बार कॉल करने पर, उस कुंजी के लिए पहले से सेट की गई वैल्यू बदल जाएंगी. 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: booleanविज्ञापनों को बीच में लाने के लिए true और उन्हें बाईं ओर अलाइन करने के लिए 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 का इस्तेमाल करके, पेज पर मौजूद सभी विज्ञापनों को SafeFrame में रेंडर किया जा सकता है. वहीं, 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 service के सभी विज्ञापन स्लॉट पर लागू होते हैं. एक ही कुंजी के लिए इस फ़ंक्शन को कई बार कॉल करने पर, पुरानी वैल्यू बदल जाएंगी. ये कुंजियां, आपके 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वीडियो का कॉन्टेंट आईडी.
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: number
विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी.

campaignId

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

creativeId

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

creativeTemplateId

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

lineItemId

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

googletag.RewardedPayload

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

प्रॉपर्टी


amount

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

type

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

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

getSlots

getSlots(): Slot[]
इस सेवा से जुड़े स्लॉट की सूची पाएं.
रिटर्न
Slot[]स्लॉट उसी क्रम में दिखते हैं जिस क्रम में उन्हें सेवा में जोड़ा गया था.

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((event: EventTypeMap[K]) => void)): void
यह कुकी, पहले से रजिस्टर किए गए लिसनर को हटाती है.
उदाहरण

JavaScript

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

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

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

JavaScript (लेगसी)

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

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

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

TypeScript

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

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

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});
पैरामीटर
eventType: Kयह एक स्ट्रिंग है, जो GPT से जनरेट किए गए इवेंट के टाइप को दिखाती है. इवेंट टाइप केस-सेंसिटिव होते हैं.
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(): SizeMappingArray
इस बिल्डर में जोड़ी गई मैपिंग से, साइज़ मैप स्पेसिफ़िकेशन बनाता है.

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

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

googletag.Slot

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

तरीके


addService

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

JavaScript

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

JavaScript (लेगसी)

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

TypeScript

googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());
इन्हें भी देखें
पैरामीटर
service: Serviceजो सेवा जोड़नी है.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीके को कॉल किया गया था.

clearCategoryExclusions

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

get(key: string): 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उस एट्रिब्यूट का नाम जिसे ढूंढना है.
रिटर्न
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[]इस स्लॉट के लिए, विज्ञापन कैटगरी को बाहर रखने के लेबल या अगर कोई लेबल सेट नहीं किया गया है, तो खाली कलेक्शन.

getConfig

getConfig(keys: string | string[]): Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">
setConfig से सेट किए गए स्लॉट के लिए, सामान्य कॉन्फ़िगरेशन के विकल्प मिलते हैं.

इस तरीके से, सभी setConfig() प्रॉपर्टी काम नहीं करती हैं. इन प्रॉपर्टी का इस्तेमाल किया जा सकता है:
उदाहरण

JavaScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

JavaScript (लेगसी)

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

// Get the value of the `targeting` setting.
var targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
var config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

TypeScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);
पैरामीटर
keys: string | string[]कॉन्फ़िगरेशन के उन विकल्पों की कुंजियां जिन्हें पाना है.
रिटर्न
Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">स्लॉट के लिए कॉन्फ़िगरेशन के विकल्प.

getResponseInformation

getResponseInformation(): ResponseInformation
विज्ञापन के जवाब की जानकारी दिखाता है. यह स्लॉट के लिए, विज्ञापन के आखिरी जवाब पर आधारित होता है. अगर इस फ़ंक्शन को तब कॉल किया जाता है, जब स्लॉट में कोई विज्ञापन नहीं होता है, तो 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

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 का इस्तेमाल करके, इस स्लॉट में मौजूद सभी विज्ञापनों को SafeFrame में रेंडर किया जा सकता है. साथ ही, false का इस्तेमाल करके, पेज-लेवल की सेटिंग से ऑप्ट-आउट किया जा सकता है (अगर मौजूद हो). अगर पेज लेवल पर यह तय नहीं किया गया है, तो इसे false पर सेट करने से कोई बदलाव नहीं होगा.
रिटर्न
Slotवह स्लॉट ऑब्जेक्ट जिस पर तरीके को कॉल किया गया था.

setSafeFrameConfig

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

googletag.config

पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
इंटरफ़ेस
AdExpansionConfig
विज्ञापन को बड़ा करने की सुविधा को कंट्रोल करने वाली सेटिंग.
AdSenseAttributesConfig
AdSense विज्ञापनों के व्यवहार को कंट्रोल करने वाली सेटिंग.
ComponentAuctionConfig
यह ऑब्जेक्ट, डिवाइस पर होने वाली विज्ञापन नीलामी में, कॉम्पोनेंट की एक नीलामी को दिखाता है.
InterstitialConfig
यह ऑब्जेक्ट, किसी इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार के बारे में बताता है.
LazyLoadConfig
GPT में लेज़ी लोडिंग के इस्तेमाल को कंट्रोल करने के लिए सेटिंग.
PageSettingsConfig
पेज-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
PrivacyTreatmentsConfig
पब्लिशर की निजता से जुड़ी सेटिंग को कंट्रोल करने के लिए सेटिंग.
PublisherProvidedSignalsConfig
पब्लिशर से मिले सिग्नल (पीपीएस) कॉन्फ़िगरेशन ऑब्जेक्ट.
SafeFrameConfig
GPT में SafeFrame को कंट्रोल करने के लिए सेटिंग.
SlotSettingsConfig
स्लॉट-लेवल की सेटिंग के लिए मुख्य कॉन्फ़िगरेशन इंटरफ़ेस.
TaxonomyData
यह एक ऐसा ऑब्जेक्ट होता है जिसमें किसी एक टैक्सोनॉमी की वैल्यू होती हैं.
VideoAdsConfig
वीडियो विज्ञापन से जुड़ी सेटिंग कॉन्फ़िगर करने के लिए सेटिंग.
टाइप एलियस
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?: boolean
विज्ञापन एक्सपैंशन की सुविधा चालू है या बंद है.

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

googletag.config.AdSenseAttributesConfig

AdSense विज्ञापनों के व्यवहार को कंट्रोल करने वाली सेटिंग.

इन एट्रिब्यूट का इस्तेमाल, हर अनुरोध के आधार पर सर्वर-साइड सेटिंग को बदलने के लिए किया जा सकता है.
प्रॉपर्टी
adsense_ad_format?
AdSense का विज्ञापन फ़ॉर्मैट.
adsense_channel_ids?
AdSense चैनल आईडी.
adsense_test_mode?
टेस्ट मोड चालू है या नहीं.
document_language?
उस पेज की भाषा जिस पर विज्ञापन दिखाए जाते हैं.
page_url?
उस पेज का यूआरएल जिस पर विज्ञापन दिखाए जाते हैं.
इन्हें भी देखें

प्रॉपर्टी


Optional adsense_ad_format

adsense_ad_format?: "120x240_as" | "120x600_as" | "125x125_as" | "160x600_as" | "180x150_as" | "200x200_as" | "234x60_as" | "250x250_as" | "300x250_as" | "336x280_as" | "468x60_as" | "728x90_as"
AdSense का विज्ञापन फ़ॉर्मैट.

Optional adsense_channel_ids

adsense_channel_ids?: string
AdSense चैनल आईडी.

इन वैल्यू का इस्तेमाल किया जा सकता है: चैनल आईडी, जिन्हें '+' से अलग किया गया हो.

उदाहरण: 271828183+314159265
इन्हें भी देखें

Optional adsense_test_mode

adsense_test_mode?: "on"
टेस्ट मोड चालू है या नहीं.

on पर सेट होने पर, विज्ञापनों को सिर्फ़ टेस्ट के तौर पर मार्क किया जाता है. साथ ही, इन्हें गिनती या बिलिंग में शामिल नहीं किया जाता. प्रोडक्शन और टेस्ट के अलावा अन्य ट्रैफ़िक के लिए, इस सेटिंग को अनसेट करना ज़रूरी है.

Optional document_language

document_language?: string
वह भाषा जिसमें विज्ञापन दिखाए जाते हैं.

अनुमति वाली वैल्यू, ISO 639-1 के मान्य भाषा कोड हैं.

उदाहरण: en
इन्हें भी देखें

Optional page_url

page_url?: string
वह यूआरएल जिस पर विज्ञापन दिखाए जाते हैं.

अनुमति वाली वैल्यू, मान्य यूआरएल होती हैं.

उदाहरण: http://www.example.com

googletag.config.ComponentAuctionConfig

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

प्रॉपर्टी


auctionConfig

auctionConfig: {
  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?: 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?: 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.LazyLoadConfig

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

प्रॉपर्टी


Optional fetchMarginPercent

fetchMarginPercent?: number
विज्ञापन का अनुरोध करने से पहले, मौजूदा व्यूपोर्ट से स्लॉट की कम से कम दूरी. इसे व्यूपोर्ट के साइज़ के प्रतिशत के तौर पर दिखाया जाता है.

इस सेटिंग का इस्तेमाल renderMarginPercent के साथ किया जाता है. इससे विज्ञापन को पहले से फ़ेच किया जा सकता है. हालांकि, अन्य सब-संसाधनों को रेंडर और डाउनलोड करने के लिए इंतज़ार करना पड़ता है. इसलिए, यह वैल्यू हमेशा renderMarginPercent से ज़्यादा या उसके बराबर होनी चाहिए.

0 का मतलब है "जब स्लॉट व्यूपोर्ट में दिखता है", 100 का मतलब है "जब विज्ञापन व्यूपोर्ट से एक यूनिट दूर होता है" वगैरह.

Optional mobileScaling

mobileScaling?: number
मोबाइल डिवाइसों पर मार्जिन के लिए लागू किया गया मल्टीप्लायर. इस मल्टीप्लायर को fetchMarginPercent और renderMarginPercent, दोनों पर लागू किया जाता है.

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

Optional renderMarginPercent

renderMarginPercent?: number
विज्ञापन दिखाने से पहले, स्लॉट को मौजूदा व्यूपोर्ट से कम से कम कितनी दूरी पर होना चाहिए. इसे व्यूपोर्ट के साइज़ के प्रतिशत के तौर पर दिखाया जाता है.

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

0 वैल्यू का मतलब है "जब स्लॉट व्यूपोर्ट में दिखता है", 100 का मतलब है "जब विज्ञापन व्यूपोर्ट से एक यूनिट दूर होता है" वगैरह.

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?
विज्ञापन को बड़ा करने की सुविधा को कंट्रोल करने वाली सेटिंग.
adsenseAttributes?
AdSense एट्रिब्यूट कॉन्फ़िगर करने के लिए सेटिंग.
adYield?
अब सेवा में नहीं है. 
categoryExclusion?
विज्ञापन कैटगरी को बाहर रखने की सेटिंग.
centering?
इस सेटिंग का इस्तेमाल, विज्ञापनों को हॉरिज़ॉन्टल तौर पर बीच में दिखाने के लिए किया जाता है.
collapseDiv?
विज्ञापन स्लॉट के छोटा होने के तरीके को कंट्रोल करने वाली सेटिंग.
disableInitialLoad?
यह सेटिंग, विज्ञापन के अनुरोध का समय कंट्रोल करती है.
lazyLoad?
GPT में लेज़ी लोडिंग के इस्तेमाल को कंट्रोल करने के लिए सेटिंग.
location?
इस सेटिंग का इस्तेमाल करके, लाइन आइटम को भौगोलिक जगहों के हिसाब से टारगेट किया जा सकता है.
pps?
पब्लिशर से मिले सिग्नल (पीपीएस) को कंट्रोल करने की सेटिंग.
privacyTreatments?
पब्लिशर की निजता से जुड़ी सेटिंग को कंट्रोल करने के लिए सेटिंग.
safeFrame?
GPT में SafeFrame के इस्तेमाल को कंट्रोल करने के लिए सेटिंग.
singleRequest?
इस कुकी का इस्तेमाल, सिंगल रिक्वेस्ट आर्किटेक्चर (एसआरए) को चालू या बंद करने के लिए किया जाता है.
targeting?
कुंजी-वैल्यू टारगेटिंग को कंट्रोल करने की सेटिंग.
threadYield?
इस सेटिंग से यह कंट्रोल किया जाता है कि क्रिएटिव का अनुरोध करने और उन्हें रेंडर करने के दौरान, GPT को JS थ्रेड जनरेट करनी चाहिए या नहीं.
videoAds?
वीडियो विज्ञापनों को कंट्रोल करने की सेटिंग.

प्रॉपर्टी


Optional adExpansion

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

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig
AdSense एट्रिब्यूट को कॉन्फ़िगर करने की सेटिंग.

इस सेटिंग के ज़रिए कॉन्फ़िगर किए गए AdSense एट्रिब्यूट, पेज पर मौजूद सभी विज्ञापन स्लॉट पर लागू होंगे. इस सेटिंग को कई बार कॉल किया जा सकता है, ताकि एट्रिब्यूट की कई वैल्यू तय की जा सकें या मौजूदा वैल्यू को बदला जा सके.

AdSense एट्रिब्यूट में किए गए बदलाव, सिर्फ़ उन विज्ञापनों पर लागू होते हैं जिनके लिए इस तरीके को कॉल करने के बाद अनुरोध किया गया है. इसलिए, यह सुझाव दिया जाता है कि googletag.display या PubAdsService.refresh को कॉल करने से पहले, इस तरीके को कॉल करें.
उदाहरण

JavaScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

JavaScript (लेगसी)

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

TypeScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

Optional adYield

adYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

Optional categoryExclusion

categoryExclusion?: string[]
विज्ञापन कैटगरी को बाहर रखने की सेटिंग.
उदाहरण

JavaScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

JavaScript (लेगसी)

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

TypeScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });
इन्हें भी देखें

Optional सेंटर में अलाइन करना

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

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

JavaScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

JavaScript (लेगसी)

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

TypeScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

Optional collapseDiv

collapseDiv?: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"
विज्ञापन स्लॉट के छोटा होने के तरीके को कंट्रोल करने वाली सेटिंग.

छोटा किया गया विज्ञापन स्लॉट, पेज पर कोई जगह नहीं लेता.

इन वैल्यू के साथ काम करता है:
  • null (डिफ़ॉल्ट): स्लॉट छोटा नहीं किया जाएगा.
  • DISABLED: विज्ञापन दिखाए जाने पर भी स्लॉट छोटा नहीं होगा.
  • BEFORE_FETCH: यह स्लॉट शुरू में छोटा होगा. विज्ञापन दिखने पर यह बड़ा हो जाएगा.
  • ON_NO_FILL: यह स्लॉट, शुरुआत में बड़ा दिखेगा. अगर कोई विज्ञापन नहीं दिखाया जाता है, तो यह छोटा हो जाएगा.
उदाहरण

JavaScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

JavaScript (लेगसी)

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

TypeScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });
इन्हें भी देखें

Optional disableInitialLoad

disableInitialLoad?: boolean
यह सेटिंग, यह कंट्रोल करती है कि विज्ञापन का अनुरोध कब किया जाए.

डिफ़ॉल्ट रूप से, googletag.display तरीका, विज्ञापन स्लॉट रजिस्टर करता है और उनके लिए विज्ञापन का अनुरोध करता है. हालांकि, कुछ मामलों में इन कार्रवाइयों को अलग-अलग करना बेहतर हो सकता है, ताकि विज्ञापन कॉन्टेंट को लोड करने के समय को ज़्यादा सटीक तरीके से कंट्रोल किया जा सके.

इस सेटिंग को चालू करने पर, display() तरीके को कॉल किए जाने पर, रजिस्टर किए गए स्लॉट के लिए विज्ञापन का अनुरोध नहीं किया जाएगा. इसके बजाय, विज्ञापन अनुरोध शुरू करने के लिए PubAdsService.refresh को अलग से कॉल करना होगा.

googletag.enableServices को कॉल करने से पहले, इस तरीके को कॉल करना ज़रूरी है.
उदाहरण

JavaScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

JavaScript (लेगसी)

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

TypeScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });
इन्हें भी देखें

Optional lazyLoad

lazyLoad?: LazyLoadConfig
GPT में लेज़ी लोडिंग के इस्तेमाल को कंट्रोल करने के लिए सेटिंग.

लेज़ी लोडिंग एक ऐसी तकनीक है जिसकी मदद से, विज्ञापन अनुरोध और रेंडरिंग में तब तक देरी की जाती है, जब तक वे उपयोगकर्ता के व्यूपोर्ट के पास न पहुंच जाएं. ज़्यादा जानकारी के लिए, लेज़ी लोडिंग का सैंपल देखें.

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

setConfig() को कॉल करते समय, लेज़ी लोड की जो भी सेटिंग नहीं दी जाती हैं उनके लिए, Google की ओर से सेट की गई डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाएगा. इन डिफ़ॉल्ट सेटिंग में समय के साथ बदलाव किया जा सकता है. किसी सेटिंग को बंद करने के लिए, वैल्यू को null पर सेट करें.
उदाहरण

JavaScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

JavaScript (लेगसी)

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

TypeScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });
इन्हें भी देखें

Optional जगह की जानकारी

location?: string
इस सेटिंग का इस्तेमाल, लाइन आइटम को भौगोलिक जगहों के हिसाब से टारगेट करने के लिए किया जाता है.
उदाहरण

JavaScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

JavaScript (लेगसी)

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

TypeScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });
इन्हें भी देखें

Optional pps

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

Optional privacyTreatments

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

Optional safeFrame

safeFrame?: SafeFrameConfig
GPT में SafeFrame के इस्तेमाल को कंट्रोल करने की सेटिंग.

इस सेटिंग के ज़रिए कॉन्फ़िगर की गई वैल्यू, पेज पर मौजूद सभी विज्ञापन स्लॉट पर लागू होंगी. SlotSettingsConfig.safeFrame के ज़रिए, विज्ञापन के अलग-अलग स्लॉट इन वैल्यू को बदल सकते हैं.
उदाहरण

JavaScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

JavaScript (लेगसी)

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

TypeScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

Optional singleRequest

singleRequest?: boolean
इस सेटिंग का इस्तेमाल, सिंगल अनुरोध आर्किटेक्चर (एसआरए) को चालू या बंद करने के लिए किया जाता है.

एसआरए चालू होने पर, googletag.display या PubAdsService.refresh कॉल से पहले तय किए गए सभी विज्ञापन स्लॉट को एक विज्ञापन अनुरोध में बैच किया जाएगा. इससे परफ़ॉर्मेंस बेहतर होती है. साथ ही, यह भी पक्का किया जाता है कि रोडब्लॉक और प्रतिस्पर्धी एक्सक्लूज़न का पालन किया जाए.

एसआरए बंद होने पर, हर विज्ञापन स्लॉट के लिए अलग से अनुरोध किया जाता है. यह GPT का डिफ़ॉल्ट व्यवहार है.

इस तरीके को googletag.enableServices को कॉल करने से पहले ज़रूर कॉल किया जाना चाहिए.
उदाहरण

JavaScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

JavaScript (लेगसी)

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

TypeScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });
इन्हें भी देखें

Optional targeting

targeting?: Record<string, string | string[]>
यह सेटिंग, कुंजी-वैल्यू टारगेटिंग को कंट्रोल करती है.

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

JavaScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

JavaScript (लेगसी)

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

TypeScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });
इन्हें भी देखें

Optional threadYield

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

Optional videoAds

videoAds?: VideoAdsConfig
वीडियो विज्ञापनों को कंट्रोल करने की सेटिंग.
उदाहरण

JavaScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

JavaScript (लेगसी)

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

TypeScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});
इन्हें भी देखें

googletag.config.PrivacyTreatmentsConfig

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

प्रॉपर्टी


इलाज

treatments: "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
यह एक ऐसा ऑब्जेक्ट होता है जिसमें Taxonomy मैपिंग होती हैं. कॉन्फ़िगरेशन को मिटाने के लिए, इसे null पर सेट करें.
उदाहरण

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>>
यह एक ऐसा ऑब्जेक्ट होता है जिसमें Taxonomy मैपिंग होती हैं. कॉन्फ़िगरेशन को मिटाने के लिए, इसे null पर सेट करें.

googletag.config.SafeFrameConfig

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

प्रॉपर्टी


Optional allowOverlayExpansion

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

Optional allowPushExpansion

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

Optional forceSafeFrame

forceSafeFrame?: boolean
विज्ञापन को SafeFrame कंटेनर का इस्तेमाल करके रेंडर करने के लिए मजबूर किया जाना चाहिए या नहीं.

Optional सैंडबॉक्स

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

Optional useUniqueDomain

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

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

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?
विज्ञापन को बड़ा करने की सुविधा को कॉन्फ़िगर करने की सेटिंग.
adsenseAttributes?
AdSense एट्रिब्यूट कॉन्फ़िगर करने के लिए सेटिंग.
categoryExclusion?
विज्ञापन कैटगरी को बाहर रखने की सेटिंग.
clickUrl?
यह सेटिंग, उस यूआरएल को कॉन्फ़िगर करने के लिए होती है जिस पर उपयोगकर्ता को विज्ञापन पर क्लिक करने के बाद रीडायरेक्ट किया जाएगा.
collapseDiv?
विज्ञापन स्लॉट के छोटा होने के व्यवहार को कॉन्फ़िगर करने की सेटिंग.
componentAuction?
डिवाइस पर होने वाली विज्ञापन नीलामी में शामिल की जाने वाली कॉम्पोनेंट नीलामियों की एक कलेक्शन.
interstitial?
ये सेटिंग, इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को कॉन्फ़िगर करती हैं.
safeFrame?
GPT में SafeFrame के इस्तेमाल को कॉन्फ़िगर करने की सेटिंग.
targeting?
यह सेटिंग, कुंजी-वैल्यू टारगेटिंग को कॉन्फ़िगर करने के लिए होती है.

प्रॉपर्टी


Optional adExpansion

adExpansion?: AdExpansionConfig
विज्ञापन को बड़ा करने की सुविधा को कॉन्फ़िगर करने की सेटिंग.
इन्हें भी देखें

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig
AdSense एट्रिब्यूट को कॉन्फ़िगर करने की सेटिंग.

इस सेटिंग के ज़रिए कॉन्फ़िगर किए गए AdSense एट्रिब्यूट, सिर्फ़ विज्ञापन स्लॉट पर लागू होंगे. इस सेटिंग को कई बार कॉल किया जा सकता है, ताकि एट्रिब्यूट की कई वैल्यू तय की जा सकें या मौजूदा वैल्यू को बदला जा सके.

AdSense एट्रिब्यूट में किए गए बदलाव, सिर्फ़ उन विज्ञापनों पर लागू होते हैं जिनके लिए इस तरीके को कॉल करने के बाद अनुरोध किया गया है. इसलिए, यह सुझाव दिया जाता है कि googletag.display या PubAdsService.refresh को कॉल करने से पहले, इस तरीके को कॉल करें.
उदाहरण

JavaScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

JavaScript (लेगसी)

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

TypeScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

Optional categoryExclusion

categoryExclusion?: string[]
विज्ञापन कैटगरी को बाहर रखने की सेटिंग.
उदाहरण

JavaScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

JavaScript (लेगसी)

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

TypeScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });
इन्हें भी देखें

Optional clickUrl

clickUrl?: string
यह सेटिंग, उस यूआरएल को कॉन्फ़िगर करने के लिए होती है जिस पर विज्ञापन पर क्लिक करने के बाद उपयोगकर्ताओं को रीडायरेक्ट किया जाएगा.

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

ध्यान दें: यह सेटिंग सिर्फ़ एसआरए से बाहर के अनुरोधों पर लागू होती है.
उदाहरण

JavaScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

JavaScript (लेगसी)

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

TypeScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

Optional collapseDiv

collapseDiv?: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"
इस सेटिंग का इस्तेमाल, विज्ञापन स्लॉट के छोटा होने के तरीके को कॉन्फ़िगर करने के लिए किया जाता है.

छोटा किया गया विज्ञापन स्लॉट, पेज पर कोई जगह नहीं लेता.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • null (डिफ़ॉल्ट): स्लॉट छोटा नहीं किया जाएगा.
  • DISABLED: विज्ञापन दिखाए जाने पर भी स्लॉट छोटा नहीं होगा.
  • BEFORE_FETCH: यह स्लॉट शुरू में छोटा होगा. विज्ञापन दिखने पर यह बड़ा हो जाएगा.
  • ON_NO_FILL: यह स्लॉट, शुरुआत में बड़ा दिखेगा. अगर कोई विज्ञापन नहीं दिखाया जाता है, तो यह छोटा हो जाएगा.
उदाहरण

JavaScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

JavaScript (लेगसी)

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

TypeScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});
इन्हें भी देखें

Optional componentAuction

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

Optional पेज पर अचानक दिखने वाला विज्ञापन

interstitial?: InterstitialConfig
ये सेटिंग, इंटरस्टीशियल विज्ञापन स्लॉट के व्यवहार को कॉन्फ़िगर करती हैं.
इन्हें भी देखें

Optional safeFrame

safeFrame?: SafeFrameConfig
GPT में SafeFrame के इस्तेमाल को कॉन्फ़िगर करने की सेटिंग.

इस सेटिंग के ज़रिए कॉन्फ़िगर की गई वैल्यू, सिर्फ़ विज्ञापन स्लॉट पर लागू होंगी. साथ ही, PageSettingsConfig.safeFrame के ज़रिए सेट की गई वैल्यू को बदल देंगी.
उदाहरण

JavaScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

JavaScript (लेगसी)

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

TypeScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

Optional targeting

targeting?: Record<string, string | string[]>
कुंजी-वैल्यू टारगेटिंग को कॉन्फ़िगर करने की सेटिंग.

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

JavaScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

JavaScript (लेगसी)

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

TypeScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });
इन्हें भी देखें

googletag.config.TaxonomyData

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

प्रॉपर्टी


values

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

googletag.config.VideoAdsConfig

वीडियो विज्ञापन से जुड़ी सेटिंग कॉन्फ़िगर करने के लिए सेटिंग.
प्रॉपर्टी
enableVideoAds
इससे पता चलता है कि पेज पर वीडियो विज्ञापन मौजूद होंगे या नहीं.
videoCmsId?
वीडियो कॉन्टेंट का सोर्स आईडी.
videoContentId?
वीडियो का कॉन्टेंट आईडी.
इन्हें भी देखें

प्रॉपर्टी


enableVideoAds

enableVideoAds: boolean
इससे यह तय होता है कि पेज पर वीडियो विज्ञापन दिखेंगे या नहीं.

true पर सेट करने से, डिसप्ले और वीडियो विज्ञापनों के लिए कॉन्टेंट बाहर रखने की पाबंदियां लागू हो जाती हैं.

अगर वीडियो कॉन्टेंट के बारे में पता है, तो videoContentId और videoCmsId को Google Ad Manager की कॉन्टेंट इंटेक सेवा को दी गई वैल्यू पर सेट करें, ताकि डिसप्ले विज्ञापनों के लिए कॉन्टेंट बाहर रखने की सुविधा का इस्तेमाल किया जा सके.

Optional videoCmsId

videoCmsId?: string
वीडियो कॉन्टेंट के सोर्स का आईडी.

यह एक यूनीक वैल्यू होती है. इसे Google Ad Manager की कॉन्टेंट इनजेस्ट करने वाली सेवा असाइन करती है. इससे videoContentId एट्रिब्यूट से तय किए गए वीडियो कॉन्टेंट के सोर्स की पहचान की जाती है.
इन्हें भी देखें

Optional videoContentId

videoContentId?: string
वीडियो कॉन्टेंट का आईडी.

यह एक यूनीक वैल्यू होती है. इससे videoCmsId एट्रिब्यूट की वैल्यू के तौर पर दिए गए कॉन्टेंट सोर्स के किसी वीडियो की पहचान की जाती है. यह वैल्यू, उस सीएमएस से असाइन की जाती है जो आपके वीडियो कॉन्टेंट को होस्ट करता है.
इन्हें भी देखें

googletag.enums

यह नेमस्पेस है, जिसका इस्तेमाल GPT, enum टाइप के लिए करता है.
इन्यूमरेशन
OutOfPageFormat
GPT के साथ काम करने वाले आउट-ऑफ़-पेज फ़ॉर्मैट.
TrafficSource
GPT के साथ काम करने वाले ट्रैफ़िक सोर्स.

इन्यूमरेशन


OutOfPageFormat

OutOfPageFormat
GPT के साथ काम करने वाले आउट-ऑफ़-पेज फ़ॉर्मैट.
इन्हें भी देखें
इन्यूमरेशन के सदस्य
AD_INTENTS
विज्ञापन इंटेंट का फ़ॉर्मैट.
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
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला विज्ञापन दिखाने के लिए तैयार होता है.
RewardedSlotVideoCompletedEvent
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला वीडियो विज्ञापन पूरा चल जाता है.
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 के लिए एलियास.
rewardedSlotVideoCompleted
events.RewardedSlotVideoCompletedEvent के लिए उपनाम.
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 के लिए एलियास.

rewardedSlotVideoCompleted

rewardedSlotVideoCompleted: RewardedSlotVideoCompletedEvent
events.RewardedSlotVideoCompletedEvent के लिए उपनाम.

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

इनाम के बारे में जानकारी देने वाला ऑब्जेक्ट.

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

बढ़ाएं Event
यह इवेंट तब ट्रिगर होता है, जब इनाम वाला वीडियो विज्ञापन पूरा चल जाता है.
प्रॉपर्टी
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 video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

    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 video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", function (event) {
    var slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

    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 video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

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
रेंडर किए गए रिज़र्वेशन विज्ञापन का लाइन आइटम आईडी.
responseIdentifier
रिस्पॉन्स आइडेंटिफ़ायर, विज्ञापन रिस्पॉन्स के लिए यूनीक आइडेंटिफ़ायर होता है.
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: number
रेंडर किए गए विज्ञापन का विज्ञापन देने वाले व्यक्ति या कंपनी का आईडी. खाली स्लॉट, बैकफ़िल विज्ञापनों, और PubAdsService के अलावा अन्य सेवाओं से रेंडर किए गए क्रिएटिव के लिए वैल्यू null होती है.

campaignId

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

companyIds

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

creativeId

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

creativeTemplateId

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

isBackfill

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

isEmpty

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

labelIds

labelIds: number[]

lineItemId

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

responseIdentifier

responseIdentifier: string
रिस्पॉन्स आइडेंटिफ़ायर, विज्ञापन रिस्पॉन्स के लिए यूनीक आइडेंटिफ़ायर होता है. इस वैल्यू का इस्तेमाल, विज्ञापन समीक्षा केंद्र (एआरसी) में विज्ञापन की पहचान करने और उसे ब्लॉक करने के लिए किया जा सकता है.

size

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

slotContentChanged

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

sourceAgnosticCreativeId

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

sourceAgnosticLineItemId

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

yieldGroupIds

yieldGroupIds: 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: SecureSignalProviderऐरे में जोड़ा जाने वाला secureSignals.SecureSignalProvider ऑब्जेक्ट.