GPT Referansı

Bu referansta, türleri tanımlamak için TypeScript notasyonu kullanılmaktadır. Aşağıdaki tabloda, örnek üzerinden kısa bir açıklama verilmiştir.

İfade yazma
string	Basit 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ştirme türü.
Array<number | string>	Değerlerin karmaşık (birleştirme) türde olduğu bir dizi türü.
[number, string]	Değerin, bu sırayla bir sayı ve 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ımlanmış bağımsız değişkeni 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ı başlıklı makaleyi inceleyin.

Metin ek açıklamaları

Bir değişkenden, parametre adından, mülk adından veya işlev imzasından sonra gelen iki nokta üst üste, tür ek açıklamasını gösterir. Tür ek açıklamaları, iki nokta üst üste işaretinin solunda bulunan öğenin kabul edebileceği veya döndürebileceği türleri açıklar. Aşağıdaki tabloda, bu referanstaki tür ek açıklamalarına dair örnekler verilmiştir.

Metin ek açıklaması
param: string	param işlevinin bir dize değeri kabul ettiğini veya döndürdüğünü belirtir. Bu söz dizimi değişkenler, parametreler, özellikler ve döndürülen türler için kullanılır.
param?: number | string	param değerinin isteğe bağlı olduğunu ancak belirtildiğinde sayı veya dize kabul ettiğini gösterir. Bu söz dizimi, parametreler ve mülkler için kullanılır.
...params: Array<() => void>	params değerinin, işlevleri kabul eden bir rest parametresi olduğunu gösterir. Rest parametreleri, belirtilen türde sınırsız sayıda değer kabul eder.

---

googletag

Google Yayıncı Etiketi'nin API'si için kullandığı genel 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 işlev dizisini 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.
ResponseInformation	Tek bir reklam yanıtını temsil eden bir nesne.
RewardedPayload	Bir ödüllü reklam ile ilişkili ödülü temsil eden bir nesne.
SafeFrameConfig	SafeFrame kapsayıcıları için yapılandırma nesnesi.
Service	Tüm hizmetler için ortak yöntemleri içeren temel hizmet sınıfı.
SizeMappingBuilder	Boyut eşleme spesifikasyonu nesneleri için oluşturucu.
Slot	Slot, bir sayfada tek bir reklam alanını temsil eden bir nesnedir.

Tür Takma Adları
GeneralSize	Bir alan için geçerli bir boyut yapılandırması. Bu, bir veya daha fazla boyut olabilir.
MultiSize	Geçerli tek boyutların listesi.
NamedSize	Bir alanın sahip olabileceği adlandırılmış boyutlar.
SingleSize	Bir slot için geçerli tek bir boyut.
SingleSizeArray	[width, height] değerlerini temsil eden iki sayı dizisi.
SizeMapping	Görüntü alanı boyutunun reklam boyutlarıyla eşlenmesi.
SizeMappingArray	Boyut eşlemelerinin listesi.

Değişkenler
apiReady	GPT API'sinin yüklü olduğunu ve çağrılmaya hazır olduğunu belirten işaret.
cmd	GPT ile ilgili çağrıların eşzamansız olarak 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 ait bir referans döndürür.
defineOutOfPageSlot	Belirtilen reklam birimi yoluyla sayfa dışı reklam alanı oluşturur.
defineSlot	Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bu alanı, reklamı barındıracak sayfadaki bir div öğesinin kimliğiyle ilişkilendirir.
destroySlots	Belirtilen alanları yok eder ve 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	Yuva hizmetlerine, yuvanın oluşturulmasını söyler.
enableServices	Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.
getVersion	GPT'nin mevcut sürümünü döndürür.
openConsole	Google Yayıncı Konsolu'nu açar.
pubads	PubAdsService'e 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ı belirler.
setConfig	Sayfa için genel yapılandırma seçeneklerini belirler.
sizeMapping	Yeni bir SizeMappingBuilder oluşturur.

Tür Takma Adları

---

GeneralSize

GeneralSize: SingleSize | MultiSize

Bir alan için geçerli bir boyut yapılandırması. Bu, bir veya daha fazla boyut olabilir.

---

MultiSize

MultiSize: SingleSize[]

Geçerli tek boyutların listesi.

---

NamedSize

NamedSize: "fluid" | ["fluid"]

Bir alanın sahip olabileceği adlandırılmış boyutlar. Çoğu durumda boyut sabit boyutlu bir dikdörtgendir ancak bazı durumlarda başka tür boyut özelliklerine ihtiyacımız vardır. Yalnızca aşağıdakiler adlandırılmış boyut olarak geçerlidir:

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

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

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

---

SingleSizeArray

SingleSizeArray: [number, number]

[width, height] değerlerini temsil eden iki sayı dizisi.

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

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

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

Boyut eşlemelerinin listesi.

Değişkenler

---

Const apiReady

apiReady: boolean | undefined

GPT API'sinin yüklü olduğunu ve çağrılmaya hazır olduğunu belirten işaret. Bu özellik, API hazır olana kadar yalnızca undefined olur.

Asenkron işlemeyi yönetmenin önerilen yönteminin, GPT hazır olduğunda geri çağırma işlevlerini sıraya almak için googletag.cmd kullanma olduğunu unutmayın. Bu geri çağırmaların, API ayarlandıktan sonra yürütüleceği garanti edildiğinden googletag.apiReady değerini kontrol etmeleri gerekmez.

---

Const cmd

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

GPT ile ilgili çağrıların eşzamansız olarak 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 dizisi olarak başlatılır ve cmd.push, dizinin sonuna bir öğe ekleyen standart Array.push yöntemidir. GPT JavaScript'i yüklendiğinde diziyi inceler ve tüm işlevleri sırayla yürütür. Ardından komut dosyası, cmd değerini, kendisine iletilen işlev bağımsız değişkenini yürütmek üzere push yöntemi tanımlanmış bir CommandArray nesnesi ile değiştirir. Bu mekanizma, tarayıcının sayfayı oluşturmaya devam etmesine izin verirken JavaScript'i eşzamansız olarak getirerek GPT'nin algılanan gecikmeyi azaltmasına olanak tanı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());
});

---

Const pubadsReady

pubadsReady: boolean | undefined

PubAdsService'in etkin, yüklü ve tamamen çalışır durumda olduğunu gösteren işaret. enableServices çağrılana ve PubAdsService yüklenip başlatılana kadar bu mülk 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, sinyal oluşturan bir işlev dizisi kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra çağrılacak sinyal oluşturan işlevleri sıraya eklemek için kullanılan standart bir diziyi değiştirmeyi amaçlar.

