2024 Google Yayıncı Etiketleri geliştirici anketinde düşüncelerinizi paylaşarak Google Yayıncı Etiketi geliştirici deneyimini iyileştirmeye yardımcı olun.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

GPT Referansı

Bu referansta, türleri açıklamak için TypeScript gösterimi kullanılmaktadır. Aşağıdaki tabloda bir kısa ve öz bir açıklamadır.

İfade yazın
`string`	Temel dize türü.
`string[]`	Değerlerin yalnızca dize olabileceği bir dizi türü.
`number \| string`	Değerin bir sayı veya dize olabileceği birleşim türü.
`Array<number \| string>`	Değerlerin karmaşık (birlikte) türünde olduğu bir dizi türü.
`[number, string]`	Değer, bir sayı ve bu sırayla bir dize içermesi gereken iki öğeli bir dizidir.
`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ı ziyaret edin.

Ek açıklamalar yazın

Değişken, parametre adı, özellik adı veya işlev imzasından sonra gelen iki nokta üst üste işareti, kullanabilirsiniz. Tür ek açıklamaları, iki nokta işaretinin solundaki öğenin türlerini açıklar kabul edebilir veya geri dönebilir. Aşağıdaki tabloda, bu referanstan yararlanabilirsiniz.

Ek açıklama türü
`param: string`	`param` işlevinin bir dize değerini kabul ettiğini veya döndürdüğünü belirtir. Bu söz dizimi kullanılır özellikleri ve dönüş türlerini ifade eder.
`param?: number \| string`	`param` değerinin isteğe bağlı olduğunu belirtir, ancak sayı veya dize kabul eder belirtir. Bu söz dizimi, parametreler ve özellikler için kullanılır.
`...params: Array<() => void>`	`params` öğesinin dinlenme parametresi . Dinlenme parametreleri, belirtilen tür.

. Tür Tanımları

Türler
`googletag.GeneralSize`	`SingleSize \| MultiSize`
Alan için bir veya daha fazla boyut olabilecek geçerli bir boyut yapılandırması.
`googletag.MultiSize`	`SingleSize[]`
Tek bir geçerli boyutların listesi.
`googletag.NamedSize`	`"fluid" \| ["fluid"]`
Bir alanın sahip olabileceği adlandırılmış boyutlar. Çoğu durumda boyut sabit boyutlu bir dikdörtgendir, ancak başka tür boyut özelliklerine ihtiyaç duyduğumuz bazı durumlar da vardır. Yalnızca aşağıdakiler geçerli adlandırılmış boyutlardır: Değişken: Reklam kapsayıcısı, üst div öğesinin% 100 genişliğini alır ve daha sonra yüksekliğini reklam öğesi içeriğine sığacak şekilde yeniden boyutlandırır. Bir sayfadaki normal blok öğelerinin davranışına benzer. Doğal reklamlar için kullanılır (ilgili makaleyi inceleyin). Alan boyutunu değişken olarak tanımlamak için hem `fluid` hem de `['fluid']` kabul edilebilir biçimler olduğunu unutmayın.
`googletag.SingleSize`	`SingleSizeArray \| NamedSize`
Alan için tek bir geçerli boyut.
`googletag.SingleSizeArray`	`[number, number]`
[Genişlik, yükseklik] değerini temsil eden iki sayı dizisi.
`googletag.SizeMapping`	`[SingleSizeArray, GeneralSize]`
Görüntü alanı boyutunun reklam boyutlarıyla eşleştirilmesi. Duyarlı reklamlar için kullanılır.
`googletag.SizeMappingArray`	`SizeMapping[]`
Boyut eşlemeleri listesi.
`googletag.config.InterstitialTrigger`	`"unhideWindow" \| "navBar"`
Desteklenen geçiş reklamı tetikleyicileri.
`googletag.config.PrivacyTreatment`	`"disablePersonalization"`
Desteklenen yayıncı gizlilik işlemleri.
`googletag.config.Taxonomy`	`"IAB_AUDIENCE_1_1" \| "IAB_CONTENT_2_2"`
Yayıncı tarafından sağlanan sinyaller (PPS) için desteklenen sınıflandırmalar.
`googletag.secureSignals.SecureSignalProvider`	`BidderSignalProvider \| PublisherSignalProvider`
Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü. `id` veya `networkCode` özelliklerinden biri sağlanmalıdır ancak ikisi birden sağlanmamalıdır.

Sıralama Türleri

Sıralamalar
`googletag.enums.OutOfPageFormat`	GPT tarafından desteklenen sayfa dışı biçimler.
`googletag.enums.TrafficSource`	GPT tarafından desteklenen trafik kaynakları.

`googletag.enums.OutOfPageFormat`

GPT tarafından desteklenen sayfa dışı biçimler.
Aşağıdaki kaynakları da incelemenizi öneririz:
- defineOutOfPageSlot

Değerler
`BOTTOM_ANCHOR`	Alanın görüntü alanının alt kısmında kaldığı sabit reklam biçimi.
`GAME_MANUAL_INTERSTITIAL`	Oyun manuel geçiş reklamı biçimi. Not: Oyun manuel geçiş reklamı sınırlı erişimli bir biçimdir.
`INTERSTITIAL`	Web geçiş reklamı biçimi.
`LEFT_SIDE_RAIL`	Sol yan reklam sütunu biçimi.
`REWARDED`	Ödüllü reklam biçimi.
`RIGHT_SIDE_RAIL`	Sağ yan reklam sütunu biçimi.
`TOP_ANCHOR`	Alanın görüntü alanının üst kısmında kaldığı sabit reklam biçimi.

`googletag.enums.TrafficSource`

GPT tarafından desteklenen trafik kaynakları.
Aşağıdaki kaynakları da incelemenizi öneririz:
- PrivacySettingsConfig.trafficSource

Değerler
`ORGANIC`	Doğrudan URL girişi, site arama veya uygulama indirme.
`PURCHASED`	Sahip olunan mülklerin dışındaki mülklerden yönlendirilen trafik (edinilen veya başka şekilde teşvik edilen etkinlikler).

googletag

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

Değişken Özeti
`apiReady`	GPT API'sinin yüklendiğini ve çağrılmaya hazır olduğunu gösteren işaret
`cmd`	GPT ile ilgili çağrıların eşzamansız olarak yürütülmesi için genel komut kuyruğu referansı.
`pubadsReady`	`PubAdsService` hizmetinin etkin, yüklü ve tamamen çalışır durumda olduğunu gösteren işaret.
`secureSignalProviders`	Güvenli sinyal sağlayıcıları dizisine başvuru.

İşlev Özeti
`companionAds`	Bir `CompanionAdsService` referansı döndürür.
`defineOutOfPageSlot`	Belirtilen reklam birimi yolunu kullanarak sayfa dışı bir reklam alanı oluşturur.
`defineSlot`	Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bunu, reklamı içeren sayfadaki bir div öğesinin kimliğiyle ilişkilendirir.
`destroySlots`	Belirtilen alanları kaldırarak ilgili tüm nesneleri ve bu alanların referanslarını GPT'den kaldırır.
`disablePublisherConsole`	Google Yayıncı Konsolu'nu devre dışı bırakır.
`display`	Alan hizmetlerine, alanı oluşturmasını söyler.
`enableServices`	Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.
`getVersion`	GPT'nin geçerli sürümünü döndürür.
`openConsole`	Google Yayıncı Konsolu'nu açar.
`pubads`	Bir `PubAdsService` referansı döndürür.
`setAdIframeTitle`	Bu noktadan itibaren `PubAdsService` tarafından oluşturulan tüm reklam kapsayıcısı iframe'lerinin başlığını ayarlar.
`setConfig`	Sayfaya ilişkin genel yapılandırma seçeneklerini ayarlar.
`sizeMapping`	Yeni bir `SizeMappingBuilder` oluşturur.

. googletag.apiReady

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

. googletag.cmd

cmd: Array<(this: typeof globalThis) => void> | CommandArray
GPT ile ilgili çağrıların eşzamansız olarak yürütülmesi için genel komut kuyruğuna referans.

googletag.cmd değişkeni, sayfadaki GPT etiketi söz dizimiyle boş bir JavaScript dizisine başlatılır ve cmd.push, dizinin sonuna öğe ekleyen standart Array.push yöntemidir. GPT JavaScript yüklendiğinde diziye göz atar ve tüm fonksiyonları sırayla yürütür. Daha sonra komut dosyası, cmd değerini, kendisine geçirilen işlev bağımsız değişkenini yürütmek için push yöntemi tanımlanmış bir CommandArray nesnesiyle değiştirir. Bu mekanizma, tarayıcının sayfayı oluşturmaya devam etmesine izin verirken, JavaScript'i eşzamansız şekilde alarak GPT'nin algılanan gecikmeyi azaltmasına olanak verir.

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

. googletag.pubadsReady

pubadsReady: boolean | undefined
PubAdsService hizmetinin etkin, yüklü ve tamamen çalışır durumda olduğunu gösteren işaret. Bu özellik, enableServices çağrılana ve PubAdsService yüklenip başlatılana kadar yalnızca undefined olur.

. googletag.secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined
Güvenli sinyal sağlayıcıları dizisine referans.

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Güvenli sinyalleri teklif verenlerle paylaşma

. googletag.companionAds

companionAds(): CompanionAdsService
Bir CompanionAdsService referansı döndürür.

İadeler
`CompanionAdsService`	Tamamlayıcı Reklamlar hizmeti.

. googletag.defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
Belirtilen reklam birimi yoluyla sayfa dışı bir reklam alanı oluşturur.

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

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Parametreler
`adUnitPath: string`	Ağ kodu ve reklam birimi koduyla birlikte tam reklam birimi yolu.
`div?: string \| OutOfPageFormat`	Bu reklam birimini veya OutOfPageFormat'ı içerecek div'in kimliği.

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

. googletag.defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null
Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bunu, reklamı içeren 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 koduyla birlikte tam reklam birimi yolu.
`size: GeneralSize`	Eklenen alanın genişliği ve yüksekliği. Duyarlı boyut eşlemesi sağlanmamışsa veya görüntü alanının boyutu, eşlemede sağlanan en küçük boyuttan daha küçükse reklam isteğinde kullanılan boyuttur.
`div?: string`	Bu reklam birimini içerecek div'in kimliği.

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

. googletag.destroySlots

destroySlots(slots?: Slot[]): boolean
Belirtilen alanları kaldırarak ilgili tüm nesneleri ve bu alanların referanslarını GPT'den kaldırır. Bu API, geri verilen gösterim alanlarını ve tamamlayıcı alanları desteklemez.

Bir alanda bu API'nin çağrılması, reklamı temizler ve alan nesnesini GPT tarafından korunan dahili durumdan kaldırır. Alan nesnesinde daha fazla işlev çağrıldığında, tanımlanmamış davranış ortaya çıkar. Bu yuvaya yapılan bir referans yayıncı sayfası tarafından korunursa tarayıcının söz konusu yuvayla ilişkili bellekte yine de yer açamayabileceğini unutmayın. Bu API'nin çağrılması, söz konusu alanla ilişkili div'in yeniden kullanılabilmesini sağlar.

Özellikle, bir alanın kaldırılması, reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez. Bir alanın div öğesi 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
`slots?: Slot[]`	Yok edilecek alan dizisi. Dizi isteğe bağlıdır; belirtilmezse tüm alanlar silinir.

İadeler
`boolean`	Alanlar kaldırıldıysa `true`, aksi takdirde `false`.

. googletag.disablePublisherConsole

disablePublisherConsole(): void
Google Yayıncı Konsolu'nu devre dışı bırakır.
Aşağıdaki kaynakları da incelemenizi öneririz:
- Google Yayıncı Konsolu

. googletag.display

display(divOrSlot: string | Element | Slot): void
Alan hizmetlerine, alanı oluşturmasını söyler. Her reklam alanı sayfa başına yalnızca bir kez görüntülenmelidir. Tüm alanlar görüntülenmeden önce tanımlanmalı ve bunlarla ilişkilendirilmiş bir hizmete sahip olmalıdır. Öğe DOM'de mevcut olana kadar display çağrısı gerçekleşmemelidir. Bunun için genellikle yöntem, yöntem çağrısında adı verilen div öğesindeki bir komut dosyası bloğunun içine yerleştirmektir.

Tekli istek mimarisi (SRA) kullanılıyorsa bu yöntem çağrıldığı sırada getirilmemiş tüm reklam alanları tek seferde getirilir. Reklam alanını görüntülenmemeye zorlamak için div'in tamamı kaldırılmalıdır.
Örnek
JavaScript

googletag.cmd.push(() => { googletag.display("div-1"); });
JavaScript (eski)

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

googletag.cmd.push(() => { googletag.display("div-1"); });
Aşağıdaki kaynakları da incelemenizi öneririz:

Parametreler
`divOrSlot: string \| Element \| Slot`	Reklam alanını veya div öğesini içeren div öğesinin ya da alan nesnesinin kimliği. Bir div öğesi sağlanırsa "id" değeri bulunmalıdır. `defineSlot` içine geçirilen kimlikle eşleşen özellik.

. googletag.enableServices

enableServices(): void
Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.

. googletag.getVersion

getVersion(): string
GPT'nin geçerli sürümünü döndürür.
Aşağıdaki kaynakları da incelemenizi öneririz:
- GPT sürüm geçmişi

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

. googletag.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
`div?: string`	Reklam alanı div kimliği. Bu değer isteğe bağlıdır. Sağlandığında Yayıncı Konsolu, görüntülenen belirtilen reklam alanının ayrıntılarıyla açılmaya çalışır.

. googletag.pubads

pubads(): PubAdsService
Bir PubAdsService referansı döndürür.

İadeler
`PubAdsService`	Yayıncı Reklamları hizmeti.

. googletag.setAdIframeTitle

setAdIframeTitle(title: string): void
Bu noktadan itibaren PubAdsService tarafından oluşturulan tüm reklam kapsayıcısı iframe'lerinin başlığını ayarlar.

Örnek

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (eski)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

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

. googletag.setConfig

setConfig(config: PageSettingsConfig): void
Sayfaya ilişkin genel yapılandırma seçeneklerini ayarlar.

Parametreler
`config: PageSettingsConfig`

. googletag.sizeMapping

sizeMapping(): SizeMappingBuilder
Yeni bir SizeMappingBuilder oluşturur.
Aşağıdaki kaynakları da incelemenizi öneririz:
- Reklam boyutları: Duyarlı reklamlar

İadeler
`SizeMappingBuilder`	Yeni bir oluşturucu.

. googletag.CommandArray

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

Yöntem Özeti
`push`	Sırayla bağımsız değişkenlerde belirtilen işlev sırasını yürütür.

push

push(...f: Array<(this: typeof globalThis) => void>): number
Sırayla bağımsız değişkenlerde belirtilen işlev sırasını 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
`...f: Array<(this: typeof globalThis) => void>`	Yürütülecek bir JavaScript işlevi. Çalışma zamanı bağlaması her zaman `globalThis` olur. Kapanış kelimesel bağlamının `this` değerini korumak için bir ok işlevi iletmeyi deneyin.

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

. googletag.CompanionAdsService

. Uzatmalar Service

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

Yöntem Özeti
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi ayarlamanızı ve çağırmanızı sağlayan bir işleyici kaydeder. Devralındığı grup: `googletag.Service.addEventListener`
`getSlots`	Bu hizmetle ilişkili slotların listesini alın. Devralındığı grup: `googletag.Service.getSlots`
`removeEventListener`	Önceden kaydedilmiş bir dinleyiciyi kaldırır. Devralındığı grup: `googletag.Service.removeEventListener`
`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

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void
Doldurulmamış tamamlayıcı alanlarının otomatik olarak doldurulup doldurulmayacağını belirler.

