GPT-Referenz

Führt die in den Argumenten angegebene Funktionssequenz in der angegebenen Reihenfolge aus.

Beispiel

JavaScript

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

JavaScript (alt)

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

TypeScript

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

Legt fest, ob Companion-Flächen, die nicht gefüllt wurden, automatisch aufgefüllt werden.

Diese Methode kann während der Lebensdauer der Seite mehrmals aufgerufen werden, um den Backfill zu aktivieren und zu deaktivieren. Nur Anzeigenflächen, die auch beim PubAdsService registriert sind, werden aufgefüllt. Aufgrund von Richtlinieneinschränkungen ist diese Methode nicht dafür vorgesehen, leere Companion-Slots zu füllen, wenn ein Ad Exchange-Video ausgeliefert wird.

Beispiel

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (alt)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Gibt an, ob die Seite als an Kinder gerichtet behandelt werden soll. Legen Sie null fest, um die Konfiguration zu löschen.

Hiermit wird die Auslieferung im Modus Eingeschränkte Anzeigenausrichtung aktiviert, um die gesetzlichen Anforderungen von Publishern zu erfüllen.

Sie haben zwei Möglichkeiten, GPT anzuweisen, die eingeschränkte Anzeigenausrichtung anzufordern:

• Automatisch über ein Signal von einer Plattform zur Einwilligungsverwaltung für IAB TCF 2.0
• Manuell, indem Sie den Wert dieses Felds auf true festlegen.

Beispiel

JavaScript

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

JavaScript (alt)

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

TypeScript

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

Weitere Informationen

• Eingeschränkte Anzeigen ausliefern

Ermöglicht die Auslieferung im Modus Nicht personalisierte Anzeigen, um die Einhaltung der rechtlichen Anforderungen von Publishern zu unterstützen.

Ermöglicht die Anzeigenbereitstellung im Modus für die eingeschränkte Datenverarbeitung, um Publishern bei der Einhaltung regulatorischer Anforderungen zu helfen.

Gibt an, ob Anfragen gekaufte oder organische Zugriffe betreffen. Anhand dieses Werts wird die Dimension Zugriffsquelle in Ad Manager-Berichten ausgefüllt. Wenn nichts festgelegt ist, wird für die Besucherquelle in Berichten standardmäßig „undefined“ verwendet.

Beispiel

JavaScript

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

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

JavaScript (alt)

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

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

TypeScript

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

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

Gibt an, ob Anzeigenanfragen als Anfragen von Nutzern gekennzeichnet werden sollen, die das erforderliche Mindestalter noch nicht erreicht haben. Legen Sie null fest, um die Konfiguration zu löschen.

Die Anzeigen werden aus den angegebenen Slots entfernt und durch leere Inhalte ersetzt. Die Slots werden als nicht abgerufen gekennzeichnet.

Wenn Sie einen Slot löschen, wird die Anzeige insbesondere aus dem langlebigen Seitenaufruf des GPT entfernt. So werden zukünftige Anfragen nicht durch Blockaden oder Wettbewerbsausschlüsse für diese Anzeige beeinflusst.

Beispiel

JavaScript

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

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

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

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

JavaScript (alt)

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

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

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

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

TypeScript

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

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

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

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

Löscht alle Labels für den Ausschluss von Anzeigenkategorien auf Seitenebene. Das ist nützlich, wenn Sie den Slot aktualisieren möchten.

Beispiel

JavaScript

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

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

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

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

JavaScript (alt)

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

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

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

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

TypeScript

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

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

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

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

Weitere Informationen

• Benutzerdefinierte Labels zum Blockieren von Anzeigen

Benutzerdefinierte Targeting-Parameter für einen bestimmten Schlüssel oder für alle Schlüssel werden gelöscht.

Beispiel

JavaScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

JavaScript (alt)

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

TypeScript

googletag.pubads().setTargeting("interests", "sports");
googletag.pubads().setTargeting("colors", "blue");
googletag.pubads().setTargeting("fruits", "apple");

googletag.pubads().clearTargeting("interests");
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.pubads().clearTargeting();
// All targeting has been cleared.

Weitere Informationen

• Schlüssel/Wert-Paar-Targeting

Hiermit können Slot-Divs minimiert werden, damit sie keinen Platz auf der Seite einnehmen, wenn kein Anzeigencontent zu sehen ist. Dieser Modus muss festgelegt werden, bevor der Dienst aktiviert wird.

Weitere Informationen

• Leere Anzeigenflächen minimieren
• Layout Shift minimieren

