GPT Referansı

Bu referansta, türleri açıklamak için TypeScript gösterimi kullanılır. Aşağıdaki tabloda, örneklerle kısa bir açıklama verilmiştir.

İfade yazın
string	Temel dize türü.
string[]	Değerlerin yalnızca dize olabileceği bir dizi türü.
number | string	Değerin sayı veya dize olabileceği bir birleşim türü.
Array<number | string>	Değerlerin karmaşık (birleşim) türünde olduğu bir dizi türü.
[number, string]	Değerin, sırasıyla bir sayı ve bir dize içermesi gereken iki öğeli bir dizi olduğu bir tuple türü.
Slot	Değerin googletag.Slot örneği olduğu bir nesne türü.
() => void	Tanımlı bağımsız değişkenleri ve dönüş değeri olmayan bir işlev türü.

Desteklenen türler ve tür ifadeleri hakkında daha fazla bilgi edinmek için TypeScript El Kitabı 'na bakın.

Tür ek açıklamaları

Bir değişken, parametre adı, özellik adı veya işlev imzasından sonra gelen iki nokta üst üste işareti, tür ek açıklamasını belirtir. Tür ek açıklamaları, iki noktanın solundaki öğenin kabul edebileceği veya döndürebileceği türleri açıklar. Aşağıdaki tabloda, bu referansta görebileceğiniz tür ek açıklamalarına örnekler verilmiştir.

Tür ek açıklaması
param: string	param işlevinin bir dize değerini kabul ettiğini veya döndürdüğünü gösterir. Bu söz dizimi; değişkenler, parametreler, özellikler ve dönüş türleri için kullanılır.
param?: number | string	param değerinin isteğe bağlı olduğunu ancak belirtildiğinde bir sayı veya dize kabul ettiğini gösterir. Bu söz dizimi, parametreler ve özellikler için kullanılır.
...params: Array<() => void>	params parametresinin, işlevleri kabul eden bir kalan parametre olduğunu gösterir. Kalan parametreler, belirtilen türde sınırsız sayıda değer kabul eder.

---

googletag

Google Yayıncı Etiketi'nin API'si için kullandığı global ad alanı.

Ad alanları
config	Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.
enums	Bu, GPT'nin enum türleri için kullandığı ad alanıdır.
events	Bu, GPT'nin etkinlikler için kullandığı ad alanıdır.
secureSignals	Bu, GPT'nin güvenli sinyalleri yönetmek için kullandığı ad alanıdır.

Arayüzler
CommandArray	Komut dizisi, bir dizi işlevi kabul eder ve bunları sırayla çağırır.
CompanionAdsService	Tamamlayıcı Reklamlar hizmeti.
PrivacySettingsConfig	Gizlilik ayarları için yapılandırma nesnesi.
PubAdsService	Yayıncı Reklamları hizmeti.
RequestHook	PubAdsService.registerRequestHook aracılığıyla kaydedildiğinde her reklam isteğinden önce çağrılan geri çağırma işlevi.
ResponseInformation	Tek bir reklam yanıtını temsil eden nesne.
RewardedPayload	Ödüllü reklamla ilişkili ödülü temsil eden nesne.
Service	Tüm hizmetler için ortak yöntemler içeren temel hizmet sınıfı.
SizeMappingBuilder	Boyut eşleme spesifikasyonu nesneleri için oluşturucu.
Slot	Alan, sayfadaki tek bir reklam alanını temsil eden bir nesnedir.

Tür Takma Adları
FluidSize	Reklam kapsayıcının üst div'inin% 100 genişliğini aldığı ve ardından yüksekliğini reklam öğesi içeriğine uyacak şekilde yeniden boyutlandırdığı boyut dizesi.
GeneralSize	Bir alan için geçerli boyut yapılandırması. Bir veya birden fazla boyut olabilir.
MultiSize	Geçerli tek boyutların listesi.
NamedSize	Bir alanın sahip olabileceği adlandırılmış boyutlar.
SingleSize	Bir alan için tek bir geçerli boyut.
SingleSizeArray	[Genişlik, yükseklik] değerlerini temsil eden iki sayıdan oluşan dizi.
SizeMapping	Görüntü alanı boyutunun reklam boyutlarıyla eşlemesi.
SizeMappingArray	Boyut eşlemelerinin listesi.

Değişkenler
apiReady	GPT API'nin yüklendiğini ve çağrılmaya hazır olduğunu gösteren işaret.
cmd	GPT ile ilgili çağrıların eşzamansız yürütülmesi için genel komut sırasına referans.
pubadsReady	PubAdsService'in etkin, yüklü ve tamamen çalışır durumda olduğunu gösteren işaret.
secureSignalProviders	Güvenli sinyal sağlayıcılar dizisine referans.

İşlevler
companionAds	CompanionAdsService'e bir referans döndürür.
defineOutOfPageSlot	Belirli reklam birimi yoluyla sayfa dışı reklam alanı oluşturur.
defineSlot	Belirli bir reklam birimi yolu ve boyutuyla reklam alanı oluşturur ve bunu sayfada reklamı içerecek div öğesinin kimliğiyle ilişkilendirir.
destroySlots	Belirli alanları yok ederek bu alanların tüm ilgili nesnelerini ve referanslarını GPT'den kaldırır.
disablePublisherConsole	Google Yayıncı Konsolu'nu devre dışı bırakır.
display	Alan hizmetlerine alanı oluşturma talimatı verir.
enableServices	Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.
getConfig	setConfig tarafından ayarlanan sayfa için genel yapılandırma seçeneklerinin dondurulmuş bir kopyasını alır.
getVersion	GPT'nin mevcut sürümünü döndürür.
openConsole	Google Yayıncı Konsolu'nu açar.
pubads	PubAdsService'e bir referans döndürür.
setAdIframeTitle	Bu noktadan itibaren PubAdsService tarafından oluşturulan tüm reklam kapsayıcısı iframe'lerinin başlığını ayarlar.
setConfig	Sayfa için genel yapılandırma seçeneklerini ayarlar.
sizeMapping	Yeni bir SizeMappingBuilder oluşturur.

Tür Takma Adları

---

FluidSize

FluidSize: "fluid"

Reklam kapsayıcının üst div'inin% 100 genişliğini aldığı ve ardından yüksekliğini reklam öğesi içeriğine uyacak şekilde yeniden boyutlandırdığı boyut dizesi. Bu, sayfadaki normal blok öğelerinin davranışına benzer. Doğal ve banner reklamlar için kullanılır (ilgili makaleye bakın).

---

GeneralSize

GeneralSize: SingleSize | MultiSize

Bir alan için geçerli boyut yapılandırması. Bir veya birden fazla boyut olabilir.

---

MultiSize

MultiSize: SingleSize[]

Geçerli tek boyutların listesi.

---

NamedSize

NamedSize: FluidSize | [FluidSize]

Bir alanın sahip olabileceği adlandırılmış boyutlar. Çoğu durumda boyut, sabit boyutlu bir dikdörtgendir ancak başka türde boyut spesifikasyonlarına ihtiyaç duyduğumuz bazı durumlar da vardır. Yalnızca aşağıdaki adlandırılmış boyutlar geçerlidir:

• Akışkan: Reklam kapsayıcısı, üst div'inin% 100 genişliğini alır ve ardından yüksekliğini reklam öğesi içeriğine uyacak şekilde yeniden boyutlandırır. Bu, sayfadaki normal blok öğelerinin davranışına benzer. Doğal ve banner reklamlar için kullanılır (ilgili makaleye bakın). Hem fluid hem de ['fluid'], bir alan boyutunu akıcı olarak bildirmek için kabul edilebilir biçimlerdir.

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

Bir alan için tek bir geçerli boyut.

---

SingleSizeArray

SingleSizeArray: [number, number]

[Genişlik, yükseklik] değerlerini temsil eden iki sayıdan oluşan dizi.

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

Görüntü alanı boyutunun reklam boyutlarıyla eşlemesi. Duyarlı reklamlar için kullanılır.

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

Boyut eşlemelerinin listesi.

Değişkenler

---

Const apiReady

apiReady: boolean | undefined

GPT API'nin yüklendiğini ve çağrılmaya hazır olduğunu gösteren işaret. Bu özellik, API hazır olana kadar yalnızca undefined olacaktır.

Eş zamansız işlemleri yönetmenin önerilen yolunun, GPT hazır olduğunda geri çağırmaları sıraya almak için googletag.cmd kullanmak olduğunu unutmayın. API ayarlandıktan sonra yürütülmeleri garanti edildiğinden bu geri çağırmaların googletag.apiReady'yi kontrol etmesi gerekmez.

---

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray

GPT ile ilgili çağrıların eşzamansız yürütülmesi için genel komut sırasına referans.

googletag.cmd değişkeni, sayfadaki GPT etiketi söz dizimi tarafından boş bir JavaScript dizisine başlatılır ve cmd.push, dizinin sonuna bir öğe ekleyen standart Array.push yöntemidir. GPT JavaScript yüklendiğinde diziyi inceler ve tüm işlevleri sırayla yürütür. Ardından komut dosyası, cmd değerini, push yöntemi kendisine iletilen işlev bağımsız değişkenini yürütecek şekilde tanımlanmış bir CommandArray nesnesiyle değiştirir. Bu mekanizma, GPT'nin JavaScript'i eşzamansız olarak getirirken tarayıcının sayfayı oluşturmaya devam etmesine olanak tanıyarak algılanan gecikmeyi azaltmasını sağlar.

Örnek

JavaScript

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

JavaScript (eski)

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'in etkin, yüklü ve tamamen çalışır durumda olduğunu gösteren işaret. Bu özellik, enableServices çağrılana ve PubAdsService yüklenip başlatılana kadar yalnızca undefined olur.

---

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

Güvenli sinyal sağlayıcılar dizisine referans.

Güvenli sinyal sağlayıcılar dizisi, bir dizi sinyal oluşturma işlevini kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra çağrılacak sinyal üreten işlevleri sıraya almak için kullanılan standart bir dizinin yerini alması amaçlanmıştır.

Örnek

JavaScript

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

JavaScript (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Güvenli sinyalleri teklif verenlerle paylaşma

İşlevler

---

companionAds

companionAds(): CompanionAdsService

CompanionAdsService'e bir referans döndürür.

İadeler
CompanionAdsService	Tamamlayıcı Reklamlar hizmeti.

---

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null

Belirli reklam birimi yoluyla sayfa dışı reklam alanı oluşturur.

Özel sayfa dışı reklamlar için div, reklamı içerecek div öğesinin kimliğidir. Daha fazla bilgi için sayfa dışı reklam öğeleri ile ilgili makaleye bakın.

GPT tarafından yönetilen sayfa dışı reklamlar için div, desteklenen bir OutOfPageFormat'tır.

Örnek

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 (eski)

// 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);

Aşağıdaki kaynakları da incelemenizi öneririz:

• Ödüllü reklam gösterme
• Web geçiş reklamı gösterme
• Sabit reklam gösterme
• Sayfa dışı reklam gösterme

Parametreler
adUnitPath: string	Ağ kodu ve reklam birimi kodunu içeren tam reklam birimi yolu.
Optional div: string | OutOfPageFormat	Bu reklam birimini veya OutOfPageFormat'ı içerecek div'in kimliği.

İadeler
Slot | null	Yeni oluşturulan alan veya alan oluşturulamıyorsa null.

---

defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null

Belirli bir reklam birimi yolu ve boyutuyla reklam alanı oluşturur ve bunu sayfada reklamı içerecek div öğesinin kimliğiyle ilişkilendirir.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Yayıncı Etiketleri'ni kullanmaya başlama

Parametreler
adUnitPath: string	Ağ kodu ve birim kodunu içeren tam reklam birimi yolu.
size: GeneralSize	Eklenen alanın genişliği ve yüksekliği. Duyarlı boyut eşleme sağlanmazsa veya görüntü alanının boyutu, eşlemede sağlanan en küçük boyuttan daha küçükse reklam isteğinde bu boyut kullanılır.
Optional div: string	Bu reklam birimini içerecek div'in kimliği.

İadeler
Slot | null	Yeni oluşturulan alan veya alan oluşturulamıyorsa null.

---

destroySlots

destroySlots(slots?: Slot[]): boolean

Belirli alanları yok ederek bu alanların tüm ilgili nesnelerini ve referanslarını GPT'den kaldırır. Bu API, geri verilen reklam alanlarını ve tamamlayıcı reklam alanlarını desteklemez.

Bu API'yi bir reklam alanında çağırmak reklamı temizler ve reklam alanı nesnesini GPT tarafından tutulan dahili durumdan kaldırır. Alan nesnesinde daha fazla işlev çağrılması, tanımlanmamış davranışlara neden olur. Yayıncı sayfası, alanla ilgili bir referans tutuyorsa tarayıcının bu alanla ilişkili belleği boşaltmayabileceğini unutmayın. Bu API'nin çağrılması, söz konusu alanla ilişkili div'i yeniden kullanılabilir hale getirir.

Özellikle bir alanın yok edilmesi, reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez. Bir alanın div öğesini sayfadan kaldırmadan önce bu işlevin çağrılmaması, tanımlanmamış davranışlara neden olur.

Örnek

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 (eski)

// 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();

Parametreler
Optional slots: Slot[]	Yok edilecek alanların dizisi. Dizi isteğe bağlıdır. Belirtilmezse tüm alanlar yok edilir.

İadeler
boolean	Alanlar imha edilmişse true, aksi takdirde false.

---

disablePublisherConsole

disablePublisherConsole(): void

Google Yayıncı Konsolu'nu devre dışı bırakır.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Yayıncı Konsolu

---

display

display(divOrSlot: string | Element | Slot): void

Alan hizmetlerine alanı oluşturma talimatı verir. Her reklam alanı, sayfa başına yalnızca bir kez gösterilmelidir. Tüm aralıklar tanımlanmalı ve gösterilmeden önce kendileriyle ilişkilendirilmiş bir hizmete sahip olmalıdır. Görüntüleme çağrısı, öğe DOM'da mevcut olana kadar gerçekleşmemelidir. Bunu yapmanın normal yolu, yöntemin çağrıldığı div öğesinin içindeki bir komut dosyası bloğuna yerleştirmektir.

Tekli istek mimarisi (SRA) kullanılıyorsa bu yöntem çağrıldığında henüz getirilmemiş tüm reklam alanları tek seferde getirilir. Bir reklam alanının gösterilmesini engellemek için div'in tamamı kaldırılmalıdır.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Yayıncı Etiketleri'ni kullanmaya başlama
• Test reklamı gösterme
• Reklam yüklemeyi ve yenilemeyi kontrol etme

Parametreler
divOrSlot: string | Element | Slot	Reklam alanını içeren div öğesinin kimliği, div öğesi veya alan nesnesi. Bir div öğesi sağlanırsa bu öğenin defineSlot'a iletilen kimlikle eşleşen bir "id" özelliği olmalıdır.

---

enableServices

enableServices(): void

Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>

setConfig tarafından ayarlanan sayfa için genel yapılandırma seçeneklerinin dondurulmuş bir kopyasını alır.

Tüm setConfig() özellikleri bu yöntem tarafından desteklenmez. Desteklenen özellikler şunlardır:

• adsenseAttributes
• disableInitialLoad
• targeting

Örnek

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 (eski)

// 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"]);

Parametreler
keys: string | string[]	Alınacak yapılandırma seçeneklerinin anahtarları.

İadeler
Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>	Sayfanın yapılandırma seçeneklerinin dondurulmuş bir kopyası.

---

getVersion

getVersion(): string

GPT'nin mevcut sürümünü döndürür.

Aşağıdaki kaynakları da incelemenizi öneririz:

• GPT sürüm geçmişi

İadeler
string	Şu anda yürütülen GPT sürüm dizesi.

---

openConsole

openConsole(div?: string): void

Google Yayıncı Konsolu'nu açar.

Örnek

JavaScript

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

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

JavaScript (eski)

// 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();

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Yayıncı Konsolu

Parametreler
Optional div: string	Reklam alanı div kimliği. Bu değer isteğe bağlıdır. Sağlandığında Yayıncı Konsolu, belirtilen reklam alanının ayrıntıları görünür olacak şekilde açılmaya çalışır.

---

pubads

pubads(): PubAdsService

PubAdsService'e bir referans döndürür.

İadeler
PubAdsService	Yayıncı Reklamları hizmeti.

---

setAdIframeTitle

setAdIframeTitle(title: string): void

Bu noktadan itibaren PubAdsService tarafından oluşturulan tüm reklam kapsayıcısı iFrame'lerinin başlığını ayarlar.

Örnek

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (eski)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

Parametreler
title: string	Tüm reklam kapsayıcısı iframe'leri için yeni başlık.

---

setConfig

setConfig(config: PageSettingsConfig): void

Sayfa için genel yapılandırma seçeneklerini ayarlar.

Parametreler
config: PageSettingsConfig

---

sizeMapping

sizeMapping(): SizeMappingBuilder

Yeni bir SizeMappingBuilder oluşturur.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam boyutları: Duyarlı reklamlar

İadeler
SizeMappingBuilder	Yeni bir oluşturucu.

---

googletag.CommandArray

Komut dizisi, bir dizi işlevi kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra çağrılacak işlevleri sıraya almak için kullanılan standart bir dizinin yerini alması amaçlanmıştır.

Yöntemler
push	Bağımsız değişkenlerde belirtilen işlev sırasını sırayla yürütür.

Yöntemler

---

push

push(...f: ((this: typeof globalThis) => void)[]): number

Bağımsız değişkenlerde belirtilen işlev dizisini sırayla yürütür.

Örnek

JavaScript

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

JavaScript (eski)

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());
});

