Dokumentacja GPT

W tym dokumencie do opisywania typów użyto notacji TypeScript. W tabeli poniżej znajdziesz krótkie objaśnienie poszczególnych przykładów.

Więcej informacji o obsługiwanych typach i wyrażeniach znajdziesz w podręczniku TypeScript .

Adnotacje typu

Dwukropek za zmienną, nazwą parametru, nazwą właściwości lub podpisem funkcji wskazuje adnotację typu. Adnotacje typu opisują typy, które element po lewej stronie dwukropka może akceptować lub zwracać. W tabeli poniżej znajdziesz przykłady adnotacji, które możesz zobaczyć w tym artykule.

---

Definicje typów

Typy wyliczeń

---

googletag.enums.OutOfPageFormat

• Formaty poza stroną obsługiwane przez GPT.

• Zobacz też

  • defineOutOfPageSlot

• Wartości
  BOTTOM_ANCHOR	Format reklamy zakotwiczonej, w którym boks przykleja się do dolnej części widocznego obszaru.
  INTERSTITIAL	Format kreacji pełnoekranowej w internecie.
  LEFT_SIDE_RAIL	Format lewej kolumny bocznej.
  REWARDED	Format reklamy z nagrodą.
  RIGHT_SIDE_RAIL	Format prawej kolumny bocznej.
  TOP_ANCHOR	Format reklamy zakotwiczonej, w którym boks przykleja się do górnej części widocznego obszaru.

---

googletag.enums.TrafficSource

• Źródła wizyt obsługiwane przez GPT.

• Zobacz też

  • PrivacySettingsConfig.trafficSource

• Wartości
  ORGANIC	Bezpośrednie wprowadzanie adresu URL, wyszukiwanie w witrynie lub pobieranie aplikacji.
  PURCHASED	Ruch przekierowywany z usług innych firm (pozyskiwane lub w inny sposób zachęty do działania).

---

googletag

Globalna przestrzeń nazw interfejsu API tagu wydawcy Google.

---

googletag.CommandArray

Tablica poleceń akceptuje sekwencję funkcji i wywołuje je w kolejności. Ma ona zastąpić tablicę standardową, która służy do umieszczania w kolejce funkcji do wywołania po załadowaniu tagu GPT.

---

googletag.CompanionAdsService

Usługa reklam towarzyszących. Ta usługa jest wykorzystywana w reklamach wideo do wyświetlania reklam towarzyszących.

Zobacz też

• Reklamy towarzyszące w kampaniach wideo i audio

---

googletag.PrivacySettingsConfig

Obiekt konfiguracji ustawień prywatności.

Zobacz też

• Konfigurowanie ustawień prywatności

---

googletag.PubAdsService

Usługa Reklamy wydawcy. Ta usługa służy do pobierania i wyświetlania reklam z konta Google Ad Managera.

---

googletag.ResponseInformation

Obiekt reprezentujący pojedynczą odpowiedź na żądanie reklamy.

Zobacz też

• Slot.getResponseInformation

---

googletag.RewardedPayload

Obiekt reprezentujący nagrodę powiązaną z reklamą z nagrodą

Zobacz też

• Wyświetlanie reklamy z nagrodą

---

googletag.SafeFrameConfig

Obiekt konfiguracji kontenerów SafeFrame.

Zobacz też

• PubAdsService.setSafeFrameConfig

---

googletag.Service

Klasa usługi podstawowej, która zawiera metody wspólne dla wszystkich usług.

---

googletag.SizeMappingBuilder

Kreator obiektów specyfikacji mapowania rozmiaru. Narzędzie to ułatwia tworzenie specyfikacji rozmiarów.

Zobacz też

• Rozmiary reklam: reklamy elastyczne

---

googletag.Slot

Boks to obiekt reprezentujący pojedynczy boks reklamowy na stronie.

---

googletag.config.AdExpansionConfig

Ustawienia sterujące rozwijaniem reklam.

Przykład

JavaScript

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

JavaScript (starsza wersja)

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

Obiekt reprezentujący aukcję z jednym elementem w aukcji reklam na urządzeniu.

Zobacz też

• Przewodnik po Protected Audience API dla sprzedawców: przeprowadzanie aukcji reklam

---

googletag.config.InterstitialConfig

Obiekt określający działanie pojedynczego pełnoekranowego boksu reklamowego.

---

googletag.config.PageSettingsConfig

Główny interfejs konfiguracyjny ustawień na poziomie strony.

Umożliwia skonfigurowanie wielu funkcji przy użyciu jednego wywołania interfejsu API.

Wszystkie właściwości wymienione poniżej są przykładami i nie odzwierciedlają rzeczywistych funkcji, które korzystają z funkcji setConfig. Zestaw funkcji znajdziesz w polach typu PageSettingsConfig poniżej.

Przykłady:

• Zmodyfikowane są tylko funkcje określone w wywołaniu setConfig.

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

• Wszystkie ustawienia danej funkcji są aktualizowane przy każdym wywołaniu funkcji setConfig.

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

• Wszystkie ustawienia funkcji można wyczyścić, przekazując null.

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

Ustawienia kontroli prywatności wydawcy.

---

googletag.config.PublisherProvidedSignalsConfig

Obiekt konfiguracji sygnałów dostarczanych przez wydawcę.

Przykład

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 (starsza wersja)

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

Zobacz też

