GPT-Referenz

In dieser Referenz wird die TypeScript-Notation zum Beschreiben von Typen verwendet. Die folgende Tabelle enthält eine kurze Erläuterung anhand von Beispielen.

Weitere Informationen zu unterstützten Typen und Typausdrücken finden Sie in der <ph type="x-smartling-placeholder"></ph> TypeScript-Handbuch

Anmerkungen eingeben

Ein Doppelpunkt nach einer Variablen, einem Parameternamen, einem Eigenschaftsnamen oder einer Funktionssignatur bezeichnet ein Anmerkung. Typanmerkungen beschreiben die Typen, die das Element links vom Doppelpunkt enthält. akzeptieren oder zurückgeben können. Die folgende Tabelle enthält Beispiele für Typanmerkungen, die Sie in dieser Referenz.

---

Typdefinitionen

Enum-Typen

---

googletag.enums.OutOfPageFormat

• Von GPT unterstützte Out-of-Page-Formate.

• Weitere Informationen

  • defineOutOfPageSlot

• Werte
  BOTTOM_ANCHOR	Ankerformat, bei dem die Anzeigenfläche am unteren Rand des Darstellungsbereichs fixiert ist.
  GAME_MANUAL_INTERSTITIAL	Manuelles Interstitial-Format für Spiele. Hinweis:Manuelle Interstitial-Anzeigen für Spiele sind eingeschränkt.
  INTERSTITIAL	Web-Interstitial-Creative-Format.
  LEFT_SIDE_RAIL	Linker Anzeigenstreifen.
  REWARDED	Anzeigen mit Prämie
  RIGHT_SIDE_RAIL	Rechter Anzeigenstreifen im seitlichen Anzeigenstreifen.
  TOP_ANCHOR	Ankerformat, bei dem die Anzeigenfläche am oberen Rand des Darstellungsbereichs fixiert ist.

---

googletag.enums.TrafficSource

• Von GPT unterstützte Besucherquellen

• Weitere Informationen

  • PrivacySettingsConfig.trafficSource

• Werte
  ORGANIC	Direkte URL-Eingabe, Websitesuche oder App-Download
  PURCHASED	Zugriffe wurden von Properties weitergeleitet, die keine eigenen Properties sind (durch akquirierte oder auf andere Weise geförderte Aktivitäten).

---

googletag

Der globale Namespace, den das Google Publisher-Tag für seine API verwendet.

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.CommandArray

Das Befehlsarray akzeptiert eine Reihe von Funktionen und ruft diese der Reihe nach auf. Es soll ein Standardarray ersetzen, mit dem Funktionen in die Warteschlange eingereiht werden, die nach dem Laden von GPT aufgerufen werden.

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.CompanionAdsService

Companion-Anzeigendienst. Dieser Dienst wird von Videoanzeigen zur Auslieferung von Companion-Anzeigen verwendet.

Weitere Informationen

• Companion-Anzeigen für Video und Audio

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.PrivacySettingsConfig

Konfigurationsobjekt für Datenschutzeinstellungen.

Weitere Informationen

• Datenschutzeinstellungen konfigurieren

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.PubAdsService

Publisher-Anzeigendienst. Mit diesem Dienst werden Anzeigen aus Ihrem Google Ad Manager-Konto abgerufen und ausgeliefert.

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.ResponseInformation

Ein Objekt, das eine einzelne Anzeigenantwort darstellt.

Weitere Informationen

• Slot.getResponseInformation

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.RewardedPayload

Ein Objekt, das die mit einer Anzeige mit Prämie verknüpfte Prämie darstellt

Weitere Informationen

• Anzeigen mit Prämie präsentieren

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.SafeFrameConfig

Konfigurationsobjekt für SafeFrame-Container.

Weitere Informationen

• PubAdsService.setSafeFrameConfig

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.Service

Basisdienstklasse, die Methoden enthält, die für alle Dienste gelten.

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.SizeMappingBuilder

Builder für Größenzuordnungsspezifikationsobjekte. Dieser Builder wird zur Verfügung gestellt, um Größenspezifikationen einfach zu erstellen.

Weitere Informationen

• Anzeigengrößen: Responsive Anzeigen

---

<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> googletag.Slot

Eine Anzeigenfläche ist ein Objekt, das eine einzelne Anzeigenfläche auf einer Seite darstellt.

---

<ph type="x-smartling-placeholder"></ph> googletag.config.AdExpansionConfig

Einstellungen zur Steuerung der Anzeigenexpansion.

Beispiel

JavaScript

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

JavaScript (alte Version)

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

---

<ph type="x-smartling-placeholder"></ph> googletag.config.ComponentAuctionConfig

