Ürünlerimiz hakkında görüşlerinizi paylaşmak ve geri bildirimde bulunmak için Google Advertising and Measurement Community sunucusundaki resmi Ad Manager Discord kanalına katılın.

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

GPT Referansı

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

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

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

Yazı ek açıklamaları

Bir değişken, parametre adı, özellik adı veya işlev imzasından sonraki iki nokta üst üste, tür açıklamasını gösterir. Tür ek açıklamaları, iki nokta üst üstenin solundaki öğenin kabul edebileceği veya döndürebileceği türleri açıklar. Aşağıdaki tabloda, bu referansta görebileceğiniz tür ek açıklamalarına ilişkin örnekler gösterilmektedir.

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

googletag

Google yayıncı etiketinin API'si için kullandığı genel ad alanı.

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

Arayüzler
`CommandArray`	Komut dizisi, bir işlevler dizisini kabul eder ve bunları sırayla çağırır.
`CompanionAdsService`	Tamamlayıcı Reklamlar hizmeti.
`PrivacySettingsConfig`	Gizlilik ayarları için yapılandırma nesnesi.
`PubAdsService`	Yayıncı Reklamları hizmeti.
`ResponseInformation`	Tek bir reklam yanıtını temsil eden nesne.
`RewardedPayload`	Ödüllü reklamla ilişkili ödülü temsil eden bir nesne.
`Service`	Tüm hizmetler için ortak yöntemleri içeren temel hizmet sınıfı.
`SizeMappingBuilder`	Boyut eşleme spesifikasyon nesneleri için oluşturucu.
`Slot`	Alan, bir sayfadaki tek bir reklam alanını temsil eden bir nesnedir.

Tür Takma Adları
`GeneralSize`	Bir alan için geçerli bir boyut yapılandırması (bir veya birden fazla boyut olabilir).
`MultiSize`	Tek geçerli boyutların listesi.
`NamedSize`	Bir alanın sahip olabileceği adlandırılmış boyutlar.
`SingleSize`	Bir yer için geçerli tek boyut.
`SingleSizeArray`	[Genişlik, yükseklik] değerlerini temsil eden iki sayılık dizi.
`SizeMapping`	Görüntü alanı boyutu ile reklam boyutlarının eşlemesi.
`SizeMappingArray`	Boyut eşlemelerinin listesi.