Parametreler
Rest ...f: ((this: typeof globalThis) => void)[]	Yürütülecek bir JavaScript işlevi. Çalışma zamanı bağlaması her zaman globalThis olur. Kapsayan sözcüksel bağlamın this değerini korumak için bir ok işlevi iletmeyi deneyin.

İadeler
number	Şu ana kadar işlenen komutların sayısı. Bu, Array.push işlevinin döndürdüğü değerle (dizinin mevcut uzunluğu) uyumludur.

---

googletag.CompanionAdsService

Service uzatır

Tamamlayıcı Reklamlar hizmeti. Bu hizmet, video reklamlar tarafından tamamlayıcı reklamları göstermek için kullanılır.

Yöntemler
addEventListener	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder. Service.addEventListener yönteminden devralındı
getSlots	Bu hizmetle ilişkili zaman aralıklarının listesini alın. Service.getSlots yönteminden devralındı
removeEventListener	Daha önce kaydedilmiş bir dinleyiciyi kaldırır. Service.removeEventListener yönteminden devralındı
setRefreshUnfilledSlots	Doldurulmamış tamamlayıcı alanlarının otomatik olarak doldurulup doldurulmayacağını ayarlar.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Video ve işitsel için tamamlayıcı reklamlar

Yöntemler

---

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void

Doldurulmamış tamamlayıcı alanların otomatik olarak doldurulup doldurulmayacağını ayarlar.

Bu yöntem, sayfanın kullanım ömrü boyunca doldurmayı açıp kapatmak için birden çok kez çağrılabilir. Yalnızca PubAdsService'e kayıtlı alanlar doldurulur. Politika kısıtlamaları nedeniyle bu yöntem, bir Ad Exchange videosu yayınlandığında boş tamamlayıcı alanlarını doldurmak için tasarlanmamıştır.

Örnek

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (eski)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Parametreler
value: boolean	Doldurulmamış alanları otomatik olarak doldurmak için true, değiştirmeden bırakmak için false seçeneğini belirleyin.

---

googletag.PrivacySettingsConfig

Gizlilik ayarları için yapılandırma nesnesi.

Özellikler
childDirectedTreatment?	Sayfanın çocuklara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtir.
limitedAds?	Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için reklam yayınlamanın sınırlı reklamlar modunda çalışmasını sağlar.
nonPersonalizedAds?	Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için reklam yayınlamanın kişiselleştirilmemiş reklamlar modunda çalışmasını sağlar.
restrictDataProcessing?	Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın kısıtlanmış işleme modunda çalışmasını sağlar.
tagForAgeTreatment?	Reklam isteğinin çocuk, genç veya belirtilmemiş olarak değerlendirilmesi gerektiğini belirten yaş kısıtlamalı değerlendirme.
trafficSource?	İsteklerin satın alınan trafiği mi yoksa organik trafiği mi temsil ettiğini gösterir.
underAgeOfConsent?	Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geldiğini belirtecek şekilde işaretlenip işaretlenmeyeceğini gösterir.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Gizlilik ayarlarını yapılandırma

Özellikler

---

Optional childDirectedTreatment

childDirectedTreatment?: boolean

Sayfanın çocuklara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtir. Yapılandırmayı temizlemek için null olarak ayarlayın.

---

Optional limitedAds

limitedAds?: boolean

Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın sınırlı reklamlar modunda çalışmasını sağlar.

GPT'ye sınırlı reklam isteğinde bulunması için iki şekilde talimat verebilirsiniz:

• IAB TCF 2.0 sürümü kullanıcı rızası yönetim platformundan gelen bir sinyali kullanarak otomatik olarak.
• Bu alanın değerini true olarak ayarlayarak manuel olarak.

Sınırlı reklamları manuel olarak yapılandırmak yalnızca GPT, sınırlı reklam URL'sinden yüklendiğinde mümkündür. GPT standart URL'den yüklendiğinde bu ayarı değiştirmeye çalışmak Yayıncı Konsolu uyarısı oluşturur.

CMP kullanıldığında sınırlı reklamları manuel olarak etkinleştirmenin gerekli olmadığını unutmayın.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Sınırlı reklam gösterme

---

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean

Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için reklam yayınlamanın kişiselleştirilmemiş reklamlar modunda çalışmasını sağlar.

---

Optional restrictDataProcessing

restrictDataProcessing?: boolean

Yayıncıların düzenleyici kurumun belirlediği kurallara uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın kısıtlanmış işleme modunda çalışmasını sağlar.

---

Optional tagForAgeTreatment

tagForAgeTreatment?: TagForAgeTreatment

Reklam isteğinin çocuk, genç veya belirtilmemiş olarak değerlendirilmesi gerektiğini belirten yaş kısıtlamalı değerlendirme.

Yasal ve düzenleyici şartlarınıza göre kullanıcılarınızın yaşa göre değerlendirme ayarlarını belirlemek için hukuk danışmanınıza başvurun. Bu ayar hakkında daha fazla bilgi için bu Yardım Merkezi makalesini inceleyin.

Bu özelliği ayarlayarak bu bildirimin doğru olduğunu ve site sahibi adına işlem yapma yetkiniz olduğunu onaylamış olursunuz. Bu ayarın kötüye kullanımının Google Hesabınızın kapatılmasına yol açabileceğini kabul ediyorsunuz.

Örnek

JavaScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

JavaScript (eski)

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

TypeScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

---

Optional trafficSource

trafficSource?: TrafficSource

İsteklerin satın alınan trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir. Bu değer, Ad Manager raporlarındaki Trafik kaynağı boyutunu doldurur. Ayarlanmazsa trafik kaynağı, raporlarda varsayılan olarak undefined olur.

Örnek

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 (eski)

// 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

Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geldiğini belirtecek şekilde işaretlenip işaretlenmeyeceğini gösterir. Yapılandırmayı temizlemek için null olarak ayarlayın.

---

googletag.PubAdsService

Service uzatır

Yayıncı Reklamları hizmeti. Bu hizmet, Google Ad Manager hesabınızdaki reklamları almak ve göstermek için kullanılır.

Yöntemler
addEventListener	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder. Service.addEventListener yönteminden devralındı
clear	Reklamları belirli alanlardan kaldırır ve boş içerikle değiştirir.
clearCategoryExclusions	Kullanımdan kaldırıldı. Sayfa düzeyi reklam kategorisi hariç tutma etiketlerinin tümünü temizler.
clearTargeting	Kullanımdan kaldırıldı. Belirli bir anahtar veya tüm anahtarlar için özel hedefleme parametrelerini temizler.
collapseEmptyDivs	Kullanımdan kaldırıldı. Gösterilecek reklam içeriği olmadığında sayfada yer kaplamamaları için alan div'lerinin daraltılmasını sağlar.
disableInitialLoad	Kullanımdan kaldırıldı. Sayfa yükleme sırasında reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam istenmesine izin verir.
display	Belirli reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve gösterir.
enableLazyLoad	Kullanımdan kaldırıldı. GPT'de, yapılandırma nesnesi tarafından tanımlanan geç yüklemeyi etkinleştirir.
enableSingleRequest	Kullanımdan kaldırıldı. Aynı anda birden fazla reklam getirmek için tek istek modunu etkinleştirir.
enableVideoAds	Kullanımdan kaldırıldı. GPT'ye sayfada video reklamların bulunacağını bildirir.
get	Kullanımdan kaldırıldı. Belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
getAttributeKeys	Kullanımdan kaldırıldı. Bu hizmette ayarlanmış özellik anahtarlarını döndürür.
getSlots	Bu hizmetle ilişkili zaman aralıklarının listesini alın. Service.getSlots yönteminden devralındı
getTargeting	Kullanımdan kaldırıldı. Ayarlanmış belirli bir özel hizmet düzeyinde hedefleme parametresini döndürür.
getTargetingKeys	Kullanımdan kaldırıldı. Ayarlanmış tüm özel hizmet düzeyi hedefleme anahtarlarının listesini döndürür.
isInitialLoadDisabled	Kullanımdan kaldırıldı. İlk reklam isteklerinin önceki bir PubAdsService.disableInitialLoad çağrısı tarafından başarıyla devre dışı bırakılıp bırakılmadığını döndürür.
refresh	Sayfadaki belirli veya tüm alanlar için yeni reklamlar getirir ve gösterir.
registerRequestHook	Sayfadaki her reklam isteğinden önce, global bir zaman aşımı süresi içinde diğer kayıtlı kancalarla paralel olarak yürütülecek bir kanca kaydeder.
removeEventListener	Daha önce kaydedilmiş bir dinleyiciyi kaldırır. Service.removeEventListener yönteminden devralındı
set	Kullanımdan kaldırıldı. Yayıncı Reklamları hizmeti kapsamındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.
setCategoryExclusion	Kullanımdan kaldırıldı. Belirli etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.
setCentering	Kullanımdan kaldırıldı. Reklamların yatay olarak ortalanmasını etkinleştirir ve devre dışı bırakır.
setForceSafeFrame	Kullanımdan kaldırıldı. Sayfadaki tüm reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
setLocation	Kullanımdan kaldırıldı. Satır öğelerini belirli konumlara coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini iletir.
setPrivacySettings	Bir yapılandırma nesnesi kullanarak tüm gizlilik ayarlarının tek bir API'den yapılandırılmasına olanak tanır.
setPublisherProvidedId	Yayıncı tarafından sağlanan kimliğin değerini ayarlar.
setSafeFrameConfig	Kullanımdan kaldırıldı. SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar.
setTargeting	Kullanımdan kaldırıldı. Tüm Yayıncı Reklamları hizmeti reklam alanları için geçerli olan belirli bir anahtar için özel hedefleme parametreleri ayarlar.
setVideoContent	Kullanımdan kaldırıldı. Hedefleme ve içerik hariç tutma amacıyla reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar.
updateCorrelator	Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntüleme başlatır.

Yöntemler

---

clear

clear(slots?: Slot[]): boolean

Reklamları belirli alanlardan kaldırır ve boş içerikle değiştirir. Alanlar, getirilmemiş olarak işaretlenir.

Özellikle bir alanın temizlenmesi, reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Bu nedenle, gelecekteki istekler bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez.

Örnek

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 (eski)

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();

Parametreler
Optional slots: Slot[]	Temizlenecek alanların dizisi. Dizi isteğe bağlıdır. Belirtilmezse tüm alanlar temizlenir.

İadeler
boolean	Alanlar temizlendiyse true, aksi takdirde false döndürür.

---

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Tüm sayfa düzeyinde reklam kategorisi hariç tutma etiketlerini temizler. Bu, alanı yenilemek istediğinizde kullanışlıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.categoryExclusion kullanın.

Örnek

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

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

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

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

JavaScript (eski)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

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

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

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

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

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

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

clearTargeting

clearTargeting(key?: string): PubAdsService

Belirli bir anahtar veya tüm anahtarlar için özel hedefleme parametrelerini temizler.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.targeting kullanın.

Örnek

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

JavaScript (eski)

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

Parametreler
Optional key: string	Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmezse tüm hedefleme parametreleri temizlenir.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

Gösterilecek reklam içeriği olmadığında sayfada yer kaplamamaları için alan div'lerinin daraltılmasını sağlar. Bu mod, hizmet etkinleştirilmeden önce ayarlanmalıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.collapseDiv kullanın.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Boş reklam alanlarını daraltma
• Düzen kaymasını en aza indirme

Parametreler
Optional collapseBeforeAdFetch: boolean	Reklamlar getirilmeden önce bile alanların daraltılıp daraltılmayacağı. Bu parametre isteğe bağlıdır. Belirtilmezse varsayılan değer olarak false kullanılır.