Ein Objekt, das eine Einzelkomponentenauktion in einer On-Device-Anzeigenauktion darstellt.

Weitere Informationen

• Protected Audience API-Leitfaden für Verkäufer: Anzeigenauktionen durchführen

---

<ph type="x-smartling-placeholder"></ph> googletag.config.InterstitialConfig

Ein Objekt, das das Verhalten einer einzelnen Interstitial-Anzeigenfläche definiert.

---

<ph type="x-smartling-placeholder"></ph> googletag.config.PageSettingsConfig

Hauptkonfigurationsoberfläche für Einstellungen auf Seitenebene.

Hiermit können mit einem einzigen API-Aufruf mehrere Funktionen festgelegt werden.

Alle unten aufgeführten Attribute sind Beispiele. Sie stellen keine tatsächlichen Funktionen dar, für die „setConfig“ verwendet wird. Die einzelnen Funktionen finden Sie unten in den Feldern des Typs „PageSettingsConfig“.

Beispiele:

• Es werden nur die im setConfig-Aufruf angegebenen Elemente geändert.

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

• Alle Einstellungen für eine bestimmte Funktion werden bei jedem Aufruf von setConfig aktualisiert.

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

• Sie können alle Einstellungen für ein Element löschen, indem Sie null übergeben.

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

---

<ph type="x-smartling-placeholder"></ph> googletag.config.PrivacyTreatmentsConfig

Einstellungen zum Verwalten von Datenschutzmaßnahmen für Publisher.

---

<ph type="x-smartling-placeholder"></ph> googletag.config.PublisherProvidedSignalsConfig

Konfigurationsobjekt für vom Publisher bereitgestellte Signale (PPS).

Beispiel

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 (alte Version)

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

Weitere Informationen

• Vom Publisher bereitgestellte Signale (Beta)
• IAB-Taxonomie für Zielgruppen 1.1
• IAB-Taxonomie für Inhalte 2.2

---

<ph type="x-smartling-placeholder"></ph> googletag.config.SlotSettingsConfig

Hauptkonfigurationsoberfläche für Einstellungen auf Anzeigenflächenebene.

Hiermit können Sie mit einem einzigen API-Aufruf für einen einzelnen Slot mehrere Funktionen festlegen.

Alle unten aufgeführten Attribute sind Beispiele. Sie stellen keine tatsächlichen Funktionen dar, für die setConfig verwendet wird. Die einzelnen Funktionen finden Sie unten in den Feldern des Typs „SlotSettingsConfig“.

Beispiele:

• Es werden nur die im Slot.setConfig-Aufruf angegebenen Elemente geändert.

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

• Alle Einstellungen für eine bestimmte Funktion werden bei jedem Aufruf von Slot.setConfig aktualisiert.

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

• Sie können alle Einstellungen für ein Element löschen, indem Sie null übergeben.

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

---

<ph type="x-smartling-placeholder"></ph> googletag.config.TaxonomyData

Ein Objekt, das die Werte für eine einzelne Taxonomie enthält.

---

<ph type="x-smartling-placeholder"></ph> googletag.events.Event

Basisoberfläche für alle GPT-Ereignisse Alle nachfolgenden GPT-Ereignisse haben die folgenden Felder.

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.EventTypeMap

Dies ist ein Pseudotyp, der einen Ereignisnamen dem entsprechenden Ereignisobjekttyp für Service.addEventListener und Service.removeEventListener zuordnet. Sie ist nur zu Referenz- und Typsicherheitszwecken dokumentiert.

---

<ph type="x-smartling-placeholder"></ph> googletag.events.GameManualInterstitialSlotClosedEvent

Dieses Ereignis wird ausgelöst, wenn eine manuelle Interstitial-Fläche für ein Spiel vom Nutzer geschlossen wurde.

Hinweis:Manuelle Interstitial-Anzeigen für Spiele haben ein eingeschränktes Format.

Beispiel

JavaScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

JavaScript (alte Version)

// This listener is called when a game manual interstial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

Weitere Informationen

• Listener für Anzeigenereignisse
• Manuelle Interstitial-Anzeige für ein Spiel einblenden

---

<ph type="x-smartling-placeholder"></ph> googletag.events.GameManualInterstitialSlotReadyEvent

Dieses Ereignis wird ausgelöst, wenn eine manuelle Interstitial-Fläche für ein Spiel dem Nutzer angezeigt werden kann.

Hinweis:Manuelle Interstitial-Anzeigen für Spiele haben ein eingeschränktes Format.

Beispiel

JavaScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (alte Version)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

Weitere Informationen