Değişkenler
`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 sırasına referans.
`pubadsReady`	PubAdsService'in etkinleştirildiğini, yüklendiğini ve tamamen çalışır durumda olduğunu gösteren işaret.
`secureSignalProviders`	Güvenli sinyal sağlayıcıları dizisine referans.

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

Tür Takma Adları

GeneralSize

GeneralSize: SingleSize | MultiSize

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

MultiSize

MultiSize: SingleSize[]

Tek geçerli boyutların listesi.

NamedSize

NamedSize: "fluid" | ["fluid"]

Bir alanın sahip olabileceği adlandırılmış boyutlar. Çoğu durumda boyut, sabit boyutlu bir dikdörtgendir ancak başka boyut özellikleri gerektiği durumlar da vardır. Yalnızca aşağıdaki adlandırılmış boyutlar geçerlidir:

fluid: Reklam kapsayıcı, üst div'in% 100 genişliğini alır ve ardından yüksekliğini reklam öğesi içeriğine uyacak şekilde yeniden boyutlandırır. Bir sayfadaki normal blok öğelerin davranışına benzer. Doğal reklamlar için kullanılır (ilgili makaleye bakın). fluid ve ['fluid'] değerlerinin her ikisinin de bir yuva boyutunu akışkan olarak bildirmek için kabul edilebilir formlar olduğunu unutmayın.

SingleSize

SingleSize: SingleSizeArray | NamedSize

Bir yer için geçerli tek boyut.

SingleSizeArray

SingleSizeArray: [number, number]

[Genişlik, yükseklik] değerlerini temsil eden iki sayılık dizi.

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

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

SizeMappingArray

SizeMappingArray: SizeMapping[]

Boyut eşlemelerinin listesi.

Değişkenler

`Const` apiReady

apiReady: boolean | undefined

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

Asenkron işlemlerin işlenmesi için önerilen yöntemin, GPT hazır olduğunda geri çağırmaları sıraya almak üzere googletag.cmd'yi kullanmak olduğunu unutmayın. Bu geri çağırmaların, API ayarlandıktan sonra yürütüleceği garanti edildiğinden googletag.apiReady'yi kontrol etmesi gerekmez.

`Const` cmd

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

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

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

`Const` pubadsReady

pubadsReady: boolean | undefined

PubAdsService'in etkinleştirildiğini, yüklendiğini ve tamamen çalışır durumda olduğunu gösteren işaret. Bu özellik, enableServices işlevi çağrılıp PubAdsService yüklenip ilk kullanıma hazırlanana kadar yalnızca undefined olacaktır.

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Güvenli sinyalleri teklif verenlerle paylaşma

İşlevler

companionAds

companionAds(): CompanionAdsService

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

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

defineOutOfPageSlot

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

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

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

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

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

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

defineSlot

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

Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bunu, sayfada reklamı içerecek 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 yuvanın genişliği ve yüksekliği. Bu boyut, duyarlı boyut eşleme sağlanmadığında veya görüntü alanının boyutu eşlemede sağlanan en küçük boyuttan daha küçük olduğunda reklam isteğinde kullanılan boyuttur.
`Optional div: string`	Bu reklam birimini içerecek div'in kimliği.

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

destroySlots

destroySlots(slots?: Slot[]): boolean

Belirtilen alanları yok eder ve bu alanlarla ilgili tüm nesneleri ve referansları GPT'den kaldırır. Bu API, geri aktarma yuvalarını ve eşlik eden reklam yuvalarını desteklemez.

Bir yuvada bu API'nin çağrılması, reklamı temizler ve yuva nesnesini GPT tarafından korunan dahili durumdan kaldırır. Yuva nesnesinde başka işlevlerin çağrılması, tanımlanmamış davranışlara neden olur. Yayıncı sayfası tarafından bu yuvaya referans verilmeye devam ediyorsa tarayıcının, yuva ile ilişkili belleği boşaltmayabileceğini unutmayın. Bu API'yi çağırmak, söz konusu alanla ilişkili div'in yeniden kullanılmasına olanak tanır.

Özellikle, bir alanı devre dışı bırakmak reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, bu reklamı içeren reklam engellerinden veya rekabetçi hariç tutmalardan etkilenmez. Bir yuvanın div'i sayfadan kaldırılmadan önce bu işlevin çağrılmaması, tanımlanmamış davranışa neden olur.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

İadeler
`boolean`	Yuvalar yok edilmişse `true`, aksi takdirde `false`.

disablePublisherConsole

disablePublisherConsole(): void

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

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

Google Yayıncı Konsolu

display

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

Slot hizmetlerine, slotu oluşturma talimatı verir. Her reklam alanı sayfada yalnızca bir kez gösterilmelidir. Tüm yuvalar tanımlanmalı ve gösterilmeden önce bunlarla ilişkilendirilmiş bir hizmet olmalıdır. Öğe DOM'da mevcut olana kadar görüntüleme çağrısı yapılmamalıdır. Bunu yapmanın normal yolu, yöntemin çağrılmasında belirtilen div öğesi içindeki bir komut dosyası bloğuna yerleştirmektir.

Tekli istek mimarisi (SRA) kullanılıyorsa bu yöntem çağrıldığında getirilmemiş tüm reklam alanları aynı anda getirilir. Bir reklam alanının gösterilmemesini zorunlu kılmak için div'in tamamı kaldırılmalıdır.

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

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

enableServices

enableServices(): void

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

getConfig

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

setConfig ile ayarlanan sayfa için genel yapılandırma seçeneklerini alır.

Bu yöntem, tüm setConfig() özelliklerini desteklemez. Desteklenen özellikler şunlardır:

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

İadeler
`Pick<PageSettingsConfig, "adsenseAttributes" \| "disableInitialLoad" \| "targeting">`	Yuva için yapılandırma seçenekleri.

getVersion

getVersion(): string

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

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

GPT sürüm geçmişi

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

openConsole

openConsole(div?: string): void

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Google Yayıncı Konsolu

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

pubads

pubads(): PubAdsService

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

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

setAdIframeTitle

setAdIframeTitle(title: string): void

Bu noktadan itibaren PubAdsService tarafından oluşturulan tüm reklam kapsayıcı 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'lerinin yeni başlığı.

setConfig

setConfig(config: PageSettingsConfig): void

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

Parametreler
`config: PageSettingsConfig`

sizeMapping

sizeMapping(): SizeMappingBuilder

Yeni bir SizeMappingBuilder oluşturur.

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

Reklam boyutları: Duyarlı reklamlar

İadeler
`SizeMappingBuilder`	Yeni bir oluşturucu.

googletag.CommandArray

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

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

Yöntemler

push

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

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

googletag.CompanionAdsService

Uzatır Service

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

Yöntemler
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlayıp çağırmanıza olanak tanıyan bir dinleyici kaydeder. Devralındığı kaynak: `Service.addEventListener`
`getSlots`	Bu hizmetle ilişkili yerlerin listesini alın. Devralındığı kaynak: `Service.getSlots`
`removeEventListener`	Daha önce kaydedilmiş bir işleyiciyi kaldırır. Devralındığı kaynak: `Service.removeEventListener`
`setRefreshUnfilledSlots`	Doldurulmamış tamamlayıcı alanların otomatik olarak doldurulup doldurulmayacağını ayarlar.

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

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

Yöntemler

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void

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

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

Örnek

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (eski)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

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

googletag.PrivacySettingsConfig

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

Özellikler
`childDirectedTreatment?`	Sayfanın çocuklara yönelik olarak değerlendirilip değerlendirilmeyeceğini gösterir.
`limitedAds?`	Yayıncıların yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın sınırlı reklamlar modunda çalışmasını sağlar.
`nonPersonalizedAds?`	Yayıncının tüzüklere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın kişiselleştirilmemiş reklamlar modunda çalışmasını sağlar.
`restrictDataProcessing?`	Yayıncıların yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın kısıtlanmış işleme modunda çalışmasını sağlar.
`trafficSource?`	İsteklerin satın alınan trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir.
`underAgeOfConsent?`	Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geliyormuş gibi işaretlenip işaretlenmeyeceğini belirtir.

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

Gizlilik ayarlarını yapılandırma

Özellikler

`Optional` childDirectedTreatment

childDirectedTreatment?: boolean

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

`Optional` limitedAds

limitedAds?: boolean

Yayıncıların yasal düzenlemelere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın sınırlı reklam modunda çalışmasını sağlar.

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

IAB TCF 2.0 kullanıcı rızası yönetim platformundan gelen bir sinyal kullanılarak otomatik olarak.
Bu alanın değerini true olarak ayarlayarak manuel olarak.

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

CMP kullanıldığında sınırlı reklamların manuel olarak etkinleştirilmesinin gerekmediğini unutmayın.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Sınırlı reklam gösterme

`Optional` nonPersonalizedAds

nonPersonalizedAds?: boolean

Yayıncının tüzüklere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamanın kişiselleştirilmemiş reklamlar modunda çalışmasını sağlar.

`Optional` restrictDataProcessing

restrictDataProcessing?: boolean

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

`Optional` trafficSource

trafficSource?: TrafficSource

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

Örnek

JavaScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

JavaScript (eski)

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

TypeScript

// Indicate requests represent organic traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.ORGANIC,
});

// Indicate requests represent purchased traffic.
googletag.pubads().setPrivacySettings({
  trafficSource: googletag.enums.TrafficSource.PURCHASED,
});

`Optional` underAgeOfConsent

underAgeOfConsent?: boolean

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

googletag.PubAdsService

Uzatır Service

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

Yöntemler
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlayıp çağırmanıza olanak tanıyan bir dinleyici kaydeder. Devralındığı kaynak: `Service.addEventListener`
`clear`	Belirtilen alanlardaki reklamları kaldırır ve bunların yerine boş içerik yerleştirir.
`clearCategoryExclusions`	Kullanımdan kaldırıldı. Tüm sayfa düzeyindeki reklam kategorisi hariç tutma etiketlerini temizler.
`clearTargeting`	Kullanımdan kaldırıldı. Belirli bir anahtarın veya tüm anahtarların özel hedefleme parametrelerini temizler.
`collapseEmptyDivs`	Kullanımdan kaldırıldı. Gösterilecek reklam içeriği olmadığında alan div'lerinin sayfada yer kaplamaması için daraltılmasını sağlar.
`disableInitialLoad`	Kullanımdan kaldırıldı. Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam istenmesine izin verir.
`display`	Belirli reklam birimi yolu ve boyutuyla bir reklam alanı oluşturup görüntüler.
`enableLazyLoad`	Kullanımdan kaldırıldı. Yapılandırma nesnesinde tanımlandığı şekilde GPT'de geç yüklemeyi etkinleştirir.
`enableSingleRequest`	Kullanımdan kaldırıldı. Aynı anda birden fazla reklam getirmek için tekli istek modunu etkinleştirir.
`enableVideoAds`	Kullanımdan kaldırıldı. Sayfada video reklamların bulunacağını GPT'ye bildirir.
`get`	Kullanımdan kaldırıldı. Belirli bir anahtarla ilişkili AdSense özelliğinin değerini döndürür.
`getAttributeKeys`	Kullanımdan kaldırıldı. Bu hizmette ayarlanan özellik anahtarlarını döndürür.
`getSlots`	Bu hizmetle ilişkili yerlerin listesini alın. Devralındığı kaynak: `Service.getSlots`
`getTargeting`	Kullanımdan kaldırıldı. Ayarlanmış belirli bir özel hizmet düzeyi hedefleme parametresini döndürür.
`getTargetingKeys`	Kullanımdan kaldırıldı. Ayarlanmış tüm özel hizmet düzeyi hedefleme anahtarlarının listesini döndürür.
`isInitialLoadDisabled`	Kullanımdan kaldırıldı. Reklamlar için ilk isteklerin önceki bir PubAdsService.disableInitialLoad çağrısıyla başarıyla devre dışı bırakılıp bırakılmadığını döndürür.
`refresh`	Sayfadaki belirli veya tüm alanlar için yeni reklamları getirir ve görüntüler.
`removeEventListener`	Daha önce kaydedilmiş bir işleyiciyi kaldırır. Devralındığı kaynak: `Service.removeEventListener`
`set`	Kullanımdan kaldırıldı. Yayıncı Reklamları hizmeti kapsamındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.
`setCategoryExclusion`	Kullanımdan kaldırıldı. Belirli etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.
`setCentering`	Kullanımdan kaldırıldı. Reklamların yatay olarak ortalanmasını etkinleştirir ve devre dışı bırakır.
`setForceSafeFrame`	Kullanımdan kaldırıldı. Sayfadaki tüm reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
`setLocation`	Kullanımdan kaldırıldı. Satır öğelerini belirli konumlara göre coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini iletir.
`setPrivacySettings`	Yapılandırma nesnesi kullanılarak tüm gizlilik ayarlarının tek bir API'den yapılandırılmasına olanak tanır.
`setPublisherProvidedId`	Yayıncı tarafından sağlanan kimliğin değerini ayarlar.
`setSafeFrameConfig`	Kullanımdan kaldırıldı. SafeFrame yapılandırması için sayfa düzeyindeki tercihleri ayarlar.
`setTargeting`	Kullanımdan kaldırıldı. Belirli bir anahtar için, Publisher Ads hizmeti reklam alanlarının tümünde geçerli olan özel hedefleme parametrelerini ayarlar.
`setVideoContent`	Kullanımdan kaldırıldı. Hedefleme ve içerik hariç tutma amacıyla reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar.
`updateCorrelator`	Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntüleme başlatır.

Yöntemler

temizle

clear(slots?: Slot[]): boolean

Belirtilen alanlardaki reklamları kaldırır ve bunların yerine boş içerik yerleştirir. Yuvalar getirilmemiş olarak işaretlenir.

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

Örnek

JavaScript

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

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

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

// This call to clear all slots.
googletag.pubads().clear();

JavaScript (eski)

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

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

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

// This call to clear all slots.
googletag.pubads().clear();

TypeScript

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

// This call to clear only slot1.
googletag.pubads().clear([slot1]);

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

// This call to clear all slots.
googletag.pubads().clear();

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

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

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Sayfa düzeyindeki tüm reklam kategorisi hariç tutma etiketlerini temizler. Bu yöntem, yuvanın yenilenmesini istediğiniz durumlarda kullanışlıdır.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

Reklamları engellemek için özel etiketler

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

clearTargeting

clearTargeting(key?: string): PubAdsService

Belirli bir anahtarın veya tüm anahtarların ö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
`Optional key: string`	Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmediği takdirde 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ı sağlar. Bu mod, hizmet etkinleştirilmeden önce ayarlanmalıdır.

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

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

İadeler
`boolean`	Div daraltma modu etkinleştirildiyse `true`, hizmet etkinleştirildikten sonra yöntem çağrıldığı için daraltma modunun etkinleştirilmesi mümkün değilse `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 reklamların istenmesine izin verir. Bu ayar, hizmet etkinleştirilmeden önce yapılmalıdır. Eşzamansız mod kullanılmalıdır. Aksi takdirde, refresh kullanılarak reklam isteğinde bulunmak mümkün olmaz.

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