Deaktiviert Anfragen für Anzeigen beim Seitenaufbau, ermöglicht aber das Anfordern von Anzeigen mit einem PubAdsService.refresh-Aufruf. Diese Einstellung sollte vor der Aktivierung des Dienstes festgelegt werden. Der asynchrone Modus muss verwendet werden, da es sonst nicht möglich ist, Anzeigen über refresh anzufordern.

Weitere Informationen

• Anzeigenlade- und -aktualisierung steuern
• Batchverarbeitung von SRAs steuern

Erstellt und zeigt eine Anzeigenfläche mit dem angegebenen Pfad und der angegebenen Größe des Anzeigenblocks an. Diese Methode funktioniert nicht im Modus „Einzelanfrage“.

Hinweis:Wenn diese Methode aufgerufen wird, wird ein Snapshot des Slots und des Seitenstatus erstellt, um für Konsistenz beim Senden der Anzeigenanfrage und beim Rendern der Antwort zu sorgen. Alle Änderungen, die nach dem Aufruf dieser Methode am Slot- oder Seitenstatus vorgenommen werden (z. B. Targeting, Datenschutzeinstellungen, erzwungenes SafeFrame), werden nur auf nachfolgende display()- oder refresh()-Anfragen angewendet.

Beispiel

JavaScript

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

JavaScript (alt)

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

TypeScript

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

Weitere Informationen

• Testanzeige präsentieren
• Anzeigenlade- und -aktualisierung steuern

Aktiviert das Lazy-Loading in GPT gemäß der Definition im Konfigurationsobjekt. Ausführlichere Beispiele finden Sie im Beispiel für Lazy Loading.

Hinweis:Das Lazy-Abrufen in der SRA funktioniert nur, wenn sich alle Slots außerhalb des Abrufmargens befinden.

Beispiel

JavaScript

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

JavaScript (alt)

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

TypeScript

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

Weitere Informationen

• Best Practices für Anzeigen: „Wichtige“ Anzeigenflächen priorisieren
• Lazy Loading

Hiermit wird der Modus „Einzelanfrage“ aktiviert, um mehrere Anzeigen gleichzeitig abzurufen. Dazu müssen alle Anzeigenflächen für Publisher-Anzeigen definiert und dem PubAdsService hinzugefügt werden, bevor der Dienst aktiviert wird. Der Modus für einzelne Anfragen muss festgelegt werden, bevor der Dienst aktiviert wird.

Weitere Informationen

• Best Practices für Anzeigen: Einzelanfrage-Architektur richtig verwenden
• Batchverarbeitung von SRAs steuern

Signalisiert GPT, dass Videoanzeigen auf der Seite vorhanden sind. So können Einschränkungen für Konkurrenzausschlüsse für Display- und Videoanzeigen aktiviert werden. Wenn der Videoinhalt bekannt ist, rufen Sie PubAdsService.setVideoContent auf, um Inhaltsausschlüsse für Displayanzeigen verwenden zu können.

Gibt den Wert für das AdSense-Attribut zurück, das mit dem jeweiligen Schlüssel verknüpft ist.

Beispiel

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (alt)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.

Weitere Informationen

• AdSense-Attribute

Gibt die Attributschlüssel zurück, die für diesen Dienst festgelegt wurden.

Beispiel

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (alt)

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

Gibt einen bestimmten benutzerdefinierten Parameter für die Ausrichtung auf Dienstebene zurück, der festgelegt wurde.

Beispiel

JavaScript

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

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

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

JavaScript (alt)

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

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

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

TypeScript

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

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

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

Gibt die Liste aller benutzerdefinierten Targeting-Schlüssel auf Dienstebene zurück, die festgelegt wurden.

Beispiel

JavaScript

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

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

JavaScript (alt)

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

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

TypeScript

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

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].

Gibt an, ob die ersten Anfragen für Anzeigen durch einen vorherigen Aufruf von PubAdsService.disableInitialLoad deaktiviert wurden.

Hiermit werden neue Anzeigen für bestimmte oder alle Anzeigenflächen auf der Seite abgerufen und angezeigt. Funktioniert nur im asynchronen Renderingmodus.

Damit die Funktion in allen Browsern richtig funktioniert, muss vor dem Aufruf von refresh ein Aufruf von display für die Anzeigenfläche erfolgen. Wenn der Aufruf von display weggelassen wird, kann es bei der Aktualisierung zu unerwartetem Verhalten kommen. Mit der Methode PubAdsService.disableInitialLoad können Sie verhindern, dass display eine Anzeige abruft.

Wenn Sie eine Anzeigenfläche aktualisieren, wird die alte Anzeige aus dem langlebigen Seitenaufruf von GPT entfernt. So werden zukünftige Anfragen nicht durch Blockierungen oder Wettbewerbsausschlüsse beeinflusst, die sich auf diese Anzeige beziehen.