İadeler
boolean	div daraltma modu etkinleştirildiyse true, yöntem hizmet etkinleştirildikten sonra çağrıldığı için daraltma modunu etkinleştirmek mümkün değilse false değerini döndürür.

---

disableInitialLoad

disableInitialLoad(): void

Sayfa yükleme sırasında reklam isteklerini devre dışı bırakır ancak reklamların bir PubAdsService.refresh çağrısıyla istenmesine izin verir. Bu ayar, hizmet etkinleştirilmeden önce yapılmalıdır. Eşzamansız mod kullanılmalıdır. Aksi takdirde refresh kullanarak reklam istemek mümkün olmaz.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.disableInitialLoad kullanın.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam yüklemeyi ve yenilemeyi kontrol etme
• SRA gruplandırmasını kontrol etme

---

görüntülü reklamcılık

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void

Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve görüntüler.

Bu yöntem, googletag.defineSlot ve hemen ardından googletag.display çağrısının kısaltılmış bir eşdeğeridir.

Bu yöntemin davranışı, Tek İstek Mimarisi'nin (SRA) etkin olup olmadığına bağlıdır:

• SRA etkin: Bu çağrıya kadar tanımlanan tüm reklam alanları gruplandırılır ve birlikte istenir.
• SRA devre dışı (varsayılan): Reklam alanı ayrı ayrı istenir.

Not: Bu yöntem çağrıldığında, reklam isteği gönderilirken ve yanıt oluşturulurken tutarlılık sağlamak için alan ve sayfa durumunun bir anlık görüntüsü oluşturulur. Bu yöntem çağrıldıktan sonra alan veya sayfa durumunda yapılan değişiklikler (hedefleme, gizlilik ayarları, SafeFrame'i zorunlu kılma vb. dahil) yalnızca sonraki display() veya refresh() istekleri için geçerli olur.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Test reklamı gösterme
• Reklam yüklemeyi ve yenilemeyi kontrol etme

Parametreler
adUnitPath: string	Oluşturulacak alanın reklam birimi yolu.
size: GeneralSize	Alan genişliği ve yüksekliği.
Optional div: string | Element	Alanı içeren div'in kimliği veya div öğesinin kendisi.
Optional clickUrl: string	Bu alanda kullanılacak tıklama URL'si.

---

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void

GPT'de yapılandırma nesnesi tarafından tanımlanan geç yüklemeyi etkinleştirir. Daha ayrıntılı örnekler için Geç yükleme örneğine bakın.

Not: SRA'da geç getirme yalnızca tüm alanlar getirme marjının dışındaysa çalışır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.lazyLoad kullanın.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamlarla ilgili en iyi uygulamalar: "Önemli" reklam alanlarına öncelik verme
• Geç yükleme

Parametreler

Optional config: {   fetchMarginPercent?: number;   mobileScaling?: number;   renderMarginPercent?: number; }

Yapılandırma nesnesi, geç yükleme davranışının özelleştirilmesine olanak tanır. Atlanan yapılandırmalar, Google tarafından belirlenen ve zaman içinde ayarlanacak varsayılan bir grubu kullanır. Getirme marjı gibi belirli bir ayarı devre dışı bırakmak için değeri -1 olarak ayarlayın. fetchMarginPercent Reklamı görüntüleme alanı boyutunun yüzdesi olarak getirmemiz için bir alanın mevcut görüntüleme alanından olması gereken minimum mesafe. 0 değeri "alan görüntüleme alanına girdiğinde", 100 değeri "reklam 1 görüntüleme alanı uzakta olduğunda" anlamına gelir ve bu şekilde devam eder. renderMarginPercent Bir reklamı oluşturmadan önce bir alanın mevcut görüntü alanından olması gereken minimum mesafe. Bu, reklamın önceden getirilmesine olanak tanır ancak diğer alt kaynakların oluşturulması ve indirilmesi için bekler. Değer, görüntü alanının yüzdesi olarak fetchMarginPercent ile aynı şekilde çalışır. mobileScaling Mobil cihazlardaki kenar boşluklarına uygulanan bir çarpan. Bu sayede mobil ve masaüstü cihazlarda farklı kenar boşlukları kullanılabilir. Örneğin, 2, 0 değeri mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir alanın getirme ve oluşturma işleminden önce sahip olabileceği minimum mesafeyi artırır.

---

enableSingleRequest

enableSingleRequest(): boolean

Birden fazla reklamı aynı anda getirmek için tek istek modunu etkinleştirir. Bu, hizmet etkinleştirilmeden önce tüm reklam alanı tanımlarının yapılmasını ve PubAdsService'e eklenmesini gerektirir. Tek istek modu, hizmet etkinleştirilmeden önce ayarlanmalıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.singleRequest kullanın.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamlarla ilgili en iyi uygulamalar: Tekli İstek Mimarisi'ni doğru şekilde kullanma
• SRA gruplandırmasını kontrol etme

İadeler
boolean	Tek istek modu etkinleştirildiyse true, hizmet etkinleştirildikten sonra yöntem çağrıldığı için tek istek modunu etkinleştirmek mümkün değilse false değerini döndürür.

---

enableVideoAds

enableVideoAds(): void

GPT'ye sayfada video reklamların bulunacağını bildirir. Bu, görüntülü ve video reklamlarda rakip hariç tutma kısıtlamalarını etkinleştirir. Video içeriği biliniyorsa görüntülü reklamlar için içerik hariç tutmayı kullanabilmek amacıyla PubAdsService.setVideoContent'i çağırın.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.videoAds'i kullanın.

---

get

get(key: string): string

Belirli bir anahtarla ilişkili AdSense özelliğinin değerini döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.getConfig kullanın.

Örnek

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

JavaScript (eski)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

var adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
var pageUrl =
  (adsenseConfig === null || adsenseConfig === void 0 ? void 0 : adsenseConfig.page_url) || null;
// Returns 'http://www.example.com'.

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Parametreler
key: string	Aranacak özelliğin adı.

İadeler
string	Özellik anahtarının mevcut değeri veya anahtar yoksa null.

---

getAttributeKeys

getAttributeKeys(): string[]

Bu hizmette ayarlanmış özellik anahtarlarını döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.getConfig kullanın.

Örnek

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

JavaScript (eski)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

var adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
var adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

İadeler
string[]	Bu hizmette ayarlanan özellik anahtarları dizisi. Sıralama tanımlanmamış.

---

getTargeting

getTargeting(key: string): string[]

Ayarlanmış belirli bir özel hizmet düzeyinde hedefleme parametresini döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.getConfig kullanın.

Örnek

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

JavaScript (eski)

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

var targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
var targeting =
  (targetingConfig === null || targetingConfig === void 0
    ? void 0
    : targetingConfig["interests"]) || [];
// Returns ['sports'].

var ageTargeting =
  (targetingConfig === null || targetingConfig === void 0 ? void 0 : targetingConfig["age"]) || [];
// Returns [] (empty array).

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

Parametreler
key: string	Aranacak hedefleme anahtarı.

İadeler
string[]	Bu anahtarla ilişkili değerler veya böyle bir anahtar yoksa boş bir dizi.

---

getTargetingKeys

getTargetingKeys(): string[]

Ayarlanmış tüm özel hizmet düzeyi hedefleme anahtarlarının listesini döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.getConfig kullanın.

Örnek

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

JavaScript (eski)

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

var targetingConfig = googletag.getConfig("targeting").targeting;
var keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

İadeler
string[]	Hedefleme anahtarları dizisi. Sıralama tanımlanmamış.

---

isInitialLoadDisabled

isInitialLoadDisabled(): boolean

Reklamlar için ilk isteklerin önceki bir PubAdsService.disableInitialLoad çağrısı tarafından başarıyla devre dışı bırakılıp bırakılmadığını döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.getConfig kullanın.

İadeler
boolean	PubAdsService.disableInitialLoad için önceki bir çağrı başarılı olduysa true, aksi takdirde false değerini döndürür.

---

refresh

refresh(slots?: Slot[], options?: {
  changeCorrelator: boolean;
}): void

Sayfadaki belirli veya tüm alanlar için yeni reklamlar getirir ve gösterir. Yalnızca eşzamansız oluşturma modunda çalışır.

Tüm tarayıcılarda düzgün çalışması için refresh çağrılmadan önce reklam alanının display çağrılması gerekir. display çağrısı atlanırsa yenileme beklenmedik şekilde davranabilir. İstenirse PubAdsService.disableInitialLoad yöntemi, display'nin reklam getirmesini durdurmak için kullanılabilir.

Bir alanı yenilemek, eski reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam yüklemeyi ve yenilemeyi kontrol etme
• Reklam alanlarını yenileme

Parametreler
Optional slots: Slot[]	Yenilenecek alanlar. Dizi isteğe bağlıdır; belirtilmezse tüm alanlar yenilenir.
Optional options: {   changeCorrelator: boolean; }	Bu yenileme çağrısıyla ilişkili yapılandırma seçenekleri. changeCorrelator Reklamları getirmek için yeni bir bağıntı oluşturulup oluşturulmayacağını belirtir. Reklam sunucularımız bu ilişkilendirici değerini kısa bir süre (şu anda 30 saniye ancak değişebilir) korur. Böylece, aynı ilişkilendiriciye sahip ve birbirine yakın zamanlarda alınan istekler tek bir sayfa görüntüleme olarak kabul edilir. Varsayılan olarak, her yenileme için yeni bir bağıntı oluşturulur. Not: Bu seçeneğin, GPT'nin şu anda sayfada bulunan reklamları otomatik olarak yansıtan ve sona erme süresi olmayan uzun süreli sayfa görüntülemesi üzerinde hiçbir etkisi yoktur.

---

registerRequestHook

registerRequestHook(hook: RequestHook, hookId: string): (() => void)

Experimental Sayfadaki her reklam isteğinden önce, global bir zaman aşımı süresi içinde diğer kayıtlı kancalarla paralel olarak yürütülecek bir kanca kaydeder.

Örnek

JavaScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

JavaScript (eski)

// Coming soon.

TypeScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

Parametreler
hook: RequestHook	İstenen alanların listesini içeren bir nesne alan ve tüm eşzamansız işlemler tamamlandığında çözümlenen bir söz döndüren işlev.
hookId: string	Daha iyi teşhis için kancayı etiketleyecek bir kimlik.

İadeler
(() => void)	Kancanın kaydını iptal eden bir işlev.

---

set

set(key: string, value: string): PubAdsService

Yayıncı Reklamları hizmeti kapsamındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.

Aynı anahtar için bu işlevin birden fazla kez çağrılması, o anahtar için daha önce ayarlanan değerleri geçersiz kılar. display veya refresh çağrılmadan önce tüm değerler ayarlanmalıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.adsenseAttributes kullanın.

Örnek

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

JavaScript (eski)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Parametreler
key: string	Özelliğin adı.
value: string	Özellik değeri.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): PubAdsService

Belirli etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.categoryExclusion kullanın.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

Parametreler
categoryExclusion: string	Eklenecek reklam kategorisi hariç tutma etiketi.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setCentering

setCentering(centerAds: boolean): void

Reklamların yatay olarak ortalanmasını etkinleştirir ve devre dışı bırakır. Ortalama varsayılan olarak devre dışıdır. Eski gpt_mobile.js'de ortalama varsayılan olarak etkindir.

Bu yöntem, display veya refresh çağrılmadan önce çağrılmalıdır. Bunun nedeni, yalnızca bu yöntem çağrıldıktan sonra istenen reklamların ortalanmasıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.centering kullanın.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Parametreler
centerAds: boolean	Reklamları ortalamak için true, sola hizalamak için false tuşlarına basın.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService

Sayfadaki tüm reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.

Bu API'yi kullanırken lütfen aşağıdakileri göz önünde bulundurun:

• Bu ayar yalnızca ilgili alanlar için yapılan sonraki reklam isteklerinde geçerli olur.
• Alan düzeyindeki ayar, belirtilmişse sayfa düzeyindeki ayarı her zaman geçersiz kılar.
• true olarak ayarlanırsa (alan düzeyinde veya sayfa düzeyinde) reklam, Google Ad Manager kullanıcı arayüzünde yapılan seçimden bağımsız olarak her zaman bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
• Ancak false olarak ayarlanırsa veya belirtilmeden bırakılırsa reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
• Bu API, iFrame'lerinden çıkmaya çalışan veya doğrudan bir yayıncı sayfasında oluşturulmalarına dayanan reklam öğelerinin davranışını etkileyebileceğinden dikkatli kullanılmalıdır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.safeFrame kullanın.

Örnek

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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 (eski)

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
forceSafeFrame: boolean	Sayfadaki tüm reklamların SafeFrame'lerde oluşturulmasını zorunlu kılmak için true ve önceki ayarı yanlış olarak değiştirmek için false. Daha önce belirtilmemişse bu ayarı false olarak belirlemek hiçbir şeyi değiştirmez.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setLocation

setLocation(address: string): PubAdsService

Satır öğelerini belirli konumlara coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini iletir.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.location kullanın.

Örnek

JavaScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

JavaScript (eski)

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

TypeScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

Parametreler
address: string	Serbest biçimli adres.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

Bir yapılandırma nesnesi kullanarak tüm gizlilik ayarlarının tek bir API'den yapılandırılmasına olanak tanır.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Gizlilik ayarlarını yapılandırma
• Sınırlı reklam gösterme

Parametreler
privacySettings: PrivacySettingsConfig	Gizlilik ayarları yapılandırmasını içeren nesne.

İadeler
PubAdsService	İşlevin çağrıldığı hizmet nesnesi.

---

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService

Yayıncı tarafından sağlanan kimliğin değerini ayarlar.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Yayıncı tarafından sağlanan tanımlayıcılar hakkında

Parametreler
ppid: string	Yayıncı tarafından sağlanan alfasayısal bir kimlik. 22 ila 150 karakter uzunluğunda olmalıdır.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService

SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı yoksayılır.

Bu sayfa düzeyindeki tercihler, belirtilmişse alan düzeyindeki tercihler tarafından geçersiz kılınır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.safeFrame kullanın.

Örnek

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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 (eski)

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
config: SafeFrameConfig	Yapılandırma nesnesi.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService

Belirli bir anahtar için tüm Yayıncı Reklamları hizmeti reklam alanlarına uygulanan özel hedefleme parametreleri ayarlar. Aynı anahtar için bu yöntemi birden fazla kez çağırmak eski değerlerin üzerine yazılmasına neden olur. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.targeting kullanın.