display

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

Belirli reklam birimi yolu ve boyutuyla bir reklam alanı oluşturup görüntüler. Bu yöntem, tek istek moduyla çalışmaz.

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

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

enableLazyLoad

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

Yapılandırma nesnesinde tanımlandığı şekilde GPT'de 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 yuvalar getirme aralığının dışındaysa çalışır.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Parametreler

Parametreler
`Optional config: { fetchMarginPercent?: number; mobileScaling?: number; renderMarginPercent?: number; }`	Yapılandırma nesnesi, geç yükleme davranışının özelleştirilmesine olanak tanır. Atlanan tüm yapılandırmalarda, zaman içinde ayarlanacak olan Google'ın belirlediği bir varsayılan değer kullanılır. Belirli bir ayarı (ör. getirme marjı) devre dışı bırakmak için değeri `-1` olarak ayarlayın. `fetchMarginPercent` Reklamı getirmeden önce bir alanın mevcut görüntü alanından olması gereken minimum uzaklık (görüntü alanı boyutunun yüzdesi olarak). 0 değeri "alan görüntü alanına girdiğinde", 100 değeri "reklam görüntü alanından 1 görüntü alanı uzaklaştığında" anlamına gelir. `renderMarginPercent` Bir reklamı oluşturmadan önce bir alanın mevcut görüntü alanından olması gereken minimum mesafe. Bu, reklamın önceden getirilmesine izin verir ancak diğer alt kaynakların oluşturulması ve indirilmesi için beklenir. Değer, görüntü alanının yüzdesi olarak `fetchMarginPercent` ile aynı şekilde çalışır. `mobileScaling` Mobil cihazlardaki marjlara uygulanan bir çarpan. Bu sayede mobil ve masaüstü cihazlarda farklı marjlar kullanılabilir. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir yuvanın getirilip oluşturulmadan önce olabileceği minimum mesafeyi artırır.

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

Yapılandırma nesnesi, geç yükleme davranışının özelleştirilmesine olanak tanır. Atlanan tüm yapılandırmalarda, zaman içinde ayarlanacak olan Google'ın belirlediği bir varsayılan değer kullanılır. Belirli bir ayarı (ör. getirme marjı) devre dışı bırakmak için değeri -1 olarak ayarlayın.

fetchMarginPercent

Reklamı getirmeden önce bir alanın mevcut görüntü alanından olması gereken minimum uzaklık (görüntü alanı boyutunun yüzdesi olarak). 0 değeri "alan görüntü alanına girdiğinde", 100 değeri "reklam görüntü alanından 1 görüntü alanı uzaklaştığında" anlamına gelir.
renderMarginPercent

Bir reklamı oluşturmadan önce bir alanın mevcut görüntü alanından olması gereken minimum mesafe. Bu, reklamın önceden getirilmesine izin verir ancak diğer alt kaynakların oluşturulması ve indirilmesi için beklenir. Değer, görüntü alanının yüzdesi olarak fetchMarginPercent ile aynı şekilde çalışır.
mobileScaling

Mobil cihazlardaki marjlara uygulanan bir çarpan. Bu sayede mobil ve masaüstü cihazlarda farklı marjlar kullanılabilir. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir yuvanın getirilip oluşturulmadan önce olabileceği minimum mesafeyi artırır.

enableSingleRequest

enableSingleRequest(): boolean

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

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

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

enableVideoAds

enableVideoAds(): void

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

get

get(key: string): 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
`string`	Özellik anahtarının geçerli değeri veya anahtar mevcut değilse `null`.

getAttributeKeys

getAttributeKeys(): string[]

Bu hizmette ayarlanmış olan ö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. Sipariş tanımsız.

getTargeting

getTargeting(key: string): string[]

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Parametreler
`key: string`	Aranacak hedefleme anahtarı.

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

getTargetingKeys

getTargetingKeys(): string[]

Ayarlanmış tüm özel hizmet düzeyi 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. Sipariş tanımsız.

isInitialLoadDisabled

isInitialLoadDisabled(): boolean

Reklamlar için yapılan ilk isteklerin önceki bir PubAdsService.disableInitialLoad çağrısıyla 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ıysa `true`, aksi takdirde `false` değerini döndürür.

refresh

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

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

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

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

Örnek

JavaScript

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

// This call to 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

Optional slots: Slot[] Yenilenecek yuvalar. Dizi isteğe bağlıdır. Belirtilmezse tüm yuvalar yenilenir.

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

Optional options: { 
  changeCorrelator: boolean; 
}

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

changeCorrelator

Reklam getirmek için yeni bir korelasyon tanımlayıcısı oluşturulup oluşturulmayacağını belirtir. Reklam sunucularımız bu ilişkilendirici değerini kısa bir süre (şu anda 30 saniye, ancak bu süre değişebilir) boyunca korur. Böylece, aynı ilişkilendirici değerine sahip ve yakın zamanda alınan istekler tek bir sayfa görüntüleme olarak kabul edilir. Varsayılan olarak, her yenilemede yeni bir korelasyon tanımlayıcısı oluşturulur.

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

set

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

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

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

Ö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 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 ortalanmasını etkinleştirir ve devre dışı bırakır. Ortalama varsayılan olarak devre dışıdır. Eski gpt_mobile.js'de ortalama varsayılan olarak etkindir.