Beispiel

JavaScript

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

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

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

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

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

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

JavaScript (alt)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

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

Weitere Informationen

• Anzeigenlade- und -aktualisierung steuern
• Anzeigenflächen aktualisieren

Legt Werte für AdSense-Attribute fest, die für alle Anzeigenflächen unter dem Publisher Ads-Dienst gelten.

Wenn Sie dies mehrmals für denselben Schlüssel aufrufen, werden die zuvor festgelegten Werte für diesen Schlüssel überschrieben. Alle Werte müssen festgelegt werden, bevor display oder refresh aufgerufen wird.

Beispiel

JavaScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");

JavaScript (alt)

googletag.pubads().set("adsense_background_color", "#FFFFFF");

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");

Weitere Informationen

• AdSense-Attribute

Legt einen Ausschluss der Anzeigenkategorie auf Seitenebene für den angegebenen Labelnamen fest.

Beispiel

JavaScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

JavaScript (alt)

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

TypeScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");

Weitere Informationen

• Benutzerdefinierte Labels zum Blockieren von Anzeigen

Hiermit wird die horizontale Zentrierung von Anzeigen aktiviert oder deaktiviert. Die Zentrierung ist standardmäßig deaktiviert. In der alten Version von gpt_mobile.js ist die Zentrierung standardmäßig aktiviert.

Diese Methode sollte vor dem Aufrufen von display oder refresh aufgerufen werden, da nur Anzeigen, die nach dem Aufrufen dieser Methode angefordert werden, zentriert werden.

Beispiel

JavaScript

// Make ads centered.
googletag.pubads().setCentering(true);

JavaScript (alt)

// Make ads centered.
googletag.pubads().setCentering(true);

TypeScript

// Make ads centered.
googletag.pubads().setCentering(true);

Mit dieser Richtlinie wird konfiguriert, ob das Rendering aller Anzeigen auf der Seite mit einem SafeFrame-Container erzwungen werden soll.

Beachten Sie bei der Verwendung dieser API Folgendes:

• Diese Einstellung gilt nur für nachfolgende Anzeigenanfragen für die jeweiligen Slots.
• Die Einstellung auf Anzeigenflächenebene überschreibt immer die Einstellung auf Seitenebene.
• Wenn der Wert auf true (auf Anzeigenflächen- oder Seitenebene) festgelegt ist, wird die Anzeige unabhängig von der Auswahl auf der Google Ad Manager-Benutzeroberfläche immer mit einem SafeFrame-Container gerendert.
• Wenn Sie jedoch false festlegen oder die Option nicht angeben, wird die Anzeige je nach Creative-Typ und Auswahl auf der Google Ad Manager-Benutzeroberfläche mit einem SafeFrame-Container gerendert.
• Diese API sollte mit Vorsicht verwendet werden, da sie sich auf das Verhalten von Creatives auswirken kann, die versuchen, aus ihren iFrames auszubrechen oder die direkt auf einer Publisher-Seite gerendert werden müssen.

Beispiel

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (alt)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

Weitere Informationen

• Creatives mit SafeFrame rendern

Gibt Standortinformationen von Websites weiter, sodass Sie Werbebuchungen per geografischem Targeting auf bestimmte Orte ausrichten können.

Beispiel

JavaScript

// Postal code:
googletag.pubads().setLocation("10001,US");

JavaScript (alt)

// Postal code:
googletag.pubads().setLocation("10001,US");

TypeScript

// Postal code:
googletag.pubads().setLocation("10001,US");

Ermöglicht die Konfiguration aller Datenschutzeinstellungen über eine einzelne API mithilfe eines Konfigurationsobjekts.

Beispiel

JavaScript

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

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

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

JavaScript (alt)

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

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

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

TypeScript

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

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

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

Weitere Informationen

• Datenschutzeinstellungen konfigurieren
• Eingeschränkte Anzeigenausrichtung

Legt den Wert für die vom Publisher bereitgestellte ID fest.

Beispiel

JavaScript

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

JavaScript (alt)

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

TypeScript

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

Weitere Informationen

• PPIDs (Publisher Provided Identifiers)

Legt die Einstellungen für die SafeFrame-Konfiguration auf Seitenebene fest. Alle nicht erkannten Schlüssel im Konfigurationsobjekt werden ignoriert. Wenn für einen erkannten Schlüssel ein ungültiger Wert übergeben wird, wird die gesamte Konfiguration ignoriert.

Diese Einstellungen auf Seitenebene werden von den Einstellungen auf Anzeigenflächenebene überschrieben, sofern diese angegeben sind.

Beispiel

JavaScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

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