Örnek

JavaScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

JavaScript (eski)

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

TypeScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

Parametreler
key: string	Hedefleme parametresi anahtarı.
value: string | string[]	Hedefleme parametresi değeri veya değer dizisi.

İadeler
PubAdsService	Yöntemin çağrıldığı hizmet nesnesi.

---

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void

Hedefleme ve içerik hariç tutma amacıyla reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar. Bu yöntem çağrıldığında video reklamlar otomatik olarak etkinleştirilir. videoContentId ve videoCmsId için Google Ad Manager içerik besleme hizmetine sağlanan değerleri kullanın.

Desteği sonlandırıldı: Bunun yerine PageSettingsConfig.videoAds kullanın.

Aşağıdaki kaynakları da incelemenizi öneririz:

• VAST reklam etiketi URL parametreleri

Parametreler
videoContentId: string	Video içeriği kimliği.
videoCmsId: string	Video CMS kimliği.

---

updateCorrelator

updateCorrelator(): PubAdsService

Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntüleme başlatır. İlişkilendirici, bir sayfa görüntülemesinden gelen tüm reklam istekleri için aynıdır ve sayfa görüntülemeleri arasında benzersizdir. Yalnızca eşzamansız mod için geçerlidir.

Not: Bu, GPT'nin uzun süreli sayfa görüntülemesi üzerinde herhangi bir etkiye sahip değildir. Bu sayfa görüntüleme, sayfadaki reklamları otomatik olarak yansıtır ve geçerlilik bitiş süresi yoktur.

Örnek

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 (eski)

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

İadeler
PubAdsService	İşlevin çağrıldığı hizmet nesnesi.

---

googletag.RequestHook

PubAdsService.registerRequestHook aracılığıyla kaydedildiğinde her reklam isteğinden önce çağrılan geri çağırma işlevi.

---

googletag.ResponseInformation

Tek bir reklam yanıtını temsil eden nesne.

Özellikler
advertiserId	Reklamverenin kimliği.
campaignId	Kampanyanın kimliği.
creativeId	Reklam öğesinin kimliği.
creativeTemplateId	Reklamın şablon kimliği.
lineItemId	Satır öğesinin kimliği.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Slot.getResponseInformation

Özellikler

---

advertiserId

advertiserId: number

Reklamverenin kimliği.

---

campaignId

campaignId: number

Kampanyanın kimliği.

---

creativeId

creativeId: number

Reklam öğesinin kimliği.

---

creativeTemplateId

creativeTemplateId: number

Reklamın şablon kimliği.

---

lineItemId

lineItemId: number

Satır öğesinin kimliği.

---

googletag.RewardedPayload

Ödüllü reklam ile ilişkili ödülü temsil eden nesne

Özellikler
amount	Ödüle dahil edilen öğelerin sayısı.
type	Ödüle dahil edilen öğenin türü (örneğin, "para").

Aşağıdaki kaynakları da incelemenizi öneririz:

• Ödüllü reklam gösterme

Özellikler

---

amount

amount: number

Ödüle dahil edilen öğelerin sayısı.

---

type

type: string

Ödüle dahil edilen öğenin türü (ör. "para").

---

googletag.Service

Tüm hizmetler için ortak yöntemler içeren temel hizmet sınıfı.

Yöntemler
addEventListener	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder.
getSlots	Bu hizmetle ilişkili zaman aralıklarının listesini alın.
removeEventListener	Daha önce kaydedilmiş bir dinleyiciyi kaldırır.

Yöntemler

---

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service

Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder. Aşağıdaki etkinlikler desteklenir:

• events.GameManualInterstitialSlotClosedEvent
• events.GameManualInterstitialSlotReadyEvent
• events.ImpressionViewableEvent
• events.RewardedSlotClosedEvent
• events.RewardedSlotGrantedEvent
• events.RewardedSlotReadyEvent
• events.SlotOnloadEvent
• events.SlotRenderEndedEvent
• events.SlotRequestedEvent
• events.SlotResponseReceived
• events.SlotVisibilityChangedEvent

İşleyici çağrıldığında uygun etkinlik türünde bir nesne işleyiciye iletilir.

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

Parametreler
eventType: K	GPT tarafından oluşturulan etkinlik türünü temsil eden bir dize. Etkinlik türleri büyük/küçük harfe duyarlıdır.
listener: ((arg: EventTypeMap[K]) => void)	Tek bir etkinlik nesnesi bağımsız değişkeni alan işlev.

İadeler
Service	Yöntemin çağrıldığı hizmet nesnesi.

---

getSlots

getSlots(): Slot[]

Bu hizmetle ilişkili zaman aralıklarının listesini alın.

İadeler
Slot[]	Hizmete eklendikleri sırayla gösterilen alanlar.

---

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((event: EventTypeMap[K]) => void)): void

Daha önce kaydedilmiş bir dinleyiciyi kaldırır.

Örnek

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 (eski)

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();
});

Parametreler
eventType: K	GPT tarafından oluşturulan etkinlik türünü temsil eden bir dize. Etkinlik türleri büyük/küçük harfe duyarlıdır.
listener: ((event: EventTypeMap[K]) => void)	Tek bir etkinlik nesnesi bağımsız değişkeni alan işlev.

---

googletag.SizeMappingBuilder

Boyut eşleme spesifikasyonu nesneleri için oluşturucu. Bu oluşturucu, boyut özelliklerini kolayca oluşturmanıza yardımcı olmak için sağlanmıştır.

Yöntemler
addSize	Tek boyutlu bir diziden (görüntü alanını temsil eden) alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.
build	Bu oluşturucuya eklenen eşlemelerden bir boyut eşleme spesifikasyonu oluşturur.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam boyutları: Duyarlı reklamlar

Yöntemler

---

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder

Tek boyutlu bir diziden (görüntü alanını temsil eden) alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Parametreler
viewportSize: SingleSizeArray	Bu eşleme girişinin görüntü alanı boyutu.
slotSize: GeneralSize	Bu eşleme girişinin alan boyutları.

İadeler
SizeMappingBuilder	Bu oluşturucuya referans.

---

build

build(): SizeMappingArray

Bu oluşturucuya eklenen eşlemelerden bir boyut eşleme spesifikasyonu oluşturur.

Geçersiz eşlemeler sağlanmışsa bu yöntem null değerini döndürür. Aksi takdirde, Slot.defineSizeMapping'e iletilecek doğru biçimde bir spesifikasyon döndürür.

Not: Bu yöntem çağrıldıktan sonra oluşturucunun davranışı tanımlanmaz.

İadeler
SizeMappingArray	Bu oluşturucu tarafından oluşturulan sonuç. Geçersiz boyut eşlemeleri sağlandıysa boş olabilir.

---

googletag.Slot

Alan, sayfadaki tek bir reklam alanını temsil eden bir nesnedir.

Yöntemler
addService	Bu alana bir hizmet ekler.
clearCategoryExclusions	Kullanımdan kaldırıldı. Bu alan için tüm alan düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.
clearTargeting	Kullanımdan kaldırıldı. Bu alan için belirli veya tüm özel alan düzeyinde hedefleme parametrelerini temizler.
defineSizeMapping	Bu alan için minimum görüntü alanı boyutundan alan boyutuna kadar bir eşleme dizisi ayarlar.
get	Kullanımdan kaldırıldı. Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
getAdUnitPath	Ağ kodu ve reklam birimi yolu ile birlikte reklam biriminin tam yolunu döndürür.
getAttributeKeys	Kullanımdan kaldırıldı. Bu alanda ayarlanan özellik anahtarlarının listesini döndürür.
getCategoryExclusions	Kullanımdan kaldırıldı. Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.
getConfig	setConfig tarafından ayarlanan alan için genel yapılandırma seçeneklerinin dondurulmuş bir kopyasını alır.
getResponseInformation	Reklam yanıtı bilgilerini döndürür.
getSlotElementId	Alan tanımlanırken sağlanan div alanının kimliğini döndürür.
getTargeting	Kullanımdan kaldırıldı. Bu alanda ayarlanan belirli bir özel hedefleme parametresini döndürür.
getTargetingKeys	Kullanımdan kaldırıldı. Bu alanda ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür.
set	Kullanımdan kaldırıldı. Bu reklam alanındaki bir AdSense özelliği için değer ayarlar.
setCategoryExclusion	Kullanımdan kaldırıldı. Bu alanda alan düzeyinde bir reklam kategorisi hariç tutma etiketi ayarlar.
setClickUrl	Kullanımdan kaldırıldı. Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği tıklama URL'sini ayarlar.
setCollapseEmptyDiv	Kullanımdan kaldırıldı. Alanda reklam olmadığında div alanının gizlenip gizlenmeyeceğini ayarlar.
setConfig	Bu alan için genel yapılandırma seçeneklerini ayarlar.
setForceSafeFrame	Kullanımdan kaldırıldı. Bu alandaki reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
setSafeFrameConfig	Kullanımdan kaldırıldı. SafeFrame yapılandırması için alan düzeyinde tercihleri ayarlar.
setTargeting	Kullanımdan kaldırıldı. Bu alan için özel bir hedefleme parametresi ayarlar.
updateTargetingFromMap	Kullanımdan kaldırıldı. JSON nesnesindeki bir anahtar:değer eşlemesinden bu alan için özel hedefleme parametreleri ayarlar.

Yöntemler

---

addService

addService(service: Service): Slot

Bu alana bir hizmet ekler.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Google Yayıncı Etiketleri'ni kullanmaya başlama
• Test reklamı gösterme

Parametreler
service: Service	Eklenecek hizmet.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

Bu alan için tüm alan düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.categoryExclusion kullanın.

Örnek

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

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

JavaScript (eski)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

// 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")!
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

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

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

clearTargeting

clearTargeting(key?: string): Slot

Bu alan için belirli veya tüm özel alan düzeyinde hedefleme parametrelerini temizler.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.targeting kullanın.

Örnek

JavaScript

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

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

JavaScript (eski)

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

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

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

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

Parametreler
Optional key: string	Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmezse tüm hedefleme parametreleri temizlenir.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

Bu alan için minimum görüntü alanı boyutundan alan boyutuna bir eşleme dizisi ayarlar.

Örnek

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 (eski)

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!);

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam boyutları: Duyarlı reklamlar

Parametreler
sizeMapping: SizeMappingArray	Boyut eşlemeleri dizisi. Bunu oluşturmak için SizeMappingBuilder'ı kullanabilirsiniz. Her boyut eşleme, iki öğeden oluşan bir dizidir: SingleSizeArray ve GeneralSize.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

get

get(key: string): string

Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür. Bu alan tarafından devralınan hizmet düzeyindeki özellikleri görmek için PubAdsService.get yöntemini kullanın.

Desteği sonlandırıldı: Bunun yerine googletag.Slot.getConfig yöntemini kullanın.

Örnek

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

JavaScript (eski)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

var adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
var pageUrl =
  (adsenseConfig === null || adsenseConfig === void 0 ? void 0 : adsenseConfig.page_url) || null;
// Returns 'http://www.example.com'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Parametreler
key: string	Aranacak özelliğin adı.

İadeler
string	Özellik anahtarının mevcut değeri veya anahtar yoksa null.

---

getAdUnitPath

getAdUnitPath(): string

Ağ kodu ve reklam birimi yoluyla birlikte reklam biriminin tam yolunu döndürür.

Örnek

JavaScript

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

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

JavaScript (eski)

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

İadeler
string	Reklam birimi yolu.

---

getAttributeKeys

getAttributeKeys(): string[]

Bu alanda ayarlanan özellik anahtarlarının listesini döndürür. Bu alan tarafından devralınan hizmet düzeyindeki özelliklerin anahtarlarını görmek için PubAdsService.getAttributeKeys kullanın.

Desteği sonlandırıldı: Bunun yerine googletag.Slot.getConfig kullanın.

Örnek

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

JavaScript (eski)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

var adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
var adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

İadeler
string[]	Özellik anahtarları dizisi. Sıralama tanımlanmamış.

---

getCategoryExclusions

getCategoryExclusions(): string[]

Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.

Desteği sonlandırıldı: Bunun yerine googletag.Slot.getConfig kullanın.

Örnek

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

JavaScript (eski)

var _a;
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

var exclusions =
  ((_a = slot.getConfig("categoryExclusion")) === null || _a === void 0
    ? void 0
    : _a.categoryExclusion) || [];
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

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

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

İadeler
string[]	Bu alan için reklam kategorisi hariç tutma etiketleri veya hiçbiri ayarlanmamışsa boş bir dizi.

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>

setConfig tarafından ayarlanan alan için genel yapılandırma seçeneklerinin dondurulmuş bir kopyasını alır.

Tüm setConfig() özellikleri bu yöntem tarafından desteklenmez. Desteklenen özellikler şunlardır:

• adsenseAttributes
• categoryExclusion
• targeting

Örnek

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 (eski)

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"]);

Parametreler
keys: string | string[]	Alınacak yapılandırma seçeneklerinin anahtarları.

İadeler
Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>	Yuvayla ilgili yapılandırma seçeneklerinin dondurulmuş bir kopyası.

---

getResponseInformation

getResponseInformation(): ResponseInformation

Reklam yanıtı bilgilerini döndürür. Bu, alan için son reklam yanıtına dayanır. Bu işlev, alanda reklam yokken çağrılırsa null döndürülür.

İadeler
ResponseInformation	En son reklam yanıtı bilgileri veya alanda reklam yoksa null.

---

getSlotElementId

getSlotElementId(): string

Alan tanımlanırken sağlanan alan kimliğini div döndürür.

Örnek

JavaScript

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

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

JavaScript (eski)

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

İadeler
string	Alan div kimliği.

---

getTargeting

getTargeting(key: string): string[]

Bu alanda ayarlanan belirli bir özel hedefleme parametresini döndürür. Hizmet düzeyinde hedefleme parametreleri dahil edilmez.

Desteği sonlandırıldı: Bunun yerine googletag.Slot.getConfig kullanın.

Örnek

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

JavaScript (eski)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

var targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
var targeting =
  (targetingConfig === null || targetingConfig === void 0
    ? void 0
    : targetingConfig["allow_expandable"]) || [];
// Returns ['true'].

var ageTargeting =
  (targetingConfig === null || targetingConfig === void 0 ? void 0 : targetingConfig["age"]) || [];
// Returns [] (empty array).

TypeScript

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

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

Parametreler
key: string	Aranacak hedefleme anahtarı.

İadeler
string[]	Bu anahtarla ilişkili değerler veya böyle bir anahtar yoksa boş bir dizi.

---

getTargetingKeys

getTargetingKeys(): string[]