Ö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 ait bir referans döndürür.

İadeler
CompanionAdsService	Tamamlayıcı Reklamlar hizmeti.

---

defineOutOfPageSlot

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

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

Özel sayfa dışı reklamlar için div, reklamı barındıracak div öğesinin kimliğidir. Daha fazla bilgi için sayfa dışı reklam öğeleri konulu makaleyi inceleyin.

GPT tarafından yönetilen sayfa dışı reklamlar için div, desteklenen bir OutOfPageFormat değeridir.

Ö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örüntüleme

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

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

---

defineSlot

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

Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bu alanı, reklamı barındıracak sayfadaki bir 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ı Etiketlerini Kullanmaya Başlama

Parametreler
adUnitPath: string	Ağ kodu ve birim kodu içeren tam reklam birimi yolu.
size: GeneralSize	Eklenen yuvanı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 küçükse reklam isteğinde kullanılan boyut budur.
Optional div: string	Bu reklam birimini içerecek div'in kimliği.

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

---

destroySlots

destroySlots(slots?: Slot[]): boolean

Belirtilen alanları yok eder ve bu alanların tüm ilgili nesnelerini ve referanslarını GPT'den kaldırır. Bu API, geri gönderme slotlarını ve tamamlayıcı slotları desteklemez.

Bir slotta bu API'nin çağrılması, reklamı temizler ve slot nesnesini GPT tarafından yönetilen dahili durumdan kaldırır. Slot nesnesinde daha fazla işlev çağrılırsa tanımlanmamış bir davranış ortaya çıkar. Yayıncı sayfası tarafından bu yuvayla ilgili bir referans tutulmaya devam ederse tarayıcının bu yuvayla ilişkili belleği boşaltmayabileceğini unutmayın. Bu API'nin çağrılmasıyla, söz konusu alanla ilişkili div yeniden kullanılabilir hale gelir.

Özellikle bir alanı devre dışı bırakmak, reklamı GPT'nin uzun ömürlü sayfa görüntüleme özelliğinden kaldırır. Böylece gelecekteki istekler, bu reklamla ilgili engellemelerden veya rekabetçi hariç tutmalardan etkilenmez. Bir yuvanın div'i sayfadan kaldırılmadan önce bu işlevin çağrılmaması, tanımlanmamış davranışa 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 yuva dizisi. Dizi isteğe bağlıdır; belirtilmezse tüm yuvalar yok edilir.

İadeler
boolean	Yuvalar yok 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

---

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

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

Yuva hizmetlerine, yuvanın oluşturulmasını söyler. Her reklam alanı, sayfa başına yalnızca bir kez gösterilmelidir. Tüm slotlar, gösterilmeden önce tanımlanmalı ve bunlarla ilişkili bir hizmet bulunmalıdır. Görüntüleme çağrısı, öğe DOM'da bulunana kadar yapılmamalıdır. Bunu yapmanın genel yolu, yöntem çağrısında belirtilen div öğesindeki bir komut dosyası bloğuna yerleştirmektir.

Tekli istek mimarisi (SRA) kullanılıyorsa bu yöntem çağrılırken getirilmemiş tüm reklam alanları bir kerede getirilir. Bir reklam yuvasının gösterilmemesini zorunlu kılmak için div'in tamamının kaldırılması gerekir.

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

• Google Yayıncı Etiketlerini Kullanmaya Başlama
• Test reklamı gösterme
• Reklam yükleme ve yenilemeyi kontrol etme

Parametreler
divOrSlot: string | Element | Slot	Reklam yuvasını içeren div öğesinin veya div öğesinin ya da slot nesnesinin kimliği. Bir div öğesi sağlanırsa bu öğenin, defineSlot işlevine 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.

---

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ülmekte olan 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. Belirtilen reklam alanı sağlandığında Yayıncı Konsolu, belirtilen reklam alanının ayrıntılarını görüntüleyerek açılmaya çalışır.

---

pubads

pubads(): PubAdsService

PubAdsService'e 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ı belirler.

Örnek

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (eski)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

Parametreler
title: string	Tüm reklam kapsayıcı iframe'lerinin yeni başlığı.

---

setConfig

setConfig(config: PageSettingsConfig): void

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

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 işlev dizisini kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra çağrılacak işlevleri sıraya eklemek için kullanılan standart bir diziyi değiştirmeyi amaçlar.

Yöntemler
push	Bağımsız değişkenlerde belirtilen işlev dizisini 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. Etrafındaki söz dizimi bağlamının this değerini korumak için bir ok işlevi iletebilirsiniz.

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

---

googletag.CompanionAdsService

Uzantı Service

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

Yöntemler
addEventListener	Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi oluşturmanıza ve çağırmanıza olanak tanıyan bir dinleyici kaydeder. Service.addEventListener adlı kaynaktan devralındı
getSlots	Bu hizmetle ilişkili alanların listesini alın. Service.getSlots adlı kaynaktan devralındı
removeEventListener	Daha önce kayıtlı olan bir dinleyiciyi kaldırır. Service.removeEventListener adlı kaynaktan 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ı belirler.

Bu yöntem, doldurma işlemini etkinleştirmek ve devre dışı bırakmak için sayfanın ömrü boyunca birden çok kez çağrılabilir. Yalnızca PubAdsService'e de kayıtlı olan alanlar doldurulur. Politika kısıtlamaları nedeniyle bu yöntem, bir Ad Exchange videosu yayınlandığında boş tamamlayıcı slotları 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şmeden 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 yasal düzenlemelere uygunluk ihtiyaçlarını desteklemek için yayınların sınırlı reklamlar modunda yayınlanmasını sağlar.
nonPersonalizedAds?	Yayıncının yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayınların kişiselleştirilmemiş reklamlar modunda yayınlanmasını sağlar.
restrictDataProcessing?	Yayıncının yasal uygunluk ihtiyaçlarını desteklemek için yayının kısıtlanmış işleme modunda çalışmasını sağlar.
trafficSource?	İsteklerin satın alınan trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir.
underAgeOfConsent?	Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geldiği şeklinde işaretlenip işaretlenmeyeceğini belirtir.

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

• Gizlilik ayarlarını yapılandırma

Özellikler

---

Optional childDirectedTreatment

childDirectedTreatment?: null | 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ının yasal uygunluk ihtiyaçlarını desteklemek için yayınların sınırlı reklamlar modunda yayınlanmasını sağlar.

GPT'ye sınırlı reklam isteğinde bulunmasını iki şekilde bildirebilirsiniz:

• IAB TCF 2.0 kullanıcı rızası yönetim platformundan gelen bir sinyal kullanılarak otomatik olarak.
• Bu alanın değerini true olarak ayarlayarak manuel olarak.
Sınırlı reklamların manuel olarak yapılandırılması 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.

Bir CMP kullanılırken sınırlı reklamları manuel olarak etkinleştirmenin gerekmediğini 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örüntüleme

---

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean

Yayıncının yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayınların kişiselleştirilmemiş reklamlar modunda yayınlanmasını sağlar.

---

Optional restrictDataProcessing

restrictDataProcessing?: boolean

Yayıncının yasal uygunluk ihtiyaçlarını desteklemek için yayının kısıtlanmış işleme modunda çalışmasını sağlar.

---

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?: null | boolean

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

---

googletag.PubAdsService

Uzantı Service

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 JavaScript işlevi oluşturmanıza ve çağırmanıza olanak tanıyan bir dinleyici kaydeder. Service.addEventListener adlı kaynaktan devralındı
clear	Reklamları belirtilen slotlardan kaldırır ve boş içerikle değiştirir.
clearCategoryExclusions	Sayfa düzeyindeki tüm reklam kategorisi hariç tutma etiketlerini temizler.
clearTargeting	Belirli bir anahtar veya tüm anahtarlar için özel hedefleme parametrelerini temizler.
collapseEmptyDivs	Gösterilecek reklam içeriği olmadığında sayfa üzerinde yer kaplamamaları için alan div'lerinin daraltılmasını sağlar.
disableInitialLoad	Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam isteğinde bulunulmasına izin verir.
display	Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturup gösterir.
enableLazyLoad	GPT'de, config nesnesi tarafından tanımlandığı şekilde gecikmeli yüklemeyi etkinleştirir.
enableSingleRequest	Aynı anda birden fazla reklam getirmek için tek istek modunu etkinleştirir.
enableVideoAds	GPT'ye sayfada video reklamlar bulunacağını bildirir.
get	Belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
getAttributeKeys	Bu hizmette ayarlanan özellik anahtarlarını döndürür.
getSlots	Bu hizmetle ilişkili alanların listesini alın. Service.getSlots adlı kaynaktan devralındı
getTargeting	Ayarlanmış belirli bir özel hizmet düzeyi hedefleme parametresini döndürür.
getTargetingKeys	Ayarlanmış tüm özel hizmet düzeyinde hedefleme anahtarlarının listesini döndürür.
isInitialLoadDisabled	Önceki bir PubAdsService.disableInitialLoad çağrısı tarafından reklamlarla ilgili ilk isteklerin 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.
removeEventListener	Daha önce kayıtlı olan bir dinleyiciyi kaldırır. Service.removeEventListener adlı kaynaktan devralındı
set	Yayıncı reklamları hizmeti kapsamındaki tüm reklam alanları için geçerli olan AdSense özellikleri değerlerini ayarlar.
setCategoryExclusion	Belirtilen etiket adı için sayfa düzeyinde bir reklam kategorisi hariç tutma ayarlar.
setCentering	Reklamların yatay olarak ortalanmasını etkinleştirir ve devre dışı bırakır.
setForceSafeFrame	Sayfadaki tüm reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
setLocation	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	SafeFrame yapılandırması için sayfa düzeyindeki tercihleri belirler.
setTargeting	Belirli bir anahtar için tüm Publisher Ads hizmeti reklam alanları için geçerli olan özel hedefleme parametreleri ayarlar.
setVideoContent	Hedefleme ve içerik hariç tutma amacıyla reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar.
updateCorrelator	Reklam istekleriyle birlikte gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntülemeyi etkili bir şekilde başlatır.

Yöntemler

---

clear

clear(slots?: Slot[]): boolean

Reklamları belirtilen slotlardan kaldırır ve boş içerikle değiştirir. Yuvalar getirilmemiş olarak işaretlenir.

Özellikle, bir yuvanın temizlenmesi reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Bu nedenle, gelecekteki istekler bu reklamla ilgili engellemelerden veya rekabetçi 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 alan dizisi. Dizi isteğe bağlıdır; belirtilmezse tüm yuvalar temizlenir.

İadeler
boolean	Yuvalar temizlenmişse true, aksi takdirde false döndürülür.

---

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Sayfa düzeyindeki tüm reklam kategorisi hariç tutma etiketlerini temizler. Bu, slotu yenilemek istediğinizde kullanışlıdır.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

• Anahtar/değer çifti hedeflemesi

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

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

---

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

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

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

• Boş reklam alanlarını daraltma
• Düzen değişikliğini en aza indirme

Parametreler
Optional collapseBeforeAdFetch: boolean	Reklamlar getirilmeden önce bile slotların daraltılıp daraltılmayacağı. Bu parametre isteğe bağlıdır. Değer 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 döndürür.

---

disableInitialLoad

disableInitialLoad(): void

Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam isteğinde bulunulmasına izin verir. Bu ayar, hizmet etkinleştirilmeden önce yapılmalıdır. Eşzamansız mod kullanılmalıdır. Aksi takdirde refresh kullanılarak reklam isteğinde bulunulamaz.

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