Bu yöntem, yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar ortalanacağından 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` tuşuna basın.

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.

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

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

Örnek

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (eski)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

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

SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
`forceSafeFrame: boolean`	Sayfadaki tüm reklamların SafeFrame'lerde oluşturulmasını zorlamak için `true`, önceki ayarı yanlış olarak değiştirmek için `false` kullanılır. Daha önce belirtilmemişse bu ayarın `false` olarak belirlenmesi herhangi bir değişikliğe neden olmaz.

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

setLocation

setLocation(address: string): PubAdsService

Web sitelerinden konum bilgilerini geçirir. Böylece satır öğelerini belirli konumlara göre coğrafi olarak hedefleyebilirsiniz.

Ö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 kullanılarak tüm gizlilik ayarlarının tek bir API'den yapılandırılmasına olanak tanır.

Örnek

JavaScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

JavaScript (eski)

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

TypeScript

googletag.pubads().setPrivacySettings({
  restrictDataProcessing: true,
});

// Set multiple privacy settings at the same time.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: true,
  underAgeOfConsent: true,
});

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});

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

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

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

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

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

Parametreler
`ppid: string`	Yayıncı tarafından sağlanan alfasayısal kimlik. 32 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üzeyindeki tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı yoksayılır.

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

SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
`config: SafeFrameConfig`	Yapılandırma nesnesi.

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

setTargeting

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

Belirli bir anahtar için, tüm yayıncı reklamları hizmeti reklam alanlarında geçerli olan özel hedefleme parametrelerini ayarlar. Aynı anahtar için bu işlevi birden çok kez çağırmak eski değerlerin üzerine yazar. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Anahtar/değer çifti hedefleme

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

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

setVideoContent

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

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

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

VAST reklam etiketi URL parametreleri

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

updateCorrelator

updateCorrelator(): PubAdsService

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

Not: Bu ayarın, sayfadaki reklamları otomatik olarak yansıtan ve geçerlilik süresi olmayan GPT'nin uzun süreli sayfa görüntüleme özelliği üzerinde etkisi 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.

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

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

Slot.getResponseInformation

Özellikler

advertiserId

advertiserId: number

Reklamverenin kimliği.

campaignId

campaignId: number

Kampanyanın kimliği.

creativeId

creativeId: number

Reklam öğesinin kimliği.

creativeTemplateId

creativeTemplateId: number

Reklamın şablon kimliği.

lineItemId

lineItemId: number

Satır öğesinin kimliği.

googletag.RewardedPayload

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

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

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

Ödüllü reklam gösterme

Özellikler

amount

amount: number

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

type

type: string

Ödüle dahil edilen öğenin türü (örneğin, "jeton").

googletag.Service

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

Yöntemler
`addEventListener`	Sayfada belirli bir GPT etkinliği gerçekleştiğinde bir JavaScript işlevi ayarlayıp çağırmanıza olanak tanıyan bir dinleyici kaydeder.
`getSlots`	Bu hizmetle ilişkili yerlerin listesini alın.
`removeEventListener`	Daha önce kaydedilmiş bir işleyiciyi kaldırır.

Yöntemler

addEventListener

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

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

Uygun etkinlik türündeki bir nesne, çağrıldığında işleyiciye iletilir.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Reklam etkinliği işleyicileri

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

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

getSlots

getSlots(): Slot[]

Bu hizmetle ilişkili yerlerin listesini alın.

İadeler
`Slot[]`	Hizmete eklendikleri sırayla yuvalar.

removeEventListener

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

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

googletag.SizeMappingBuilder

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

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

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

Reklam boyutları: Duyarlı reklamlar

Yöntemler

addSize

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

Görüntü alanını temsil eden tek boyutlu bir diziden, alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.

Örnek

JavaScript

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

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

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

JavaScript (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 &lt; 640x480
  .build();

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

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

TypeScript

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

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

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

Parametreler
`viewportSize: SingleSizeArray`	Bu eşleme girişi için görüntü alanının boyutu.
`slotSize: GeneralSize`	Bu eşleme girişi için yuvanın boyutları.

İadeler
`SizeMappingBuilder`	Bu oluşturucuya yapılan bir referans.

oluşturma

build(): SizeMappingArray

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

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

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

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

googletag.Slot

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

Yöntemler
`addService`	Bu alana Hizmet ekler.
`clearCategoryExclusions`	Kullanımdan kaldırıldı. Bu alan için tüm alan düzeyindeki reklam kategorisi hariç tutma etiketlerini temizler.
`clearTargeting`	Kullanımdan kaldırıldı. Bu alan için belirli veya tüm özel alan düzeyinde hedefleme parametrelerini temizler.
`defineSizeMapping`	Bu yuva için minimum görüntü alanı boyutundan yuva boyutuna eşlemeler dizisi ayarlar.
`get`	Kullanımdan kaldırıldı. Bu alan için verilen 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`	Kullanımdan kaldırıldı. Bu yuvada ayarlanan özellik anahtarlarının listesini döndürür.
`getCategoryExclusions`	Kullanımdan kaldırıldı. Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.
`getConfig`	setConfig tarafından ayarlanan alan için genel yapılandırma seçeneklerini alır.
`getResponseInformation`	Reklam yanıtı bilgilerini döndürür.
`getSlotElementId`	Yuva tanımlanırken sağlanan yuvanın `div` kimliğini döndürür.
`getTargeting`	Kullanımdan kaldırıldı. Bu yuvada ayarlanan belirli bir özel hedefleme parametresini döndürür.
`getTargetingKeys`	Kullanımdan kaldırıldı. Bu alanda ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür.
`set`	Kullanımdan kaldırıldı. Bu reklam alanındaki bir AdSense özelliği için değer ayarlar.
`setCategoryExclusion`	Kullanımdan kaldırıldı. Bu alanda alan düzeyinde reklam kategorisi hariç tutma etiketi ayarlar.
`setClickUrl`	Kullanımdan kaldırıldı. Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği tıklama URL'sini ayarlar.
`setCollapseEmptyDiv`	Kullanımdan kaldırıldı. Alanın `div` içinde reklam olmadığında alanın gizlenip gizlenmeyeceğini ayarlar.
`setConfig`	Bu yuva için genel yapılandırma seçeneklerini belirler.
`setForceSafeFrame`	Kullanımdan kaldırıldı. Bu alandaki reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
`setSafeFrameConfig`	Kullanımdan kaldırıldı. SafeFrame yapılandırması için yuva düzeyindeki tercihleri ayarlar.
`setTargeting`	Kullanımdan kaldırıldı. Bu alan için özel bir hedefleme parametresi ayarlar.
`updateTargetingFromMap`	Kullanımdan kaldırıldı. Bu yuva için JSON nesnesindeki bir anahtar:değer haritasından özel hedefleme parametrelerini ayarlar.

Yöntemler

addService

addService(service: Service): Slot

Bu alana hizmet ekler.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Parametreler
`service: Service`	Eklenecek hizmet.

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

clearCategoryExclusions

clearCategoryExclusions(): Slot

Bu alan için tüm alan düzeyi 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ığı yuva nesnesi.

clearTargeting

clearTargeting(key?: string): Slot

Bu reklam alanı için belirli veya tüm özel reklam 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
`Optional key: string`	Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmediği takdirde tüm hedefleme parametreleri temizlenir.

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

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

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

Örnek

JavaScript

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

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

JavaScript (eski)

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

var mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

TypeScript

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

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping!);

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

Reklam boyutları: Duyarlı reklamlar

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

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

get

get(key: string): string

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

AdSense Özellikleri

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

İadeler
`string`	Özellik anahtarının geçerli değeri veya anahtar mevcut değilse `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 yuvada ayarlanan özellik anahtarlarının listesini döndürür. Bu yuvadan devralınan hizmet düzeyindeki özelliklerin anahtarlarını görmek için PubAdsService.getAttributeKeys'i kullanın.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
`string[]`	Özellik anahtarlarının dizisi. Sipariş tanımsız.

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 ayarlanmamışsa boş bir dizi.

getConfig

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

setConfig ile ayarlanan alan için genel yapılandırma seçeneklerini alır.

Bu yöntem, tüm setConfig() özelliklerini desteklemez. Desteklenen özellikler şunlardır:

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

İadeler
`Pick<SlotSettingsConfig, "adsenseAttributes" \| "targeting" \| "categoryExclusion">`	Yuva için yapılandırma seçenekleri.

getResponseInformation

getResponseInformation(): ResponseInformation

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

İadeler
`ResponseInformation`	En son reklam yanıtı bilgileri veya alanın reklamı yoksa `null`.

getSlotElementId

getSlotElementId(): string

Yuva tanımlandığında sağlanan yuvanın div 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`	`div` numaralı alan kimliği.

getTargeting

getTargeting(key: string): string[]

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Parametreler
`key: string`	Aranacak hedefleme anahtarı.

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

getTargetingKeys

getTargetingKeys(): string[]

Bu yuvada ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür. Hizmet düzeyinde hedefleme anahtarları dahil değildir.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

İadeler
`string[]`	Hedefleme anahtarları dizisi. Sipariş tanımsız.

set

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

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

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

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

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

Bu alanda alan düzeyinde 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ığı yuva nesnesi.

setClickUrl

setClickUrl(value: string): Slot

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

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

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

setCollapseEmptyDiv

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

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