Bu yöntem, dolguyu etkinleştirmek ve devre dışı bırakmak için sayfanın kullanım süresi boyunca birden fazla kez çağrılabilir. Yalnızca PubAdsService ile de kayıtlı olan alanlar doldurulur. Politika kısıtlamaları nedeniyle bu yöntem, Ad Exchange videosu yayınlandığında boş tamamlayıcı alanları dolduracak şekilde tasarlanmamıştır.

Örnek

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (eski)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Parametreler
`value: boolean`	Doldurulmayan alanları otomatik olarak doldurmak için `true`, değiştirilmemeleri için `false`.

. googletag.PrivacySettingsConfig

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

Tesis Özeti
`childDirectedTreatment`	Sayfanın çocuklara yönelik olarak ele alınıp alınmayacağını belirtir.
`limitedAds`	Yayıncının yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını sınırlı reklamlar modunda çalışacak şekilde etkinleştirir.
`nonPersonalizedAds`	Yayıncıların yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını kişiselleştirilmemiş reklamlar modunda çalışacak şekilde etkinleştirir.
`restrictDataProcessing`	Yayıncının yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını kısıtlı işleme modunda çalışacak şekilde etkinleştirir.
`trafficSource`	İsteklerin satın alınmış 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 gelen kullanıcılar olarak işaretlenip işaretlenmeyeceğini belirtir.

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