• Reklam yükleme 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şturup gösterir. Bu yöntem tek istek modunda çalışmaz.

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 slotun ve sayfa durumunun anlık görüntüsü oluşturulur. Bu yöntem çağrıldıktan sonra slot veya sayfa durumunda yapılan değişiklikler (hedefleme, gizlilik ayarları, SafeFrame'i zorlama 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ükleme ve yenilemeyi kontrol etme

Parametreler
adUnitPath: string	Oluşturulacak alanın reklam birimi yolu.
size: GeneralSize	Yuvanın genişliği ve yüksekliği.
Optional div: string | Element	Yuvayı içeren div öğesinin 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, config nesnesi tarafından tanımlandığı şekilde gecikmeli 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 slotlar getirme marjının dışındaysa çalışır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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, tembel davranışın özelleştirilmesine olanak tanır. Atlanan tüm yapılandırmalarda, Google tarafından ayarlanan ve zaman içinde ayarlanacak bir varsayılan kullanılır. Belirli bir ayarı (ör. getirme marjı) devre dışı bırakmak için değeri -1 olarak ayarlayın. fetchMarginPercent Reklamı getirmeden önce bir yuvanın geçerli görüntü alanından en az ne kadar uzakta olması gerektiğini görüntü alanı boyutunun yüzdesi olarak belirtir. 0 değeri "alan görüntü alanına girdiğinde", 100 değeri "reklam 1 görüntü alanı uzaklıkta olduğunda" vb. anlamına gelir. renderMarginPercent Bir reklamı oluşturmadan önce bir yuvanın geçerli görüntü alanından en az ne kadar uzakta olması gerektiği. Bu sayede reklam önceden alınır ancak diğer alt kaynakların oluşturulması ve indirilmesi beklenir. 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 çarpan. Bu sayede mobil cihazlarda ve masaüstünde farklı marjlar kullanabilirsiniz. Örneğin, 2,0 değerinin kullanılması, mobil cihazlarda tüm kenar boşluklarının 2 ile çarpılmasına neden olur.Bu da bir yuvanın getirilip oluşturulmadan önce bulunabileceği minimum mesafeyi artırır.

---

enableSingleRequest

enableSingleRequest(): boolean

Aynı anda birden fazla reklam getirmek için tek istek modunu etkinleştirir. Bunun için, hizmeti etkinleştirmeden önce tüm yayıncı reklam alanlarının tanımlanması ve PubAdsService'e eklenmesi gerekir. Tek istek modu, hizmet etkinleştirilmeden önce ayarlanmalıdır.

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	Tekli istek modu etkinleştirildiyse true, yöntem hizmet etkinleştirildikten sonra çağrıldığı için tekli istek modunu etkinleştirmek mümkün değilse false döndürür.

---

enableVideoAds

enableVideoAds(): void

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

---

get

get(key: string): null | string

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

• AdSense Özellikleri

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

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

---

getAttributeKeys

getAttributeKeys(): string[]

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

---

getTargeting

getTargeting(key: string): string[]

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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üzeyinde hedefleme anahtarlarının listesini döndürür.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
string[]	Hedefleme anahtarı dizisi. Sıralama tanımlanmadı.

---

isInitialLoadDisabled

isInitialLoadDisabled(): boolean

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

İadeler
boolean	PubAdsService.disableInitialLoad çağrısı başarılıysa true, aksi takdirde false döndürür.

---

refresh

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

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

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

Bir alanı yenilemek, eski reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, söz konusu reklamla ilgili engellemelerden veya rekabetçi 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ükleme ve yenilemeyi kontrol etme
• Reklam alanlarını yenileme

Parametreler
Optional slots: null | Slot[]	Yenilenecek yuvalar. Dizi isteğe bağlıdır; belirtilmezse tüm yuvalar yenilenir.
Optional options: {   changeCorrelator: boolean; }	Bu yenileme çağrısıyla ilişkili yapılandırma seçenekleri. changeCorrelator Reklam getirme işlemi için yeni bir ilişkilendiricinin 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 bu süre değişebilir) korur. Böylece, yakın zamanda alınan ve aynı ilişkilendiriciye sahip istekler tek bir sayfa görüntüleme olarak kabul edilir. Varsayılan olarak her yenileme için yeni bir ilişkilendirici oluşturulur. Not: Bu seçeneğin, GPT'nin uzun süreli sayfa görüntüleme üzerinde hiçbir etkisi yoktur. Bu sayfa görüntüleme, sayfadaki mevcut reklamları otomatik olarak yansıtır ve geçerlilik süresi yoktur.

---

set

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

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

Bu işlevin aynı anahtar için birden fazla kez çağrılması, söz konusu anahtar için daha önce ayarlanmış değerleri geçersiz kılar. Tüm değerler, display veya refresh çağrılmadan önce ayarlanmalıdır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("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 merkezleme varsayılan olarak etkindir.

Yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar merkezleneceğinden, bu yöntem display veya refresh çağrılmadan önce çağrılmalıdır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Parametreler
centerAds: boolean	Reklamları true ile ortala, false ile sola hizala.

---

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 istekleri için geçerli olur.
• Belirtilen alan düzeyi ayarı, sayfa düzeyindeki ayarı her zaman geçersiz kılar.
• true olarak ayarlanırsa (reklam 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 belirtilmezse reklam, reklam öğesi 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 güvenen reklam öğelerinin davranışını etkileyebileceğinden dikkatli kullanılmalıdır.

Örnek

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (eski)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

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

• SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
forceSafeFrame: boolean	Sayfadaki tüm reklamların SafeFrame'de oluşturulmasını zorlamak için true ve önceki ayarı false olarak değiştirmek için false değerini kullanın. Daha önce belirtilmemişse bu değeri false olarak ayarlamak hiçbir şeyi değiştirmez.

İadeler
PubAdsService	İşlevin ç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.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

// Postal code:
googletag.pubads().setLocation("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örüntüleme

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 kimlik. 32 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üzeyindeki tercihleri belirler. config nesnesinde tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı göz ardı edilir.

Bu sayfa düzeyindeki tercihler, belirtilirse alan düzeyindeki tercihlerle geçersiz kılınır.

Örnek

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

JavaScript (eski)

googletag.pubads().setForceSafeFrame(true);

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

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

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 Publisher Ads hizmeti reklam alanları için geçerli olan özel hedefleme parametreleri ayarlar. Bu işlevin aynı anahtar için birden çok kez çağrılması, eski değerlerin üzerine yazılır. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

• Anahtar/değer çifti hedeflemesi

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.

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

• VAST reklam etiketi URL parametreleri

Parametreler
videoContentId: string	Videonun içerik kimliği.
videoCmsId: string	Videonun içerik yönetim sistemi kimliği.

---

updateCorrelator

updateCorrelator(): PubAdsService

Reklam istekleriyle birlikte gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntülemeyi etkili bir şekilde 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üleme özelliğini etkilemez. Bu özellik, sayfadaki gerçek reklamları otomatik olarak yansıtır ve geçerlilik 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.ResponseInformation

Tek bir reklam yanıtını temsil eden bir 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: null | number

Reklamverenin kimliği.

---

campaignId

campaignId: null | number

Kampanyanın kimliği.

---

creativeId

creativeId: null | number

Reklam öğesinin kimliği.

---

creativeTemplateId

creativeTemplateId: null | number

Reklamın şablon kimliği.

---

lineItemId

lineItemId: null | number

Satır öğesinin kimliği.

---

googletag.RewardedPayload

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

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

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. "coin").

---

googletag.SafeFrameConfig

SafeFrame kapsayıcıları için yapılandırma nesnesi.

Özellikler
allowOverlayExpansion?	SafeFrame'in, sayfa içeriğini yer paylaşımı yaparak reklam içeriğinin genişlemesine izin verip vermeyeceği.
allowPushExpansion?	SafeFrame'in sayfa içeriğini iterek reklam içeriğinin genişlemesine izin verip vermeyeceği.
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 kullanmaması.

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

• PubAdsService.setSafeFrameConfig

Özellikler

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

SafeFrame'in, sayfa içeriğini yer paylaşımı yaparak reklam içeriğinin 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 sandbox

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'tür (false olarak zorlanamaz). Korumalı alan özelliğinin eklentileri (ör. Flash) devre dışı bıraktığını unutmayın.

---

Optional useUniqueDomain

useUniqueDomain?: null | boolean

SafeFrame'in rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı. Depolanan değeri temizlemek için null değerini iletin.

Not: Bu özellik varsayılan olarak etkindir.

Desteği sonlandırıldı: Bu özelliği artık devre dışı bırakamazsınız. useUniqueDomain ayarının etkisi yoktur.

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

• SafeFrame kullanarak reklam öğeleri oluşturma

---

googletag.Service

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

Yöntemler
addEventListener	Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi oluşturmanıza ve çağırmanıza olanak tanıyan bir dinleyici kaydeder.
getSlots	Bu hizmetle ilişkili alanların listesini alın.
removeEventListener	Daha önce kayıtlı olan 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 JavaScript işlevi oluşturmanıza ve çağırmanıza olanak tanıyan bir dinleyici 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
Uygun etkinlik türüne sahip bir nesne, çağrıldığında 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 etkinliğin 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 alanların listesini alın.

İadeler
Slot[]	Hizmete eklendikleri sırayla slotlar.

---

removeEventListener

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

Daha önce kayıtlı olan 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 etkinliğin 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 eder) alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.
build	Bu oluşturucuya eklenen eşlemelerden bir boyut haritası 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 eder) 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şi için görüntü alanının boyutu.
slotSize: GeneralSize	Bu eşleme girişi için yuvanın boyutları.