Ö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`	Reklam döndürülmediğinde alanın daraltılıp daraltılmayacağı.
`Optional collapseBeforeAdFetch: boolean`	Reklam getirilmeden önce alanın daraltılıp daraltılmayacağı. Daraltma `true` değilse yoksayılır.

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

setConfig

setConfig(slotConfig: SlotSettingsConfig): void

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

Parametreler
`slotConfig: SlotSettingsConfig`	Yapılandırma nesnesi.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

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

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
`forceSafeFrame: boolean`	Bu alandaki tüm reklamların SafeFrame'lerde oluşturulmasını zorunlu kılmak için `true`, sayfa düzeyindeki bir ayarı (varsa) devre dışı bırakmak için `false` simgesini tıklayın. Sayfa düzeyinde belirtilmediğinde bu ayarı `false` olarak ayarlamak hiçbir şeyi değiştirmez.

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

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): Slot

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

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

Örnek

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

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

JavaScript (eski)

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

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

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

SafeFrame kullanarak reklam öğeleri oluşturma

Parametreler
`config: SafeFrameConfig`	Yapılandırma nesnesi.

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

setTargeting

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

Bu alan için özel bir hedefleme parametresi ayarlar. Bu yöntemi aynı anahtar için birden çok kez çağırmak eski değerlerin üzerine yazar. Burada ayarlanan değerler, hizmet düzeyinde ayarlanan hedefleme parametrelerini geçersiz kılar. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Anahtar/değer çifti hedefleme

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

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

updateTargetingFromMap

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

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

Notlar:

Üzerine yazma durumunda yalnızca son değer saklanır.
Değer bir dizi ise önceki değerler birleştirilmez, üzerine yazılır.
Burada ayarlanan değerler, hizmet düzeyinde ayarlanan hedefleme parametrelerini geçersiz kılar.

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

googletag.config

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

Arayüzler
`AdExpansionConfig`	Reklam genişletmeyi kontrol etme ayarları.
`AdSenseAttributesConfig`	AdSense reklamlarının davranışını kontrol etmeye yönelik ayarlar.
`ComponentAuctionConfig`	Cihaz üzerinde reklam açık artırmasında tek bir bileşen açık artırmasını temsil eden bir nesne.
`InterstitialConfig`	Tek bir geçiş reklamı alanının davranışını tanımlayan bir nesne.
`LazyLoadConfig`	GPT'de geç yükleme kullanımını kontrol etme ayarları.
`PageSettingsConfig`	Sayfa düzeyindeki ayarlar için ana yapılandırma arayüzü.
`PrivacyTreatmentsConfig`	Yayıncı gizliliği işlemlerini kontrol etmeye yönelik ayarlar.
`PublisherProvidedSignalsConfig`	Yayıncı tarafından sağlanan sinyaller (PPS) yapılandırma nesnesi.
`SafeFrameConfig`	GPT'de SafeFrame'i kontrol etme ayarları.
`SlotSettingsConfig`	Slot düzeyindeki ayarlar için ana yapılandırma arayüzü.
`TaxonomyData`	Tek bir Taksonomi'nin değerlerini içeren bir nesne.
`VideoAdsConfig`	Video reklamlarla ilgili ayarları yapılandırmak için kullanılan ayarlar.

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

Tür Takma Adları

CollapseDivBehavior

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

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

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

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

Desteklenen geçiş reklamı tetikleyicileri.

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Desteklenen yayıncı gizlilik değerlendirmeleri.

Sınıflandırma

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

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

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

googletag.config.AdExpansionConfig

Reklam genişletmeyi kontrol etme ayarları.

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Özellikler

`Optional` etkinleştirildi

enabled?: boolean

Reklam genişletmenin etkin olup olmadığı.

Bu değer ayarlandığında Google Ad Manager'da yapılandırılan varsayılan değer geçersiz kılınır.

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

googletag.config.AdSenseAttributesConfig

AdSense reklamlarının davranışını kontrol etmeye yönelik ayarlar.

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

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

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

Özellikler

`Optional` adsense_ad_format

adsense_ad_format?: "120x240_as" | "120x600_as" | "125x125_as" | "160x600_as" | "180x150_as" | "200x200_as" | "234x60_as" | "250x250_as" | "300x250_as" | "336x280_as" | "468x60_as" | "728x90_as"

AdSense reklam biçimi.

`Optional` adsense_channel_ids

adsense_channel_ids?: string

AdSense kanal kimlikleri.

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

Örnek: 271828183+314159265

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

Özel kanallarla reklam birimi performansını izleme

`Optional` adsense_test_mode

adsense_test_mode?: "on"

Test modunun etkin olup olmadığı.

on olarak ayarlandığında reklamlar yalnızca test amaçlı olarak işaretlenir ve sayma veya faturalandırmaya dahil edilmez. Bu ayar, üretim ve test dışı trafik için ayarlanmamış olmalıdır.

`Optional` document_language

document_language?: string

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

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

Örnek: en

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

ISO 639 dil kodları listesi

`Optional` page_url

page_url?: string

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

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

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

googletag.config.ComponentAuctionConfig

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

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

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

Protected Audience API satıcı kılavuzu: reklam açık artırmaları yayınlama

Özellikler

auctionConfig

auctionConfig: { 
  auctionSignals?: unknown; 
  decisionLogicURL: string; 
  interestGroupBuyers?: string[]; 
  perBuyerExperimentGroupIds?: { 
    [buyer: string]: number; 
  }; 
  perBuyerGroupLimits?: { 
    [buyer: string]: number; 
  }; 
  perBuyerSignals?: { 
    [buyer: string]: unknown; 
  }; 
  perBuyerTimeouts?: { 
    [buyer: string]: number; 
  }; 
  seller: string; 
  sellerExperimentGroupId?: number; 
  sellerSignals?: unknown; 
  sellerTimeout?: number; 
  trustedScoringSignalsURL?: string; 
}

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 yapılandırma silinir.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

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

configKey

configKey: string

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

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

googletag.config.InterstitialConfig

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

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

Özellikler

`Optional` requireStorageAccess

requireStorageAccess?: boolean

Bu geçiş reklamının gösterilmesi için yerel depolama izni gerekip gerekmediği.

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

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

`Optional` tetikleyiciler

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

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

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Web geçiş reklamı gösterme

googletag.config.LazyLoadConfig

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

Özellikler
`fetchMarginPercent?`	Bir reklam isteğinde bulunmadan önce bir alanın mevcut görüntü alanından olması gereken minimum uzaklık (görüntü alanı boyutunun yüzdesi olarak ifade edilir).
`mobileScaling?`	Mobil cihazlardaki marjlara uygulanan çarpan.
`renderMarginPercent?`	Bir reklamı oluşturmadan önce bir alanın geçerli görüntü alanından olması gereken minimum uzaklık, görüntü alanı boyutunun yüzdesi olarak ifade edilir.

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

PageSettingsConfig.lazyLoad

Özellikler

`Optional` fetchMarginPercent

fetchMarginPercent?: number

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

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

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

`Optional` mobileScaling

mobileScaling?: number

Mobil cihazlardaki marjlara uygulanan çarpan. Bu çarpan hem fetchMarginPercent hem de renderMarginPercent için geçerlidir.

Bu sayede, görüntü alanı boyutlarının ve kaydırma hızlarının farklı olabileceği mobil cihazlarda ve masaüstü bilgisayarlarda farklı marjlar kullanılabilir. Örneğin, 2,0 değeri, mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir yuvanın getirilip oluşturulmadan önce görüntü alanına olan minimum mesafesini artırır.

`Optional` renderMarginPercent

renderMarginPercent?: number

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

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

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

googletag.config.PageSettingsConfig

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

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

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

Örnekler:

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

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

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

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

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

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

Bir özelliğin 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,
  });

Özellikler
`adExpansion?`	Reklam genişletmeyi kontrol etme ayarları.
`adsenseAttributes?`	AdSense özelliklerini yapılandırmak için ayar.
`adYield?`	Desteği sonlandırıldı.
`categoryExclusion?`	Reklam kategorisi hariç tutmaları yapılandırma ayarı.
`centering?`	Reklamların yatay olarak ortalanmasını kontrol etme ayarı.
`collapseDiv?`	Reklam alanlarının daraltma davranışını kontrol etmeye yönelik ayar.
`disableInitialLoad?`	Reklamların ne zaman isteneceğiyle ilgili ayar.
`lazyLoad?`	GPT'de geç yükleme kullanımını kontrol etme ayarları.
`location?`	Satır öğelerini coğrafi konumları hedefleyecek şekilde ayarlama.
`pps?`	Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol etme ayarları.
`privacyTreatments?`	Yayıncı gizliliği işlemlerini kontrol etmeye yönelik ayarlar.
`safeFrame?`	GPT'de SafeFrame kullanımını kontrol etme ayarları.
`singleRequest?`	Tekli İstek Mimarisi'ni (SRA) etkinleştirmek veya devre dışı bırakmak için kullanılan ayar.
`targeting?`	Anahtar/değer çifti hedeflemesini kontrol etme ayarı.
`threadYield?`	GPT'nin reklam öğeleri istenirken ve oluşturulurken JS iş parçacığını bırakıp bırakmayacağını kontrol etmeye yönelik ayar.
`videoAds?`	Video reklamları kontrol etme ayarları

Özellikler

`Optional` adExpansion

adExpansion?: AdExpansionConfig

Reklam genişletmeyi kontrol etme ayarları.

`Optional` adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

AdSense özelliklerini yapılandırma ayarı.

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

AdSense özelliği değişiklikleri yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar için geçerlidir. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh için yapılan çağrılardan önce çağrılması önerilir.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

`Optional` adYield

adYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

`Optional` categoryExclusion

categoryExclusion?: string[]

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

Reklamları engellemek için özel etiketler

`Optional` ortalanıyor

centering?: boolean

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

Yatay ortalama değişiklikleri yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar için geçerlidir. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh için yapılan çağrılardan önce çağrılması önerilir.

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

`Optional` collapseDiv

collapseDiv?: CollapseDivBehavior

Reklam alanlarının daraltma davranışını kontrol etmeye yönelik ayar.

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

Desteklenen değerler:

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

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

`Optional` disableInitialLoad

disableInitialLoad?: boolean

Reklamların ne zaman isteneceğiyle ilgili ayar.

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

Bu ayar etkinleştirildiğinde, display() yöntemi çağrıldığında kayıtlı yuvalar için reklam isteğinde bulunulmaz. Bunun yerine, reklam isteğini başlatmak için PubAdsService.refresh'e ayrı bir çağrı yapılması gerekir.

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

`Optional` lazyLoad

lazyLoad?: LazyLoadConfig

GPT'de geç yüklemenin kullanımını kontrol etmeye yönelik ayarlar.

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

Not: singleRequest etkinse tembel getirme yalnızca tüm yuvalar getirme aralığının dışındayken çalışır.

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

`Optional` location

location?: string

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

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

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

`Optional` pps

pps?: PublisherProvidedSignalsConfig

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

`Optional` privacyTreatments

privacyTreatments?: PrivacyTreatmentsConfig

Yayıncı gizliliği işlemlerini kontrol etmeye yönelik ayarlar.

`Optional` safeFrame

safeFrame?: SafeFrameConfig

GPT'de SafeFrame kullanımını kontrol etmeye yönelik ayarlar.

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

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

`Optional` singleRequest

singleRequest?: boolean

Tekli İstek Mimarisi'ni (SRA) etkinleştirme veya devre dışı bırakma ayarı.

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

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

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

`Optional` hedefleme

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

Anahtar/değer hedeflemeyi kontrol etmeye yönelik ayar.

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

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

Anahtar/değer çifti hedefleme

`Optional` threadYield

threadYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

GPT'nin reklam öğeleri istenirken ve oluşturulurken JS iş parçacığını bırakıp bırakmayacağını kontrol eden ayar.

GPT yalnızca Scheduler.postTask veya Scheduler.yield API'sini destekleyen tarayıcılarda iş parçacığını bırakır.

Desteklenen değerler:

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Scheduler

`Optional` videoAds

videoAds?: VideoAdsConfig

Video reklamları kontrol etme ayarları

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Video içeriği besleme

googletag.config.PrivacyTreatmentsConfig

Yayıncı gizliliği işlemlerini kontrol etmeye yönelik ayarlar.

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

Özellikler

tedaviler

treatments: "disablePersonalization"[]

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

googletag.config.PublisherProvidedSignalsConfig

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

Özellikler
`taxonomies`	Yapılandırmayı temizlemek için Taxonomy eşlemeleri veya null içeren bir nesne.

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

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

Özellikler

taksonomiler

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Yapılandırmayı temizlemek için Taxonomy eşlemeleri veya null içeren bir nesne.

googletag.config.SafeFrameConfig

GPT'de SafeFrame'i kontrol etme ayarları.

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

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

Özellikler

`Optional` allowOverlayExpansion

allowOverlayExpansion?: boolean

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

`Optional` allowPushExpansion

allowPushExpansion?: boolean

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

`Optional` forceSafeFrame

forceSafeFrame?: boolean

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

`Optional` sandbox

sandbox?: boolean

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

`Optional` useUniqueDomain

useUniqueDomain?: boolean

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

Not: Bu özellik varsayılan olarak etkindir.

Kullanımdan kaldırıldı: Bu özellik artık devre dışı bırakılamaz. useUniqueDomain ayarının etkisi yoktur.

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

SafeFrame kullanarak reklam öğeleri oluşturma

googletag.config.SlotSettingsConfig

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

Tek bir slot 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 olup setConfig'i kullanan gerçek özellikleri yansıtmaz. Özellik grubu için aşağıdaki SlotSettingsConfig türündeki alanlara bakın.

Örnekler:

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

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

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

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

Belirli bir özelliğin tüm ayarları, Slot.setConfig her çağrıldığında güncellenir.

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

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

Bir özelliğin 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,
  });

Özellikler
`adExpansion?`	Reklam genişletmeyi yapılandırma ayarları.
`adsenseAttributes?`	AdSense özelliklerini yapılandırmak için ayar.
`categoryExclusion?`	Reklam kategorisi hariç tutmaları yapılandırma ayarı.
`clickUrl?`	Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği URL'yi yapılandırma ayarı.
`collapseDiv?`	Reklam alanının daraltma davranışını yapılandırma ayarı.
`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ı yapılandıran ayarlar.
`safeFrame?`	GPT'de SafeFrame kullanımını yapılandırma ayarları.
`targeting?`	Anahtar/değer çifti hedeflemeyi yapılandırma ayarı.

