Riferimento GPT

Questo riferimento utilizza la notazione TypeScript per descrivere i tipi. La tabella seguente fornisce una una breve spiegazione con un esempio.

Per saperne di più sui tipi e sulle espressioni di tipo supportati, consulta le Manuale TypeScript

Annotazioni del tipo

I due punti dopo una variabile, un nome di parametro, un nome di proprietà o una firma di funzione indicano del tipo di annotazione. Le annotazioni del tipo descrivono i tipi di elementi a sinistra dei due punti può accettare o restituire. La tabella seguente mostra esempi di tipi di annotazioni che potresti vedere in questo riferimento.

---

Definizioni dei tipi

Tipi di enum

---

googletag.enums.OutOfPageFormat

• Formati fuori pagina supportati da GPT.

• Vedi anche

  • defineOutOfPageSlot

• Valori
  BOTTOM_ANCHOR	Formato di ancoraggio in cui l'area si trova nella parte inferiore dell'area visibile.
  GAME_MANUAL_INTERSTITIAL	Formato interstitial manuale dei giochi. Nota:l'interstitial manuale dei giochi è un formato ad accesso limitato.
  INTERSTITIAL	Formato della creatività interstitial per il web.
  LEFT_SIDE_RAIL	Formato laterale sinistro.
  REWARDED	Formato con premio.
  RIGHT_SIDE_RAIL	Formato laterale destro.
  TOP_ANCHOR	Formato di ancoraggio in cui l'area si trova nella parte superiore dell'area visibile.

---

googletag.enums.TrafficSource

• Sorgenti di traffico supportate da GPT.

• Vedi anche

  • PrivacySettingsConfig.trafficSource

• Valori
  ORGANIC	Inserimento di URL diretti, ricerca su sito o download di app.
  PURCHASED	Traffico reindirizzato da proprietà diverse da quelle possedute (attività acquisite o altrimenti incentivate).

---

googletag

Lo spazio dei nomi globale utilizzato da Tag publisher di Google per la propria API.

---

googletag.CommandArray

L'array di comandi accetta una sequenza di funzioni e le richiama in ordine. È destinato a sostituire un array standard utilizzato per accodare le funzioni da richiamare dopo il caricamento di GPT.

---

googletag.CompanionAdsService

Servizio di annunci companion. Questo servizio viene utilizzato dagli annunci video per mostrare annunci companion.

Vedi anche

• Annunci companion per video e audio

---

googletag.PrivacySettingsConfig

Oggetto di configurazione per le impostazioni della privacy.

Vedi anche

• Configurare le impostazioni della privacy

---

googletag.PubAdsService

Servizio Annunci del publisher. Questo servizio viene utilizzato per recuperare e mostrare annunci dal tuo account Google Ad Manager.

---

googletag.ResponseInformation

Un oggetto che rappresenta una singola risposta a un annuncio.

Vedi anche

• Slot.getResponseInformation

---

googletag.RewardedPayload

Un oggetto che rappresenta il premio associato a un annuncio con premio.

Vedi anche

• Mostrare un annuncio con premio

---

googletag.SafeFrameConfig

Oggetto di configurazione per i container SafeFrame.

Vedi anche

• PubAdsService.setSafeFrameConfig

---

googletag.Service

Classe di servizio di base che contiene metodi comuni per tutti i servizi.

---

googletag.SizeMappingBuilder

Strumento di creazione per oggetti delle specifiche di mappatura delle dimensioni. Questo builder consente di creare facilmente le specifiche delle dimensioni.

Vedi anche

• Dimensioni degli annunci: annunci adattabili

---

googletag.Slot

L'area è un oggetto che rappresenta una singola area annuncio su una pagina.

---

googletag,config,AdExpansionConfig

Impostazioni per controllare l'espansione dell'annuncio.

Esempio

JavaScript

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

JavaScript (legacy)

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

Un oggetto che rappresenta un'asta di un singolo componente in un'asta dell'annuncio on-device.

Vedi anche

• Guida per i venditori dell'API Protected Audience: eseguire aste degli annunci

---

googletag,config,InterstitialConfig

Un oggetto che definisce il comportamento di una singola area annuncio interstitial.

---

googletag,config,PageSettingsConfig

Interfaccia di configurazione principale per le impostazioni a livello di pagina.

Consente di impostare più funzionalità con una singola chiamata API.

Tutte le proprietà elencate di seguito sono esempi e non riflettono le funzionalità effettive che utilizzano setConfig. Per l'insieme di funzionalità, consulta i campi all'interno del tipo PageSettingsConfig di seguito.

Esempi:

• Vengono modificate solo le funzionalità specificate nella chiamata setConfig.

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

• Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a 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
        }
    });
  

• Tutte le impostazioni di un elemento possono essere cancellate trasmettendo 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

Impostazioni per controllare il trattamento della privacy dei publisher.

---

googletag,config,PublisherProvidedSignalsConfig

Oggetto di configurazione degli indicatori forniti dal publisher (PPS).

Esempio

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 (legacy)

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

Vedi anche

• Informazioni sugli indicatori forniti dal publisher (beta)
• Tassonomia del pubblico IAB 1.1
• Tassonomia dei contenuti IAB 2.2

---

googletag,config,SlotSettingsConfig