İadeler
SizeMappingBuilder	Bu oluşturucuya referans.

---

build

build(): null | SizeMappingArray

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

Geçersiz eşlemeler sağlandıysa 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ımlanmamıştır.

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

---

googletag.Slot

Slot, bir sayfada tek bir reklam alanını temsil eden bir nesnedir.

Yöntemler
addService	Bu alana bir Hizmet ekler.
clearCategoryExclusions	Bu slot için tüm slot düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.
clearTargeting	Bu alan için belirli veya tüm özel alan düzeyinde hedefleme parametrelerini temizler.
defineSizeMapping	Bu yuva için minimum görüntü alanı boyutundan yuva boyutuna kadar bir eşleme dizisi ayarlar.
get	Bu alan için belirli bir anahtarla ilişkili AdSense özelliğinin değerini döndürür.
getAdUnitPath	Ağ kodu ve reklam birimi yolu ile reklam biriminin tam yolunu döndürür.
getAttributeKeys	Bu yuvada ayarlanan özellik anahtarlarının listesini döndürür.
getCategoryExclusions	Bu alanın reklam kategorisi hariç tutma etiketlerini döndürür.
getResponseInformation	Reklam yanıtı bilgilerini döndürür.
getSlotElementId	Yuva tanımlanırken sağlanan div yuvanın kimliğini döndürür.
getTargeting	Bu yuvada ayarlanan belirli bir özel hedefleme parametresini döndürür.
getTargetingKeys	Bu yuvada ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür.
set	Bu reklam alanındaki bir AdSense özelliği için değer ayarlar.
setCategoryExclusion	Bu alanda alan düzeyinde bir reklam kategorisi hariç tutma etiketi ayarlar.
setClickUrl	Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği tıklama URL'sini ayarlar.
setCollapseEmptyDiv	Alanda reklam olmadığında div alanının gizlenip gizlenmeyeceğini belirler.
setConfig	Bu yuva için genel yapılandırma seçeneklerini belirler.
setForceSafeFrame	Bu alandaki reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
setSafeFrameConfig	SafeFrame yapılandırması için slot düzeyindeki tercihleri belirler.
setTargeting	Bu slot için özel bir hedefleme parametresi ayarlar.
updateTargetingFromMap	JSON nesnesinde bir anahtar/değer eşlemesinden bu slot 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ı Etiketlerini Kullanmaya Başlama
• Test reklamı gösterme

Parametreler
service: Service	Eklenecek hizmet.

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

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

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

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

---

clearTargeting

clearTargeting(key?: string): Slot

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

• Anahtar/değer çifti hedeflemesi

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

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

---

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

Bu yuva için minimum görüntü alanı boyutundan yuva boyutuna kadar 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şleme dizisi. Bunu oluşturmak için SizeMappingBuilder'ı kullanabilirsiniz. Her beden eşleme, iki öğeden oluşan bir dizidir: SingleSizeArray ve GeneralSize.

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

---

get

get(key: string): null | string

Bu alan için belirli bir anahtarla ilişkili AdSense özelliğinin değerini döndürür. Bu alanın devraldığı hizmet düzeyindeki özellikleri görmek için PubAdsService.get'i kullanın.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

• AdSense Özellikleri

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

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

---

getAdUnitPath

getAdUnitPath(): string

Ağ kodu ve reklam birimi yolu ile 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 yuvada ayarlanan özellik anahtarlarının listesini döndürür. Bu yuva tarafından devralınan hizmet düzeyindeki özelliklerin anahtarlarını görmek için PubAdsService.getAttributeKeys'i kullanın.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
string[]	Özellik anahtarı dizisi. Sıralama tanımlanmadı.

---

getCategoryExclusions

getCategoryExclusions(): string[]

Bu alanın reklam kategorisi hariç tutma etiketlerini döndürür.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

---

getResponseInformation

getResponseInformation(): null | ResponseInformation

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

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

---

getSlotElementId

getSlotElementId(): string

Yuva tanımlanırken sağlanan div yuvanın kimliğini 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	Slot div kimliği.

---

getTargeting

getTargeting(key: string): string[]

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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 yuvada ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür. Hizmet düzeyinde hedefleme anahtarları dahil değildir.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
string[]	Hedefleme anahtarı dizisi. Sıralama tanımlanmadı.

---

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öntemin aynı anahtar için birden fazla kez çağrılması, söz konusu anahtar için daha önce ayarlanan değerleri geçersiz kılar. Tüm değerler, display veya refresh çağrılmadan önce ayarlanmalıdır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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ığı slot nesnesi.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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ığı slot 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ştirilmiş olsa bile Google Ad Manager sunucuları tıklamayı kaydeder. 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 dışı istekler için işe yarar.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

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

---

setCollapseEmptyDiv

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

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

• Boş reklam alanlarını daraltma
• Düzen değişikliğini en aza indirme

Parametreler
collapse: boolean	Hiçbir 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ğı. collapse true değilse yoksayılır.

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

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): void