Bu alanda ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür. Hizmet düzeyinde hedefleme anahtarları dahil edilmez.

Desteği sonlandırıldı: Bunun yerine googletag.Slot.getConfig kullanın.

Örnek

JavaScript

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

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

JavaScript (eski)

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

var targetingConfig = slot.getConfig("targeting").targeting;
var keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

TypeScript

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

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

İadeler
string[]	Hedefleme anahtarları dizisi. Sıralama tanımlanmamış.

---

set

set(key: string, value: string): Slot

Bu reklam alanındaki bir AdSense özelliği için değer ayarlar. Bu işlem, bu anahtar için hizmet düzeyinde ayarlanan tüm değerleri geçersiz kılar.

Bu yöntemi aynı anahtar için birden fazla kez çağırmak, o anahtar için daha önce ayarlanan değerleri geçersiz kılar. display veya refresh çağrılmadan önce tüm değerler ayarlanmalıdır.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.adsenseAttributes kullanın.

Örnek

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

JavaScript (eski)

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Parametreler
key: string	Özelliğin adı.
value: string	Özellik değeri.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

Bu alanda alan düzeyinde bir reklam kategorisi hariç tutma etiketi ayarlar.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.categoryExclusion kullanın.

Örnek

JavaScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

JavaScript (eski)

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

Parametreler
categoryExclusion: string	Eklenecek reklam kategorisi hariç tutma etiketi.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setClickUrl

setClickUrl(value: string): Slot

Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği tıklama URL'sini ayarlar.

Tıklama URL'si değiştirilse bile Google Ad Manager sunucuları tıklamayı kaydetmeye devam eder. Yayınlanan reklam öğesiyle ilişkili tüm açılış sayfası URL'leri, sağlanan değere eklenir. Sonraki çağrılar değerin üzerine yazar. Bu yalnızca SRA olmayan istekler için çalışır.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.clickUrl kullanın.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Parametreler
value: string	Ayarlanacak tıklama URL'si.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot

Alanda reklam olmadığında div alanının gizlenip gizlenmeyeceğini ayarlar. Bu, hizmet düzeyindeki ayarları geçersiz kılar.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.collapseDiv kullanın.

Örnek

JavaScript

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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 (eski)

var slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

var slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Boş reklam alanlarını daraltma
• Düzen kaymasını en aza indirme

Parametreler
collapse: boolean	Reklam döndürülmezse alanın daraltılıp daraltılmayacağı.
Optional collapseBeforeAdFetch: boolean	Reklam getirilmeden önce bile alanın daraltılıp daraltılmayacağı. Daraltma true değilse yoksayılır.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): Slot

Bu alan için genel yapılandırma seçeneklerini ayarlar.

Parametreler
slotConfig: SlotSettingsConfig	Yapılandırma nesnesi.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

Bu alandaki reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.

Bu API'yi kullanırken lütfen aşağıdakileri göz önünde bulundurun:

• Bu ayar yalnızca ilgili alanlar için yapılan sonraki reklam isteklerinde geçerli olur.
• Alan düzeyindeki ayar, belirtilmişse sayfa düzeyindeki ayarı her zaman geçersiz kılar.
• true olarak ayarlanırsa (alan düzeyinde veya sayfa düzeyinde) reklam, Google Ad Manager kullanıcı arayüzünde yapılan seçimden bağımsız olarak her zaman bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
• Ancak false olarak ayarlanırsa veya belirtilmeden bırakılırsa reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
• Bu API, iFrame'lerinden çıkmaya çalışan veya doğrudan bir yayıncı sayfasında oluşturulmalarına dayanan reklam öğelerinin davranışını etkileyebileceğinden dikkatli kullanılmalıdır.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.safeFrame kullanın.

Örnek

JavaScript

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

JavaScript (eski)

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());

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
forceSafeFrame: boolean	Bu alandaki tüm reklamların SafeFrame'lerde oluşturulmasını zorunlu kılmak için true ve sayfa düzeyindeki bir ayarın (varsa) kapsamı dışında kalmayı seçmek için false. Sayfa düzeyinde belirtilmediğinde bu ayarı false olarak belirlemek hiçbir şeyi değiştirmez.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): Slot

SafeFrame yapılandırması için alan düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı yoksayılır.

Belirtilmesi halinde bu alan düzeyindeki tercihler, sayfa düzeyindeki tercihleri geçersiz kılar.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.safeFrame kullanın.

Örnek

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 (eski)

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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
config: SafeFrameConfig	Yapılandırma nesnesi.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

setTargeting

setTargeting(key: string, value: string | string[]): Slot

Bu alan için özel bir hedefleme parametresi ayarlar. Bu yöntemi aynı anahtar için birden çok kez çağırmak eski değerlerin üzerine yazılmasına neden olur. Burada ayarlanan değerler, hizmet düzeyinde ayarlanan hedefleme parametrelerinin üzerine yazılır. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.targeting kullanın.

Örnek

JavaScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

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

JavaScript (eski)

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

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

TypeScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

Parametreler
key: string	Hedefleme parametresi anahtarı.
value: string | string[]	Hedefleme parametresi değeri veya değer dizisi.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

updateTargetingFromMap

updateTargetingFromMap(map: {
  [adUnitPath: string]: string | string[];
}): Slot

JSON nesnesindeki bir anahtar:değer eşlemesinden bu alan için özel hedefleme parametreleri ayarlar. Bu, nesnenin tüm anahtar değerleri için Slot.setTargeting'i çağırmakla aynıdır. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Notlar:

• Üzerine yazma durumunda yalnızca son değer saklanır.
• Değer bir diziyse önceki değerler birleştirilmez, üzerine yazılır.
• Burada ayarlanan değerler, hizmet düzeyinde ayarlanan hedefleme parametrelerinin üzerine yazılır.

Desteği sonlandırıldı: Bunun yerine SlotSettingsConfig.targeting kullanın.

Örnek

JavaScript

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

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

JavaScript (eski)

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

Parametreler
map: {   [adUnitPath: string]: string | string[]; }	Hedefleme parametresi anahtar/değer eşlemesi.

İadeler
Slot	Yöntemin çağrıldığı alan nesnesi.

---

googletag.config

Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.

Arayüzler
AdExpansionConfig	Reklam genişletmeyi kontrol etme ayarları.
AdSenseAttributesConfig	AdSense reklamlarının davranışını kontrol etmeye yönelik ayarlar.
AutoRefreshConfig	Otomatik yenileme yapılandırma ayarları.
ContinueButtonConfig	Devam düğmesinin davranışını yapılandırma ayarları.
InterstitialConfig	Tek bir geçiş reklamı alanının davranışını tanımlayan nesne.
LazyLoadConfig	GPT'de geç yükleme kullanımını kontrol etme ayarları.
PageSettingsConfig	Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.
PrivacyTreatmentsConfig	Yayıncı gizlilik işlemlerini kontrol etme ayarları.
PublisherProvidedSignalsConfig	Yayıncı tarafından sağlanan sinyaller (PPS) yapılandırma nesnesi.
SafeFrameConfig	GPT'de SafeFrame'i kontrol etme ayarları.
SlotSettingsConfig	Alan düzeyindeki ayarlar için ana yapılandırma arayüzü.
TaxonomyData	Tek bir sınıflandırma değerlerini içeren nesne.
VideoAdsConfig	Video reklamlarla ilgili ayarları yapılandırma ayarları.

Tür Takma Adları
CollapseDivBehavior	Reklam alanlarının daraltma davranışını kontrol etmek için desteklenen değerler.
InterstitialTrigger	Desteklenen geçiş reklamı tetikleyicileri.
PrivacyTreatment	Desteklenen yayıncı gizlilik işlemleri.
Taxonomy	Yayıncı tarafından sağlanan sinyaller (PPS) için desteklenen sınıflandırmalar.

Tür Takma Adları

---

CollapseDivBehavior

CollapseDivBehavior: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"

Reklam alanlarının daraltma davranışını kontrol etmek için desteklenen değerler.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PageSettingsConfig.collapseDiv
• SlotSettingsConfig.collapseDiv

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar" | "inactivity" | "endOfArticle" | "continueReading" | "backward"

Desteklenen geçiş reklamı tetikleyicileri.

Not: 15 Haziran 2026'dan itibaren backward tetikleyicisi artık desteklenmeyecek ve etkinleştirilmesi herhangi bir etki yaratmayacak. Daha fazla bilgi için GPT sürüm notlarına bakın.

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Desteklenen yayıncı gizlilik işlemleri.

---

Sınıflandırma

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

Yayıncı tarafından sağlanan sinyaller (PPS) için desteklenen sınıflandırmalar.

Aşağıdaki kaynakları da incelemenizi öneririz:

• IAB Kitle Sınıflandırması 1.1
• IAB İçerik Sınıflandırması 2.2

---

googletag.config.AdExpansionConfig

Reklam genişletmeyi kontrol etme ayarları.

Özellikler
enabled?	Reklam genişletmenin etkin veya devre dışı olup olmadığı.

Örnek

JavaScript

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

JavaScript (eski)

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

Özellikler

---

Optional etkin

enabled?: boolean

Reklam genişletmenin etkin veya devre dışı olup olmadığı.

Bu değerin ayarlanması, Google Ad Manager'da yapılandırılan varsayılan ayarı geçersiz kılar.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Masaüstü ve tablette reklamları genişletme
• Mobil web'de reklamları genişletme (kısmi ekran)

---

googletag.config.AdSenseAttributesConfig

AdSense reklamlarının davranışını kontrol eden ayarlar.

Bu özellikler, sunucu tarafı ayarlarını istek bazında geçersiz kılmak için kullanılabilir.

Özellikler
adsense_ad_format?	AdSense reklam biçimi.
adsense_channel_ids?	AdSense kanal kimlikleri
adsense_test_mode?	Test modunun etkin olup olmadığı.
document_language?	Reklamların gösterildiği sayfanın dili.
page_url?	Reklamların gösterildiği sayfanın URL'si.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PageSettingsConfig.adsenseAttributes
• SlotSettingsConfig.adsenseAttributes

Özellikler

---

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 reklam biçimi.

---

Optional adsense_channel_ids

adsense_channel_ids?: string

AdSense kanal kimlikleri.

İzin verilen değerler, "+" ile ayrılmış kanal kimlikleridir.

Örnek: 271828183+314159265

Aşağıdaki kaynakları da incelemenizi öneririz:

• Özel kanallarla reklam birimi performansını izleme

---

Optional adsense_test_mode

adsense_test_mode?: "on"

Test modunun etkin olup olmadığı.

on olarak ayarlandığında reklamlar yalnızca test amaçlı olarak işaretlenir ve sayıma veya faturalandırmaya dahil edilmez. Bu ayar, test amaçlı olmayan üretim trafiği için ayarlanmamalıdır.

---

Optional document_language

document_language?: string

Reklamların gösterildiği sayfanın dili.

İzin verilen değerler, geçerli ISO 639-1 dil kodlarıdır.

Örnek: en

Aşağıdaki kaynakları da incelemenizi öneririz:

• ISO 639 dil kodlarının listesi

---

Optional page_url

page_url?: string

Reklamların gösterildiği sayfanın URL'si.

İzin verilen değerler geçerli URL'lerdir.

Örnek: http://www.example.com

---

googletag.config.AutoRefreshConfig

Otomatik yenileme yapılandırma ayarları.

Özellikler
backForwardCache?	Sayfa geri-ileri önbellekten geri yüklendiğinde GPT'nin etkin bir şekilde görüntülenen reklam alanını otomatik olarak yenileyip yenilemeyeceği.
heavyAds?	Chrome'un Ağır Reklam Müdahalesi, alanın reklam iframe'inde tetiklenirse GPT'nin bir reklam alanını otomatik olarak yenileyip yenilemeyeceği.

Özellikler

---

Optional backForwardCache

backForwardCache?: boolean

Sayfa geri-ileri önbellekten geri yüklendiğinde GPT'nin etkin olarak görüntülenen bir reklam alanını otomatik olarak yenileyip yenilemeyeceği. Varsayılan değer true'dir.

Örnek

JavaScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

JavaScript (eski)

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Geri-ileri önbellek

---

Optional heavyAds

heavyAds?: boolean

Chrome'un Ağır Reklam Müdahalesi, alanın reklam iframe'inde tetiklenirse GPT'nin bir reklam alanını otomatik olarak yenileyip yenilemeyeceği. Varsayılan değer true'dir.

Örnek

JavaScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

JavaScript (eski)

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Chrome'un yoğun reklam müdahalelerini anlama

---

googletag.config.ContinueButtonConfig

Devam düğmesinin davranışını yapılandırma ayarları.

Özellikler
backgroundColor?	Düğmenin arka plan rengi.
font?	Düğme metninin yazı tipi ailesi.
fontColor?	Düğmenin metin rengi.
freqCapIntervalMinutes?	Dakika cinsinden sıklık sınırı aralığı.
targetId?	Devam düğmesinin oluşturulacağı/tetikleneceği HTML öğesinin kimliği.

Aşağıdaki kaynakları da incelemenizi öneririz:

• SlotSettingsConfig.continueButton

Özellikler

---

Optional backgroundColor

backgroundColor?: string

Düğmenin arka plan rengi.

Örnek: 'blue', '#94B1FF'

---

Optional yazı tipi

font?: string

Düğme metninin yazı tipi ailesi.

Örnek: 'Arial'

---

Optional fontColor

fontColor?: string

Düğmenin metin rengi.

Örnek: 'white', '#B73B87'

---

Optional freqCapIntervalMinutes

freqCapIntervalMinutes?: number

Dakika cinsinden sıklık sınırı aralığı.

1'e eşit veya 1'den büyük bir tam sayı olmalıdır.

---

Optional targetId

targetId?: string

Devam düğmesinin oluşturulacağı/tetikleneceği HTML öğesinin kimliği.

---

googletag.config.InterstitialConfig

Tek bir geçiş reklamı alanının davranışını tanımlayan nesne.

Özellikler
requireStorageAccess?	Bu geçiş reklamını göstermek için yerel depolama alanı izninin gerekli olup olmadığı.
triggers?	Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.

Özellikler

---

Optional requireStorageAccess

requireStorageAccess?: boolean

Bu geçiş reklamını göstermek için yerel depolama alanı izninin gerekli olup olmadığı.

GPT, geçiş reklamları için sıklık sınırı uygulamak üzere yerel depolama alanını kullanır. Ancak yerel depolama alanı izni vermemiş kullanıcılara geçiş reklamları gösterilmeye devam eder. Bu özelliği true olarak ayarlamak, varsayılan davranışı devre dışı bırakır ve geçiş reklamlarının yalnızca yerel depolama izni vermiş kullanıcılara gösterilmesini sağlar.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Web geçiş reklamlarını trafiğe ekleme