Özellikler

`Optional` adExpansion

adExpansion?: AdExpansionConfig

Reklam genişletmeyi yapılandırma ayarları

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

Reklam genişletme

`Optional` adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

AdSense özelliklerini yapılandırma ayarı.

Bu ayar aracılığıyla yapılandırılan AdSense özellikleri yalnızca reklam alanında geçerli olur. Bu ayar, birden fazla özellik değeri tanımlamak veya mevcut değerlerin üzerine yazmak için birden fazla kez çağrılabilir.

AdSense özelliği değişiklikleri yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar için geçerlidir. Bu nedenle, bu yöntemin googletag.display veya PubAdsService.refresh için yapılan çağrılardan önce çağrılması önerilir.

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

`Optional` categoryExclusion

categoryExclusion?: string[]

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Reklamları engellemek için özel etiketler

`Optional` clickUrl

clickUrl?: string

Kullanıcıların reklamı tıkladıktan sonra yönlendirileceği URL'yi yapılandırma ayarı.

Tıklama URL'si değiştirilse bile Google Ad Manager sunucuları tıklamayı kaydetmeye devam eder. Yayınlanan reklam öğesiyle ilişkili tüm açılış sayfası URL'leri, sağlanan değere eklenir. Bu değeri birden fazla kez ayarlamak, daha önce yapılandırılmış tüm değerlerin üzerine yazar. null iletildiğinde değer temizlenir.

Not: Bu ayar yalnızca SRA dışı istekler için geçerlidir.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

`Optional` collapseDiv

collapseDiv?: CollapseDivBehavior

Reklam alanının daraltma davranışını yapılandırmak için kullanılan ayar.

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

Desteklenen değerler:

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

Örnek

JavaScript

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

TypeScript

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

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

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

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

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

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

`Optional` componentAuction

componentAuction?: ComponentAuctionConfig[]

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

`Optional` geçiş reklamı

interstitial?: InterstitialConfig

Geçiş reklamı alanı davranışını yapılandıran ayarlar.

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

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

`Optional` safeFrame

safeFrame?: SafeFrameConfig

GPT'de SafeFrame kullanımını yapılandırma ayarları.

Bu ayar aracılığıyla yapılandırılan değerler yalnızca reklam alanı için geçerli olur ve PageSettingsConfig.safeFrame aracılığıyla ayarlanan değerleri geçersiz kılar.

Örnek

JavaScript

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

TypeScript

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

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

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

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

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

`Optional` hedefleme

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

Anahtar/değer çifti hedeflemeyi yapılandırma ayarı.

Bu ayar aracılığıyla yapılandırılan hedefleme yalnızca reklam alanı için geçerli olur. Bu ayar, birden fazla hedefleme anahtar/değer çiftini tanımlamak veya mevcut değerlerin üzerine yazmak için birden çok kez çağrılabilir. Hedefleme anahtarları, Google Ad Manager hesabınızda tanımlanır.

Örnek

JavaScript

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

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

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

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

Anahtar/değer çifti hedefleme

googletag.config.TaxonomyData

Tek bir Taksonomi'nin değerlerini içeren bir nesne.

Özellikler
`values`	Taksonomi değerlerinin listesi.

Özellikler

values

values: readonly string[]

Taksonomi değerlerinin listesi.

googletag.config.VideoAdsConfig

Video reklamlarla ilgili ayarları yapılandırmak için kullanılan ayarlar.

Özellikler
`enableVideoAds`	Sayfada video reklamların bulunup bulunmayacağı.
`videoCmsId?`	Video içeriği kaynağı kimliği.
`videoContentId?`	Video içerik kimliği.

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

PageSettingsConfig.videoAds

Özellikler

enableVideoAds

enableVideoAds: boolean

Sayfada video reklamların bulunup bulunmayacağı.

true olarak ayarlandığında görüntülü ve video reklamlarda içerik hariç tutma kısıtlamaları etkinleştirilir.

Video içeriği biliniyorsa görüntülü reklamlarda içerik hariç tutma özelliğini kullanmak için videoContentId ve videoCmsId parametrelerini Google Ad Manager içerik alımı hizmetine sağlanan değerlere ayarlayın.

`Optional` videoCmsId

videoCmsId?: string

Video içeriği kaynağı kimliği.

Bu, Google Ad Manager içerik besleme hizmeti tarafından videoContentId ile belirtilen video içeriğinin kaynağını tanımlamak için atanan benzersiz bir değerdir.

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

cmsid (İçerik Kaynağı Kimliği)

`Optional` videoContentId

videoContentId?: string

Video içeriği kimliği.

Bu, videoCmsId ile belirtilen içerik kaynağındaki belirli bir videoyu tanımlayan benzersiz bir değerdir. Bu değer, video içeriğinizi barındıran İYS tarafından atanır.

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

vid (Video kimliği)

googletag.enums

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

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

Numaralandırmalar

OutOfPageFormat

OutOfPageFormat

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

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

defineOutOfPageSlot

Numaralandırma Üyeleri
`AD_INTENTS`	Amaca dayalı reklam biçimi.
`BOTTOM_ANCHOR`	Alan, görüntü alanının alt kısmına yapışır.
`GAME_MANUAL_INTERSTITIAL`	Oyun manuel geçiş reklamı biçimi. Not: Oyun manuel geçiş reklamı, sınırlı erişim sunulan bir biçimdir.
`INTERSTITIAL`	Web geçiş reklamı öğesi biçimi.
`LEFT_SIDE_RAIL`	Sol yan reklam sütunu biçimi.
`REWARDED`	Ödüllü biçim.
`RIGHT_SIDE_RAIL`	Sağ yan reklam sütunu biçimi.
`TOP_ANCHOR`	Alanının görüntü alanının üst kısmına yapıştığı sabit biçim.