Bu yuva için genel yapılandırma seçeneklerini belirler.

Parametreler
slotConfig: SlotSettingsConfig	Yapılandırma nesnesi.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

Bu alandaki reklamların 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 slotlar için yapılan sonraki reklam istekleri için geçerli olur.
• Belirtilen alan düzeyi ayarı, sayfa düzeyindeki ayarı her zaman geçersiz kılar.
• true olarak ayarlanırsa (reklam 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 belirtilmezse reklam, reklam öğesi 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 güvenen reklam öğelerinin davranışını etkileyebileceğinden dikkatli kullanılmalıdır.

Ö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	true, bu alandaki tüm reklamların SafeFrame'de oluşturulmasını zorlamak için, false ise sayfa düzeyindeki bir ayarı (varsa) devre dışı bırakmak için kullanılır. Sayfa düzeyinde belirtilmediği takdirde bu değerin false olarak ayarlanması hiçbir şeyi değiştirmez.

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

---

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot

SafeFrame yapılandırması için slot düzeyindeki tercihleri belirler. config nesnesinde tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı göz ardı edilir.

Belirtilirse bu slot düzeyindeki tercihler, sayfa düzeyindeki tüm tercihleri geçersiz kılar.

Ö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: null | SafeFrameConfig	Yapılandırma nesnesi.

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

---

setTargeting

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

Bu slot için özel bir hedefleme parametresi ayarlar. Bu yöntemin aynı anahtar için birden çok kez çağrılması, eski değerlerin üzerine yazılır. 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.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

• Anahtar/değer çifti hedeflemesi

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

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

---

updateTargetingFromMap

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

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

Notlar:

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

Ö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ığı slot nesnesi.

---

googletag.config

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

Arayüzler
AdExpansionConfig	Reklam genişletmeyi kontrol etmek için ayarlar.
ComponentAuctionConfig	Cihaz üzerinde reklam açık artırmasında tek bir bileşen açık artırmasını temsil eden bir nesne.
InterstitialConfig	Tek bir geçiş reklamı alanının davranışını tanımlayan bir nesne.
PageSettingsConfig	Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.
PrivacyTreatmentsConfig	Yayıncı gizlilik işlemlerini kontrol etmek için kullanılan ayarlar.
PublisherProvidedSignalsConfig	Yayıncı tarafından sağlanan sinyaller (PPS) yapılandırma nesnesi.
SlotSettingsConfig	Yuva düzeyindeki ayarlar için ana yapılandırma arayüzü.
TaxonomyData	Tek bir taksonomi değerini içeren bir nesne.

Tür Takma Adları
InterstitialTrigger	Desteklenen geçiş reklamı tetikleyicileri.
PrivacyTreatment	Desteklenen yayıncı gizlilik değerlendirmeleri.
Taxonomy	Yayıncı tarafından sağlanan sinyaller (PPS) için desteklenen sınıflandırmalar.

Tür Takma Adları

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

Desteklenen geçiş reklamı tetikleyicileri.

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Desteklenen yayıncı gizlilik değerlendirmeleri.

---

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 etmek için ayarlar.

Özellikler
enabled?	Reklam genişletmenin etkin 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?: null | boolean

Reklam genişletmenin etkin olup olmadığı.

Bu değerin ayarlanması, Google Ad Manager'da yapılandırılmış 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.ComponentAuctionConfig

Cihaz üzerinde reklam açık artırmasında tek bir bileşen açık artırmasını temsil eden bir nesne.

Özellikler
auctionConfig	Bu bileşen açık artırması için bir açık artırma yapılandırması nesnesi.
configKey	Bu bileşen açık artırmasıyla ilişkili yapılandırma anahtarı.

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

• Protected Audience API Satıcı Rehberi: Reklam açık artırmaları yapma

Özellikler

---

auctionConfig

auctionConfig: null | {
  auctionSignals?: unknown;
  decisionLogicUrl: string;
  interestGroupBuyers?: string[];
  perBuyerExperimentGroupIds?: {
    [buyer: string]: number;
  };
  perBuyerGroupLimits?: {
    [buyer: string]: number;
  };
  perBuyerSignals?: {
    [buyer: string]: unknown;
  };
  perBuyerTimeouts?: {
    [buyer: string]: number;
  };
  seller: string;
  sellerExperimentGroupId?: number;
  sellerSignals?: unknown;
  sellerTimeout?: number;
  trustedScoringSignalsUrl?: string;
}

Bu bileşen açık artırması için açık artırma yapılandırması nesnesi.

Bu değer null olarak ayarlanırsa belirtilen configKey için mevcut tüm yapılandırmalar silinir.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

• Protected Audience API: Cihaz Üzerinde Açık Artırma Başlatma

---

configKey

configKey: string

Bu bileşen açık artırmasıyla ilişkili yapılandırma anahtarı.

Bu değer boş olmamalı ve benzersiz olmalıdır. İki ComponentAuctionConfig nesnesi aynı configKey değerini paylaşıyorsa en son ayarlanan değer, önceki yapılandırmaların üzerine yazılır.

---

googletag.config.InterstitialConfig

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

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

Özellikler

---

Optional requireStorageAccess

requireStorageAccess?: null | boolean

Bu geçiş reklamının gösterilmesi için yerel depolama 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 vermeyen kullanıcılara geçiş reklamları gösterilmeye devam edebilir. Bu mülkü true olarak ayarlamak varsayılan davranışı devre dışı bırakır ve geçiş reklamlarının yalnızca yerel depolama izni veren 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 tetikleyiciler

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

Bu geçiş reklamının geçiş tetikleyicisi yapılandırması.

Geçiş tetikleyicisinin değeri true olarak ayarlandığında tetikleyici etkinleştirilir, false olarak ayarlandığında ise devre dışı bırakılır. Bu işlem, 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.PageSettingsConfig

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

Tek bir API çağrısıyla birden fazla özelliği ayarlamanıza olanak tanır.

Aşağıda listelenen tüm mülkler ö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 özellikle ilgili tüm ayarlar, googletag.setConfig çağrısı her yapıldığında 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
        }
    });
  

• Bir özellikle ilgili tüm ayarlar null ile temizlenebilir.

    // 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 etmek için ayarlar.
adYield?	Desteği sonlandırıldı.
pps?	Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etmek için ayarlar.
privacyTreatments?	Yayıncı gizlilik işlemlerini kontrol etmek için kullanılan ayarlar.
threadYield?	GPT'nin reklam öğelerini oluştururken JS iş parçacığının oluşturulup oluşturulmayacağını kontrol eden ayar.

Özellikler

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