Gizlilik ayarlarını yapılandırma

childDirectedTreatment

childDirectedTreatment: null | boolean
Sayfanın çocuklara yönelik olarak ele alınıp alınmayacağını belirtir. Yapılandırmayı temizlemek için değeri null olarak ayarlayın.

limitedAds

limitedAds: boolean
Yayıncının yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayını sınırlı reklamlar modunda çalışacak şekilde etkinleştirir.

GPT'ye sınırlı reklamlar istemesini iki şekilde söyleyebilirsiniz:
- IAB TCF 2.0 sürümü kullanıcı rızası yönetim platformundan gelen sinyal kullanılarak otomatik olarak.
- Manuel olarak bu alanın değerini true olarak ayarlayarak.
Sınırlı reklamları manuel olarak yapılandırmak, yalnızca GPT sınırlı reklam URL'sinden yüklendiğinde mümkündür. GPT standart URL'den yüklendiğinde bu ayarın değiştirilmesi bir Yayıncı Konsolu uyarısı oluşturur.

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Sınırlı reklam yayınlama

nonPersonalizedAds

nonPersonalizedAds: boolean
Yayıncıların yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını kişiselleştirilmemiş reklamlar modunda çalışacak şekilde etkinleştirir.

restrictDataProcessing

restrictDataProcessing: boolean
Yayıncının yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını kısıtlı işleme modunda çalışacak şekilde etkinleştirir.

trafficSource

trafficSource: TrafficSource
İsteklerin satın alınmış trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir. Bu değer, Ad Manager raporlarında Trafik kaynağı boyutunu doldurur. Politika ayarlanmazsa trafik kaynağı raporlarda varsayılan olarak undefined değerine ayarlanır.

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

underAgeOfConsent

underAgeOfConsent: null | boolean
Reklam isteklerinin, reşit olma yaşının altındaki kullanıcılardan gelen kullanıcılar olarak işaretlenip işaretlenmeyeceğini belirtir. Yapılandırmayı temizlemek için değeri null olarak ayarlayın.

. googletag.PubAdsService

. Uzatmalar Service

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

Yöntem Özeti
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi ayarlamanızı ve çağırmanızı sağlayan bir işleyici kaydeder. Devralındığı grup: `googletag.Service.addEventListener`
`clear`	Belirtilen alanlardaki reklamları kaldırır ve bunları boş içerikle değiştirir.
`clearCategoryExclusions`	Tüm sayfa düzeyi reklam kategorisi hariç tutma etiketlerini temizler.
`clearTargeting`	Belirli bir anahtara veya tüm anahtarlara ait özel hedefleme parametrelerini temizler.
`collapseEmptyDivs`	Gösterilecek reklam içeriği olmadığında alan div'lerinin sayfada yer kaplamaması için daraltılmasını etkinleştirir.
`disableInitialLoad`	Sayfa yüklemede 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şturur ve gösterir.
`enableLazyLoad`	GPT'de, yapılandırma nesnesi tarafından tanımlandığı şekilde geç yüklemeyi etkinleştirir.
`enableSingleRequest`	Aynı anda birden fazla reklam getirmek için tekli istek modunu etkinleştirir.
`enableVideoAds`	GPT'ye, sayfada video reklamların olacağı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 slotların listesini alın. Devralındığı grup: `googletag.Service.getSlots`
`getTargeting`	Ayarlanmış belirli bir özel hizmet düzeyinde hedefleme parametresini döndürür.
`getTargetingKeys`	Ayarlanmış tüm özel hizmet düzeyinde hedefleme anahtarlarının listesini döndürür.
`isInitialLoadDisabled`	Reklam için ilk isteklerin önceki bir `PubAdsService.disableInitialLoad` çağrısı tarafından başarıyla devre dışı bırakılıp bırakılmadığını döndürür.
`refresh`	Sayfadaki belirli alanlar veya tüm alanlar için yeni reklamlar getirir ve görüntüler.
`removeEventListener`	Önceden kaydedilmiş bir dinleyiciyi kaldırır. Devralındığı grup: `googletag.Service.removeEventListener`
`set`	Yayıncı Reklamları hizmeti altındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.
`setCategoryExclusion`	Belirli bir etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.
`setCentering`	Reklamların yatay olarak ortalaması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 sitelerindeki konum bilgilerini aktarır.
`setPrivacySettings`	Yapılandırma nesnesi kullanarak tek bir API'den tüm gizlilik ayarlarının yapılandırılmasına olanak tanır.
`setPublisherProvidedId`	Yayıncı tarafından sağlanan kimlik için değeri ayarlar.
`setSafeFrameConfig`	SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar.
`setTargeting`	Belirli bir anahtara yönelik olarak tüm Yayıncı Reklamları hizmet reklam alanları için geçerli olan özel hedefleme parametrelerini ayarlar.
`setVideoContent`	Hedefleme ve içerik hariç tutma amaçlarına yönelik reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar.
`updateCorrelator`	Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirir ve etkin bir şekilde yeni bir sayfa görüntüleme başlatır.

clear

clear(slots?: Slot[]): boolean
Belirtilen alanlardaki reklamları kaldırır ve bunları boş içerikle değiştirir. Alanlar, getirilmedi olarak işaretlenecektir.

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

Örnek

JavaScript

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

// This call to 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
`slots?: Slot[]`	Temizlenecek alan dizisi. Dizi isteğe bağlıdır; belirtilmezse tüm alanlar temizlenir.

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

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService
Tüm sayfa düzeyi reklam kategorisi hariç tutma etiketlerini temizler. Alanı yenilemek istiyorsanız bu yararlı bir özelliktir.

Ö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 anahtara veya tüm anahtarlara ait ö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 hedefleme

Parametreler
`key?: string`	Hedefleme parametresi anahtarı. Bu anahtar isteğe bağlıdır. belirtilmediyse tüm hedefleme parametreleri temizlenir.

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

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
Gösterilecek reklam içeriği olmadığında alan div'lerinin sayfada yer kaplamaması için daraltılmasını etkinleştirir. Bu mod, hizmet etkinleştirilmeden önce ayarlanmalıdır.
Aşağıdaki kaynakları da incelemenizi öneririz:
- Boş reklam alanlarını daraltma
- Düzen kaymasını en aza indirme

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