JavaScript (alt)

googletag.pubads().setForceSafeFrame(true);

var pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

const pageConfig = {
  allowOverlayExpansion: true,
  allowPushExpansion: true,
  sandbox: true,
};

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

// The following slot will not allow for expansion by overlay.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig(slotConfig)
  .addService(googletag.pubads());

// The following slot will inherit the page level settings, and hence
// would allow for expansion by overlay.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

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

Weitere Informationen

• Creatives mit SafeFrame rendern

Hiermit werden benutzerdefinierte Targeting-Parameter für einen bestimmten Schlüssel festgelegt, die auf alle Anzeigenflächen des Publisher Ads-Dienstes angewendet werden. Wenn Sie diese Funktion mehrmals für denselben Schlüssel aufrufen, werden alte Werte überschrieben. Diese Schlüssel werden in Ihrem Google Ad Manager-Konto definiert.

Beispiel

JavaScript

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

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

JavaScript (alt)

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

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

TypeScript

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

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

Weitere Informationen

• Schlüssel/Wert-Paar-Targeting

Hier legen Sie fest, welche Informationen zu Videoinhalten zusammen mit den Anzeigenanfragen gesendet werden sollen, um das Targeting und den Ausschluss von Inhalten zu ermöglichen. Videoanzeigen werden automatisch aktiviert, wenn diese Methode aufgerufen wird. Verwenden Sie für videoContentId und videoCmsId die Werte, die für den Contentaufnahmedienst von Google Ad Manager bereitgestellt werden.

Weitere Informationen

• URL-Parameter für VAST-Anzeigen-Tags

Ändert den Korrelator, der mit den Anzeigenanfragen gesendet wird, wodurch ein neuer Seitenaufruf gestartet wird. Der Korrelator ist für alle Anzeigenanfragen aus einem Seitenaufruf gleich und für verschiedene Seitenaufrufe unterschiedlich. Gilt nur für den asynchronen Modus.

Hinweis:Dies hat keine Auswirkungen auf die langlebige Seitenaufruf-ID von GPT, die automatisch die tatsächlich auf der Seite vorhandenen Anzeigen widerspiegelt und keine Ablaufzeit hat.

Beispiel

JavaScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

JavaScript (alt)

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

TypeScript

// Assume that the correlator is currently 12345. All ad requests made
// by this page will currently use that value.

// Replace the current correlator with a new correlator.
googletag.pubads().updateCorrelator();

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.

Die ID des Werbetreibenden.

Die ID der Kampagne.

Die ID des Creatives.

Die Vorlagen-ID der Anzeige.

Die ID der Position.

Die Anzahl der Artikel, die in der Prämie enthalten sind.

Die Art des Artikels, der in der Prämie enthalten ist (z. B. „coin“).

Ob SafeFrame es zulassen soll, dass sich Anzeigeninhalte durch Überlagerung des Seiteninhalts maximieren.

Ob SafeFrame es zulassen soll, dass sich Anzeigeninhalte durch das Verschieben von Seiteninhalten maximieren.

Gibt an, ob SafeFrame das HTML5-Sandbox-Attribut verwenden soll, um eine Navigation auf der obersten Ebene ohne Nutzerinteraktion zu verhindern. Der einzige gültige Wert ist true. Der Wert kann nicht auf false festgelegt werden. Hinweis: Das Sandbox-Attribut deaktiviert Plug-ins (z. B. Flash).

Gibt an, ob SafeFrame zufällig ausgewählte Subdomains für Reservierungs-Creatives verwenden soll Gib null ein, um den gespeicherten Wert zu löschen.

Hinweis: Diese Funktion ist standardmäßig aktiviert.

Weitere Informationen

• Creatives mit SafeFrame rendern

Registriert einen Listener, mit dem Sie eine JavaScript-Funktion einrichten und aufrufen können, wenn ein bestimmtes GPT-Ereignis auf der Seite eintritt. Die folgenden Ereignisse werden unterstützt:

• events.GameManualInterstitialSlotClosedEvent
• events.GameManualInterstitialSlotReadyEvent
• events.ImpressionViewableEvent
• events.RewardedSlotClosedEvent
• events.RewardedSlotGrantedEvent
• events.RewardedSlotReadyEvent
• events.SlotOnloadEvent
• events.SlotRenderEndedEvent
• events.SlotRequestedEvent
• events.SlotResponseReceived
• events.SlotVisibilityChangedEvent

Beispiel

JavaScript

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

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

JavaScript (alt)

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

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

TypeScript

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

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

Weitere Informationen

• Anzeigenereignis-Listener

Liste der Slots abrufen, die mit diesem Dienst verknüpft sind