---

Optional tetikleyici

triggers?: Partial<Record<InterstitialTrigger, boolean>>

Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.

Geçiş reklamı tetikleyicisinin değerini true olarak ayarlamak tetikleyiciyi etkinleştirir, false olarak ayarlamak ise devre dışı bırakır. Bu, Google Ad Manager'da yapılandırılan varsayılan değerleri geçersiz kılar.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Web geçiş reklamı gösterme

---

googletag.config.LazyLoadConfig

GPT'de geç yükleme kullanımını kontrol etme ayarları.

Özellikler
fetchMarginPercent?	Bir reklam isteğinde bulunmadan önce bir alanın mevcut görüntü alanından olması gereken minimum mesafe. Görüntü alanı boyutunun yüzdesi olarak ifade edilir.
mobileScaling?	Mobil cihazlardaki kenar boşluklarına uygulanan bir çarpan.
renderMarginPercent?	Bir reklamı oluşturmadan önce bir alanın mevcut görüntü alanından olması gereken minimum mesafe, görüntü alanı boyutunun yüzdesi olarak ifade edilir.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PageSettingsConfig.lazyLoad

Özellikler

---

Optional fetchMarginPercent

fetchMarginPercent?: number

Bir reklam isteğinde bulunmadan önce alanın mevcut görüntüleme alanından olması gereken minimum mesafe, görüntüleme alanı boyutunun yüzdesi olarak ifade edilir.

renderMarginPercent ile birlikte kullanılan bu ayar, bir reklamın önceden getirilmesine olanak tanır ancak diğer alt kaynakları oluşturmak ve indirmek için bekler. Bu nedenle, bu değer her zaman renderMarginPercent değerinden büyük veya ona eşit olmalıdır.

0 değeri "alan, görüntü alanına girdiğinde", 100 değeri "reklam 1 görüntü alanı uzakta olduğunda" anlamına gelir.

---

Optional mobileScaling

mobileScaling?: number

Mobil cihazlardaki kenar boşluklarına uygulanan bir çarpan. Bu çarpan hem fetchMarginPercent hem de renderMarginPercent'e uygulanır.

Bu, görüntü alanı boyutlarının ve kaydırma hızlarının farklı olabileceği mobil ve masaüstü cihazlarda farklı kenar boşluklarına olanak tanır. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir alanın getirme ve oluşturma işleminden önce görüntü alanından olabileceği minimum mesafeyi artırır.

---

Optional renderMarginPercent

renderMarginPercent?: number

Bir reklamı oluşturmadan önce alanın mevcut görüntüleme alanından olması gereken minimum uzaklık, görüntüleme alanı boyutunun yüzdesi olarak ifade edilir.

fetchMarginPercent ile birlikte kullanılan bu ayar, bir reklamın önceden getirilmesine olanak tanır ancak diğer alt kaynakları oluşturmak ve indirmek için bekler. Bu nedenle, bu değer her zaman fetchMarginPercent değerinden küçük veya bu değere eşit olmalıdır.

0 değeri "alan, görüntü alanına girdiğinde", 100 değeri "reklam 1 görüntü alanı uzakta olduğunda" anlamına gelir.

---

googletag.config.PageSettingsConfig

Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.

Tek bir API çağrısıyla birden fazla özelliğin ayarlanmasına olanak tanır.

Aşağıda listelenen tüm özellikler örnektir ve setConfig'i kullanan gerçek özellikleri yansıtmaz. Özellik grubu için aşağıdaki PageSettingsConfig türündeki alanlara bakın.

Örnekler:

• Yalnızca googletag.setConfig çağrısında belirtilen özellikler değiştirilir.

    // Configure feature alpha.
    googletag.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    googletag.setConfig({
       bravo: {...}
    });

• Belirli bir özelliğin tüm ayarları, her googletag.setConfig çağrısıyla güncellenir.

    // 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 değerini ileterek bir özelliğin tüm ayarlarını temizleyebilirsiniz.

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

Özellikler
adExpansion?	Reklam genişletmeyi kontrol etme ayarları.
adsenseAttributes?	AdSense özelliklerini yapılandırma ayarı.
adYield?	Kullanımdan kaldırıldı.
autoRefresh?	Otomatik reklam yenileme davranışını yapılandırma ayarı.
categoryExclusion?	Reklam kategorisi hariç tutmalarını yapılandırma ayarı.
centering?	Reklamların yatay olarak ortalanmasını kontrol etme ayarı.
collapseDiv?	Reklam alanlarının daraltma davranışını kontrol etme ayarı.
disableInitialLoad?	Reklamların ne zaman isteneceğini kontrol etme ayarı.
lazyLoad?	GPT'de geç yükleme kullanımını kontrol etme ayarları.
location?	Satır öğelerini coğrafi konumlara göre coğrafi hedefleme ayarı.
pps?	Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etme ayarları.
privacyTreatments?	Yayıncı gizlilik işlemlerini kontrol etme ayarları.
requestHookTimeoutMs?	GPT'nin bir reklam isteğiyle devam etmeden önce tüm kayıtlı istek kancalarının tamamlanmasını bekleyeceği maksimum süreyi kontrol etme ayarı.
safeFrame?	GPT'de SafeFrame kullanımını kontrol etme ayarları.
singleRequest?	Tekli İstek Mimarisi'ni (SRA) etkinleştirme veya devre dışı bırakma ayarı.
targeting?	Anahtar/değer çifti hedeflemeyi kontrol etme ayarı.
threadYield?	GPT'nin reklam öğelerini isterken ve oluştururken JS iş parçacığını verip vermeyeceğini kontrol eden ayar.
videoAds?	Video reklamları kontrol etme ayarları.

Özellikler

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Reklam genişletmeyi kontrol etme ayarları.

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

AdSense özelliklerini yapılandırma ayarı.

Bu ayar aracılığıyla yapılandırılan AdSense özellikleri, sayfadaki tüm reklam alanlarına uygulanır. Bu ayar, birden fazla özellik değeri tanımlamak veya mevcut değerlerin üzerine yazmak için birden çok kez çağrılabilir.

AdSense özellik değişiklikleri yalnızca bu yöntem çağrıldıktan sonra yapılan reklam istekleri için geçerli olur. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh çağrılarından önce çağrılması önerilir.

Örnek

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 (eski)

// 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"

Desteği sonlandırıldı: Bunun yerine threadYield kullanın. Bu özellik yakın gelecekte kaldırılacaktır.

---

Optional autoRefresh

autoRefresh?: AutoRefreshConfig

Otomatik reklam yenileme davranışını yapılandırma ayarı.

Örnek

JavaScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

JavaScript (eski)

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

Reklam kategorisi hariç tutmalarını yapılandırma ayarı.

Örnek

JavaScript

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

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

JavaScript (eski)

// 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

---

Optional centering

centering?: boolean

Reklamların yatay olarak ortalanmasını kontrol etme ayarı. Ortalama varsayılan olarak devre dışıdır.

Yatay ortalama değişiklikleri yalnızca bu yöntem çağrıldıktan sonra istenen reklam istekleri için geçerli olur. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh çağrılarından önce çağrılması önerilir.

Örnek

JavaScript

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

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

JavaScript (eski)

// 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?: CollapseDivBehavior

Reklam alanlarının daraltma davranışını kontrol etme ayarı.

Daraltılmış bir reklam alanı, sayfada yer kaplamaz.

Desteklenen değerler:

• null (varsayılan): Alan daraltılmaz.
• DISABLED: Reklam döndürülse de döndürülmese de alan daraltılmaz.
• BEFORE_FETCH: Alan daraltılmış olarak başlar ve bir reklam döndürüldüğünde genişler.
• ON_NO_FILL: Alan genişletilmiş olarak başlar ve reklam döndürülmezse daraltılır.

Örnek

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 (eski)

// 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Boş reklam alanlarını daraltma
• Düzen kaymasını en aza indirme

---

Optional disableInitialLoad

disableInitialLoad?: boolean

Reklamların ne zaman isteneceğini kontrol eden ayar.

Varsayılan olarak googletag.display yöntemi hem reklam alanlarını kaydeder hem de bunlar için reklam ister. Ancak reklam içeriğinin ne zaman yükleneceğini daha hassas bir şekilde kontrol etmek için bu işlemleri ayırmanın tercih edilebileceği durumlar vardır.

Bu ayar etkinleştirildiğinde, display() yöntemi çağrıldığında kayıtlı alanlar için reklam istenmez. Bunun yerine, reklam isteği başlatmak için PubAdsService.refresh yöntemine ayrı bir çağrı yapılmalıdır.

Bu yöntem, googletag.enableServices çağrılmadan önce çağrılmalıdır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam yüklemeyi ve yenilemeyi kontrol etme
• SRA gruplandırmasını kontrol etme

---

Optional lazyLoad

lazyLoad?: LazyLoadConfig

GPT'de geç yükleme kullanımını kontrol etme ayarları.

Geç yükleme, reklamların istenmesini ve oluşturulmasını kullanıcının görüntü alanına yaklaşana kadar geciktiren bir tekniktir. Daha ayrıntılı bir örnek için Geç yükleme örneğine bakın.

Not: singleRequest etkinleştirilirse yavaş getirme yalnızca tüm alanlar getirme kenar boşluğunun dışındayken çalışır.

setConfig() çağrılırken belirtilmeyen tüm geç yükleme ayarları, Google tarafından belirlenen varsayılan bir değeri kullanır. Bu varsayılanlar zaman içinde ayarlanabilir. Belirli bir ayarı devre dışı bırakmak için değeri null olarak ayarlayın.

Örnek

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 (eski)

// 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamlarla ilgili en iyi uygulamalar: "Önemli" reklam alanlarına öncelik verme
• Geç yükleme

---

Optional konum

location?: string

Satır öğelerini coğrafi konumlara göre coğrafi hedefleme ayarı.

Örnek

JavaScript

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

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

JavaScript (eski)

// 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Yayın için coğrafi konumları hedefleme

---

Optional pps

pps?: PublisherProvidedSignalsConfig

Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etme ayarları.

---

Optional privacyTreatments

privacyTreatments?: PrivacyTreatmentsConfig

Yayıncı gizlilik işlemlerini kontrol etme ayarları.

---

Optional Experimental requestHookTimeoutMs

requestHookTimeoutMs?: number | "auto"

GPT'nin bir reklam isteğiyle devam etmeden önce tüm kayıtlı istek kancalarının tamamlanmasını bekleyeceği maksimum süreyi kontrol etme ayarı.

Kayıtlı tüm istek kancaları paralel olarak yürütülür. Bu zaman aşımı, bu paralel yürütmelerin tamamlanmasını beklerken reklam isteği sürecinin ne kadar süre duraklatılacağına dair üst sınırı tanımlar.

Desteklenen değerler:

• Milisaniye cinsinden pozitif sayı: Özelleştirilmiş bekleme süresi.
• 'auto': GPT, Google tarafından optimize edilmiş bir zaman aşımı kullanır.
• null: Zaman aşımlarını devre dışı bırakır (GPT, kancaların tamamlanmasını süresiz olarak bekler).

Örnek

JavaScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

JavaScript (eski)

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

TypeScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

---

Optional safeFrame

safeFrame?: SafeFrameConfig

GPT'de SafeFrame kullanımını kontrol etme ayarları.

Bu ayar aracılığıyla yapılandırılan değerler, sayfadaki tüm reklam alanlarına uygulanır. Ayrı reklam alanları, SlotSettingsConfig.safeFrame aracılığıyla bu değerleri geçersiz kılabilir.

Örnek

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 (eski)

// 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

Tekli İstek Mimarisi'ni (SRA) etkinleştirmek veya devre dışı bırakmak için kullanılan ayar.

SRA etkinleştirildiğinde, googletag.display veya PubAdsService.refresh çağrısından önce tanımlanan tüm reklam alanları tek bir reklam isteğinde toplanır. Bu, performans avantajları sağlar ancak birlikte gösterimlerin ve rakip hariç tutmaların dikkate alınmasını sağlamak için de gereklidir.

SRA devre dışı bırakıldığında her reklam alanı ayrı ayrı istenir. Bu, GPT'nin varsayılan davranışıdır.

Bu yöntem, googletag.enableServices çağrılmadan önce çağrılmalıdır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Birlikte gösterimler hakkında
• Reklamlarla ilgili en iyi uygulamalar: Tekli İstek Mimarisi'ni doğru şekilde kullanma
• SRA gruplandırmasını kontrol etme

---

Optional hedefleme

targeting?: Record<string, string | string[]>

Anahtar/değer hedeflemeyi kontrol etme ayarı.

Bu ayar aracılığıyla yapılandırılan hedefleme, sayfadaki tüm reklam alanlarına uygulanır. Bu ayar, birden fazla hedefleme anahtar/değer çifti tanımlamak veya mevcut değerlerin üzerine yazmak için birden çok kez çağrılabilir. Hedefleme anahtarları, Google Ad Manager hesabınızda tanımlanır.

Örnek

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 (eski)

// 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 } });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

---

Optional threadYield

threadYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

GPT'nin reklam öğelerini isterken ve oluştururken JS iş parçacığını verip vermeyeceğini kontrol eden ayar.

GPT, yalnızca Scheduler.postTask veya Scheduler.yield API'yi destekleyen tarayıcılar için verilir.

Desteklenen değerler:

• null (varsayılan): GPT, görüntü alanının dışındaki alanlar için JS iş parçacığını verir.
• ENABLED_ALL_SLOTS: GPT, alanın görüntü alanında olup olmadığına bakılmaksızın tüm alanlar için JS iş parçacığını verir.
• DISABLED: GPT, JS iş parçacığını oluşturmaz.

Örnek

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 (eski)

// 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Scheduler

---

Optional videoAds

videoAds?: VideoAdsConfig

Video reklamları kontrol etme ayarları

Örnek

JavaScript

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