İadeler
`boolean`	Div daraltma modu etkinse `true`, yöntem hizmet etkinleştirildikten sonra çağrıldığı için daraltma modu etkinleştirilemiyorsa `false` değerini döndürür.

disableInitialLoad

disableInitialLoad(): void
Sayfa yüklemede reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam isteğinde bulunulmasına izin verir. Bunun, hizmet etkinleştirilmeden önce ayarlanması gerekir. Eş zamansız mod kullanılmalıdır; Aksi takdirde, refresh kullanarak reklam isteğinde bulunamazsınız.
Aşağıdaki kaynakları da incelemenizi öneririz:
- Reklam yüklemeyi kontrol etme ve yenileme
- SRA toplu işlemesini kontrol etme

display

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve gösterir. Bu yöntem tekli istek modunda çalışmaz.

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

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

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

enableLazyLoad

enableLazyLoad(config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }): void
GPT'de, yapılandırma nesnesi tarafından tanımlandığı şekilde geç yüklemeyi etkinleştirir. Daha ayrıntılı örnekler için Geç yükleme örneğine bakın.

Not: SRA'da geç getirme yalnızca tüm alanlar getirme kenar boşluğunun dışında olduğunda ç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:

Parametreler

Parametreler
`config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }`	Yapılandırma nesnesi, geç davranışın özelleştirilmesine olanak tanır. Atlanan yapılandırmalarda, Google tarafından zaman içinde ayarlanacak varsayılan bir ayar kullanılır. Getirme kenar boşluğu gibi belirli bir ayarı devre dışı bırakmak için değeri `-1` olarak ayarlayın. `fetchMarginPercent` Reklamı görüntü alanı boyutunun yüzdesi olarak getirebilmemiz için, alanın mevcut görüntü alanına olan minimum mesafesi 0 değeri, "alan görüntü alanına girdiğinde", 100 değeri "reklamın 1 görüntü alanı uzakta olduğu zaman" anlamına gelir. `renderMarginPercent` Bir reklam oluşturulmadan önce alanın geçerli görüntü alanından minimum mesafe olması gerekir. Bu, reklamın önceden getirilmesini ancak diğer alt kaynakların oluşturulup indirilmesini beklemenize olanak tanır. Değer, görüntü alanının yüzdesi olarak `fetchMarginPercent` gibi çalışır. `mobileScaling` Mobil cihazlarda kenar boşluklarına uygulanan bir çarpan. Bu, mobil ve masaüstünde kâr marjlarının değişmesine olanak tanır. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir alanın getirme ve oluşturma işleminden önce ulaşabileceği minimum mesafeyi artırır.

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

Yapılandırma nesnesi, geç davranışın özelleştirilmesine olanak tanır. Atlanan yapılandırmalarda, Google tarafından zaman içinde ayarlanacak varsayılan bir ayar kullanılır. Getirme kenar boşluğu gibi belirli bir ayarı devre dışı bırakmak için değeri -1 olarak ayarlayın.

fetchMarginPercent

Reklamı görüntü alanı boyutunun yüzdesi olarak getirebilmemiz için, alanın mevcut görüntü alanına olan minimum mesafesi 0 değeri, "alan görüntü alanına girdiğinde", 100 değeri "reklamın 1 görüntü alanı uzakta olduğu zaman" anlamına gelir.
renderMarginPercent

Bir reklam oluşturulmadan önce alanın geçerli görüntü alanından minimum mesafe olması gerekir. Bu, reklamın önceden getirilmesini ancak diğer alt kaynakların oluşturulup indirilmesini beklemenize olanak tanır. Değer, görüntü alanının yüzdesi olarak fetchMarginPercent gibi çalışır.
mobileScaling

Mobil cihazlarda kenar boşluklarına uygulanan bir çarpan. Bu, mobil ve masaüstünde kâr marjlarının değişmesine olanak tanır. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir alanın getirme ve oluşturma işleminden önce ulaşabileceği minimum mesafeyi artırır.

enableSingleRequest

enableSingleRequest(): boolean
Aynı anda birden fazla reklam getirmek için tekli istek modunu etkinleştirir. Bu, hizmetin etkinleştirilmesinden önce tüm Yayıncı Reklamları alanlarının tanımlanmasını ve PubAdsService'e eklenmesini gerektirir. Hizmet etkinleştirilmeden önce tekli istek modu ayarlanmalıdır.
Aşağıdaki kaynakları da incelemenizi öneririz:
- Ads en iyi uygulamaları: Tekli İstek Mimarisini doğru kullanma
- SRA toplu işlemesini kontrol etme

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

enableVideoAds

enableVideoAds(): void
GPT'ye, sayfada video reklamların olacağını bildirir. Bu seçenek, görüntülü ve video reklamlarda rakip hariç tutma kısıtlamaları sağlar. Video içeriği biliniyorsa görüntülü reklamlarda içerik hariç tutmayı kullanabilmek için PubAdsService.setVideoContent numaralı telefonu arayı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ı için geçerli değer veya anahtar yoksa `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üzeyinde 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 veya böyle bir anahtar yoksa boş bir diziyle ilişkilendirilen değerler.

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 anahtarları dizisi. Sıralama tanımlanmadı.

isInitialLoadDisabled

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

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

refresh

refresh(slots?: null | Slot[], options?: { changeCorrelator: boolean }): void
Sayfadaki belirli alanlar veya tüm alanlar için yeni reklamlar getirir ve görüntüler. Yalnızca eşzamansız oluşturma modunda çalışır.

Tüm tarayıcılarda doğru davranış için refresh çağrısından önce reklam alanına display çağrısı gelmelidir. display çağrısı atlanırsa yenileme beklenmedik şekilde davranabilir. İstenirse display ürününün reklam getirmesini durdurmak için PubAdsService.disableInitialLoad yöntemi kullanılabilir.

Alanın yenilenmesi, eski reklamı GPT'nin uzun süreli sayfa görüntüleme özelliğinden kaldırır. Böylece gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez.

Örnek

JavaScript

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

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

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

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

Parametreler

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

slots?: null | Slot[]

Yenilenecek alanlar. Dizi isteğe bağlıdır; belirtilmezse tüm alanlar yenilenir.

options?: { changeCorrelator: boolean }

Bu yenileme çağrısıyla ilişkili yapılandırma seçenekleri.

changeCorrelator

Reklamları getirmek için yeni bir ilişkilendirici oluşturulup oluşturulmayacağını belirtir. Reklam sunucularımız, bu ilişkilendirici değerini kısa bir süreliğine (şu anda 30 saniye için, ancak değişebilir) saklar. Böylece, aynı ilişkilendiriciye sahip, birbirine yakın zamanlarda alınan istekler tek bir sayfa görüntüleme olarak kabul edilir. Varsayılan olarak her yenileme için yeni bir ilişkilendirici oluşturulur.

Not: Bu seçeneğin, GPT'nin uzun ömürlü sayfa görüntüleme üzerinde herhangi bir etkisi yoktur. Bu, sayfadaki reklamları otomatik olarak yansıtır ve geçerlilik süresi yoktur.

set

set(key: string, value: string): PubAdsService
Yayıncı Reklamları hizmeti altındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.

Aynı anahtar için bunu birden fazla kez çağırmak, o anahtar için daha önce ayarlanmış olan değerleri geçersiz kılar. display veya refresh çağrılmadan önce tüm değerler 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
Belirli bir etiket adı için sayfa düzeyinde 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 ortalamasını etkinleştirir ve devre dışı bırakır. Ortalama varsayılan olarak devre dışıdır. Eski gpt_mobile.js'de ortalamalama varsayılan olarak etkindir.

Yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar ortalanacağından, 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ı ortalamak için `true`, sola hizalamak için `false`.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
Sayfadaki tüm 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ğıdaki hususları göz önünde bulundurun:
- Bu ayar yalnızca ilgili alanlar için yapılacak sonraki reklam istekleri için geçerli olur.
- Alan düzeyi ayarı (belirtilmişse) her zaman sayfa düzeyi ayarını geçersiz kılar.
- true olarak (alan düzeyinde veya sayfa düzeyinde) ayarlanırsa 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.
- Bununla birlikte, false olarak ayarlanır veya ayarlanmadan bırakılırsa reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
- Bu API, iFrame'lerinden çıkmaya çalışan veya doğrudan yayıncılar sayfasında oluşturulmalarını gerektiren reklam öğelerinin davranışını etkileyebileceği için 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:

Reklam öğelerini SafeFrame kullanarak oluşturma

Parametreler
`forceSafeFrame: boolean`	Sayfadaki tüm reklamların SafeFrame'lerde oluşturulmasını zorunlu tutmak için `true`, önceki ayarı false (yanlış) olarak değiştirmek için `false`. Daha önce belirtilmediğinde bu seçeneğin `false` olarak ayarlanması 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 sitelerindeki konum bilgilerini aktarır.

Ö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
Yapılandırma nesnesi kullanarak tek bir API'den tüm gizlilik ayarlarının 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:

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 kimlik için değeri 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 alfanümerik kimlik. 32 ile 150 karakter arasında olmalıdır.

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

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService
SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan anahtar için geçersiz değer iletildiğinde yapılandırmanın tamamı yoksayılır.

Bu sayfa düzeyindeki tercihler, belirtilirse alan düzeyinde tercihler tarafından 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:

Reklam öğelerini SafeFrame kullanarak 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 anahtara yönelik olarak tüm Yayıncı Reklamları hizmet reklam alanları için geçerli olan özel hedefleme parametrelerini ayarlar. Bu komut aynı anahtar için birden fazla kez çağrıldığında eski değerlerin üzerine yazılır. Bu anahtarlar, Google Ad Manager hesabınızda tanımlanmıştı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 hedefleme

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

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

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void
Hedefleme ve içerik hariç tutma amaçlarına yönelik 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`	Video içerik kimliği.
`videoCmsId: string`	Video İYS kimliği.

updateCorrelator

updateCorrelator(): PubAdsService
Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirir ve etkin bir şekilde yeni bir sayfa görüntüleme başlatır. İlişkilendirici, bir sayfa görüntülemeden gelen tüm reklam istekleri için aynıdır ve sayfa görüntülemeler arasında benzersizdir. Yalnızca eşzamansız modda geçerlidir.

Not: Bu durum, GPT'nin uzun süreli sayfa görüntüleme üzerinde herhangi bir etkiye sahip değildir. Sayfa görüntüleme, sayfadaki 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 nesne.

Tesis Özeti
`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

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ü reklamla ilişkili ödülü temsil eden bir nesne

Tesis Özeti
`amount`	Ödüle dahil edilen öğe sayısı.
`type`	Ödüle dahil edilen öğenin türü (örneğin, "madeni para").

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

Ödüllü reklam yayınlama

amount

amount: number
Ödüle dahil edilen öğe sayısı.

type

type: string
Ödüle dahil edilen öğenin türü (örneğin, "madeni para").

. googletag.SafeFrameConfig

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

Tesis Özeti
`allowOverlayExpansion`	SafeFrame'in, sayfa içeriğiyle yer paylaşımlı olarak reklam içeriğinin genişletilmesine izin verip vermediği.
`allowPushExpansion`	SafeFrame'in, sayfa içeriğini iterek reklam içeriğinin genişletilmesine izin verip vermediğ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 kullanmayacağı.

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

PubAdsService.setSafeFrameConfig

allowOverlayExpansion

allowOverlayExpansion: boolean
SafeFrame'in, sayfa içeriğiyle yer paylaşımlı olarak reklam içeriğinin genişletilmesine izin verip vermediği.

allowPushExpansion

allowPushExpansion: boolean
SafeFrame'in, sayfa içeriğini iterek reklam içeriğinin genişletilmesine izin verip vermediği.

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

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 aktarın.

Not: Bu özellik varsayılan olarak etkindir.

Desteği sonlandırıldı: Bu özellik artık devre dışı bırakılamaz. useUniqueDomain politikasının etkisi yok.

Aşağıdaki kaynakları da incelemenizi öneririz:
- Reklam öğelerini SafeFrame kullanarak oluşturma

. googletag.Service

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

Yöntem Özeti
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi ayarlamanızı ve çağırmanızı sağlayan bir işleyici kaydeder.
`getSlots`	Bu hizmetle ilişkili slotların listesini alın.
`removeEventListener`	Önceden kaydedilmiş bir dinleyiciyi kaldırır.

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 ayarlamanızı ve çağırmanızı sağlayan bir işleyici kaydeder. Aşağıdaki etkinlikler desteklenir:
Çağrı yapıldığında, uygun etkinlik türündeki bir nesne işleyiciye iletilir.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Reklam etkinliği işleyicileri

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

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

getSlots

getSlots(): Slot[]
Bu hizmetle ilişkili slotların listesini alın.

İadeler
`Slot[]`	Slotlar, hizmete eklendikleri sırayla gösterilir.

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (event: EventTypeMap[K]) => void): void
Önceden kaydedilmiş bir dinleyiciyi kaldırır.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Parametreler
`eventType: K`	GPT tarafından oluşturulan etkinlik türünü temsil eden bir dize. Etkinlik türleri büyük/küçük harfe duyarlıdır.
`listener: (event: EventTypeMap[K]) => void`	Tek bir etkinlik nesnesi bağımsız değişkenini 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 üzere sağlanmıştır.

Yöntem Özeti
`addSize`	Tek boyutlu bir diziden (görüntü alanını temsil eden) bir eşlemeyi, alanı temsil eden tek veya çok boyutlu bir diziye 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

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
Tek boyutlu bir diziden (görüntü alanını temsil eden) bir eşlemeyi, alanı temsil eden tek veya çok boyutlu bir diziye 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 alanın boyutları.

İadeler
`SizeMappingBuilder`	Bu oluşturucu için bir referans.

build

build(): null | SizeMappingArray
Bu oluşturucuya eklenen eşlemelerden bir boyut haritası spesifikasyonu oluşturur.

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

Not: Oluşturucunun bu yöntem çağrıldıktan sonraki davranışı tanımlanmamıştır.

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

. googletag.Slot

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

