GPT Referansı

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

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

Ek açıklamalar yazın

Değişken, parametre adı, özellik adı veya işlev imzasından sonra gelen iki nokta işareti, tür ek açıklamasını ifade eder. Tür ek açıklamaları, iki nokta işaretinin solundaki öğenin kabul edebileceği veya döndürebileceği türleri açıklar. Aşağıdaki tabloda, bu referansta görebileceğiniz ek açıklama türü örnekleri verilmektedir.

---

Tür Tanımları

Sıralama Türleri

---

googletag.enums.OutOfPageFormat

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

• Şunlara da bakabilirsiniz:

  • defineOutOfPageSlot

• Değerler
  BOTTOM_ANCHOR	Alanın görüntü alanının alt kısmında kaldığı sabit reklam biçimi.
  INTERSTITIAL	Web geçiş reklamı biçimi.
  LEFT_SIDE_RAIL	Sol yan reklam sütunu biçimi.
  REWARDED	Ödüllü reklam biçimi.
  RIGHT_SIDE_RAIL	Sağ yan reklam sütunu biçimi.
  TOP_ANCHOR	Alanın görüntü alanının üst kısmında kaldığı sabit reklam biçimi.

---

googletag.enums.TrafficSource

• GPT tarafından desteklenen trafik kaynakları.

• Şunlara da bakabilirsiniz:

  • PrivacySettingsConfig.trafficSource

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

---

googletag

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

---

googletag.CommandArray

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

---

googletag.CompanionAdsService

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

Şunlara da bakabilirsiniz:

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

---

googletag.PrivacySettingsConfig

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

Şunlara da bakabilirsiniz:

• Gizlilik ayarlarını yapılandırma

---

googletag.PubAdsService

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

---

googletag.ResponseInformation

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

Şunlara da bakabilirsiniz:

• Slot.getResponseInformation

---

googletag.RewardedPayload

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

Şunlara da bakabilirsiniz:

• Ödüllü reklam yayınlama

---

googletag.SafeFrameConfig

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

Şunlara da bakabilirsiniz:

• PubAdsService.setSafeFrameConfig

---

googletag.Service

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

---

googletag.SizeMappingBuilder

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

Şunlara da bakabilirsiniz:

• Reklam boyutları: Duyarlı reklamlar

---

googletag.Slot

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

---

googletag.config.AdExpansionConfig

Reklam genişletmeyi kontrol etmek için ayarlar.

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

---

googletag.config.ComponentAuctionConfig

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

Şunlara da bakabilirsiniz:

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

---

googletag.config.InterstitialConfig

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

---

googletag.config.PageSettingsConfig

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

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

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

Örnekler:

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

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

• Belirli bir özellikle ilgili tüm ayarlar, setConfig için yapılan her çağrıyla güncellenir.

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

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

    // Configure features delta, golf, and hotel.
    googletag.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    googletag.setConfig({
        delta: null,
        hotel: null,
    });
  

---

googletag.config.PrivacyTreatmentsConfig

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

---

googletag.config.PublisherProvidedSignalsConfig

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

Örnek

JavaScript

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

JavaScript (eski)

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

TypeScript

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

Şunlara da bakabilirsiniz:

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

---

googletag.config.SlotSettingsConfig

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

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

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

Örnekler:

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

    const slot = googletag.defineSlot("/1234567/example", [160, 600]);
  
    // Configure feature alpha.
    slot.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    slot.setConfig({
       bravo: {...}
    });
  

• Belirli bir özellikle ilgili tüm ayarlar, Slot.setConfig için yapılan her çağrıyla güncellenir.

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

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

    // Configure features delta, golf, and hotel.
    slot.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    slot.setConfig({
        delta: null,
        hotel: null,
    });
  

---

googletag.config.TaxonomyData

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

---

googletag.events.Event

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.EventTypeMap

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

---

googletag.events.ImpressionViewableEvent

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.RewardedSlotClosedEvent

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

Örnek

JavaScript

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

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

JavaScript (eski)

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

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

TypeScript

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam yayınlama

---

googletag.events.RewardedSlotGrantedEvent

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam yayınlama

---

googletag.events.RewardedSlotReadyEvent

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri
• Ödüllü reklam yayınlama

---

googletag.events.SlotOnloadEvent

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotRenderEndedEvent

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

Örnek

JavaScript

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

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

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

JavaScript (eski)

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

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

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

TypeScript

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

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotRequestedEvent

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotResponseReceived

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.events.SlotVisibilityChangedEvent

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

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

Şunlara da bakabilirsiniz:

• Reklam etkinliği işleyicileri

---

googletag.secureSignals.BidderSignalProvider

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

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

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

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

Şunlara da bakabilirsiniz:

• Güvenli sinyalleri teklif verenlerle paylaşma

---

googletag.secureSignals.PublisherSignalProvider

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

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

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

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

Şunlara da bakabilirsiniz:

• Güvenli sinyalleri teklif verenlerle paylaşma

---

googletag.secureSignals.SecureSignalProvidersArray

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