JavaScript (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Video içeriği besleme

---

googletag.config.PrivacyTreatmentsConfig

Yayıncı gizlilik işlemlerini kontrol etme ayarları.

Özellikler
treatments	Etkinleştirilecek yayıncı gizlilik işlemleri dizisi.

Özellikler

---

tedaviler

treatments: "disablePersonalization"[]

Etkinleştirilecek yayıncı gizlilik değerlendirmeleri dizisi.

Örnek

JavaScript

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

JavaScript (eski)

// 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

Yayıncı tarafından sağlanan sinyaller (PPS) yapılandırma nesnesi.

Özellikler
taxonomies	Sınıflandırma eşlemelerini içeren bir nesne veya yapılandırmayı temizlemek için null.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Yayıncı tarafından sağlanan sinyaller hakkında (Beta)
• IAB Kitle Sınıflandırması 1.1
• IAB İçerik Sınıflandırması 2.2

Özellikler

---

taxonomies

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Sınıflandırma eşlemelerini içeren bir nesne veya yapılandırmayı temizlemek için null.

---

googletag.config.SafeFrameConfig

GPT'de SafeFrame'i kontrol etme ayarları.

Özellikler
allowOverlayExpansion?	SafeFrame'in, reklam içeriğinin sayfa içeriğini kaplayarak genişlemesine izin verip vermeyeceği.
allowPushExpansion?	SafeFrame'in, sayfa içeriğini iterek reklam içeriğinin genişlemesine izin verip vermeyeceği.
forceSafeFrame?	Reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağı.
sandbox?	SafeFrame'in, kullanıcı etkileşimi olmadan üst düzey gezinmeyi önlemek için HTML5 korumalı alan özelliğini kullanıp kullanmayacağı.
useUniqueDomain?	Kullanımdan kaldırıldı. SafeFrame'in rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PageSettingsConfig.safeFrame
• SlotSettingsConfig.safeFrame

Özellikler

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

SafeFrame'in, reklam içeriğinin sayfa içeriğini kaplayarak genişlemesine izin verip vermeyeceği.

---

Optional allowPushExpansion

allowPushExpansion?: boolean

SafeFrame'in, sayfa içeriğini iterek reklam içeriğinin genişlemesine izin verip vermeyeceği.

---

Optional forceSafeFrame

forceSafeFrame?: boolean

Reklamların bir SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağı.

---

Optional korumalı alan

sandbox?: boolean

SafeFrame'in, kullanıcı etkileşimi olmadan üst düzey gezinmeyi önlemek için HTML5 korumalı alan özelliğini kullanıp kullanmayacağı. Geçerli tek değer true (false olarak zorlanamaz). Korumalı alan özelliğinin eklentileri (ör. Flash) devre dışı bıraktığını unutmayın.

---

Optional useUniqueDomain

useUniqueDomain?: boolean

SafeFrame'in rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı. null değerini ileterek depolanan değeri temizleyin.

Not: Bu özellik varsayılan olarak etkindir.

Desteği sonlandırıldı: Bu özellik artık devre dışı bırakılamaz. useUniqueDomain ayarının herhangi bir etkisi yoktur.

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

---

googletag.config.SlotSettingsConfig

Alan düzeyindeki ayarlar için ana yapılandırma arayüzü.

Tek bir alan için tek bir API çağrısıyla birden fazla özelliğin ayarlanmasına olanak tanır.

Aşağıda listelenen tüm özellikler örnektir ve setConfig'i kullanan gerçek özellikleri yansıtmaz. Özellik grubu için aşağıdaki SlotSettingsConfig türündeki alanlara bakın.

Örnekler:

• Yalnızca Slot.setConfig çağrısında belirtilen özellikler değiştirilir.

    const slot = googletag.defineSlot("/1234567/example", [160, 600]);
  
    // Configure feature alpha.
    slot.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    slot.setConfig({
       bravo: {...}
    });

• Belirli bir özelliğin tüm ayarları, Slot.setConfig için yapılan her çağrıyla güncellenir.

    // 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 değerini ileterek bir özelliğin tüm ayarlarını temizleyebilirsiniz.

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

Özellikler
adExpansion?	Reklam genişletmeyi yapılandırma ayarları.
adsenseAttributes?	AdSense özelliklerini yapılandırma ayarı.
categoryExclusion?	Reklam kategorisi hariç tutmalarını yapılandırma ayarı.
clickUrl?	Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği URL'yi yapılandırma ayarı.
collapseDiv?	Reklam alanının daraltma davranışını yapılandırma ayarı.
continueButton?	İçerik ara reklamları için devam düğmesinin davranışını yapılandırma ayarları.
interstitial?	Geçiş reklamı alanı davranışını yapılandıran ayarlar.
safeFrame?	GPT'de SafeFrame kullanımını yapılandırma ayarları.
targeting?	Anahtar/değer hedeflemeyi yapılandırma ayarı.

Özellikler

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Reklam genişletmeyi yapılandırma ayarları.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam genişletme

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

AdSense özelliklerini yapılandırma ayarı.

Bu ayar aracılığıyla yapılandırılan AdSense özellikleri yalnızca reklam alanına uygulanır. Bu ayar, birden fazla özellik değeri tanımlamak veya mevcut değerlerin üzerine yazmak için birden çok kez çağrılabilir.

AdSense özellik değişiklikleri yalnızca bu yöntem çağrıldıktan sonra yapılan reklam istekleri için geçerli olur. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh çağrılarından önce çağrılması önerilir.

Örnek

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 (eski)

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[]

Reklam kategorisi hariç tutmalarını yapılandırma ayarı.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

---

Optional clickUrl

clickUrl?: string

Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği URL'yi yapılandırma ayarı.

Tıklama URL'si değiştirilse bile Google Ad Manager sunucuları tıklamayı kaydetmeye devam eder. Yayınlanan reklam öğesiyle ilişkili tüm açılış sayfası URL'leri, sağlanan değere eklenir. Bu değerin birden fazla kez ayarlanması, önceden yapılandırılmış değerlerin üzerine yazılmasına neden olur. null değerinin iletilmesi, değeri temizler.

Not: Bu ayar yalnızca SRA olmayan istekler için geçerlidir.

Örnek

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 (eski)

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?: CollapseDivBehavior

Reklam alanının daraltma davranışını yapılandırma ayarı.

Daraltılmış bir reklam alanı sayfada yer kaplamaz.

Desteklenen değerler:

• null (varsayılan): Alan daraltılmaz.
• DISABLED: Reklam döndürülse de döndürülmese de alan daraltılmaz.
• BEFORE_FETCH: Alan daraltılmış olarak başlar ve bir reklam döndürüldüğünde genişler.
• ON_NO_FILL: Alan genişletilmiş olarak başlar ve reklam döndürülmezse daraltılır.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Boş reklam alanlarını daraltma
• Düzen kaymasını en aza indirme

---

Optional continueButton

continueButton?: ContinueButtonConfig

İçerik ara reklamları için devam düğmesinin davranışını yapılandırma ayarları.

Bu ayarlar, içerik ara reklamı biçimleriyle ilişkili çıkış ve okumaya devam etme etkileşimlerinin görünümünü ve davranışını özelleştirmeye olanak tanır.

setConfig() çağrılırken belirtilmeyen tüm devam düğmesi ayarları, Google tarafından belirlenen varsayılan değeri kullanır.

Tüm devam düğmesi ayarlarını devre dışı bırakmak veya temizlemek için null değerini iletin.

Örnek

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

JavaScript (eski)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

---

Optional geçiş reklamı

interstitial?: InterstitialConfig

Geçiş reklamı alanı davranışını yapılandıran ayarlar.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Web geçiş reklamlarını trafiğe ekleme

---

Optional safeFrame

safeFrame?: SafeFrameConfig

GPT'de SafeFrame kullanımını yapılandırma ayarları.

Bu ayar aracılığıyla yapılandırılan değerler yalnızca reklam alanına uygulanır ve PageSettingsConfig.safeFrame aracılığıyla ayarlanan değerleri geçersiz kılar.

Örnek

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 (eski)

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 hedefleme

targeting?: Record<string, string | string[]>

Anahtar/değer çifti hedeflemesini yapılandırma ayarı.

Bu ayar aracılığıyla yapılandırılan hedefleme yalnızca reklam alanına uygulanır. Bu ayar, birden fazla hedefleme anahtar/değer çifti tanımlamak veya mevcut değerlerin üzerine yazmak için birden çok kez çağrılabilir. Hedefleme anahtarları, Google Ad Manager hesabınızda tanımlanır.

Örnek

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 (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

---

googletag.config.TaxonomyData

Tek bir sınıflandırma değerlerini içeren nesne.

Özellikler
values	Sınıflandırma değerlerinin listesi.

Özellikler

---

values

values: readonly string[]

Sınıflandırma değerlerinin listesi.

---

googletag.config.VideoAdsConfig

Video reklamlarla ilgili ayarları yapılandırma ayarları.

Özellikler
enableVideoAds	Sayfada video reklamların olup olmayacağı.
videoCmsId?	Video içeriği kaynağı kimliği.
videoContentId?	Video içeriği kimliği.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PageSettingsConfig.videoAds

Özellikler

---

enableVideoAds

enableVideoAds: boolean

Sayfada video reklamların bulunup bulunmayacağı.

true olarak ayarlandığında görüntülü ve video reklamlarda içerik hariç tutma kısıtlamalarını etkinleştirir.

Video içeriği biliniyorsa görüntülü reklamlar için içerik hariç tutmayı kullanmak üzere videoContentId ve videoCmsId değerlerini Google Ad Manager içerik besleme hizmetine sağlanan değerlere ayarlayın.

---

Optional videoCmsId

videoCmsId?: string

Video içerik kaynağı kimliği.

Bu, videoContentId tarafından belirtilen video içeriğinin kaynağını tanımlamak için Google Ad Manager içerik besleme hizmeti tarafından atanan benzersiz bir değerdir.

Aşağıdaki kaynakları da incelemenizi öneririz:

• cmsid (İçerik Kaynağı Kimliği)

---

Optional videoContentId

videoContentId?: string

Video Content ID.

Bu, videoCmsId tarafından belirtilen içerik kaynağından belirli bir videoyu tanımlayan benzersiz bir değerdir. Bu değer, video içeriğinizi barındıran İYS tarafından atanır.

Aşağıdaki kaynakları da incelemenizi öneririz:

• vid (Video kimliği)

---

googletag.enums

Bu, GPT'nin enum türleri için kullandığı ad alanıdır.

Numaralandırmalar
OutOfPageFormat	GPT tarafından desteklenen sayfa dışı biçimler.
TagForAgeTreatment	GPT tarafından desteklenen yaş değerlendirmesi ayarları.
TrafficSource	GPT tarafından desteklenen trafik kaynakları.

Numaralandırmalar

---

OutOfPageFormat

OutOfPageFormat

GPT tarafından desteklenen sayfa dışı biçimler.

Aşağıdaki kaynakları da incelemenizi öneririz:

• defineOutOfPageSlot

Numaralandırma Üyeleri
AD_INTENTS	Amaca dayalı reklam biçimi.
BOTTOM_ANCHOR	Alan, görüntü alanının alt kısmına sabitlenir.
GAME_MANUAL_INTERSTITIAL	Oyun manuel geçiş reklamı biçimi. Not: Oyun manuel geçiş reklamı, sınırlı erişim sunulan bir biçimdir.
INTERSTITIAL	Web geçiş reklamı biçimi.
LEFT_SIDE_RAIL	Sol yan reklam sütunu biçimi.
REWARDED	Ödüllü reklam biçimi.
RIGHT_SIDE_RAIL	Sağ yan reklam sütunu biçimi.
TOP_ANCHOR	Alan, görüntü alanının üst kısmına sabitlenir.

---

TagForAgeTreatment

TagForAgeTreatment

GPT tarafından desteklenen yaş değerlendirmesi ayarları.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PrivacySettingsConfig.tagForAgeTreatment

Numaralandırma Üyeleri
CHILD	Reklam isteklerinin, ÇOCUK yaştakilere yönelik olarak değerlendirilmesi gerektiğini belirtir.
TEEN	Reklam isteklerinin GENÇ yaştakilere yönelik olarak değerlendirilmesi gerektiğini belirtir.
UNSPECIFIED	Varsayılan değer. Reklam isteği için belirli bir yaş kısıtlamalı değerlendirme sinyalinin geçerli olmadığını gösterir.

---

TrafficSource

TrafficSource

GPT tarafından desteklenen trafik kaynakları.

Aşağıdaki kaynakları da incelemenizi öneririz:

• PrivacySettingsConfig.trafficSource

Numaralandırma Üyeleri
ORGANIC	Doğrudan URL girişi, site arama veya uygulama indirme
PURCHASED	Sahip olunanlar dışındaki mülklerden yönlendirilen trafik (edinilen veya başka şekilde teşvik edilen etkinlikler).

---

googletag.events

Bu, GPT'nin etkinlikler için kullandığı ad alanıdır. Kodunuz, Service.addEventListener kullanarak bu etkinliklere yanıt verebilir.

Arayüzler
Event	Tüm GPT etkinlikleri için temel arayüz.
EventTypeMap	Bu, Service.addEventListener ve Service.removeEventListener için bir etkinlik adını ilgili etkinlik nesnesi türüyle eşleyen bir sözde türdür.
GameManualInterstitialSlotClosedEvent	Bu etkinlik, oyun manuel geçiş reklamı alanı kullanıcı tarafından kapatıldığında tetiklenir.
GameManualInterstitialSlotReadyEvent	Bu etkinlik, bir oyun manuel geçiş reklamı alanı kullanıcıya gösterilmeye hazır olduğunda tetiklenir.
ImpressionViewableEvent	Bu etkinlik, Aktif Görüntüleme ölçütlerine göre bir gösterim görüntülenebilir hale geldiğinde tetiklenir.
RewardedSlotClosedEvent	Bu etkinlik, ödüllü reklam alanı kullanıcı tarafından kapatıldığında tetiklenir.
RewardedSlotGrantedEvent	Bu etkinlik, ödüllü reklam görüntüleme karşılığında ödül verildiğinde tetiklenir.
RewardedSlotReadyEvent	Bu etkinlik, ödüllü reklam gösterilmeye hazır olduğunda tetiklenir.
RewardedSlotVideoCompletedEvent	Bu etkinlik, ödüllü video reklamın oynatılması tamamlandığında tetiklenir.
SlotOnloadEvent	Bu etkinlik, reklam öğesinin iFrame'i yükleme etkinliğini tetiklediğinde tetiklenir.
SlotRenderEndedEvent	Bu etkinlik, reklam öğesi kodu bir alana yerleştirildiğinde tetiklenir.
SlotRequestedEvent	Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.
SlotResponseReceived	Bu etkinlik, belirli bir alan için reklam yanıtı alındığında tetiklenir.
SlotVisibilityChangedEvent	Bu etkinlik, bir reklam alanının ekrandaki yüzdesi her değiştiğinde tetiklenir.

---

googletag.events.Event

Tüm GPT etkinlikleri için temel arayüz. Aşağıdaki tüm GPT etkinliklerinde şu alanlar bulunur.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı.
slot	Etkinliği tetikleyen alan.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

Özellikler

---

serviceName

serviceName: string

Etkinliği tetikleyen hizmetin adı.

---

slot

slot: Slot

Etkinliği tetikleyen alan.

---

googletag.events.EventTypeMap

Bu, Service.addEventListener ve Service.removeEventListener için bir etkinlik adını ilgili etkinlik nesnesi türüyle eşleyen bir sözde türdür. Yalnızca referans ve tür güvenliği amacıyla belgelenmiştir.

Özellikler
gameManualInterstitialSlotClosed	events.GameManualInterstitialSlotClosedEvent için takma ad.
gameManualInterstitialSlotReady	events.GameManualInterstitialSlotReadyEvent için takma ad.
impressionViewable	events.ImpressionViewableEvent için takma ad.
rewardedSlotClosed	events.RewardedSlotClosedEvent için takma ad.
rewardedSlotGranted	events.RewardedSlotGrantedEvent için takma ad.
rewardedSlotReady	events.RewardedSlotReadyEvent için takma ad.
rewardedSlotVideoCompleted	events.RewardedSlotVideoCompletedEvent için takma ad.
slotOnload	events.SlotOnloadEvent için takma ad.
slotRenderEnded	events.SlotRenderEndedEvent için takma ad.
slotRequested	events.SlotRequestedEvent için takma ad.
slotResponseReceived	events.SlotResponseReceived için takma ad.
slotVisibilityChanged	events.SlotVisibilityChangedEvent için takma ad.

Özellikler

---

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent

events.GameManualInterstitialSlotClosedEvent için takma ad.

---

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent

events.GameManualInterstitialSlotReadyEvent için takma ad.

---

impressionViewable

impressionViewable: ImpressionViewableEvent

events.ImpressionViewableEvent için takma ad.

---

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent

events.RewardedSlotClosedEvent için takma ad.

---

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent

events.RewardedSlotGrantedEvent için takma ad.

---

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent

events.RewardedSlotReadyEvent için takma ad.

---

rewardedSlotVideoCompleted

rewardedSlotVideoCompleted: RewardedSlotVideoCompletedEvent

events.RewardedSlotVideoCompletedEvent için takma ad.

---

slotOnload

slotOnload: SlotOnloadEvent

events.SlotOnloadEvent için takma ad.

---

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent

events.SlotRenderEndedEvent için takma ad.

---

slotRequested

slotRequested: SlotRequestedEvent

events.SlotRequestedEvent için takma ad.

---

slotResponseReceived

slotResponseReceived: SlotResponseReceived

events.SlotResponseReceived için takma ad.

---

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent

events.SlotVisibilityChangedEvent için takma ad.

---

googletag.events.GameManualInterstitialSlotClosedEvent

Event uzatır

Bu etkinlik, bir oyun manuel geçiş reklamı alanı kullanıcı tarafından kapatıldığında tetiklenir.

Not: Oyun manuel geçiş reklamı, sınırlı erişim sunulan bir biçimdir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Oyun manuel geçiş reklamı görüntüleme

---

googletag.events.GameManualInterstitialSlotReadyEvent

Event uzatır

Bu etkinlik, oyun manuel geçiş reklamı alanı kullanıcıya gösterilmeye hazır olduğunda tetiklenir.

Not: Oyun manuel geçiş reklamı, sınırlı erişim sunulan bir biçimdir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Yöntemler
makeGameManualInterstitialVisible	Oyun manuel geçiş reklamını kullanıcıya gösterir.

Örnek

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 (eski)

// 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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Oyun manuel geçiş reklamı görüntüleme

Yöntemler

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): boolean

Oyun manuel geçiş reklamını kullanıcıya gösterir. Reklamın başarıyla gösterilip gösterilmediğini döndürür.

İadeler
boolean

---

googletag.events.ImpressionViewableEvent

Event uzatır

Bu etkinlik, Aktif Görüntüleme ölçütlerine göre bir gösterim görüntülenebilir hale geldiğinde tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

---

googletag.events.RewardedSlotClosedEvent

Event uzatır

Bu etkinlik, ödüllü reklam alanı kullanıcı tarafından kapatıldığında tetiklenir. Ödül verilmeden önce veya sonra tetiklenebilir. Ödül verilip verilmediğini belirlemek için events.RewardedSlotGrantedEvent'i kullanın.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

---

googletag.events.RewardedSlotGrantedEvent

Event uzatır

Bu etkinlik, ödüllü reklam görüntüleme karşılığında ödül verildiğinde tetiklenir. Ödül verme ölçütleri karşılanmadan önce reklam kapatılırsa bu etkinlik tetiklenmez.

Özellikler
payload	Verilen ödül hakkında bilgi içeren bir nesne.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

Özellikler

---

payload

payload: RewardedPayload

Verilen ödül hakkında bilgi içeren bir nesne.

---

googletag.events.RewardedSlotReadyEvent

Event uzatır

Bu etkinlik, ödüllü reklam gösterilmeye hazır olduğunda tetiklenir. Yayıncı, reklamı göstermeden önce kullanıcıya reklamı görüntüleme seçeneği sunmaktan sorumludur.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Yöntemler
makeRewardedVisible	Ödüllü reklamı gösterir.

Örnek

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 (eski)

// 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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

Yöntemler

---

makeRewardedVisible

makeRewardedVisible(): boolean

Ödüllü reklamı gösterir. Bu yöntem, kullanıcı reklamı görüntülemeye izin verene kadar çağrılmamalıdır.

İadeler
boolean	Ödüllü reklamın başarıyla gösterilip gösterilmediği.

---

googletag.events.RewardedSlotVideoCompletedEvent

Event uzatır

Bu etkinlik, ödüllü video reklamın oynatılması tamamlandığında tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

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.
    }
  });
}

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