TrafficSource

TrafficSource

GPT tarafından desteklenen trafik kaynakları.

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

PrivacySettingsConfig.trafficSource

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

googletag.events

Bu, GPT'nin Etkinlikler için kullandığı ad alanıdır. Kodunuz, Service.addEventListener kullanarak bu etkinliklere tepki verebilir.

Arayüzler
`Event`	Tüm GPT etkinlikleri için temel arayüz.
`EventTypeMap`	Bu, Service.addEventListener ve Service.removeEventListener için bir etkinlik adını ilgili etkinlik nesnesi türüyle eşleyen bir sözde türdür.
`GameManualInterstitialSlotClosedEvent`	Bu etkinlik, oyun kılavuzu geçiş reklamı yuvası kullanıcı tarafından kapatıldığında tetiklenir.
`GameManualInterstitialSlotReadyEvent`	Bu etkinlik, bir oyun kılavuzu geçiş reklamı alanı kullanıcıya gösterilmeye hazır olduğunda tetiklenir.
`ImpressionViewableEvent`	Bu etkinlik, bir gösterim Aktif Görüntüleme ölçütlerine göre görüntülenebilir hale geldiğinde tetiklenir.
`RewardedSlotClosedEvent`	Bu etkinlik, ödüllendirilmiş bir reklam alanı kullanıcı tarafından kapatıldığında tetiklenir.
`RewardedSlotGrantedEvent`	Bu etkinlik, ödüllü reklam görüntüleme karşılığında ödül verildiğinde tetiklenir.
`RewardedSlotReadyEvent`	Bu etkinlik, bir ödüllü reklam gösterilmeye hazır olduğunda tetiklenir.
`RewardedSlotVideoCompletedEvent`	Bu etkinlik, ödüllü video reklam oynatıldığında tetiklenir.
`SlotOnloadEvent`	Bu etkinlik, reklam öğesinin iFrame'i yükleme etkinliğini tetiklediğinde tetiklenir.
`SlotRenderEndedEvent`	Bu etkinlik, reklam öğesi kodu bir yuvaya yerleştirildiğinde tetiklenir.
`SlotRequestedEvent`	Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.
`SlotResponseReceived`	Bu etkinlik, belirli bir alan için reklam yanıtı alındığında tetiklenir.
`SlotVisibilityChangedEvent`	Bu etkinlik, bir reklam alanı alanının ekrandaki yüzdesi her değiştiğinde tetiklenir.

googletag.events.Event

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

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

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

Reklam etkinliği işleyicileri

Özellikler

serviceName

serviceName: string

Etkinliği tetikleyen hizmetin adı.

slot

slot: Slot

Etkinliği tetikleyen alan.

googletag.events.EventTypeMap

Bu, Service.addEventListener ve Service.removeEventListener için bir etkinlik adını ilgili etkinlik nesnesi türüyle eşleyen bir sözde türdür. Yalnızca referans ve tür güvenliği amacıyla belgelenmiştir.

Özellikler
`gameManualInterstitialSlotClosed`	events.GameManualInterstitialSlotClosedEvent için diğer ad.
`gameManualInterstitialSlotReady`	events.GameManualInterstitialSlotReadyEvent için diğer ad.
`impressionViewable`	events.ImpressionViewableEvent için diğer ad.
`rewardedSlotClosed`	events.RewardedSlotClosedEvent için takma ad.
`rewardedSlotGranted`	events.RewardedSlotGrantedEvent için takma ad.
`rewardedSlotReady`	events.RewardedSlotReadyEvent için takma ad.
`rewardedSlotVideoCompleted`	events.RewardedSlotVideoCompletedEvent için diğer 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 diğer ad.

Özellikler

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent

events.GameManualInterstitialSlotClosedEvent için diğer ad.

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent

events.GameManualInterstitialSlotReadyEvent için diğer ad.

impressionViewable

impressionViewable: ImpressionViewableEvent

events.ImpressionViewableEvent için diğer ad.

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent

events.RewardedSlotClosedEvent için takma ad.

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent

events.RewardedSlotGrantedEvent için takma ad.

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent

events.RewardedSlotReadyEvent için takma ad.

rewardedSlotVideoCompleted

rewardedSlotVideoCompleted: RewardedSlotVideoCompletedEvent

events.RewardedSlotVideoCompletedEvent için diğer ad.

slotOnload

slotOnload: SlotOnloadEvent

events.SlotOnloadEvent için takma ad.

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent

events.SlotRenderEndedEvent için takma ad.

slotRequested

slotRequested: SlotRequestedEvent

events.SlotRequestedEvent için takma ad.

slotResponseReceived

slotResponseReceived: SlotResponseReceived

events.SlotResponseReceived için takma ad.

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent

events.SlotVisibilityChangedEvent için diğer ad.

googletag.events.GameManualInterstitialSlotClosedEvent

Uzatır Event

Bu etkinlik, bir oyun kılavuzu geçiş reklamı alanı kullanıcı tarafından kapatıldığında tetiklenir.

Not: Oyun kılavuzu geçiş reklamı, sınırlı erişim sunulan bir biçimdir.

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `Event.slot`

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

googletag.events.GameManualInterstitialSlotReadyEvent

Uzatır Event

Bu etkinlik, oyun manuel geçiş reklamı alanı kullanıcıya gösterilmeye hazır olduğunda tetiklenir.

Not: Oyun manuel geçiş reklamı, sınırlı erişim sunulan bir biçimdir.

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `Event.slot`

Yöntemler
`makeGameManualInterstitialVisible`	Oyun manuel geçiş reklamını kullanıcıya gösterir.

Örnek

JavaScript

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

TypeScript

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

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

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

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

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

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

Yöntemler

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void

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

googletag.events.ImpressionViewableEvent

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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.events.RewardedSlotClosedEvent

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `Event.slot`

Örnek

JavaScript

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

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

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

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

JavaScript (eski)

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

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

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

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

TypeScript

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

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

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

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

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

googletag.events.RewardedSlotGrantedEvent

Uzatır Event

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

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

Örnek

JavaScript

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

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

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

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

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

JavaScript (eski)

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

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

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

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

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

TypeScript

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

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

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

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

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

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

Özellikler

payload

payload: RewardedPayload

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

googletag.events.RewardedSlotReadyEvent

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `Event.slot`

Yöntemler
`makeRewardedVisible`	Ödüllü reklamı gösterir.

Örnek

JavaScript

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (eski)

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
    var slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

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

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

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

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

Yöntemler

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

Uzatır Event

Bu etkinlik, ödüllü video reklam oynatıldığında tetiklenir.

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `Event.slot`

Örnek

JavaScript

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

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

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

JavaScript (eski)

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

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

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", function (event) {
    var slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

TypeScript

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

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

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

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

googletag.events.SlotOnloadEvent

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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.events.SlotRenderEndedEvent

Uzatır Event

Bu etkinlik, reklam öğesi kodu bir yuvaya yerleştirildiğinde tetiklenir. Bu etkinlik, reklam öğesinin kaynakları getirilmeden önce gerçekleşir. Bu nedenle, reklam öğesi henüz görünür olmayabilir. Bir alan için tüm reklam öğesi kaynaklarının yüklenmesi tamamlandığında bilgilendirilmek istiyorsanız bunun yerine events.SlotOnloadEvent'i kullanabilirsiniz.

Özellikler
`advertiserId`	Oluşturulan reklamın reklamveren kimliği.
`campaignId`	Oluşturulan reklamın kampanya kimliği.
`companyIds`	Oluşturulan dolgu reklam için teklif veren şirketlerin kimlikleri.
`creativeId`	Oluşturulan rezervasyon reklamının reklam öğesi kimliği.
`creativeTemplateId`	Oluşturulan rezervasyon reklamının reklam öğesi şablonu kimliği.
`isBackfill`	Reklamın dolgu reklam olup olmadığı.
`isEmpty`	Alana bir reklam döndürülüp döndürülmediği.
`labelIds`	Desteği sonlandırıldı.
`lineItemId`	Oluşturulan rezervasyon reklamının satır öğesi kimliği.
`responseIdentifier`	Yanıt tanımlayıcısı, reklam yanıtının benzersiz tanımlayıcısıdır.
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`size`	Oluşturulan reklam öğesinin piksel boyutunu gösterir.
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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 satır öğesi kimliği.
`yieldGroupIds`	Doldurma olarak oluşturulan reklamın getiri grubu kimlikleri.

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

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