Yöntem Özeti
`addService`	Bu alana bir `Service` ekler.
`clearCategoryExclusions`	Bu alan için tüm alan 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 alan için minimum görüntü alanı boyutundan alan boyutuna kadar bir eşleme dizisi ayarlar.
`get`	Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
`getAdUnitPath`	Ağ kodu ve reklam birimi yoluyla birlikte reklam biriminin tam yolunu döndürür.
`getAttributeKeys`	Bu alanda ayarlanan özellik anahtarlarının listesini döndürür.
`getCategoryExclusions`	Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.
`getResponseInformation`	Reklam yanıtı bilgilerini döndürür.
`getSlotElementId`	Alan tanımlandığında sağlanan `div` alanının kimliğini döndürür.
`getTargeting`	Bu alanda ayarlanmış belirli bir özel hedefleme parametresini döndürür.
`getTargetingKeys`	Bu alanda ayarlanmış 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 hiç reklam olmadığında `div` alanının gizlenip gizlenmeyeceğini ayarlar.
`setConfig`	Bu alan için genel yapılandırma seçeneklerini ayarlar.
`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 alan düzeyinde tercihleri ayarlar.
`setTargeting`	Bu alan için özel hedefleme parametresi ayarlar.
`updateTargetingFromMap`	Bir JSON nesnesindeki key:value haritasından bu alan için özel hedefleme parametrelerini ayarlar.

addService

addService(service: Service): Slot
Bu alana bir Service 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:

Parametreler
`service: Service`	Eklenecek hizmet.

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

clearCategoryExclusions

clearCategoryExclusions(): Slot
Bu alan için tüm alan düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.

Ö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ığı alan 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 hedefleme

Parametreler
`key?: string`	Hedefleme parametresi anahtarı. Bu anahtar isteğe bağlıdır. belirtilmediyse tüm hedefleme parametreleri temizlenir.

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

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot
Bu alan için minimum görüntü alanı boyutundan alan boyutuna 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. Oluşturmak için `SizeMappingBuilder` aracını kullanabilirsiniz. Her boyut eşlemesi iki öğeden oluşan bir dizidir: `SingleSizeArray` ve `GeneralSize`.

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

get

get(key: string): null | string
Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür. Bu alan tarafından devralınan hizmet düzeyi özellikleri görmek için PubAdsService.get değerini 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ı için geçerli değer veya anahtar yoksa `null`.

getAdUnitPath

getAdUnitPath(): string
Ağ kodu ve reklam birimi yoluyla birlikte reklam biriminin tam yolunu döndürür.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
`string`	Reklam birimi yolu.

getAttributeKeys

getAttributeKeys(): string[]
Bu alanda ayarlanan özellik anahtarlarının listesini döndürür. Bu alan tarafından devralınan hizmet düzeyinde özelliklerin anahtarlarını görmek için PubAdsService.getAttributeKeys aracını 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 anahtarları dizisi. Sıralama tanımlanmadı.

getCategoryExclusions

getCategoryExclusions(): string[]
Bu alan için 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 hiçbiri ayarlanmamışsa boş dizi.

getResponseInformation

getResponseInformation(): null | ResponseInformation
Reklam yanıtı bilgilerini döndürür. Bu, alandaki son reklam yanıtını temel alır. Bu alan, reklam olmadığında çağrılırsa null döndürülür.

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

getSlotElementId

getSlotElementId(): string
Alan tanımlandığında sağlanan div alanını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`	Alan `div` Kimliği.

getTargeting

getTargeting(key: string): string[]
Bu alanda ayarlanmış 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 veya böyle bir anahtar yoksa boş bir diziyle ilişkilendirilen değerler.

getTargetingKeys

getTargetingKeys(): string[]
Bu alanda ayarlanmış tüm özel hedefleme anahtarlarının listesini döndürür. Hizmet düzeyindeki 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 anahtarları 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 ayarlanmış tüm değerleri geçersiz kılar.

Aynı anahtar için bu yöntemi birden fazla kez çağırmak, o anahtar için daha önce ayarlanmış olan değerleri geçersiz kılar. display veya refresh çağrılmadan önce tüm değerler 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ığı alan 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ığı alan nesnesi.

setClickUrl

setClickUrl(value: string): Slot
Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği tıklama URL'sini ayarlar.

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

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

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
Alanda hiç reklam olmadığında div alanının gizlenip gizlenmeyeceğini ayarlar. Bu işlem, 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:

Parametreler
`collapse: boolean`	Hiçbir reklam döndürülmezse alanın daraltılıp daraltılmayacağı.
`collapseBeforeAdFetch?: boolean`	Alan, reklam getirilmeden önce bile daraltılıp daraltılmayacağını belirler. Daraltma `true` değilse yoksayılır.

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

setConfig

setConfig(slotConfig: SlotSettingsConfig): void
Bu alan için genel yapılandırma seçeneklerini ayarlar.

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ğıdaki hususları göz önünde bulundurun:
- Bu ayar yalnızca ilgili alanlar için yapılacak sonraki reklam istekleri için geçerli olur.
- Alan düzeyi ayarı (belirtilmişse) her zaman sayfa düzeyi ayarını geçersiz kılar.
- true olarak (alan düzeyinde veya sayfa düzeyinde) ayarlanırsa 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.
- Bununla birlikte, false olarak ayarlanır veya ayarlanmadan bırakılırsa reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur.
- Bu API, iFrame'lerinden çıkmaya çalışan veya doğrudan yayıncılar sayfasında oluşturulmalarını gerektiren reklam öğelerinin davranışını etkileyebileceği için 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:

Reklam öğelerini SafeFrame kullanarak oluşturma

Parametreler
`forceSafeFrame: boolean`	Bu alandaki tüm reklamların SafeFrame'lerde oluşturulmasını zorunlu tutmak için `true` ve sayfa düzeyi ayarını (varsa) devre dışı bırakmak için `false`. Bu ayarın, sayfa düzeyinde belirtilmediğinde `false` olarak ayarlanması hiçbir şeyi değiştirmez.

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

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot
SafeFrame yapılandırması için alan düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan anahtar için geçersiz değer iletildiğinde yapılandırmanın tamamı yok sayılır.

Bu alan düzeyindeki tercihler, belirtilirse 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:

Reklam öğelerini SafeFrame kullanarak oluşturma

Parametreler
`config: null \| SafeFrameConfig`	Yapılandırma nesnesi.

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

setTargeting

setTargeting(key: string, value: string | string[]): Slot
Bu alan için özel hedefleme parametresi ayarlar. Bu yöntemi aynı anahtar için birden çok kez çağırmak, eski değerlerin üzerine yazılmasına neden olur. Burada ayarlanan değerler, hizmet düzeyinde ayarlanan hedefleme parametrelerinin üzerine yazılır. Bu anahtarlar, Google Ad Manager hesabınızda tanımlanmıştı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 hedefleme

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

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

updateTargetingFromMap

updateTargetingFromMap(map: { [adUnitPath: string]: string | string[] }): Slot
Bir JSON nesnesindeki key:value haritasından bu alan için özel hedefleme parametrelerini ayarlar. Bu, nesnenin tüm anahtar değerleri için Slot.setTargeting çağrısıyla aynıdır. Bu anahtarlar, Google Ad Manager hesabınızda tanımlanır.

Notlar:
- Üzerine yazma durumunda yalnızca son değer saklanır.
- Değer bir diziyse önceki herhangi bir değerin ü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ığı alan nesnesi.

. googletag.configAdExpansionConfig

Reklam genişletmeyi kontrol etmek için ayarlar.

Tesis Özeti
`enabled`	Reklam genişletmenin etkin veya devre dışı olup olmadığı.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

enabled

enabled: boolean
Reklam genişletmenin etkin mi yoksa devre dışı mı olduğu.

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

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

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

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

Protected Audience API Satıcı kılavuzu: Reklam açık artırmaları yürütme

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 bir açık artırma yapılandırma 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şkilendirilmiş yapılandırma anahtarı.

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

. googletag.configInterstitialConfig

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

Tesis Özeti
`triggers`	Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.

triggers

triggers: Partial<Record<InterstitialTrigger, boolean>>
Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.

Bir geçiş reklamı tetikleyicisinin değerinin true olarak ayarlanması, geçiş reklamı tetikleyicisini etkinleştirir ve false devre dışı bırakır. Bu, Google Ad Manager'da yapılandırılan varsayılan değerleri geçersiz kılar.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Web geçiş reklamı görüntüleme

. googletag.configPageSettingsConfig

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

Tek bir API çağrısı ile birden fazla özelliğin ayarlanmasını sağlar.

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

Örnekler:

Yalnızca 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, setConfig için yapılan her çağrıyla güncellenir.

  // Configure feature charlie to echo = 1, foxtrot = true.
  googletag.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  googletag.setConfig({
      charlie: {
          echo: 2
      }
  });