• Listener für Anzeigenereignisse
• Manuelle Interstitial-Anzeige für ein Spiel einblenden

---

<ph type="x-smartling-placeholder"></ph> googletag.events.ImpressionViewableEvent

Dieses Ereignis wird ausgelöst, wenn eine Impression gemäß den Active View-Kriterien sichtbar wird.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.RewardedSlotClosedEvent

Dieses Ereignis wird ausgelöst, wenn eine Anzeigenfläche mit Prämie vom Nutzer geschlossen wird. Sie kann entweder vor oder nach der Gewährung einer Prämie ausgelöst werden. Wenn du feststellen möchtest, ob eine Prämie gewährt wurde, verwende stattdessen events.RewardedSlotGrantedEvent.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse
• Anzeigen mit Prämie präsentieren

---

<ph type="x-smartling-placeholder"></ph> googletag.events.RewardedSlotGrantedEvent

Dieses Ereignis wird ausgelöst, wenn eine Prämie für das Ansehen einer Anzeige mit Prämie gewährt wird. Wenn die Anzeige geschlossen wird, bevor die Kriterien für die Gewährung einer Prämie erfüllt sind, wird dieses Ereignis nicht ausgelöst.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse
• Anzeigen mit Prämie präsentieren

---

<ph type="x-smartling-placeholder"></ph> googletag.events.RewardedSlotReadyEvent

Dieses Ereignis wird ausgelöst, wenn eine Anzeige mit Prämie bereit zur Auslieferung ist. Der Publisher ist dafür verantwortlich, dass der Nutzer die Anzeige vor der Auslieferung sieht.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse
• Anzeigen mit Prämie präsentieren

---

<ph type="x-smartling-placeholder"></ph> googletag.events.SlotOnloadEvent

Dieses Ereignis tritt ein, wenn der iFrame des Creatives das zugehörige Ladeereignis auslöst. Beim Rendern von Rich Media-Anzeigen im synchronen Renderingmodus wird kein iFrame verwendet, sodass kein SlotOnloadEvent ausgelöst wird.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.SlotRenderEndedEvent

Dieses Ereignis wird ausgelöst, wenn der Creative-Code in eine Anzeigenfläche injiziert wird. Dieses Ereignis tritt ein, bevor die Ressourcen des Creatives abgerufen werden, sodass das Creative möglicherweise noch nicht sichtbar ist. Wenn Sie wissen möchten, wann alle Creative-Ressourcen für eine Anzeigenfläche geladen sind, verwenden Sie stattdessen die events.SlotOnloadEvent.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.SlotRequestedEvent

Dieses Ereignis wird ausgelöst, wenn eine Anzeige für eine bestimmte Anzeigenfläche angefordert wurde.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.SlotResponseReceived

Dieses Ereignis wird ausgelöst, wenn eine Anzeigenantwort für eine bestimmte Anzeigenfläche empfangen wird.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.events.SlotVisibilityChangedEvent

Dieses Ereignis wird immer dann ausgelöst, wenn sich der Bildschirmprozentsatz einer Anzeigenfläche ändert. Das Ereignis wird gedrosselt und nicht häufiger als einmal alle 200 ms ausgelöst.

Beispiel

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 (alte Version)

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

Weitere Informationen

• Listener für Anzeigenereignisse

---

<ph type="x-smartling-placeholder"></ph> googletag.secureSignals.BidderSignalProvider

Gibt ein sicheres Signal für einen bestimmten Bieter zurück.

Ein Anbieter sicherer Signale besteht aus zwei Teilen:

1. Eine Collector-Funktion, die eine Promise zurückgibt, die in ein sicheres Signal aufgelöst wird.
2. Ein id, der den mit dem Signal verknüpften Bieter identifiziert.

Beispiel

JavaScript

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

JavaScript (alte Version)

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

Weitere Informationen

• Sichere Signale für Bieter freigeben

---

<ph type="x-smartling-placeholder"></ph> googletag.secureSignals.PublisherSignalProvider

Gibt ein sicheres Signal für einen bestimmten Publisher zurück.

Ein Anbieter von Publisher-Signalen besteht aus zwei Teilen:

1. Eine Collector-Funktion, die eine Promise zurückgibt, die in ein sicheres Signal aufgelöst wird.
2. Ein networkCode, der den mit dem Signal verknüpften Publisher identifiziert.

Beispiel

JavaScript

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

JavaScript (alte Version)

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

Weitere Informationen

• Sichere Signale für Bieter freigeben

---

<ph type="x-smartling-placeholder"></ph> googletag.secureSignals.SecureSignalProvidersArray

Eine Schnittstelle zum Verwalten sicherer Signale.