Reklam etkinliği işleyicileri

Özellikler

advertiserId

advertiserId: number

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

campaignId

campaignId: number

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

companyIds

companyIds: number[]

Oluşturulan dolgu reklam için teklif veren şirketlerin kimlikleri. Boş alanlar, rezervasyon reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null'dır.

creativeId

creativeId: number

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

creativeTemplateId

creativeTemplateId: number

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

isBackfill

isBackfill: boolean

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

isEmpty

isEmpty: boolean

Alana bir reklam döndürülüp döndürülmediği. Reklam döndürülmediyse değer true, aksi takdirde false olur.

labelIds

labelIds: number[]

lineItemId

lineItemId: number

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

responseIdentifier

responseIdentifier: string

Yanıt tanımlayıcısı, reklam yanıtının benzersiz tanımlayıcısıdır. Bu değer, reklamı Reklam İnceleme Merkezi'nde (ARC) tanımlamak ve engellemek için kullanılabilir.

size

size: string | number[]

Oluşturulan reklam öğesinin piksel boyutunu gösterir. Örnek: [728, 90]. Boş reklam alanları için değer null'dır.

slotContentChanged

slotContentChanged: boolean

Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği. İçerik değiştirildiyse değer true, aksi takdirde false olur.

sourceAgnosticCreativeId

sourceAgnosticCreativeId: number

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

sourceAgnosticLineItemId

sourceAgnosticLineItemId: number

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

yieldGroupIds

yieldGroupIds: number[]

Doldurma olarak oluşturulan reklamın getiri grubu kimlikleri. Boş alanlar, rezervasyon reklamları ve PubAdsService dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değer null'dır.

googletag.events.SlotRequestedEvent

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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.events.SlotResponseReceived

Uzatır Event

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

Özellikler
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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.events.SlotVisibilityChangedEvent

Uzatır Event

Bu etkinlik, bir reklam alanı alanının ekrandaki yüzdesi her değiştiğinde tetiklenir. Etkinliğin sıklığı sınırlandırılmıştır ve 200 ms'de bir defadan daha sık tetiklenmez.

Özellikler
`inViewPercentage`	Reklamın görünen alanının yüzdesi.
`serviceName`	Etkinliği tetikleyen hizmetin adı. Devralındığı kaynak: `Event.serviceName`
`slot`	Etkinliği tetikleyen alan. Devralındığı kaynak: `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

Özellikler

inViewPercentage

inViewPercentage: number

Reklamın görünen alanının yüzdesi. Değer, 0 ile 100 arasında bir sayıdır.

googletag.secureSignals

Bu, GPT'nin güvenli sinyalleri yönetmek için kullandığı ad alanıdır.

Arayüzler
`BidderSignalProvider`	Belirli bir teklif veren için güvenli bir sinyal döndürür.
`PublisherSignalProvider`	Belirli bir yayıncı için güvenli bir sinyal döndürür.
`SecureSignalProvidersArray`	Güvenli sinyalleri yönetmek için kullanılan bir arayüz.

Tür Takma Adları
`SecureSignalProvider`	Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü.

Tür Takma Adları

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü. id veya networkCode özelliklerinden biri sağlanmalıdır ancak ikisi birden sağlanmamalıdır.

googletag.secureSignals.BidderSignalProvider

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

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

Güvenli sinyale çözümlenen bir Promise döndüren toplayıcı işlev.
Sinyalle ilişkili teklif vereni tanımlayan bir id.

Bir yayıncı için güvenli sinyal döndürmek üzere bunun yerine secureSignals.PublisherSignalProvider'ı kullanın.

Özellikler
`collectorFunction`	Güvenli bir sinyale dönüşen bir `Promise` döndüren işlev.
`id`	Google Ad Manager'da kaydedildiği şekliyle, bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısı.

Örnek

JavaScript

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (eski)

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// id is provided
googletag.secureSignalProviders!.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

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

Güvenli sinyalleri teklif verenlerle paylaşma

Özellikler

collectorFunction

collectorFunction: (() => Promise<string>)

Güvenli bir sinyale dönüşen bir Promise döndüren işlev.

id

id: string

Google Ad Manager'da kaydedildiği şekliyle, bu güvenli sinyalle ilişkili toplayıcının benzersiz tanımlayıcısı.

googletag.secureSignals.PublisherSignalProvider

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

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

Güvenli sinyale çözümlenen bir Promise döndüren toplayıcı işlev.
Sinyalle ilişkili yayıncıyı tanımlayan bir networkCode.

Bir teklif veren için güvenli sinyal döndürmek üzere bunun yerine secureSignals.BidderSignalProvider'ı kullanın.

Özellikler
`collectorFunction`	Güvenli bir sinyale dönüşen bir `Promise` döndüren işlev.
`networkCode`	Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).

Örnek

JavaScript

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (eski)

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// networkCode is provided
googletag.secureSignalProviders!.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

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

Güvenli sinyalleri teklif verenlerle paylaşma

Özellikler

collectorFunction

collectorFunction: (() => Promise<string>)

Güvenli bir sinyale dönüşen bir Promise döndüren işlev.

networkCode

networkCode: string

Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).

googletag.secureSignals.SecureSignalProvidersArray

Güvenli sinyalleri yönetmek için kullanılan bir arayüz.

Yöntemler
`clearAllCache`	Tüm toplayıcılar için tüm sinyalleri önbellekten temizler.
`push`	Sinyal sağlayıcı dizisine yeni bir secureSignals.SecureSignalProvider ekler ve sinyal oluşturma sürecini başlatır.

Yöntemler

clearAllCache

clearAllCache(): void

Tüm toplayıcılar için tüm sinyalleri önbellekten temizler.

Bu yöntemin çağrılması, mevcut ve potansiyel olarak sonraki sayfa görüntülemeleri için reklam isteklerine sinyallerin dahil olma olasılığını azaltabilir. Bu nedenle yöntem, yalnızca yeni bir kullanıcıyı belirten etkinlikler (oturum açma, oturumu kapatma, kaydolma vb.) gibi önemli durum değişiklikleri olduğunda çağrılmalıdır.

push

push(provider: SecureSignalProvider): void

Sinyal sağlayıcı dizisine yeni bir secureSignals.SecureSignalProvider ekler ve sinyal oluşturma sürecini başlatır.

Parametreler
`provider: SecureSignalProvider`	Diziye eklenecek secureSignals.SecureSignalProvider nesnesi.

GPT Referansı Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yazı ek açıklamaları

googletag

Tür Takma Adları

GeneralSize

MultiSize

NamedSize

SingleSize

SingleSizeArray

SizeMapping

SizeMappingArray

Değişkenler

Const apiReady

Const cmd

JavaScript

JavaScript (eski)

TypeScript

Const pubadsReady

secureSignalProviders

JavaScript

JavaScript (eski)

TypeScript

İşlevler

companionAds

defineOutOfPageSlot

JavaScript

JavaScript (eski)

TypeScript

defineSlot

JavaScript

JavaScript (eski)

TypeScript

destroySlots

JavaScript

JavaScript (eski)

TypeScript

disablePublisherConsole

display

enableServices

getConfig

JavaScript

JavaScript (eski)

TypeScript

getVersion

openConsole

JavaScript

JavaScript (eski)

TypeScript

pubads

setAdIframeTitle

JavaScript

JavaScript (eski)

TypeScript

setConfig

sizeMapping

googletag.CommandArray

Yöntemler

push

JavaScript

JavaScript (eski)

TypeScript

googletag.CompanionAdsService

Devralındığı kaynak: Service.addEventListener

Devralındığı kaynak: Service.getSlots

Devralındığı kaynak: Service.removeEventListener

Yöntemler

setRefreshUnfilledSlots

JavaScript

JavaScript (eski)

TypeScript

googletag.PrivacySettingsConfig

Özellikler

Optional childDirectedTreatment

Optional limitedAds

JavaScript

JavaScript (eski)

TypeScript

Optional nonPersonalizedAds

Optional restrictDataProcessing

Optional trafficSource

GPT Referansı

`Const` apiReady

`Const` cmd

`Const` pubadsReady

Devralındığı kaynak: `Service.addEventListener`

Devralındığı kaynak: `Service.getSlots`

Devralındığı kaynak: `Service.removeEventListener`

`Optional` childDirectedTreatment

`Optional` limitedAds

`Optional` nonPersonalizedAds

`Optional` restrictDataProcessing

`Optional` trafficSource

`Optional` underAgeOfConsent

Devralındığı kaynak: `Service.addEventListener`

Devralındığı kaynak: `Service.getSlots`

Devralındığı kaynak: `Service.removeEventListener`