Bir özellikle ilgili tüm ayarlar null iletilerek 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,
  });

Tesis Özeti
`adExpansion`	Reklam genişletmeyi kontrol etmek için ayarlar.
`adYield`	Kullanımdan kaldırıldı. .
`pps`	Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etmek için kullanılan ayarlar.
`privacyTreatments`	Yayıncı gizlilik işlemlerini kontrol etmek için ayarlar.
`threadYield`	GPT'nin reklam öğelerini oluştururken JS iş parçacığını verip vermeyeceğini kontrol etmek için kullanılan ayar.

adExpansion

adExpansion: null | AdExpansionConfig
Reklam genişletmeyi kontrol etmek için ayarlar.

adYield

adYield: null | "DISABLED" | "ENABLED_ALL_SLOTS"

pps

pps: null | PublisherProvidedSignalsConfig
Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etmek için kullanılan ayarlar.

privacyTreatments

privacyTreatments: null | PrivacyTreatmentsConfig
Yayıncı gizlilik işlemlerini kontrol etmek için ayarlar.

threadYield

threadYield: null | "DISABLED" | "ENABLED_ALL_SLOTS"
GPT'nin, reklam öğeleri oluşturulurken JS iş parçacığı sağlayıp sağlamayacağını kontrol etmek için kullanılan ayar.

GPT, yalnızca Scheduler.postTask API'yi destekleyen tarayıcılardan veri getirir.

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Planlayıcı: postTask() yöntemi

. googletag.configPrivacyTreatmentsConfig

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

Tesis Özeti
`treatments`	Yayıncı gizliliği için etkinleştirebileceğiniz bir dizi seçenek.

treatments

treatments: "disablePersonalization"[]
Yayıncı gizliliği için etkinleştirebileceğiniz bir dizi seçenek.

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

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

Mülk Özeti
`taxonomies`	Sınıflandırma eşlemeleri içeren bir nesne.

Örnek

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '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 | 18-20'
      // '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 | 18-20'
      // '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:

taxonomies

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>
Sınıflandırma eşlemeleri içeren bir nesne.

. googletag.configSlotSettingsConfig

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

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

Aşağıda listelenen tüm özellikler örnek olarak verilmiştir ve setConfig 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 için yapılan her çağrıyla güncellenir.

  // Configure feature charlie to echo = 1, foxtrot = true.
  slot.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  slot.setConfig({
      charlie: {
          echo: 2
      }
  });

Bir özellikle ilgili tüm ayarlar null iletilerek 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,
  });

Mülk Özeti
`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.

adExpansion

adExpansion: AdExpansionConfig
Reklam genişletmeyi kontrol etmek için ayarlar.

componentAuction

componentAuction: ComponentAuctionConfig[]
Cihaz üzerinde reklam açık artırmasına dahil edilecek bir dizi bileşen açık artırması.

interstitial

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

. googletag.configTaxonomyData

Tek bir Sınıflandırmanın değerlerini içeren nesne.

Tesis Özeti
`values`	Sınıflandırma değerlerinin listesi.

values

values: string[]
Sınıflandırma değerlerinin listesi.

. googletag.eventsEvent

Tüm GPT etkinlikleri için Temel Arayüz. Aşağıdaki tüm GPT etkinlikleri aşağıdaki alanlara sahip olur.

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı.
`slot`	Etkinliği tetikleyen alan.

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

Reklam etkinliği işleyicileri

serviceName

serviceName: string
Etkinliği tetikleyen hizmetin adı.

slot

slot: Slot
Etkinliği tetikleyen alan.

. googletag.eventsEventTypeMap

Bu, bir etkinlik adını Service.addEventListener ve Service.removeEventListener için karşılık gelen etkinlik nesne türüyle eşleyen yapay bir türdür. Bu bilgiler yalnızca referans ve tür güvenliği amacıyla belgelenmiştir.

Tesis Özeti
`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.

. googletag.eventsGameManualInterstitialSlotClosedEvent

. Uzatmalar Event

Bu etkinlik, 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 biçimindedir.

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. googletag.eventsGameManualInterstitialSlotReadyEvent

. Uzatmalar 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 biçimidir.

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

Yöntem Özeti
`makeGameManualInterstitialVisible`	Oyunun manuel geçiş reklamını kullanıcıya gösterir.

Örnek

JavaScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
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:

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void
Oyunun manuel geçiş reklamını kullanıcıya gösterir.

. googletag.eventsImpressionViewableEvent

. Uzatmalar Event

Bu etkinlik, bir gösterim Aktif Görüntüleme ölçütlerine göre görüntülenebilir olduğunda tetiklenir.

Mülk Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. Uzatmalar Event

Bu etkinlik, ödüllü reklam alanı kullanıcı tarafından kapatıldığında tetiklenir. Bu reklamlar, bir ödül verilmeden önce ya da verildikten sonra etkinleşebilir. Bir ödülün verilip verilmediğini öğrenmek için bunun yerine events.RewardedSlotGrantedEvent işlevini kullanın.

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. googletag.eventsRewardedSlotGrantedEvent

. Uzatmalar Event

Bu etkinlik, ödüllü reklamın izlenmesi karşılığında ödül verildiğinde tetiklenir. Reklam, ödül verme ölçütleri karşılanmadan kapatılırsa bu etkinlik tetiklenmez.

Tesis Özeti
`payload`	Verilen ödülle ilgili bilgileri içeren bir nesne.
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

payload

payload: null | RewardedPayload
Verilen ödülle ilgili bilgileri içeren bir nesne.

. googletag.eventsRewardedSlotReadyEvent

. Uzatmalar Event

Bu etkinlik, ödüllü reklam gösterilmeye hazır olduğunda tetiklenir. Yayıncı, kullanıcıya reklamı görüntülemeden önce görüntüleme seçeneği sunmakla sorumludur.

Mülk Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