Interfaccia di configurazione principale per le impostazioni a livello di area annuncio.

Consente di impostare più funzionalità con una singola chiamata API per una singola area.

Tutte le proprietà elencate di seguito sono esempi e non riflettono le funzionalità effettive che utilizzano setConfig. Per l'insieme di funzionalità, consulta i campi all'interno del tipo SlotSettingsConfig di seguito.

Esempi:

• Vengono modificate solo le funzionalità specificate nella chiamata 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: {...}
    });
  

• Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a 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
        }
    });
  

• Tutte le impostazioni di un elemento possono essere cancellate trasmettendo 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

Un oggetto contenente i valori di una singola Tassonomia.

---

googletag,events,Event

Interfaccia di base per tutti gli eventi GPT. Tutti gli eventi GPT seguenti avranno i seguenti campi.

Vedi anche

• Listener di eventi annuncio

---

googletag,events,EventTypeMap

Si tratta di uno pseudo-tipo che mappa un nome evento al tipo di oggetto evento corrispondente per Service.addEventListener e Service.removeEventListener. È documentato solo a scopo di riferimento e a scopo di sicurezza del tipo.

---

googletag,events,GameManualInterstitialSlotClosedEvent

Questo evento viene attivato quando un'area interstitial manuale del gioco viene chiusa dall'utente.

Nota: l'interstitial manuale di un gioco è un formato ad accesso limitato.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio
• Mostrare un annuncio interstitial manuale di un gioco

---

googletag,events,GameManualInterstitialSlotReadyEvent

Questo evento viene attivato quando un'area interstitial manuale del gioco è pronta per essere mostrata all'utente.

Nota: l'interstitial manuale di un gioco è un formato ad accesso limitato.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio
• Mostrare un annuncio interstitial manuale di un gioco

---

googletag,events,ImpressionViewableEvent

Questo evento viene attivato quando un'impressione diventa visibile, in base ai criteri di Visualizzazione attiva.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,events,RewardedSlotClosedEvent

Questo evento viene attivato quando un'area annuncio con premio viene chiusa dall'utente. Può attivarsi prima o dopo l'assegnazione di un premio. Per determinare se è stato concesso un premio, utilizza invece events.RewardedSlotGrantedEvent.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio
• Mostrare un annuncio con premio

---

googletag,events,RewardedSlotGrantedEvent

Questo evento viene attivato quando viene concesso un premio per la visualizzazione di un annuncio con premio. Se l'annuncio viene chiuso prima che vengano soddisfatti i criteri per la concessione di un premio, questo evento non viene attivato.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio
• Mostrare un annuncio con premio

---

googletag,events,RewardedSlotReadyEvent

Questo evento viene attivato quando un annuncio con premio è pronto per essere visualizzato. Il publisher è responsabile di offrire all'utente la possibilità di visualizzare l'annuncio prima di farlo.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio
• Mostrare un annuncio con premio

---

googletag,events,SlotOnloadEvent

Questo evento viene attivato quando l'iframe della creatività attiva il suo evento di caricamento. Quando si esegue il rendering degli annunci rich media in modalità sincrona, non viene utilizzato nessun iframe, pertanto non viene attivato alcun elemento SlotOnloadEvent.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,events,SlotRenderEndedEvent

Questo evento viene attivato quando il codice creatività viene inserito in un'area. Questo evento si verifica prima del recupero delle risorse della creatività, quindi la creatività potrebbe non essere ancora visibile. Per sapere quando tutte le risorse della creatività per un'area sono state caricate tutte, prendi in considerazione l'utilizzo di events.SlotOnloadEvent.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,events,SlotRequestedEvent

Questo evento viene attivato quando viene richiesto un annuncio per una determinata area.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,events,SlotResponseReceived

Questo evento viene attivato quando viene ricevuta una risposta a un annuncio per una determinata area.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,events,SlotVisibilityChangedEvent

Questo evento viene attivato ogni volta che la percentuale sullo schermo dell'area di un'area annuncio cambia. L'evento è limitato e non si attiva più di una volta ogni 200 ms.

Esempio

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 (legacy)

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

Vedi anche

• Listener di eventi annuncio

---

googletag,secureSignals,BidderSignalProvider

Restituisce un indicatore sicuro per uno specifico offerente.

Un fornitore di indicatori sicuri dello strumento di offerta è costituito da due parti:

1. Una funzione del collettore, che restituisce un Promise che si risolve in un segnale sicuro.
2. Un id che identifica l'offerente associato all'indicatore.

Esempio

JavaScript

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

JavaScript (legacy)

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

Vedi anche

• Condividere indicatori sicuri con gli offerenti

---

googletag,secureSignals,PublisherSignalProvider

Restituisce un indicatore sicuro per un publisher specifico.

Un fornitore di indicatori del publisher è costituito da due parti:

1. Una funzione del collettore, che restituisce un Promise che si risolve in un segnale sicuro.
2. Un networkCode che identifica il publisher associato all'indicatore.

Esempio

JavaScript

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

JavaScript (legacy)

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

Vedi anche

• Condividere indicatori sicuri con gli offerenti

---

googletag,secureSignals,SecureSignalProvidersArray

Un'interfaccia per la gestione di indicatori sicuri.