---

googletag.events.SlotOnloadEvent

Event uzatır

Bu etkinlik, reklam öğesinin iFrame'i yükleme etkinliğini tetiklediğinde tetiklenir. Rich media reklamları eşzamanlı oluşturma modunda oluşturulurken iframe kullanılmaz. Bu nedenle SlotOnloadEvent tetiklenmez.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotRenderEndedEvent

Event uzatır

Bu etkinlik, reklam öğesi kodu bir alana yerleştirildiğinde tetiklenir. Bu etkinlik, reklam öğesinin kaynakları getirilmeden önce gerçekleşir. Bu nedenle, reklam öğesi henüz görünür olmayabilir. Bir alan için tüm reklam öğesi kaynaklarının ne zaman yüklendiğini bilmeniz gerekiyorsa bunun yerine events.SlotOnloadEvent'i kullanabilirsiniz.

Özellikler
advertiserId	Oluşturulan reklamın reklamveren kimliği.
campaignId	Oluşturulan reklamın kampanya kimliği.
companyIds	Oluşturulan dolgu reklam için teklif veren şirketlerin kimlikleri.
creativeId	Oluşturulan rezervasyon reklamının reklam öğesi kimliği.
creativeTemplateId	Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği.
isBackfill	Reklamın dolgu reklam olup olmadığı.
isEmpty	Alan için reklam döndürülüp döndürülmediği
labelIds	Kullanımdan kaldırıldı.
lineItemId	Oluşturulan rezervasyon reklamının satır öğesi kimliği.
responseIdentifier	Yanıt tanımlayıcı, reklam yanıtının benzersiz tanımlayıcısıdır.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
size	Oluşturulan reklam öğesinin piksel boyutunu gösterir.
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı
slotContentChanged	Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği.
sourceAgnosticCreativeId	Oluşturulan rezervasyon veya dolgu reklamın reklam öğesi kimliği.
sourceAgnosticLineItemId	Oluşturulan rezervasyon veya dolgu reklamın satır öğesi kimliği.
yieldGroupIds	Oluşturulan dolgu reklamın getiri gruplarının kimlikleri.

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

Özellikler

---

advertiserId

advertiserId: number

Oluşturulan reklamın reklamveren kimliği. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

campaignId

campaignId: number

Oluşturulan reklamın kampanya kimliği. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

companyIds

companyIds: number[]

Oluşturulan dolgu reklam için teklif veren şirketlerin kimlikleri. Boş alanlar, rezervasyon reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

creativeId

creativeId: number

Oluşturulan rezervasyon reklamının reklam öğesi kimliği. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

creativeTemplateId

creativeTemplateId: number

Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

isBackfill

isBackfill: boolean

Reklamın dolgu reklam olup olmadığı. Reklam bir dolgu reklamıysa değer true, aksi takdirde false olur.

---

isEmpty

isEmpty: boolean

Alan için reklam döndürülüp döndürülmediği Reklam döndürülmediyse değer true, aksi takdirde false olur.

---

labelIds

labelIds: number[]

Desteği sonlandırıldı: Bu alan artık doldurulmuyor.

---

lineItemId

lineItemId: number

Oluşturulan rezervasyon reklamının satır öğesi kimliği. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

responseIdentifier

responseIdentifier: string

Yanıt tanımlayıcı, reklam yanıtının benzersiz tanımlayıcısıdır. Bu değer, reklamı Reklam İnceleme Merkezi'nde (ARC) tanımlamak ve engellemek için kullanılabilir.

---

size

size: string | number[]

Oluşturulan reklam öğesinin piksel boyutunu gösterir. Örnek: [728, 90]. Boş reklam alanları için değer null olur.

---

slotContentChanged

slotContentChanged: boolean

Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği. İçerik değiştirildiyse değer true, aksi takdirde false olur.

---

sourceAgnosticCreativeId

sourceAgnosticCreativeId: number

Oluşturulan rezervasyon veya dolgu reklamın reklam öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: number

Oluşturulan rezervasyon veya dolgu reklamın satır öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

---

yieldGroupIds

yieldGroupIds: number[]

Oluşturulan dolgu reklamın getiri gruplarının kimlikleri. Boş alanlar, rezervasyon reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

googletag.events.SlotRequestedEvent

Event uzatır

Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotResponseReceived

Event uzatır

Bu etkinlik, belirli bir alan için reklam yanıtı alındığında tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotVisibilityChangedEvent

Event uzatır

Bu etkinlik, bir reklam alanının ekrandaki yüzdesi her değiştiğinde tetiklenir. Etkinlik kısıtlanır ve her 200 ms'de bir defadan fazla tetiklenmez.

Özellikler
inViewPercentage	Reklam alanının görünür olan yüzdesi.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName mülkünden devralındı
slot	Etkinliği tetikleyen alan. Event.slot mülkünden devralındı

Örnek

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 (eski)

// 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.
  }
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

Özellikler

---

inViewPercentage

inViewPercentage: number

Reklam alanının görünür olan yüzdesi. Değer, 0 ile 100 arasında bir sayıdır.

---

googletag.secureSignals

Bu, GPT'nin güvenli sinyalleri yönetmek için kullandığı ad alanıdır.

Arayüzler
BidderSignalProvider	Belirli bir teklif veren için güvenli bir sinyal döndürür.
PublisherSignalProvider	Belirli bir yayıncı için güvenli bir sinyal döndürür.
SecureSignalProvidersArray	Güvenli sinyalleri yönetmek için kullanılan bir arayüz.

Tür Takma Adları
SecureSignalProvider	Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü.

Tür Takma Adları

---

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü. id veya networkCode değerlerinden biri sağlanmalıdır ancak ikisi birden sağlanmamalıdır.

---

googletag.secureSignals.BidderSignalProvider

Belirli bir teklif veren için güvenli sinyal döndürür.

Teklif veren güvenli sinyal sağlayıcı 2 bölümden oluşur:

1. Güvenli bir sinyale çözümlenen bir Promise döndüren toplayıcı işlevi.
2. Sinyalle ilişkili teklif vereni tanımlayan bir id.

Bir yayıncı için güvenli sinyal döndürmek istiyorsanız bunun yerine secureSignals.PublisherSignalProvider'ı kullanın.

Özellikler
collectorFunction	Güvenli bir sinyale çözümlenen bir Promise döndüren işlev.
id	Google Ad Manager'da kayıtlı olduğu şekilde, bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısı.

Örnek

JavaScript

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

JavaScript (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Güvenli sinyalleri teklif verenlerle paylaşma

Özellikler

---

collectorFunction

collectorFunction: (() => Promise<string>)

Güvenli bir sinyale çözümlenen bir Promise döndüren işlev.

---

id

id: string

Google Ad Manager'da kayıtlı olduğu şekilde, bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısı.

---

googletag.secureSignals.PublisherSignalProvider

Belirli bir yayıncı için güvenli sinyal döndürür.

Yayıncı sinyal sağlayıcı 2 bölümden oluşur:

1. Güvenli bir sinyale çözümlenen bir Promise döndüren toplayıcı işlevi.
2. Sinyalle ilişkili yayıncıyı tanımlayan bir networkCode.

Bir teklif veren için güvenli sinyal döndürmek istiyorsanız bunun yerine secureSignals.BidderSignalProvider'ı kullanın.

Özellikler
collectorFunction	Güvenli bir sinyale çözümlenen bir Promise döndüren işlev.
networkCode	Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).

Örnek

JavaScript

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

JavaScript (eski)

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Güvenli sinyalleri teklif verenlerle paylaşma

Özellikler

---

collectorFunction

collectorFunction: (() => Promise<string>)

Güvenli bir sinyale çözümlenen bir Promise döndüren işlev.

---

networkCode

networkCode: string

Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).

---

googletag.secureSignals.SecureSignalProvidersArray

Güvenli sinyalleri yönetmek için kullanılan bir arayüz.

Yöntemler
clearAllCache	Tüm toplayıcılar için tüm sinyalleri önbellekten temizler.
push	Sinyal sağlayıcı dizisine yeni bir secureSignals.SecureSignalProvider ekler ve sinyal oluşturma işlemini başlatır.

Yöntemler

---

clearAllCache

clearAllCache(): void

Tüm toplayıcılar için tüm sinyalleri önbellekten temizler.

Bu yöntemin çağrılması, mevcut ve potansiyel olarak sonraki sayfa görüntülemeleri için reklam isteklerine sinyallerin dahil olma olasılığını azaltabilir. Bu nedenle yöntem, yalnızca yeni bir kullanıcıyı belirten etkinlikler (oturum açma, oturumu kapatma, kaydolma vb.) gibi önemli durum değişiklikleri olduğunda çağrılmalıdır.

---

push

push(provider: SecureSignalProvider): void

Sinyal sağlayıcı dizisine yeni bir secureSignals.SecureSignalProvider ekler ve sinyal oluşturma işlemini başlatır.

Parametreler
provider: SecureSignalProvider	Diziye eklenecek secureSignals.SecureSignalProvider nesnesi.