Yöntem Özeti
`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:

makeRewardedVisible

makeRewardedVisible(): void
Ödüllü reklamı gösterir. Bu yöntem, kullanıcı reklamı görüntülemeyi kabul edene kadar çağrılmamalıdır.

. googletag.eventsSlotOnloadEvent

. Uzatmalar Event

Bu etkinlik, reklam öğesinin iframe'i yükleme etkinliğini tetiklediğinde tetiklenir. Rich media reklamları eşzamanlı oluşturma modunda oluşturulurken herhangi bir iframe kullanılmaz. Bu nedenle SlotOnloadEvent tetiklenmez.

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. Uzatmalar Event

Bu etkinlik, reklam öğesi kodu bir alana yerleştirildiğinde tetiklenir. Bu etkinlik, reklam öğesinin kaynakları getirilmeden önce gerçekleşir. Bu nedenle reklam öğesi henüz görünmeyebilir. Bir alan için tüm reklam öğesi kaynaklarının ne zaman yüklendiğini bilmek istiyorsanız bunun yerine events.SlotOnloadEvent aracını kullanabilirsiniz.

Tesis Özeti
`advertiserId`	Oluşturulan reklamın reklamveren kimliği.
`campaignId`	Oluşturulan reklamın kampanya kimliği.
`companyIds`	Oluşturulan dolgu reklamı için teklif veren şirketlerin kimlikleri.
`creativeId`	Oluşturulan rezervasyon reklamının reklam öğesi kimliği.
`creativeTemplateId`	Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği.
`isBackfill`	Reklamın dolgu reklam olup olmadığı.
`isEmpty`	Alan için bir reklam döndürülüp döndürülmediği.
`labelIds`	Oluşturulan reklamın etiket kimlikleri.
`lineItemId`	Oluşturulan rezervasyon reklamının satır öğesi kimliği.
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`size`	Oluşturulan reklam öğesinin piksel boyutunu belirtir.
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`
`slotContentChanged`	Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği.
`sourceAgnosticCreativeId`	Oluşturulan rezervasyon veya dolgu reklamının reklam öğesi kimliği.
`sourceAgnosticLineItemId`	Oluşturulan rezervasyon veya dolgu reklamının satır öğesi kimliği.
`yieldGroupIds`	Oluşturulan dolgu reklam için 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("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

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

JavaScript (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("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

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

TypeScript

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

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

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

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

Reklam etkinliği işleyicileri

advertiserId

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

campaignId

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

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.

creativeId

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

creativeTemplateId

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

isBackfill

isBackfill: boolean
Reklamın dolgu reklam olup olmadığı. Reklam bir dolgu reklamsa true, aksi durumda 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 halde false olur.

labelIds

labelIds: null | number[]
Oluşturulan reklamın etiket kimlikleri. Boş alanlar, dolgu reklamlar ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null.

lineItemId

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

size

size: null | string | number[]
Oluşturulan reklam öğesinin piksel boyutunu belirtir. Örnek: [728, 90]. Boş reklam alanları için null değerindedir.

slotContentChanged

slotContentChanged: boolean
Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği. İçerik değiştirilmişse değer true, aksi takdirde false olur.

sourceAgnosticCreativeId

sourceAgnosticCreativeId: null | number
Oluşturulan rezervasyon veya dolgu reklamının reklam öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number
Oluşturulan rezervasyon veya dolgu reklamının satır öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi PubAdsService dışındaki hizmetler tarafından oluşturuluyorsa değer null olur.

yieldGroupIds

yieldGroupIds: null | number[]
Oluşturulan dolgu reklam için 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.

. googletag.eventsSlotRequestedEvent

. Uzatmalar Event

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

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. Uzatmalar Event

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

Tesis Özeti
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

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

. Uzatmalar Event

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

Tesis Özeti
`inViewPercentage`	Reklam alanının görünür olan yüzdesi.
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı grup: `googletag.events.Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı grup: `googletag.events.Event.slot`

Ö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

inViewPercentage

inViewPercentage: number
Reklam alanının görünür olan yüzdesi. Değer 0 ile 100 arasında bir sayıdır.

. googletag.secureSignalsBidderSignalProvider

Belirli bir teklif veren için güvenli bir sinyal döndürür.

Teklif veren güvenli sinyal sağlayıcısı 2 bölümden oluşur:

Güvenli bir sinyale dönüşen Promise döndüren bir toplayıcı işlevi.
Sinyalle ilişkili teklif vereni tanımlayan id.

Bir yayıncı için güvenli sinyal döndürmek amacıyla secureSignals.PublisherSignalProvider değerini kullanın.

Tesis Özeti
`collectorFunction`	.
`id`	Google Ad Manager'da kaydedildiği şekliyle bu güvenli sinyalle ilişkili toplayıcı için benzersiz bir tanımlayıcı.

Ö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

collectorFunction

collectorFunction: () => Promise<string>

id

id: string
Google Ad Manager'da kaydedildiği şekliyle bu güvenli sinyalle ilişkili toplayıcı için benzersiz bir tanımlayıcı.

. googletag.secureSignalsPublisherSignalProvider

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

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

Güvenli bir sinyale dönüşen Promise döndüren bir toplayıcı işlevi.
Sinyalle ilişkilendirilmiş yayıncıyı tanımlayan networkCode.

Teklif veren için güvenli bir sinyal döndürmek amacıyla secureSignals.BidderSignalProvider değerini kullanın.

Mülk Özeti
`collectorFunction`	.
`networkCode`	Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda göründüğü şekliyle).

Ö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

collectorFunction

collectorFunction: () => Promise<string>

networkCode

networkCode: string
Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda göründüğü şekliyle).

. googletag.secureSignalsSecureSignalProvidersArray

Güvenli sinyalleri yönetmeye yarayan bir arayüz.

Yöntem Özeti
`clearAllCache`	Tüm toplayıcılar için tüm sinyalleri önbellekten temizler.
`push`	Sinyal sağlayıcı dizisine yeni bir `secureSignals.SecureSignalProvider` ekler ve sinyal oluşturma sürecini başlatır.

clearAllCache

clearAllCache(): void
Tüm toplayıcılara ait tüm sinyalleri önbellekten temizler.

Bu yöntemin çağrılması, mevcut ve daha sonra gerçekleştirilen sayfa görüntülemeleri için reklam isteklerine sinyallerin dahil edilme olasılığını azaltabilir. Bu nedenle, yalnızca yeni bir kullanıcıyı belirten etkinlikler (giriş, çıkış, kaydolma vb.) gibi anlamlı durum değişiklikleri gerçekleştiğinde çağrılmalıdır.

push

push(provider: SecureSignalProvider): void
Sinyal sağlayıcı dizisine yeni bir secureSignals.SecureSignalProvider ekler ve sinyal oluşturma sürecini başlatır.

Parametreler
`provider: SecureSignalProvider`	Diziye eklenecek `secureSignals.SecureSignalProvider` nesnesi.

GPT Referansı

Ek açıklamalar yazın

. Tür Tanımları

googletag.GeneralSize

googletag.MultiSize

googletag.NamedSize

googletag.SingleSize

googletag.SingleSizeArray

googletag.SizeMapping

googletag.SizeMappingArray

googletag.config.InterstitialTrigger

googletag.config.PrivacyTreatment

googletag.config.Taxonomy

googletag.secureSignals.SecureSignalProvider

Sıralama Türleri

googletag.enums.OutOfPageFormat

googletag.enums.TrafficSource

googletag

. googletag.apiReady

JavaScript

JavaScript (eski)

TypeScript

. googletag.cmd

JavaScript

JavaScript (eski)

TypeScript

. googletag.pubadsReady

. googletag.secureSignalProviders

JavaScript

JavaScript (eski)

TypeScript

. googletag.companionAds

. googletag.defineOutOfPageSlot

JavaScript

JavaScript (eski)

TypeScript

. googletag.defineSlot

JavaScript

JavaScript (eski)

TypeScript

. googletag.destroySlots

JavaScript

JavaScript (eski)

TypeScript

. googletag.disablePublisherConsole

. googletag.display

JavaScript

JavaScript (eski)

TypeScript

. googletag.enableServices

. googletag.getVersion

. googletag.openConsole

JavaScript

JavaScript (eski)

TypeScript

. googletag.pubads

. googletag.setAdIframeTitle

JavaScript

JavaScript (eski)

TypeScript

. googletag.setConfig

. googletag.sizeMapping

. googletag.CommandArray

push

JavaScript

JavaScript (eski)

TypeScript

. googletag.CompanionAdsService

Devralındığı grup: googletag.Service.addEventListener

Devralındığı grup: googletag.Service.getSlots

Devralındığı grup: googletag.Service.removeEventListener

setRefreshUnfilledSlots

JavaScript

JavaScript (eski)

TypeScript

. googletag.PrivacySettingsConfig

childDirectedTreatment

limitedAds

JavaScript

JavaScript (eski)

`googletag.GeneralSize`

`googletag.MultiSize`

`googletag.NamedSize`

`googletag.SingleSize`

`googletag.SingleSizeArray`

`googletag.SizeMapping`

`googletag.SizeMappingArray`

`googletag.config.InterstitialTrigger`

`googletag.config.PrivacyTreatment`

`googletag.config.Taxonomy`

`googletag.secureSignals.SecureSignalProvider`

`googletag.enums.OutOfPageFormat`

`googletag.enums.TrafficSource`

Devralındığı grup: `googletag.Service.addEventListener`

Devralındığı grup: `googletag.Service.getSlots`

Devralındığı grup: `googletag.Service.removeEventListener`

Devralındığı grup: `googletag.Service.addEventListener`

Devralındığı grup: `googletag.Service.getSlots`

Devralındığı grup: `googletag.Service.removeEventListener`