• Sygnały dostarczane przez wydawcę (beta)
• Taksonomia odbiorców IAB 1.1
• Taksonomia treści IAB 2.2

---

googletag.config.SlotSettingsConfig

Główny interfejs konfiguracyjny ustawień na poziomie boksu.

Umożliwia skonfigurowanie wielu funkcji przy użyciu jednego wywołania interfejsu API dla jednego boksu.

Wszystkie właściwości wymienione poniżej są przykładami i nie odzwierciedlają rzeczywistych funkcji, które korzystają z setConfig. Zestaw funkcji znajdziesz w polach typu SlotSettingsConfig poniżej.

Przykłady:

• Zmodyfikowane są tylko funkcje określone w wywołaniu Slot.setConfig.

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

• Wszystkie ustawienia danej funkcji są aktualizowane przy każdym wywołaniu funkcji Slot.setConfig.

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

• Wszystkie ustawienia funkcji można wyczyścić, przekazując null.

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

Obiekt zawierający wartości pojedynczej taksonomii.

---

googletag.events.Event

Podstawowy interfejs do wszystkich zdarzeń GPT. Wszystkie poniższe zdarzenia GPT będą miały te pola.

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.EventTypeMap

To pseudotyp, który mapuje nazwę zdarzenia na odpowiadający mu typ obiektu zdarzenia dla Service.addEventListener i Service.removeEventListener. Jest ona udokumentowana tylko w celach referencyjnych i bezpieczeństwa wpisywania.

---

googletag.events.ImpressionViewableEvent

Zdarzenie to jest wywoływane, gdy wyświetlenie staje się widoczne zgodnie z kryteriami Widoku aktywnego.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.RewardedSlotClosedEvent

Zdarzenie jest wywoływane, gdy użytkownik zamknie boks reklamowy z nagrodą. Może się uruchomić przed przyznaniem nagrody lub po jej przyznaniu. Aby sprawdzić, czy nagroda została przyznana, użyj narzędzia events.RewardedSlotGrantedEvent.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy
• Wyświetlanie reklamy z nagrodą

---

googletag.events.RewardedSlotGrantedEvent

Zdarzenie jest uruchamiane, gdy zostanie przyznana nagroda za obejrzenie reklamy z nagrodą. Jeśli reklama zostanie zamknięta, zanim zostaną spełnione kryteria przyznawania nagrody, zdarzenie nie zostanie uruchomione.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy
• Wyświetlanie reklamy z nagrodą

---

googletag.events.RewardedSlotReadyEvent

Zdarzenie to jest wywoływane, gdy reklama z nagrodą jest gotowa do wyświetlenia. Wydawca odpowiada za umożliwienie użytkownikom obejrzenia reklamy przed jej wyświetleniem.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy
• Wyświetlanie reklamy z nagrodą

---

googletag.events.SlotOnloadEvent

To zdarzenie jest wywoływane, gdy element iframe kreacji uruchomi zdarzenie wczytywania. Podczas renderowania reklam multimedialnych w trybie renderowania synchronicznego nie są używane żadne elementy iframe, więc element SlotOnloadEvent nie będzie uruchamiany.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.SlotRenderEndedEvent

To zdarzenie jest wywoływane po wstrzyknięciu kodu kreacji do boksu. Zdarzenie to nastąpi przed pobraniem zasobów kreacji, więc może ona być jeszcze niewidoczna. Jeśli chcesz wiedzieć, kiedy wszystkie zasoby kreacji w danym boksie zostały wczytane, skorzystaj z tabeli events.SlotOnloadEvent.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.SlotRequestedEvent

Zdarzenie to jest wywoływane po wysłaniu żądania reklamy dla określonego boksu.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.SlotResponseReceived

Zdarzenie to jest wywoływane po otrzymaniu odpowiedzi na reklamę w przypadku określonego boksu.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.events.SlotVisibilityChangedEvent

Zdarzenie jest wywoływane zawsze, gdy zmienia się odsetek obszaru boksu reklamowego na ekranie. Zdarzenie jest ograniczane i będzie uruchamiane nie częściej niż raz na 200 ms.

Przykład

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 (starsza wersja)

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

Zobacz też

• Detektory zdarzeń reklamy

---

googletag.secureSignals.BidderSignalProvider

Zwraca bezpieczny sygnał dla określonego licytującego.

Dostawca bezpiecznych sygnałów dla licytującego składa się z 2 części:

1. Funkcja kolektora, która zwraca wartość Promise, która zmienia się w bezpieczny sygnał.
2. Element id, który identyfikuje licytującego powiązanego z sygnałem.

Przykład

JavaScript

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (starsza wersja)

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

Zobacz też

• Udostępnianie bezpiecznych sygnałów licytującym

---

googletag.secureSignals.PublisherSignalProvider

Zwraca bezpieczny sygnał dla określonego wydawcy.

Dostawca sygnału dla wydawcy składa się z 2 części:

1. Funkcja kolektora, która zwraca wartość Promise, która zmienia się w bezpieczny sygnał.
2. Identyfikator networkCode, który identyfikuje wydawcę powiązanego z sygnałem.

Przykład

JavaScript

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

JavaScript (starsza wersja)

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

Zobacz też

• Udostępnianie bezpiecznych sygnałów licytującym

---

googletag.secureSignals.SecureSignalProvidersArray

Interfejs do zarządzania bezpiecznymi sygnałami.