Reklam genişletmeyi kontrol etmek için ayarlar.

---

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
Desteği sonlandırıldı: Bunun yerine threadYield işlevini kullanın. Bu özellik yakın zamanda kaldırılacaktır.

---

Optional pps

pps?: null | PublisherProvidedSignalsConfig

Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etmek için ayarlar.

---

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig

Yayıncı gizlilik işlemlerini kontrol etmek için kullanılan ayarlar.

---

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

Reklam öğelerini oluştururken GPT'nin JS iş parçacığına vermesi gerekip gerekmediğini kontrol eden ayar.

GPT yalnızca Scheduler.postTask veya Scheduler.yield API'sini destekleyen tarayıcılarda verim verir.

Desteklenen değerler:

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

Ö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:

• Planlayıcı

---

googletag.config.PrivacyTreatmentsConfig

Yayıncı gizlilik işlemlerini kontrol etmek için kullanılan ayarlar.

Özellikler
treatments	Etkinleştirilecek bir dizi yayıncı gizlilik değerlendirmesi.

Özellikler

---

tedavileri

treatments: null | "disablePersonalization"[]

Etkinleştirilecek bir dizi yayıncı gizlilik değerlendirmesi.

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

Ö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

---

sınıflandırmalar

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Sınıflandırma eşlemelerini içeren bir nesne.

---

googletag.config.SlotSettingsConfig

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

Tek bir yuva için tek bir API çağrısıyla birden fazla özelliği ayarlamanıza olanak tanır.

Aşağıda listelenen tüm mülkler ö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 özellikle ilgili tüm ayarlar, Slot.setConfig çağrısı her yapıldığında 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
        }
    });
  

• Bir özellikle ilgili tüm ayarlar null ile temizlenebilir.

    // 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 kontrol etmek için ayarlar.
componentAuction?	Cihaz üzerinde reklam açık artırmasına dahil edilecek bir dizi bileşen açık artırması.
interstitial?	Geçiş reklam alanı davranışını kontrol eden ayarlar.

Özellikler

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

Reklam genişletmeyi kontrol etmek için ayarlar.

---

Optional componentAuction

componentAuction?: null | ComponentAuctionConfig[]

Cihaz üzerinde reklam açık artırmasına dahil edilecek bir dizi bileşen açık artırması.

---

Optional geçiş reklamı

interstitial?: null | InterstitialConfig

Geçiş reklam alanı davranışını kontrol eden ayarlar.

---

googletag.config.TaxonomyData

Tek bir taksonomi değerini içeren bir nesne.

Özellikler
values	Taksonomi değerlerinin listesi.

Özellikler

---

values

values: string[]

Taksonomi değerlerinin listesi.

---

googletag.enums

Bu, GPT'nin enum türleri için kullandığı ad alanıdır.

Listeleme
OutOfPageFormat	GPT tarafından desteklenen sayfa dışı biçimler.
TrafficSource	GPT tarafından desteklenen trafik kaynakları.

Listeleme

---

OutOfPageFormat

OutOfPageFormat

GPT tarafından desteklenen sayfa dışı biçimler.

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

• defineOutOfPageSlot

Numaralandırma Üyeleri
BOTTOM_ANCHOR	Alanın görüntü alanının alt kısmına yapıştırıldığı ankraj biçimi.
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ı reklam öğesi biçimi.
LEFT_SIDE_RAIL	Sol yan reklam sütunu biçimi.
REWARDED	Ödüllü biçim.
RIGHT_SIDE_RAIL	Sağ yan reklam sütunu biçimi.
TOP_ANCHOR	Alanın görüntü alanının üst kısmına yapıştırıldığı yer işareti biçimi.

---

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 tepki 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 kılavuzu geçiş reklamı kullanıcı tarafından kapatıldığında tetiklenir.
GameManualInterstitialSlotReadyEvent	Bu etkinlik, 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ü bir reklam görüntülendiğinde ödül verildiğinde tetiklenir.
RewardedSlotReadyEvent	Bu etkinlik, bir ödüllü reklam gösterilmeye hazır olduğunda tetiklenir.
SlotOnloadEvent	Bu etkinlik, reklam öğesinin iFrame'i yükleme etkinliğini tetiklediğinde tetiklenir.
SlotRenderEndedEvent	Bu etkinlik, reklam öğesi kodu bir yuvaya eklendiğinde tetiklenir.
SlotRequestedEvent	Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.
SlotResponseReceived	Bu etkinlik, belirli bir slot için bir reklam yanıtı alındığında tetiklenir.
SlotVisibilityChangedEvent	Bu etkinlik, bir reklam yuvasının alanının ekrandaki yüzdesi değiştiğinde tetiklenir.

---

googletag.events.Event

Tüm GPT etkinlikleri için temel arayüz. Aşağıdaki tüm GPT etkinliklerinde aşağıdaki alanlar bulunur.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı.
slot	Etkinliği tetikleyen slot.

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

---

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

---

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

Uzantı Event

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 adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot kaynağından devralındı

Örnek

JavaScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);
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 interstial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);
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 interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);
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 kılavuzu geçiş reklamı görüntüleme

---

googletag.events.GameManualInterstitialSlotReadyEvent

Uzantı Event

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 adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot kaynağından devralındı

Yöntemler
makeGameManualInterstitialVisible	Oyun kılavuzu 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,
);
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,
);
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,
);
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 kılavuzu geçiş reklamı görüntüleme

Yöntemler

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void

Oyun kılavuzu geçiş reklamını kullanıcıya gösterir.

---

googletag.events.ImpressionViewableEvent

Uzantı Event

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 adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan 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

Uzantı Event

Bu etkinlik, ödüllü reklam alanı kullanıcı tarafından kapatıldığında tetiklenir. Bu etiket, ödül verilmeden önce veya sonra tetiklenebilir. Ödül verilip verilmediğini belirlemek için bunun yerine events.RewardedSlotGrantedEvent'i kullanın.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName kaynağından devralındı
slot	Etkinliği tetikleyen slot. Event.slot kaynağından devralındı

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

---

googletag.events.RewardedSlotGrantedEvent

Uzantı Event

Bu etkinlik, ödüllü bir reklam görüntülendiğinde ödül verildiğinde tetiklenir. Ödül verme ölçütleri karşılanmadan önce reklam kapatılırsa bu etkinlik tetiklenmez.

Özellikler
payload	Verilen ödülle ilgili bilgileri içeren bir nesne.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan devralındı

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

Özellikler

---

payload

payload: null | RewardedPayload

Verilen ödülle ilgili bilgileri içeren bir nesne.

---

googletag.events.RewardedSlotReadyEvent

Uzantı Event

Bu etkinlik, bir ödüllü reklam gösterilmeye hazır olduğunda tetiklenir. Kullanıcıya reklamı görüntüleme seçeneği sunmaktan yayıncı sorumludur.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan 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.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

• Reklam etkinliği işleyicileri
• Ödüllü reklam gösterme

Yöntemler

---

makeRewardedVisible

makeRewardedVisible(): void

Ödüllü reklamı gösterir. Bu yöntem, kullanıcı reklamı görüntülemeye izin verene kadar çağrılmamalıdır.

---

googletag.events.SlotOnloadEvent

Uzantı Event

Bu etkinlik, reklam öğesinin iFrame'i yükleme etkinliğini tetiklediğinde tetiklenir. Rich media reklamlar senkronize oluşturma modunda oluşturulurken iFrame kullanılmadığından SlotOnloadEvent tetiklenmez.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan 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

Uzantı Event

Bu etkinlik, reklam öğesi kodu bir yuvaya eklendiğinde tetiklenir. Bu etkinlik, reklam öğesinin kaynakları getirilmeden önce gerçekleşir. Bu nedenle reklam öğesi henüz görünmeyebilir. Bir alanla ilgili tüm reklam öğesi kaynaklarının ne zaman yüklendiğini bilmeniz gerekiyorsa bunun yerine events.SlotOnloadEvent etkinliğini 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	Bir reklamın dolgu reklam olup olmadığı.
isEmpty	Alan için bir reklam döndürülüp döndürülmediği.
labelIds	Desteği sonlandırıldı.
lineItemId	Oluşturulan rezervasyon reklamının satır öğesi kimliği.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName kaynağından devralındı
size	Oluşturulan reklam öğesinin piksel boyutunu belirtir.
slot	Etkinliği tetikleyen slot. Event.slot kaynağından devralındı
slotContentChanged	Alan içeriğinin, oluşturulan reklamla değiştirilip değiştirilmediği.
sourceAgnosticCreativeId	Oluşturulan rezervasyonun veya dolgu reklamın reklam öğesi kimliği.
sourceAgnosticLineItemId	Oluşturulan rezervasyonun veya dolgu reklamın satır öğesi kimliği.
yieldGroupIds	Oluşturulan doldurma reklamını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: null | number

Oluşturulan reklamın reklamveren kimliği. Boş alanlar, doldurma reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

campaignId

campaignId: null | number

Oluşturulan reklamın kampanya kimliği. Boş alanlar, doldurma reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

companyIds

companyIds: null | 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: null | number

Oluşturulan rezervasyon reklamının reklam öğesi kimliği. Boş alanlar, doldurma reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

creativeTemplateId

creativeTemplateId: null | number

Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği. Boş alanlar, doldurma reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

isBackfill

isBackfill: boolean

Bir reklamın dolgu reklam olup olmadığı. Reklam dolgu reklamsa değer true, aksi takdirde false olur.

---

isEmpty

isEmpty: boolean

Alan için bir reklam döndürülüp döndürülmediği. Hiçbir reklam döndürülmediyse değer true, aksi takdirde false olur.

---

labelIds

labelIds: null | number[]
Kullanımdan kaldırıldı: Bu alan artık doldurulmuyor.

---

lineItemId

lineItemId: null | number

Oluşturulan rezervasyon reklamının satır öğesi kimliği. Boş alanlar, doldurma reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null olur.

---

size

size: null | string | number[]

Oluşturulan reklam öğesinin piksel boyutunu belirtir. Ö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: null | number

Oluşturulan rezervasyonun veya dolgu reklamın reklam öğesi kimliği. Reklam rezervasyon veya satır öğesi doldurma işlemi değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number

Oluşturulan rezervasyonun veya dolgu reklamın satır öğesi kimliği. Reklam rezervasyon veya satır öğesi doldurma işlemi değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

---

yieldGroupIds

yieldGroupIds: null | number[]

Oluşturulan doldurma reklamını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

Uzantı Event

Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan 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

Uzantı Event

Bu etkinlik, belirli bir slot için bir reklam yanıtı alındığında tetiklenir.

Özellikler
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot kaynağından 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

Uzantı Event

Bu etkinlik, bir reklam yuvasının alanının ekrandaki yüzdesi değiştiğinde tetiklenir. Etkinlik sınırlandırılır ve 200 ms'de bir defadan daha sık tetiklenmez.

Özellikler
inViewPercentage	Reklamın görünür alanının yüzdesi.
serviceName	Etkinliği tetikleyen hizmetin adı. Event.serviceName adlı kaynaktan devralındı
slot	Etkinliği tetikleyen slot. Event.slot adlı kaynaktan 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ın görünür alanının yüzdesi. Değer, 0 ile 100 arasında bir sayı olmalı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 bir arayüz.

Tür Takma Adları
SecureSignalProvider	Belirli bir teklif veren veya sağlayıcı için güvenli bir 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 bir sinyal döndürme arayüzü. id veya networkCode'ten biri sağlanmalıdır ancak ikisini 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ısı 2 bölümden oluşur:

1. Güvenli bir sinyale çözümlenen bir Promise döndüren bir toplayıcı işlevi.
2. Sinyal ile 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 parametresini kullanın.

Özellikler
collectorFunction	Güvenli bir sinyale çözüm bulan bir Promise döndüren işlev.
id	Google Ad Manager'da kayıtlı olarak bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısıdır.

Ö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üm bulan bir Promise döndüren işlev.

---

id

id: string

Google Ad Manager'da kayıtlı olarak bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısıdır.

---

googletag.secureSignals.PublisherSignalProvider

Belirli bir yayıncı için güvenli bir sinyal döndürür.

Yayıncı sinyal sağlayıcısı 2 bölümden oluşur:

1. Güvenli bir sinyale çözümlenen bir Promise döndüren bir toplayıcı işlevi.
2. Sinyal ile 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 öğesini kullanın.

Özellikler
collectorFunction	Güvenli bir sinyale çözüm bulan 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üm bulan 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 bir arayüz.

Yöntemler
clearAllCache	Tüm toplayıcıların tüm sinyallerini ö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ın tüm sinyallerini önbellekten temizler.

Bu yöntemin çağrılması, sinyallerin mevcut ve muhtemelen sonraki sayfa görüntülemelerinin reklam isteklerine dahil edilme olasılığını azaltabilir. Bu nedenle, yalnızca yeni bir kullanıcıyı belirten etkinlikler (giriş yapma, oturumu kapatma, kaydolma vb.) gibi anlamlı 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.