Riferimento GPT

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

Digita l'espressione
string	Il tipo di stringa primitiva.
string[]	Un tipo di array in cui i valori possono essere solo stringhe.
number | string	Un tipo unione, in cui il valore può essere un numero o una stringa.
Array<number | string>	Un tipo di array in cui i valori sono di tipo complesso (unione).
[number, string]	Un tipo di tupla, in cui il valore è un array di due elementi che deve contenere un numero e una stringa in questo ordine.
Slot	Un tipo di oggetto, il cui valore è un'istanza di googletag.Slot.
() => void	Un tipo di funzione senza argomenti definiti e senza valore restituito.

Per ulteriori informazioni sui tipi e sulle espressioni di tipo supportati, consulta il manuale TypeScript .

Annotare i tipi

Un due punti dopo una variabile, un nome parametro, un nome proprietà o la firma di una funzione indica un'annotazione del tipo. Le annotazioni di tipo descrivono i tipi che l'elemento a sinistra del due punti può accettare o restituire. La tabella seguente mostra esempi di annotazioni di tipo che potresti trovare in questo riferimento.

Annotazione del tipo
param: string	Indica che param accetta o restituisce un valore di stringa. Questa sintassi viene utilizzata per variabili, parametri, proprietà e tipi di restituzione.
param?: number | string	Indica che param è facoltativo, ma accetta un numero o una stringa se specificato. Questa sintassi viene utilizzata per i parametri e le proprietà.
...params: Array<() => void>	Indica che params è un parametro rest che accetta funzioni. I parametri REST accettano un numero illimitato di valori del tipo specificato.

---

googletag

Lo spazio dei nomi globale utilizzato dal Tag publisher di Google per la sua API.

Spazi dei nomi
config	Interfaccia di configurazione principale per le impostazioni a livello di pagina.
enums	Questo è lo spazio dei nomi utilizzato da GPT per i tipi di enum.
events	Questo è lo spazio dei nomi utilizzato da GPT per gli eventi.
secureSignals	Questo è lo spazio dei nomi utilizzato da GPT per gestire gli indicatori sicuri.

Interfacce
CommandArray	L'array di comandi accetta una sequenza di funzioni e le richiama in ordine.
CompanionAdsService	Servizio Annunci companion.
PrivacySettingsConfig	Oggetto di configurazione per le impostazioni della privacy.
PubAdsService	Servizio Annunci del publisher.
ResponseInformation	Un oggetto che rappresenta una singola risposta all'annuncio.
RewardedPayload	Un oggetto che rappresenta il premio associato a un annuncio con premio.
SafeFrameConfig	Oggetto di configurazione per i contenitori SafeFrame.
Service	Classe di servizio di base che contiene metodi comuni a tutti i servizi.
SizeMappingBuilder	Generatore di oggetti delle specifiche di mappatura delle dimensioni.
Slot	Slot è un oggetto che rappresenta una singola area annuncio in una pagina.

Alias del tipo
GeneralSize	Una configurazione delle dimensioni valida per uno spazio, che può essere una o più dimensioni.
MultiSize	Un elenco di singole dimensioni valide.
NamedSize	Dimensioni con nome che uno slot può avere.
SingleSize	Una singola dimensione valida per uno spazio.
SingleSizeArray	Array di due numeri che rappresentano [larghezza, altezza].
SizeMapping	Una mappatura delle dimensioni dell'area visibile alle dimensioni degli annunci.
SizeMappingArray	Un elenco di mappature delle dimensioni.

Variabili
apiReady	Indica che l'API GPT è caricata e pronta per essere chiamata.
cmd	Riferimento alla coda di comandi globale per l'esecuzione asincrona delle chiamate relative a GPT.
pubadsReady	Flag che indica che PubAdsService è attivato, caricato e completamente operativo.
secureSignalProviders	Riferimento all'array dei fornitori di indicatori sicuri.

Funzioni
companionAds	Restituisce un riferimento a CompanionAdsService.
defineOutOfPageSlot	Consente di creare un'area annuncio fuori pagina con il percorso dell'unità pubblicitaria specificato.
defineSlot	Consente di creare un'area annuncio con un determinato percorso e dimensioni dell'unità pubblicitaria e di associarla all'ID di un elemento div nella pagina che conterrà l'annuncio.
destroySlots	Distrugge gli slot specificati, rimuovendo tutti gli oggetti e i riferimenti correlati da GPT.
disablePublisherConsole	Disattiva la Google Publisher Console.
display	Indica ai servizi dello slot di eseguire il rendering dello slot.
enableServices	Attiva tutti i servizi GPT che sono stati definiti per le aree annuncio nella pagina.
getVersion	Restituisce la versione corrente di GPT.
openConsole	Viene aperta la Google Publisher Console.
pubads	Restituisce un riferimento a PubAdsService.
setAdIframeTitle	Imposta il titolo per tutti gli iframe dei contenitori degli annunci creati da PubAdsService, da questo momento in poi.
setConfig	Imposta le opzioni di configurazione generali per la pagina.
sizeMapping	Crea un nuovo SizeMappingBuilder.

Alias del tipo

---

GeneralSize

GeneralSize: SingleSize | MultiSize

Una configurazione delle dimensioni valida per uno spazio, che può essere una o più dimensioni.

---

MultiSize

MultiSize: SingleSize[]

Un elenco di singole dimensioni valide.

---

NamedSize

NamedSize: "fluid" | ["fluid"]

Dimensioni con nome che uno slot può avere. Nella maggior parte dei casi, la dimensione è un rettangolo di dimensioni fisse, ma in alcuni casi sono necessarie altre specifiche di dimensioni. Sono validi solo i seguenti formati con nome:

• fluid: il contenitore dell'annuncio occupa il 100% della larghezza del div principale e poi ridimensiona la sua altezza in base ai contenuti della creatività. In modo simile al comportamento degli elementi di blocco standard in una pagina. Utilizzato per gli annunci nativi (vedi l'articolo correlato). Tieni presente che sia fluid sia ['fluid'] sono forme accettabili per dichiarare una dimensione dell'area come fluida.

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

Una singola dimensione valida per uno spazio.

---

SingleSizeArray

SingleSizeArray: [number, number]

Array di due numeri che rappresentano [larghezza, altezza].

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

Una mappatura delle dimensioni dell'area visibile alle dimensioni degli annunci. Utilizzato per gli annunci adattabili.

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

Un elenco di mappature delle dimensioni.

Variabili

---

Const apiReady

apiReady: boolean | undefined

Indica che l'API GPT è caricata e pronta per essere chiamata. Questa proprietà sarà semplicemente undefined finché l'API non sarà pronta.

Tieni presente che il modo consigliato per gestire l'aggiornamento asincrono è utilizzare googletag.cmd per mettere in coda i callback per quando GPT è pronto. Questi callback non devono controllare googletag.apiReady, in quanto è garantito che vengano eseguiti una volta configurata l'API.

---

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray

Riferimento alla coda di comando globale per l'esecuzione asincrona delle chiamate relative a GPT.

La variabile googletag.cmd viene inizializzata a un array JavaScript vuoto dalla sintassi del tag GPT nella pagina e cmd.push è il metodo Array.push standard che aggiunge un elemento alla fine dell'array. Quando il codice JavaScript di GPT viene caricato, esamina l'array ed esegue tutte le funzioni in ordine. Lo script sostituisce quindi cmd con un oggetto CommandArray il cui metodo push è definito per eseguire l'argomento della funzione che gli viene passato. Questo meccanismo consente a GPT di ridurre la latenza percepita recuperando il codice JavaScript in modo asincrono, consentendo al browser di continuare a eseguire il rendering della pagina.

Esempio

JavaScript

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

JavaScript (precedente)

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

---

Const pubadsReady

pubadsReady: boolean | undefined

Flag che indica che PubAdsService è attivato, caricato e completamente operativo. Questa proprietà sarà semplicemente undefined finché non viene chiamata enableServices e PubAdsService non viene caricato e inizializzato.

---

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

Riferimento all'array di fornitori di indicatori sicuri.

L'array di fornitori di indicatori sicuri accetta una sequenza di funzioni di generazione di indicatori e le invoca in ordine. Ha lo scopo di sostituire un array standard utilizzato per mettere in coda le funzioni di generazione di indicatori da richiamare una volta caricato il GPT.

Esempio

JavaScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});

JavaScript (precedente)

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    return Promise.resolve("signal");
  },
});

TypeScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    return Promise.resolve("signal");
  },
});

Vedi anche

• Condividere indicatori sicuri con gli offerenti

Funzioni

---

companionAds

companionAds(): CompanionAdsService

Restituisce un riferimento a CompanionAdsService.

Resi
CompanionAdsService	Il servizio Annunci companion.

---

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null

Consente di creare un'area annuncio fuori pagina con il percorso dell'unità pubblicitaria specificato.

Per gli annunci fuori pagina personalizzati, div è l'ID dell'elemento div che conterrà l'annuncio. Per ulteriori dettagli, consulta l'articolo sulle creatività fuori pagina.

Per gli annunci fuori pagina gestiti con GPT, div è un OutOfPageFormat supportato.

Esempio

JavaScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

JavaScript (precedente)

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

TypeScript

// Define a custom out-of-page ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", "div-1");

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);

Vedi anche

• Mostrare un annuncio con premio
• Mostrare un annuncio interstitial per il web
• Mostrare un annuncio ancorato
• Mostrare un annuncio fuori pagina

Parametri
adUnitPath: string	Percorso dell'unità pubblicitaria completo con il codice di rete e il codice dell'unità pubblicitaria.
Optional div: string | OutOfPageFormat	ID del div che conterrà questa unità pubblicitaria o OutOfPageFormat.

Resi
Slot | null	Lo slot appena creato o null se non è possibile crearne uno.

---

defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null

Consente di creare un'area annuncio con un determinato percorso e dimensioni dell'unità pubblicitaria e di associarla all'ID di un elemento div nella pagina che conterrà l'annuncio.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Introduzione ai tag publisher di Google

Parametri
adUnitPath: string	Percorso dell'unità pubblicitaria completo con il codice di rete e il codice dell'unità.
size: GeneralSize	Larghezza e altezza dell'area aggiunta. Si tratta della dimensione utilizzata nella richiesta di annuncio se non viene fornita una mappatura delle dimensioni adattabili o se la dimensione dell'area visibile è inferiore alla dimensione più piccola indicata nella mappatura.
Optional div: string	ID del div che conterrà questa unità pubblicitaria.

Resi
Slot | null	Lo slot appena creato o null se non è possibile crearne uno.

---

destroySlots

destroySlots(slots?: Slot[]): boolean

Distrugge gli slot specificati, rimuovendo tutti gli oggetti e i riferimenti correlati da GPT. Questa API non supporta le aree annunci passback e le aree annunci companion.

La chiamata di questa API in un'area annuncio cancella l'annuncio e rimuove l'oggetto area annuncio dallo stato interno gestito da GPT. La chiamata di altre funzioni all'oggetto slot comporterà un comportamento non definito. Tieni presente che il browser potrebbe comunque non liberare la memoria associata allo slot se un riferimento viene mantenuto dalla pagina del publisher. La chiamata a questa API rende disponibile per il riutilizzo il div associato allo slot.

In particolare, la distruzione di uno slot rimuove l'annuncio dalla visualizzazione di pagina a lungo termine del GPT, pertanto le richieste future non saranno influenzate da blocchi o esclusioni della concorrenza che coinvolgono questo annuncio. Se non chiami questa funzione prima di rimuovere il div di uno slot dalla pagina, il comportamento sarà indefinito.

Esempio

JavaScript

// The calls to construct an ad and display contents.
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 destroy only slot1.
googletag.destroySlots([slot1]);

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

// This call to destroy all slots.
googletag.destroySlots();

JavaScript (precedente)

// The calls to construct an ad and display contents.
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 destroy only slot1.
googletag.destroySlots([slot1]);

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

// This call to destroy all slots.
googletag.destroySlots();

TypeScript

// The calls to construct an ad and display contents.
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 destroy only slot1.
googletag.destroySlots([slot1]);

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

// This call to destroy all slots.
googletag.destroySlots();

Parametri
Optional slots: Slot[]	L'array di slot da distruggere. L'array è facoltativo; se non è specificato, tutti gli slot verranno distrutti.

Resi
boolean	true se gli slot sono stati distrutti, false altrimenti.

---

disablePublisherConsole

disablePublisherConsole(): void

Disattiva la Google Publisher Console.

Vedi anche

• Google Publisher Console

---

display

display(divOrSlot: string | Element | Slot): void

Indica ai servizi dello slot di eseguire il rendering dello slot. Ogni area annuncio deve essere visualizzata una sola volta per pagina. Tutti gli slot devono essere definiti e avere un servizio associato prima di essere visualizzati. La chiamata di visualizzazione non deve avvenire finché l'elemento non è presente nel DOM. Il modo usuale per farlo è inserirlo in un blocco di script all'interno dell'elemento div denominato nella chiamata al metodo.

Se viene utilizzata l'architettura di richiesta singola (SRA), tutte le aree annuncio non recuperate al momento della chiamata di questo metodo verranno recuperate contemporaneamente. Per impedire la visualizzazione di uno spazio annuncio, è necessario rimuovere l'intero div.

Vedi anche

• Introduzione ai tag publisher di Google
• Mostrare un annuncio di prova
• Controllare il caricamento e l'aggiornamento degli annunci

Parametri
divOrSlot: string | Element | Slot	L'ID dell'elemento div contenente lo spazio pubblicitario o l'elemento div o l'oggetto spazio. Se viene fornito un elemento div, deve avere un attributo "id" che corrisponda all'ID passato a defineSlot.

---

enableServices

enableServices(): void

Attiva tutti i servizi GPT che sono stati definiti per le aree annuncio nella pagina.

---

getVersion

getVersion(): string

Restituisce la versione corrente di GPT.

Vedi anche

• Cronologia delle versioni di GPT

Resi
string	La stringa della versione GPT attualmente in esecuzione.

---

openConsole

openConsole(div?: string): void

Viene aperta la Google Publisher Console.

Esempio

JavaScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

JavaScript (precedente)

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

TypeScript

// Calling with div ID.
googletag.openConsole("div-1");

// Calling without div ID.
googletag.openConsole();

Vedi anche

• Google Publisher Console

Parametri
Optional div: string	Un ID div dell'area annuncio. Questo valore è facoltativo. Se specificato, la Publisher Console tenterà di aprirsi con i dettagli dell'area annuncio specificata in vista.

---

pubads

pubads(): PubAdsService

Restituisce un riferimento a PubAdsService.

Resi
PubAdsService	Il servizio Annunci del publisher.

---

setAdIframeTitle

setAdIframeTitle(title: string): void

Imposta il titolo per tutti gli iframe dei contenitori degli annunci creati da PubAdsService, da questo momento in poi.

Esempio

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (precedente)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

Parametri
title: string	Il nuovo titolo per tutti gli iframe del contenitore degli annunci.

---

setConfig

setConfig(config: PageSettingsConfig): void

Imposta le opzioni di configurazione generali per la pagina.

Parametri
config: PageSettingsConfig

---

sizeMapping

sizeMapping(): SizeMappingBuilder

Crea un nuovo SizeMappingBuilder.

Vedi anche

• Dimensioni degli annunci: annunci adattabili

Resi
SizeMappingBuilder	Un nuovo generatore.

---

googletag.CommandArray

L'array di comandi accetta una sequenza di funzioni e le richiama in ordine. Ha lo scopo di sostituire un array standard utilizzato per mettere in coda le funzioni da richiamare una volta caricato il GPT.

Metodi
push	Esegue la sequenza di funzioni specificate negli argomenti in ordine.

Metodi

---

push

push(...f: ((this: typeof globalThis) => void)[]): number

Esegue la sequenza di funzioni specificate negli argomenti in ordine.

Esempio

JavaScript

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

JavaScript (precedente)

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

Parametri
Rest ...f: ((this: typeof globalThis) => void)[]	Una funzione JavaScript da eseguire. La compilazione di runtime sarà sempre globalThis. Valuta la possibilità di passare una funzione freccia per mantenere il valore this del contesto lessicale che la racchiude.

Resi
number	Il numero di comandi elaborati finora. Questo è compatibile con il valore restituito di Array.push (la lunghezza corrente dell'array).

---

googletag.CompanionAdsService

Si estende Service

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

Metodi
addEventListener	Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Ereditata da Service.addEventListener
getSlots	Visualizza l'elenco degli slot associati a questo servizio. Ereditata da Service.getSlots
removeEventListener	Rimuove un ascoltatore registrato in precedenza. Ereditata da Service.removeEventListener
setRefreshUnfilledSlots	Imposta se il backfill automatico verrà eseguito per gli slot companion che non sono stati compilati.

Vedi anche

• Annunci companion per video e audio

Metodi

---

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void

Imposta se le aree companion che non sono state riempite verranno sottoposte a backfill automatico.

Questo metodo può essere chiamato più volte durante la vita utile della pagina per attivare e disattivare il backfill. Verrà eseguito il backfill solo per le aree registrate anche con PubAdsService. A causa delle limitazioni delle norme, questo metodo non è progettato per riempire gli slot companion vuoti quando viene pubblicato un video di Ad Exchange.

Esempio

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (precedente)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Parametri
value: boolean	true per eseguire automaticamente il backfill degli slot non compilati, false per lasciarli invariati.

---

googletag.PrivacySettingsConfig

Oggetto di configurazione per le impostazioni della privacy.

Proprietà
childDirectedTreatment?	Indica se la pagina deve essere trattata come destinata ai minori.
limitedAds?	Consente la pubblicazione in modalità di annunci con limitazioni per soddisfare le esigenze di conformità normativa dei publisher.
nonPersonalizedAds?	Consente di pubblicare annunci in modalità non personalizzata per soddisfare le esigenze di conformità normativa dei publisher.
restrictDataProcessing?	Consente di pubblicare annunci in modalità di elaborazione limitata per soddisfare le esigenze di conformità normativa dei publisher.
trafficSource?	Indica se le richieste rappresentano traffico organico o acquistato.
underAgeOfConsent?	Indica se contrassegnare le richieste di annunci come provenienti da utenti di età inferiore a quella del consenso digitale.

Vedi anche

• Configurare le impostazioni della privacy

Proprietà

---

Optional childDirectedTreatment

childDirectedTreatment?: null | boolean

Indica se la pagina deve essere trattata come destinata ai minori. Imposta su null per cancellare la configurazione.

---

Optional limitedAds

limitedAds?: boolean

Consente la pubblicazione in modalità di annunci con limitazioni per soddisfare le esigenze di conformità normativa dei publisher.

Puoi chiedere a GPT di richiedere annunci con limitazioni in due modi:

• Automaticamente, utilizzando un indicatore di una piattaforma di gestione del consenso che utilizza la versione 2.0 del TCF di IAB.
• Manualmente, impostando il valore di questo campo su true.
La configurazione manuale degli annunci con limitazioni è possibile solo quando GPT viene caricato dall'URL degli annunci con limitazioni. Il tentativo di modificare questa impostazione quando GPT è stato caricato dall'URL standard genera un avviso in Publisher Console.

Tieni presente che non è necessario attivare manualmente gli annunci con limitazioni quando è in uso una CMP.

Esempio

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

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

Vedi anche

• Mostrare un annuncio con limitazioni

---

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean

Consente di pubblicare annunci in modalità non personalizzata per soddisfare le esigenze di conformità normativa dei publisher.

---

Optional restrictDataProcessing

restrictDataProcessing?: boolean

Consente di pubblicare annunci in modalità di elaborazione limitata per soddisfare le esigenze di conformità normativa dei publisher.

---

Optional trafficSource

trafficSource?: TrafficSource

Indica se le richieste rappresentano traffico organico o acquistato. Questo valore compila la dimensione Origine traffico nei report di Ad Manager. Se non viene impostato, la sorgente di traffico predefinita è undefined nei report.

Esempio

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

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

---

Optional underAgeOfConsent

underAgeOfConsent?: null | boolean

Indica se contrassegnare le richieste di annunci come provenienti da utenti di età inferiore a quella del consenso digitale. Imposta su null per cancellare la configurazione.

---

googletag.PubAdsService

Si estende Service

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

Metodi
addEventListener	Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Ereditata da Service.addEventListener
clear	Rimuove gli annunci dagli slot specificati e li sostituisce con contenuti vuoti.
clearCategoryExclusions	Cancella tutte le etichette di esclusione delle categorie di annunci a livello di pagina.
clearTargeting	Cancella i parametri di targeting personalizzato per una chiave specifica o per tutte le chiavi.
collapseEmptyDivs	Consente di comprimere i div delle aree in modo che non occupino spazio sulla pagina quando non sono presenti contenuti dell'annuncio da visualizzare.
disableInitialLoad	Disattiva le richieste di annunci al caricamento della pagina, ma consente di richiederli con una chiamata PubAdsService.refresh.
display	Consente di creare e visualizzare un'area annuncio con il percorso e le dimensioni dell'unità pubblicitaria specificati.
enableLazyLoad	Attiva il caricamento lento in GPT come definito dall'oggetto config.
enableSingleRequest	Attiva la modalità di richiesta singola per il recupero di più annunci contemporaneamente.
enableVideoAds	Indica a GPT che nella pagina saranno presenti annunci video.
get	Restituisce il valore dell'attributo AdSense associato alla chiave specificata.
getAttributeKeys	Restituisce le chiavi degli attributi impostate su questo servizio.
getSlots	Visualizza l'elenco degli slot associati a questo servizio. Ereditata da Service.getSlots
getTargeting	Restituisce un parametro di targeting a livello di servizio personalizzato specifico che è stato impostato.
getTargetingKeys	Restituisce l'elenco di tutte le chiavi di targeting a livello di servizio personalizzate che sono state impostate.
isInitialLoadDisabled	Restituisce se le richieste iniziali di annunci sono state disattivate correttamente da una chiamata PubAdsService.disableInitialLoad precedente.
refresh	Recupera e mostra nuovi annunci per aree specifiche o per tutte le aree della pagina.
removeEventListener	Rimuove un ascoltatore registrato in precedenza. Ereditata da Service.removeEventListener
set	Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio del servizio Annunci per i publisher.
setCategoryExclusion	Imposta un'esclusione di categorie di annunci a livello di pagina per il nome dell'etichetta specificato.
setCentering	Attiva e disattiva il centratura orizzontale degli annunci.
setForceSafeFrame	Consente di configurare se tutti gli annunci nella pagina devono essere forzati a essere visualizzati utilizzando un contenitore SafeFrame.
setLocation	Trasmette i dati sulla posizione dai siti web in modo da poter scegliere come target geografico gli elementi pubblicitari per località specifiche.
setPrivacySettings	Consente la configurazione di tutte le impostazioni della privacy da una singola API utilizzando un oggetto di configurazione.
setPublisherProvidedId	Imposta il valore per l'ID fornito dal publisher.
setSafeFrameConfig	Imposta le preferenze a livello di pagina per la configurazione di SafeFrame.
setTargeting	Imposta i parametri di targeting personalizzato per una determinata chiave che si applicano a tutti gli spazi pubblicitari del servizio Publisher Ads.
setVideoContent	Imposta le informazioni sui contenuti video da inviare insieme alle richieste di annunci a fini di targeting ed esclusione dei contenuti.
updateCorrelator	Modifica il correlatore inviato con le richieste di annunci, avviando di fatto una nuova visualizzazione di pagina.

Metodi

---

clear

clear(slots?: Slot[]): boolean

Rimuove gli annunci dagli slot specificati e li sostituisce con contenuti vuoti. Gli slot verranno contrassegnati come non recuperati.

In particolare, l'eliminazione di uno slot rimuove l'annuncio dalla visualizzazione di pagina a lungo termine del GPT, pertanto le richieste future non saranno influenzate da blocchi o esclusioni della concorrenza che coinvolgono questo annuncio.

Esempio

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

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

Parametri
Optional slots: Slot[]	L'array di slot da cancellare. L'array è facoltativo; se non è specificato, tutti gli slot verranno cancellati.

Resi
boolean	Restituisce true se gli slot sono stati cancellati, false in caso contrario.

---

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Cancella tutte le etichette di esclusione delle categorie di annunci a livello di pagina. Questa opzione è utile se vuoi aggiornare la posizione.

Esempio

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

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

Vedi anche

• Etichette personalizzate per bloccare gli annunci

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

clearTargeting

clearTargeting(key?: string): PubAdsService

Cancella i parametri di targeting personalizzato per una chiave specifica o per tutte le chiavi.

Esempio

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

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.

Vedi anche

• Targeting per coppie chiave-valore

Parametri
Optional key: string	Chiave del parametro di targeting. La chiave è facoltativa; se non è specificata, tutti i parametri di targeting verranno cancellati.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

Consente di comprimere i div delle aree in modo che non occupino spazio sulla pagina quando non sono presenti contenuti dell'annuncio da visualizzare. Questa modalità deve essere impostata prima dell'attivazione del servizio.

Vedi anche

• Comprimere le aree annuncio vuote
• Ridurre al minimo lo spostamento del layout

Parametri
Optional collapseBeforeAdFetch: boolean	Indica se comprimere gli slot anche prima del recupero degli annunci. Questo parametro è facoltativo. Se non viene fornito, verrà utilizzato false come valore predefinito.

Resi
boolean	Restituisce true se la modalità di chiusura di div è stata attivata e false se è impossibile attivare la modalità di chiusura perché il metodo è stato chiamato dopo l'attivazione del servizio.

---

disableInitialLoad

disableInitialLoad(): void

Disattiva le richieste di annunci al caricamento della pagina, ma consente di richiederli con una chiamata PubAdsService.refresh. Questo valore deve essere impostato prima di attivare il servizio. È necessario utilizzare la modalità asincrona; in caso contrario, non sarà possibile richiedere gli annunci utilizzando refresh.

Vedi anche

• Controllare il caricamento e l'aggiornamento degli annunci
• Controllare il raggruppamento SRA

---

display

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void

Consente di creare e visualizzare un'area annuncio con il percorso e le dimensioni dell'unità pubblicitaria specificati. Questo metodo non funziona con la modalità di richiesta singola.

Nota: quando viene chiamato questo metodo, viene creato uno snapshot dello stato della pagina e dello slot per garantire la coerenza durante l'invio della richiesta di annuncio e il rendering della risposta. Eventuali modifiche apportate allo stato della pagina o dello slot dopo la chiamata di questo metodo (inclusi targeting, impostazioni della privacy, forzatura di SafeFrame e così via) verranno applicate solo alle richieste display() o refresh() successive.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Mostrare un annuncio di prova
• Controllare il caricamento e l'aggiornamento degli annunci

Parametri
adUnitPath: string	Il percorso dell'unità pubblicitaria della posizione da visualizzare.
size: GeneralSize	Larghezza e altezza della sezione.
Optional div: string | Element	L'ID del div contenente lo slot o l'elemento div stesso.
Optional clickUrl: string	L'URL di clic da utilizzare in questo slot.

---

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void

Attiva il caricamento lento in GPT come definito dall'oggetto config. Per esempi più dettagliati, consulta l'esempio di caricamento lento.

Nota: il recupero lento in SRA funziona solo se tutti gli slot sono al di fuori del margine di recupero.

Esempio

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

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

Vedi anche

• Best practice per gli annunci: dai la priorità agli spazi pubblicitari "importanti"
• Caricamento lento

Parametri

Optional config: {   fetchMarginPercent?: number;   mobileScaling?: number;   renderMarginPercent?: number; }

L'oggetto di configurazione consente la personalizzazione del comportamento lazy. Per le configurazioni omesse verrà utilizzato un valore predefinito impostato da Google che verrà ottimizzato nel tempo. Per disattivare una determinata impostazione, ad esempio un margine di recupero, imposta il valore su -1. fetchMarginPercent La distanza minima dall'area visibile corrente che deve avere uno slot prima del recupero dell'annuncio in percentuale delle dimensioni dell'area visibile. Un valore pari a 0 significa "quando l'area entra nell'area visibile", 100 significa "quando l'annuncio è a 1 area visibile di distanza" e così via. renderMarginPercent La distanza minima dall'area visibile corrente che deve avere uno slot prima di poter visualizzare un annuncio. In questo modo è possibile eseguire il pre-caricamento dell'annuncio, ma attendere il rendering e il download di altre risorse secondarie. Il valore funziona esattamente come fetchMarginPercent in percentuale del viewport. mobileScaling Un moltiplicatore applicato ai margini sui dispositivi mobili. In questo modo, i margini possono variare da un dispositivo mobile a un computer. Ad esempio, un valore di 2,0 moltiplica per 2 tutti i margini sui dispositivi mobili, aumentando la distanza minima che può avere uno slot prima del recupero e del rendering.

---

enableSingleRequest

enableSingleRequest(): boolean

Attiva la modalità di richiesta singola per il recupero di più annunci contemporaneamente. Per poter attivare il servizio, è necessario definire e aggiungere tutti gli slot annunci del publisher a PubAdsService. La modalità di richiesta singola deve essere impostata prima dell'attivazione del servizio.

Vedi anche

• Best practice per gli annunci: utilizzare correttamente l'architettura di richiesta singola
• Controllare il raggruppamento SRA

Resi
boolean	Restituisce true se è stata attivata la modalità di richiesta singola e false se non è possibile attivarla perché il metodo è stato chiamato dopo l'attivazione del servizio.

---

enableVideoAds

enableVideoAds(): void

Indica a GPT che nella pagina saranno presenti annunci video. In questo modo vengono attivati i vincoli di esclusione competitiva per gli annunci display e video. Se i contenuti video sono noti, chiama PubAdsService.setVideoContent per poter utilizzare l'esclusione dei contenuti per gli annunci display.

---

get

get(key: string): null | string

Restituisce il valore dell'attributo AdSense associato alla chiave specificata.

Esempio

JavaScript

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

JavaScript (precedente)

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'.

Vedi anche

• Attributi AdSense

Parametri
key: string	Nome dell'attributo da cercare.

Resi
null | string	Valore corrente per la chiave dell'attributo o null se la chiave non è presente.

---

getAttributeKeys

getAttributeKeys(): string[]

Restituisce le chiavi degli attributi impostate su questo servizio.

Esempio

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

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'].

Resi
string[]	Array di chiavi degli attributi impostate su questo servizio. L'ordinamento non è definito.

---

getTargeting

getTargeting(key: string): string[]

Restituisce un parametro di targeting a livello di servizio personalizzato specifico che è stato impostato.

Esempio

JavaScript

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

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

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

JavaScript (precedente)

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).

Parametri
key: string	La chiave di targeting da cercare.

Resi
string[]	I valori associati a questa chiave o un array vuoto se non esiste questa chiave.

---

getTargetingKeys

getTargetingKeys(): string[]

Restituisce l'elenco di tutte le chiavi di targeting a livello di servizio personalizzate che sono state impostate.

Esempio

JavaScript

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

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

JavaScript (precedente)

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'].

Resi
string[]	Array di chiavi di targeting. L'ordinamento non è definito.

---

isInitialLoadDisabled

isInitialLoadDisabled(): boolean

Restituisce se le richieste iniziali di annunci sono state disattivate correttamente da una chiamata PubAdsService.disableInitialLoad precedente.

Resi
boolean	Restituisce true se una chiamata precedente a PubAdsService.disableInitialLoad è andata a buon fine, false in caso contrario.

---

aggiorna

refresh(slots?: null | Slot[], options?: {
  changeCorrelator: boolean;
}): void

Recupera e mostra nuovi annunci per aree specifiche o per tutte le aree della pagina. Funziona solo in modalità di rendering asincrono.

Per un comportamento corretto in tutti i browser, la chiamata a refresh deve essere preceduta da una chiamata a display l'area annuncio. Se la chiamata a display viene omessa, l'aggiornamento potrebbe comportarsi in modo imprevisto. Se vuoi, puoi utilizzare il metodo PubAdsService.disableInitialLoad per impedire a display di recuperare un annuncio.

L'aggiornamento di uno slot rimuove l'annuncio precedente dalla visualizzazione di pagina a lungo termine del GPT, pertanto le richieste future non saranno influenzate da blocchi o esclusioni della concorrenza che coinvolgono l'annuncio.

Esempio

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

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

Vedi anche

• Controllare il caricamento e l'aggiornamento degli annunci
• Aggiornare le aree annuncio

Parametri
Optional slots: null | Slot[]	Le caselle da aggiornare. L'array è facoltativo; se non è specificato, verranno aggiornati tutti gli slot.
Optional options: {   changeCorrelator: boolean; }	Opzioni di configurazione associate a questa chiamata di aggiornamento. changeCorrelator Specifica se deve essere generato o meno un nuovo correlatore per il recupero degli annunci. I nostri ad server mantengono questo valore correlatore per breve tempo (attualmente per 30 secondi, ma soggetto a modifiche), in modo che le richieste con lo stesso correlatore ricevute in momenti ravvicinati vengano considerate una singola visualizzazione di pagina. Per impostazione predefinita, viene generato un nuovo correlatore per ogni aggiornamento. Nota:questa opzione non influisce sulla visualizzazione di pagina a lungo termine di GPT, che riflette automaticamente gli annunci attualmente presenti nella pagina e non ha una data di scadenza.

---

set

set(key: string, value: string): PubAdsService

Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio del servizio Annunci per i publisher.

Se la chiami più volte per la stessa chiave, i valori impostati in precedenza per quella chiave verranno sostituiti. Tutti i valori devono essere impostati prima di chiamare display o refresh.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Attributi AdSense

Parametri
key: string	Il nome dell'attributo.
value: string	Valore dell'attributo.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): PubAdsService

Imposta un'esclusione di categorie di annunci a livello di pagina per il nome dell'etichetta specificato.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Etichette personalizzate per bloccare gli annunci

Parametri
categoryExclusion: string	L'etichetta di esclusione della categoria di annunci da aggiungere.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setCentering

setCentering(centerAds: boolean): void

Attiva e disattiva il centratura orizzontale degli annunci. Il centratura è disattivata per impostazione predefinita. In gpt_mobile.js precedente, il centratura è attivata per impostazione predefinita.

Questo metodo deve essere invocato prima di chiamare display o refresh perché solo gli annunci richiesti dopo aver chiamato questo metodo verranno centrati.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Parametri
centerAds: boolean	true per allineare gli annunci al centro, false per allinearli a sinistra.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService

Consente di configurare se tutti gli annunci nella pagina devono essere forzati a essere visualizzati utilizzando un contenitore SafeFrame.

Tieni presente quanto segue quando utilizzi questa API:

• Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per i rispettivi slot.
• L'impostazione a livello di area, se specificata, sostituirà sempre l'impostazione a livello di pagina.
• Se impostato su true (a livello di area annuncio o di pagina), l'annuncio verrà sempre visualizzato utilizzando un contenitore SafeFrame, indipendentemente dalla scelta effettuata nell'interfaccia utente di Google Ad Manager.
• Tuttavia, se impostato su false o lasciato non specificato, l'annuncio verrà visualizzato utilizzando un contenitore SafeFrame a seconda del tipo di creatività e della selezione effettuata nell'interfaccia utente di Google Ad Manager.
• Questa API deve essere utilizzata con cautela in quanto potrebbe influire sul comportamento delle creatività che tentano di uscire dai propri iframe o che si basano sul loro rendering direttamente nella pagina di un publisher.

Esempio

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

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");

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

Parametri
forceSafeFrame: boolean	true per forzare il rendering di tutti gli annunci nella pagina in SafeFrame e false per impostare su false l'impostazione precedente. Se non è stato specificato in precedenza, l'impostazione su false non cambia nulla.

Resi
PubAdsService	L'oggetto servizio su cui è stata chiamata la funzione.

---

setLocation

setLocation(address: string): PubAdsService

Trasmette i dati sulla posizione dai siti web in modo da poter scegliere come target geografico gli elementi pubblicitari per località specifiche.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Parametri
address: string	Indirizzo in formato libero.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

Consente la configurazione di tutte le impostazioni della privacy da una singola API utilizzando un oggetto di configurazione.

Esempio

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

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

Vedi anche

• Configurare le impostazioni della privacy
• Mostrare un annuncio con limitazioni

Parametri
privacySettings: PrivacySettingsConfig	Oggetto contenente la configurazione delle impostazioni della privacy.

Resi
PubAdsService	L'oggetto servizio su cui è stata chiamata la funzione.

---

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService

Imposta il valore per l'ID fornito dal publisher.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Informazioni sugli identificatori forniti dai publisher

Parametri
ppid: string	Un ID alfanumerico fornito dal publisher. Deve avere una lunghezza compresa tra 32 e 150 caratteri.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService

Imposta le preferenze a livello di pagina per la configurazione di SafeFrame. Eventuali chiavi non riconosciute nell'oggetto config verranno ignorate. L'intera configurazione verrà ignorata se viene passato un valore non valido per una chiave riconosciuta.

Queste preferenze a livello di pagina verranno sostituite dalle preferenze a livello di area, se specificate.

Esempio

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

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");

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

Parametri
config: SafeFrameConfig	L'oggetto di configurazione.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService

Imposta i parametri di targeting personalizzato per una determinata chiave che si applicano a tutti gli spazi pubblicitari del servizio Publisher Ads. Se la chiami più volte per la stessa chiave, i vecchi valori verranno sovrascritti. Queste chiavi sono definite nel tuo account Google Ad Manager.

Esempio

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

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

Vedi anche

• Targeting per coppie chiave-valore

Parametri
key: string	Chiave del parametro di targeting.
value: string | string[]	Valore del parametro di targeting o array di valori.

Resi
PubAdsService	L'oggetto servizio su cui è stato chiamato il metodo.

---

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void

Imposta le informazioni sui contenuti video da inviare insieme alle richieste di annunci a fini di targeting ed esclusione dei contenuti. Gli annunci video verranno attivati automaticamente quando viene chiamato questo metodo. Per videoContentId e videoCmsId, utilizza i valori forniti al servizio di importazione dei contenuti di Google Ad Manager.

Vedi anche

• Parametri URL del tag annuncio VAST

Parametri
videoContentId: string	L'ID dei contenuti video.
videoCmsId: string	L'ID CMS del video.

---

updateCorrelator

updateCorrelator(): PubAdsService

Modifica il correlatore inviato con le richieste di annunci, avviando di fatto una nuova visualizzazione di pagina. Il correlatore è uguale per tutte le richieste di annunci provenienti da una visualizzazione di pagina ed è univoco in tutte le visualizzazioni di pagina. Si applica solo alla modalità asincrona.

Nota: questo non influisce sulla visualizzazione di pagina a lungo termine di GPT, che riflette automaticamente gli annunci effettivamente presenti nella pagina e non ha una data di scadenza.

Esempio

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

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

Resi
PubAdsService	L'oggetto servizio su cui è stata chiamata la funzione.

---

googletag.ResponseInformation

Un oggetto che rappresenta una singola risposta all'annuncio.

Proprietà
advertiserId	L'ID dell'inserzionista.
campaignId	L'ID della campagna.
creativeId	L'ID della creatività.
creativeTemplateId	L'ID del modello dell'annuncio.
lineItemId	L'ID della voce.

Vedi anche

• Slot.getResponseInformation

Proprietà

---

advertiserId

advertiserId: null | number

L'ID dell'inserzionista.

---

campaignId

campaignId: null | number

L'ID della campagna.

---

creativeId

creativeId: null | number

L'ID della creatività.

---

creativeTemplateId

creativeTemplateId: null | number

L'ID del modello dell'annuncio.

---

lineItemId

lineItemId: null | number

L'ID della voce.

---

googletag.RewardedPayload

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

Proprietà
amount	Il numero di articoli inclusi nel premio.
type	Il tipo di elemento incluso nel premio (ad esempio, "coin").

Vedi anche

• Mostrare un annuncio con premio

Proprietà

---

amount

amount: number

Il numero di articoli inclusi nel premio.

---

type

type: string

Il tipo di elemento incluso nel premio (ad esempio, "coin").

---

googletag.SafeFrameConfig

Oggetto di configurazione per i contenitori SafeFrame.

Proprietà
allowOverlayExpansion?	Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio sovrapponendo i contenuti della pagina.
allowPushExpansion?	Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio spingendo i contenuti della pagina.
sandbox?	Indica se SafeFrame deve utilizzare l'attributo sandbox HTML5 per impedire la navigazione di primo livello senza interazione dell'utente.
useUniqueDomain?	Ritirata. Se SafeFrame deve utilizzare sottodomini casuali per le creatività di prenotazione.

Vedi anche

• PubAdsService.setSafeFrameConfig

Proprietà

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio sovrapponendo i contenuti della pagina.

---

Optional allowPushExpansion

allowPushExpansion?: boolean

Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio spingendo i contenuti della pagina.

---

Optional sandbox

sandbox?: boolean

Indica se SafeFrame deve utilizzare l'attributo sandbox HTML5 per impedire la navigazione di primo livello senza interazione dell'utente. L'unico valore valido è true (non può essere impostato su false). Tieni presente che l'attributo sandbox disattiva i plug-in (ad es. Flash).

---

Optional useUniqueDomain

useUniqueDomain?: null | boolean

Indica se SafeFrame deve utilizzare sottodomini casuali per le creatività di prenotazione. Passa null per cancellare il valore memorizzato.

Nota: questa funzionalità è attivata per impostazione predefinita.

Ritiro: non è più possibile disattivare questa funzionalità. L'impostazione di useUniqueDomain non ha alcun effetto.

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

---

googletag.Service

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

Metodi
addEventListener	Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina.
getSlots	Visualizza l'elenco degli slot associati a questo servizio.
removeEventListener	Rimuove un ascoltatore registrato in precedenza.

Metodi

---

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service

Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Sono supportati i seguenti eventi:

• events.GameManualInterstitialSlotClosedEvent
• events.GameManualInterstitialSlotReadyEvent
• events.ImpressionViewableEvent
• events.RewardedSlotClosedEvent
• events.RewardedSlotGrantedEvent
• events.RewardedSlotReadyEvent
• events.SlotOnloadEvent
• events.SlotRenderEndedEvent
• events.SlotRequestedEvent
• events.SlotResponseReceived
• events.SlotVisibilityChangedEvent
Quando viene chiamato, al listener viene passato un oggetto del tipo di evento appropriato.

Esempio

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

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

Vedi anche

• Listener di eventi correlati agli annunci

Parametri
eventType: K	Una stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
listener: ((arg: EventTypeMap[K]) => void)	Funzione che accetta un singolo argomento oggetto evento.

Resi
Service	L'oggetto servizio su cui è stato chiamato il metodo.

---

getSlots

getSlots(): Slot[]

Visualizza l'elenco degli slot associati a questo servizio.

Resi
Slot[]	Slot nell'ordine in cui sono stati aggiunti al servizio.

---

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((event: EventTypeMap[K]) => void)): void

Rimuove un ascoltatore registrato in precedenza.

Esempio

JavaScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

JavaScript (precedente)

googletag.cmd.push(function () {
  // Define a new ad slot.
  googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  var onViewableListener = function (event) {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(function () {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

TypeScript

googletag.cmd.push(() => {
  // Define a new ad slot.
  googletag
    .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")!
    .addService(googletag.pubads());

  // Define a new function that removes itself via removeEventListener
  // after the impressionViewable event fires.
  const onViewableListener = (event: googletag.events.ImpressionViewableEvent) => {
    googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
    setTimeout(() => {
      googletag.pubads().refresh([event.slot]);
    }, 30000);
  };

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});

Parametri
eventType: K	Una stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
listener: ((event: EventTypeMap[K]) => void)	Funzione che accetta un singolo argomento oggetto evento.

---

googletag.SizeMappingBuilder

Generatore di oggetti delle specifiche di mappatura delle dimensioni. Questo generatore è fornito per aiutarti a creare facilmente le specifiche delle dimensioni.

Metodi
addSize	Aggiunge una mappatura da un array di dimensioni singole (che rappresenta la visualizzazione) a un array di dimensioni singole o multiple che rappresenta l'area.
build	Genera una specifica della mappa delle dimensioni dalle mappature aggiunte a questo generatore.

Vedi anche

• Dimensioni degli annunci: annunci adattabili

Metodi

---

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder

Aggiunge una mappatura da un array di dimensioni singole (che rappresenta la visualizzazione) a un array di dimensioni singole o multiple che rappresenta l'area.

Esempio

JavaScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

JavaScript (precedente)

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

TypeScript

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports < 640x480
  .build();

// Mapping 2
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [])
  .addSize([640, 480], [120, 60])
  .addSize([0, 0], [])
  .build();

// Mapping 2 will not show any ads for the following viewport sizes:
// [1024, 768] > size >= [980, 690] and
// [640, 480] > size >= [0, 0]

Parametri
viewportSize: SingleSizeArray	Le dimensioni dell'area visibile per questa voce di mappatura.
slotSize: GeneralSize	Le dimensioni dell'area per questa voce di mappatura.

Resi
SizeMappingBuilder	Un riferimento a questo generatore.

---

build

build(): null | SizeMappingArray

Genera una specifica della mappa delle dimensioni dalle mappature aggiunte a questo generatore.

Se sono state fornite mappature non valide, questo metodo restituirà null. In caso contrario, restituisce una specifica nel formato corretto da passare a Slot.defineSizeMapping.

Nota: il comportamento del builder dopo l'chiamata di questo metodo non è definito.

Resi
null | SizeMappingArray	Il risultato creato da questo generatore. Può essere nullo se sono state fornite mappature delle dimensioni non valide.

---

googletag.Slot

Slot è un oggetto che rappresenta una singola area annuncio in una pagina.

Metodi
addService	Aggiunge un servizio a questo slot.
clearCategoryExclusions	Cancella tutte le etichette di esclusione delle categorie di annunci a livello di area annuncio per questa area.
clearTargeting	Cancella uno o tutti i parametri di targeting personalizzato a livello di area annuncio per questa area.
defineSizeMapping	Imposta un array di mappature da una dimensione minima dell'area visibile alla dimensione dello spazio per questo spazio.
get	Restituisce il valore dell'attributo AdSense associato alla chiave specificata per questo spazio.
getAdUnitPath	Restituisce il percorso completo dell'unità pubblicitaria, con il codice di rete e il percorso dell'unità pubblicitaria.
getAttributeKeys	Restituisce l'elenco delle chiavi degli attributi impostate in questo slot.
getCategoryExclusions	Restituisce le etichette di esclusione delle categorie di annunci per questo spazio.
getResponseInformation	Restituisce le informazioni sulla risposta all'annuncio.
getSlotElementId	Restituisce l'ID dell'area div specificata al momento della definizione.
getTargeting	Restituisce un parametro di targeting personalizzato specifico impostato su questo slot.
getTargetingKeys	Restituisce l'elenco di tutte le chiavi di targeting personalizzate impostate in questo slot.
set	Imposta un valore per un attributo AdSense in questa area annuncio.
setCategoryExclusion	Imposta un'etichetta di esclusione di categorie di annunci a livello di area su questa area.
setClickUrl	Imposta l'URL di clic a cui gli utenti verranno reindirizzati dopo aver fatto clic sull'annuncio.
setCollapseEmptyDiv	Imposta se l'area annuncio div deve essere nascosta quando non è presente alcun annuncio.
setConfig	Imposta le opzioni di configurazione generali per questo slot.
setForceSafeFrame	Consente di configurare se gli annunci in questa area devono essere visualizzati utilizzando un contenitore SafeFrame.
setSafeFrameConfig	Imposta le preferenze a livello di slot per la configurazione di SafeFrame.
setTargeting	Imposta un parametro di targeting personalizzato per questo spazio.
updateTargetingFromMap	Imposta i parametri di targeting personalizzato per questo slot da una mappa chiave:valore in un oggetto JSON.

Metodi

---

addService

addService(service: Service): Slot

Aggiunge un servizio a questo slot.

Esempio

JavaScript

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

JavaScript (precedente)

googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());

TypeScript

googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());

Vedi anche

• Introduzione ai tag publisher di Google
• Mostrare un annuncio di prova

Parametri
service: Service	Il servizio da aggiungere.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

Cancella tutte le etichette di esclusione delle categorie di annunci a livello di area annuncio per questa area.

Esempio

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

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

// Make an ad request. Any ad can be returned for the slot.

JavaScript (precedente)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

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

// Make an ad request. Any ad can be returned for the slot.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

// Make an ad request. No ad with 'AirlineAd' label will be returned
// for the slot.

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

// Make an ad request. Any ad can be returned for the slot.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

clearTargeting

clearTargeting(key?: string): Slot

Cancella uno o tutti i parametri di targeting personalizzato a livello di area annuncio per questa area.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .setTargeting("color", "red")
  .addService(googletag.pubads());

slot.clearTargeting("color");
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.clearTargeting();
// All targeting has been cleared.

Vedi anche

• Targeting per coppie chiave-valore

Parametri
Optional key: string	Chiave del parametro di targeting. La chiave è facoltativa; se non è specificata, tutti i parametri di targeting verranno cancellati.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

Imposta un array di mappature da una dimensione minima dell'area visibile alla dimensione dello spazio per questo spazio.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

var mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping);

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

const mapping = googletag
  .sizeMapping()
  .addSize([100, 100], [88, 31])
  .addSize(
    [320, 400],
    [
      [320, 50],
      [300, 50],
    ],
  )
  .build();

slot.defineSizeMapping(mapping!);

Vedi anche

• Dimensioni degli annunci: annunci adattabili

Parametri
sizeMapping: SizeMappingArray	Array di mappature delle dimensioni. Puoi utilizzare SizeMappingBuilder per crearlo. Ogni mappatura delle taglie è un array di due elementi: SingleSizeArray e GeneralSize.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

get

get(key: string): null | string

Restituisce il valore dell'attributo AdSense associato alla chiave specificata per questo spazio. Per visualizzare gli attributi a livello di servizio ereditati da questo slot, utilizza PubAdsService.get.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

slot.get("adsense_background_color");
// Returns '#FFFFFF'.

Vedi anche

• Attributi AdSense

Parametri
key: string	Nome dell'attributo da cercare.

Resi
null | string	Valore corrente per la chiave dell'attributo o null se la chiave non è presente.

---

getAdUnitPath

getAdUnitPath(): string

Restituisce il percorso completo dell'unità pubblicitaria, con il codice di rete e il percorso dell'unità pubblicitaria.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getAdUnitPath();
// Returns '/1234567/sports'.

Resi
string	Percorso dell'unità pubblicitaria.

---

getAttributeKeys

getAttributeKeys(): string[]

Restituisce l'elenco delle chiavi degli attributi impostate in questo slot. Per visualizzare le chiavi degli attributi a livello di servizio ereditati da questo slot, utilizza PubAdsService.getAttributeKeys.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .set("adsense_border_color", "#AABBCC")
  .addService(googletag.pubads());

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].

Resi
string[]	Array di chiavi degli attributi. L'ordinamento non è definito.

---

getCategoryExclusions

getCategoryExclusions(): string[]

Restituisce le etichette di esclusione delle categorie di annunci per questo spazio.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .setCategoryExclusion("TrainAd")
  .addService(googletag.pubads());

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].

Resi
string[]	Le etichette di esclusione delle categorie di annunci per questo spazio o un array vuoto se non ne sono state impostate.

---

getResponseInformation

getResponseInformation(): null | ResponseInformation

Restituisce le informazioni sulla risposta all'annuncio. Questo valore si basa sull'ultima risposta all'annuncio per lo slot. Se viene chiamata quando lo slot non contiene annunci, viene restituito null.

Resi
null | ResponseInformation	Le informazioni più recenti sulla risposta all'annuncio o null se lo spazio non contiene annunci.

---

getSlotElementId

getSlotElementId(): string

Restituisce l'ID dell'area div specificata al momento della definizione.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

slot.getSlotElementId();
// Returns 'div'.

Resi
string	ID area annuncio div.

---

getTargeting

getTargeting(key: string): string[]

Restituisce un parametro di targeting personalizzato specifico impostato su questo slot. I parametri di targeting a livello di servizio non sono inclusi.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

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

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

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

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .addService(googletag.pubads());

slot.getTargeting("allow_expandable");
// Returns ['true'].

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

Parametri
key: string	La chiave di targeting da cercare.

Resi
string[]	I valori associati a questa chiave o un array vuoto se non esiste questa chiave.

---

getTargetingKeys

getTargetingKeys(): string[]

Restituisce l'elenco di tutte le chiavi di targeting personalizzate impostate in questo slot. Le chiavi di targeting a livello di servizio non sono incluse.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setTargeting("allow_expandable", "true")
  .setTargeting("interests", ["sports", "music"])
  .addService(googletag.pubads());

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].

Resi
string[]	Array di chiavi di targeting. L'ordinamento non è definito.

---

set

set(key: string, value: string): Slot

Imposta un valore per un attributo AdSense in questa area annuncio. Verranno sostituiti tutti i valori impostati a livello di servizio per questa chiave.

La chiamata di questo metodo più di una volta per la stessa chiave sostituirà i valori impostati in precedenza per la chiave in questione. Tutti i valori devono essere impostati prima di chiamare display o refresh.

Esempio

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

JavaScript (precedente)

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());

Vedi anche

• Attributi AdSense

Parametri
key: string	Il nome dell'attributo.
value: string	Valore dell'attributo.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

Imposta un'etichetta di esclusione di categorie di annunci a livello di area su questa area.

Esempio

JavaScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

JavaScript (precedente)

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());

Vedi anche

• Etichette personalizzate per bloccare gli annunci

Parametri
categoryExclusion: string	L'etichetta di esclusione della categoria di annunci da aggiungere.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setClickUrl

setClickUrl(value: string): Slot

Imposta l'URL di clic a cui gli utenti verranno reindirizzati dopo aver fatto clic sull'annuncio.

I server Google Ad Manager registrano comunque un clic anche se l'URL di clic viene sostituito. Qualsiasi URL pagina di destinazione associato alla creatività pubblicata viene aggiunto al valore fornito. Le chiamate successive sovrascrivono il valore. Questo funziona solo per le richieste non SRA.

Esempio

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

JavaScript (precedente)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());

Parametri
value: string	L'URL di clic da impostare.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot

Imposta se l'area annuncio div deve essere nascosta quando non è presente alcun annuncio. Questa impostazione sostituisce le impostazioni a livello di servizio.

Esempio

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

JavaScript (precedente)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setCollapseEmptyDiv(true, true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.

Vedi anche

• Comprimere le aree annuncio vuote
• Ridurre al minimo lo spostamento del layout

Parametri
collapse: boolean	Indica se comprimere l'area se non viene restituito alcun annuncio.
Optional collapseBeforeAdFetch: boolean	Indica se comprimere l'area anche prima del recupero di un annuncio. Ignorato se collapse non è true.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): void

Imposta le opzioni di configurazione generali per questo slot.

Parametri
slotConfig: SlotSettingsConfig	L'oggetto di configurazione.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

Configura se gli annunci in questa area devono essere forzati a essere visualizzati utilizzando un contenitore SafeFrame.

Tieni presente quanto segue quando utilizzi questa API:

• Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per i rispettivi slot.
• L'impostazione a livello di area, se specificata, sostituirà sempre l'impostazione a livello di pagina.
• Se impostato su true (a livello di area annuncio o di pagina), l'annuncio verrà sempre visualizzato utilizzando un contenitore SafeFrame, indipendentemente dalla scelta effettuata nell'interfaccia utente di Google Ad Manager.
• Tuttavia, se impostato su false o lasciato non specificato, l'annuncio verrà visualizzato utilizzando un contenitore SafeFrame a seconda del tipo di creatività e della selezione effettuata nell'interfaccia utente di Google Ad Manager.
• Questa API deve essere utilizzata con cautela in quanto potrebbe influire sul comportamento delle creatività che tentano di uscire dai propri iframe o che si basano sul loro rendering direttamente nella pagina di un publisher.

Esempio

JavaScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

JavaScript (precedente)

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setForceSafeFrame(true)
  .addService(googletag.pubads());

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

Parametri
forceSafeFrame: boolean	true per forzare il rendering di tutti gli annunci in questa area in SafeFrame e false per disattivare un'impostazione a livello di pagina (se presente). Se non specificato a livello di pagina, l'impostazione false non cambia nulla.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setSafeFrameConfig

setSafeFrameConfig(config: null | SafeFrameConfig): Slot

Imposta le preferenze a livello di slot per la configurazione di SafeFrame. Eventuali chiavi non riconosciute nell'oggetto config verranno ignorate. L'intera configurazione verrà ignorata se viene passato un valore non valido per una chiave riconosciuta.

Queste preferenze a livello di slot, se specificate, sostituiranno eventuali preferenze a livello di pagina.

Esempio

JavaScript

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());

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

JavaScript (precedente)

googletag.pubads().setForceSafeFrame(true);

// The following slot will have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
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 have a sandboxed safeframe that only
// disallows top-level navigation.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setSafeFrameConfig({ sandbox: true })
  .addService(googletag.pubads());

// The following slot will inherit page-level settings.
googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());

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

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

Parametri
config: null | SafeFrameConfig	L'oggetto di configurazione.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

setTargeting

setTargeting(key: string, value: string | string[]): Slot

Imposta un parametro di targeting personalizzato per questo spazio. La chiamata di questo metodo più volte per la stessa chiave sovrascriverà i valori precedenti. I valori impostati qui sostituiranno i parametri di targeting impostati a livello di servizio. Queste chiavi sono definite nel tuo account Google Ad Manager.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

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

JavaScript (precedente)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

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

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());

// Example with a single value for a key.
slot.setTargeting("allow_expandable", "true");

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

Vedi anche

• Targeting per coppie chiave-valore

Parametri
key: string	Chiave del parametro di targeting.
value: string | string[]	Valore del parametro di targeting o array di valori.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

updateTargetingFromMap

updateTargetingFromMap(map: {
  [adUnitPath: string]: string | string[];
}): Slot

Imposta i parametri di targeting personalizzato per questo slot da una mappa chiave:valore in un oggetto JSON. È come chiamare Slot.setTargeting per tutti i valori chiave dell'oggetto. Queste chiavi sono definite nel tuo account Google Ad Manager.

Note:

• In caso di sovrascrittura, verrà mantenuto solo l'ultimo valore.
• Se il valore è un array, qualsiasi valore precedente verrà sovrascritto, non unito.
• I valori impostati qui sostituiranno i parametri di targeting impostati a livello di servizio.

Esempio

JavaScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

JavaScript (precedente)

var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

TypeScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div")!;

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

Parametri
map: {   [adUnitPath: string]: string | string[]; }	Mappa chiave:valore del parametro di targeting.

Resi
Slot	L'oggetto area su cui è stato chiamato il metodo.

---

googletag.config

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

Interfacce
AdExpansionConfig	Impostazioni per controllare l'espansione dell'annuncio.
ComponentAuctionConfig	Un oggetto che rappresenta un'asta di un singolo componente in un'asta di annunci on-device.
InterstitialConfig	Un oggetto che definisce il comportamento di un singolo spazio annuncio interstitial.
PageSettingsConfig	Interfaccia di configurazione principale per le impostazioni a livello di pagina.
PrivacyTreatmentsConfig	Impostazioni per controllare i trattamenti della privacy del publisher.
PublisherProvidedSignalsConfig	Oggetto di configurazione degli indicatori forniti dal publisher (PPS).
SlotSettingsConfig	Interfaccia di configurazione principale per le impostazioni a livello di slot.
TaxonomyData	Un oggetto contenente i valori di una singola tassonomia.

Alias del tipo
InterstitialTrigger	Attivatori di annunci interstitial supportati.
PrivacyTreatment	Trattamenti della privacy del publisher supportati.
Taxonomy	Tassonomie supportate per gli indicatori forniti dal publisher (PPS).

Alias del tipo

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"

Attivatori di annunci interstitial supportati.

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Trattamenti della privacy del publisher supportati.

---

Tassonomia

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

Tassonomie supportate per gli indicatori forniti dal publisher (PPS).

Vedi anche

• Tassonomia del pubblico IAB 1.1
• Tassonomia dei contenuti IAB 2.2

---

googletag.config.AdExpansionConfig

Impostazioni per controllare l'espansione dell'annuncio.

Proprietà
enabled?	Indica se l'espansione dell'annuncio è attivata o disattivata.

Esempio

JavaScript

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

JavaScript (precedente)

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

Proprietà

---

Optional enabled

enabled?: null | boolean

Indica se l'espansione dell'annuncio è attivata o disattivata.

L'impostazione di questo valore sostituisce il valore predefinito configurato in Google Ad Manager.

Vedi anche

• Espandere gli annunci su computer e tablet
• Espandere gli annunci sul web mobile (schermo parziale)

---

googletag.config.ComponentAuctionConfig

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

Proprietà
auctionConfig	Un oggetto di configurazione dell'asta per l'asta del componente.
configKey	La chiave di configurazione associata a questa asta del componente.

Vedi anche

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

Proprietà

---

auctionConfig

auctionConfig: null | {
  auctionSignals?: unknown;
  decisionLogicUrl: string;
  interestGroupBuyers?: string[];
  perBuyerExperimentGroupIds?: {
    [buyer: string]: number;
  };
  perBuyerGroupLimits?: {
    [buyer: string]: number;
  };
  perBuyerSignals?: {
    [buyer: string]: unknown;
  };
  perBuyerTimeouts?: {
    [buyer: string]: number;
  };
  seller: string;
  sellerExperimentGroupId?: number;
  sellerSignals?: unknown;
  sellerTimeout?: number;
  trustedScoringSignalsUrl?: string;
}

Un oggetto di configurazione dell'asta per questa asta del componente.

Se questo valore è impostato su null, qualsiasi configurazione esistente per configKey specificato verrà eliminata.

Esempio

JavaScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

JavaScript (precedente)

var componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

var auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

TypeScript

const componentAuctionConfig = {
  // Seller URL should be https and the same as decisionLogicUrl's origin
  seller: "https://testSeller.com",
  decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
  interestGroupBuyers: ["https://example-buyer.com"],
  auctionSignals: { auction_signals: "auction_signals" },
  sellerSignals: { seller_signals: "seller_signals" },
  perBuyerSignals: {
    // listed on interestGroupBuyers
    "https://example-buyer.com": {
      per_buyer_signals: "per_buyer_signals",
    },
  },
};

const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600])!;

// To add configKey to the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: componentAuctionConfig,
    },
  ],
});

// To remove configKey from the component auction:
auctionSlot.setConfig({
  componentAuction: [
    {
      configKey: "https://testSeller.com",
      auctionConfig: null,
    },
  ],
});

Vedi anche

• API Protected Audience: avvio di un'asta on-device

---

configKey

configKey: string

La chiave di configurazione associata a questa asta del componente.

Questo valore deve essere non vuoto e univoco. Se due oggetti ComponentAuctionConfig condividono lo stesso valore configKey, l'ultimo impostato sovrascriverà le configurazioni precedenti.

---

googletag.config.InterstitialConfig

Un oggetto che definisce il comportamento di un singolo spazio annuncio interstitial.

Proprietà
requireStorageAccess?	Indica se è necessario il consenso per lo spazio di archiviazione locale per la visualizzazione di questo annuncio interstitial.
triggers?	La configurazione dell'attivatore interstitial per questo annuncio interstitial.

Proprietà

---

Optional requireStorageAccess

requireStorageAccess?: null | boolean

Indica se è necessario il consenso per lo spazio di archiviazione locale per la visualizzazione di questo annuncio interstitial.

GPT utilizza lo spazio di archiviazione locale per applicare una quota limite per gli annunci interstitial. Tuttavia, gli utenti che non hanno fornito il consenso per lo spazio di archiviazione locale sono comunque idonei alla visualizzazione di annunci interstitial. Se imposti questa proprietà su true, viene disattivato il comportamento predefinito e viene garantito che gli annunci interstitial vengano mostrati solo agli utenti che hanno fornito il consenso per lo spazio di archiviazione locale.

Esempio

JavaScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

JavaScript (precedente)

// Opt out of showing interstitials to users
// without local storage consent.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

TypeScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

Vedi anche

• Interstitial per il web

---

Optional trigger

triggers?: null | Partial<Record<InterstitialTrigger, boolean>>

La configurazione dell'attivatore interstitial per questo annuncio interstitial.

Se imposti il valore di un attivatore interstitial su true, lo attivi, mentre se lo imposti su false, lo disattivi. Verranno sostituiti i valori predefiniti configurati in Google Ad Manager.

Esempio

JavaScript

// Define a GPT managed web interstitial ad slot.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

JavaScript (precedente)

// Define a GPT managed web interstitial ad slot.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

// Enable optional interstitial triggers.
// Change this value to false to disable.
var enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

TypeScript

// Define a GPT managed web interstitial ad slot.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

// Enable optional interstitial triggers.
// Change this value to false to disable.
const enableTriggers = true;

interstitialSlot.setConfig({
  interstitial: {
    triggers: {
      navBar: enableTriggers,
      unhideWindow: enableTriggers,
    },
  },
});

Vedi anche

• Mostrare un annuncio interstitial per il web

---

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 del tipo PageSettingsConfig di seguito.

Esempi:

• Vengono modificate solo le funzionalità specificate nella chiamata googletag.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 googletag.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 una funzionalità possono essere cancellate passando 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,
    });
  

Proprietà
adExpansion?	Impostazioni per controllare l'espansione dell'annuncio.
adYield?	Ritiro .
pps?	Impostazioni per controllare gli indicatori forniti dal publisher (PPS).
privacyTreatments?	Impostazioni per controllare i trattamenti della privacy del publisher.
threadYield?	Impostazione per controllare se GPT deve restituire il thread JS durante il rendering delle creatività.

Proprietà

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

Impostazioni per controllare l'espansione dell'annuncio.

---

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
Deprecato: utilizza threadYield. Questa funzionalità verrà rimossa nel prossimo futuro.

---

Optional pps

pps?: null | PublisherProvidedSignalsConfig

Impostazioni per controllare gli indicatori forniti dal publisher (PPS).

---

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig

Impostazioni per controllare i trattamenti della privacy del publisher.

---

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

Impostazione per controllare se GPT deve cedere il thread JS durante il rendering delle creatività.

GPT cederà solo per i browser che supportano l'API Scheduler.postTask o Scheduler.yield.

Valori supportati:

• null (valore predefinito): GPT restituisce il thread JS per le aree annuncio al di fuori dell'area visibile.
• ENABLED_ALL_SLOTS: GPT restituirà il thread JS per tutte le aree, indipendentemente dal fatto che siano all'interno dell'area visibile.
• DISABLED: GPT non restituirà il thread JS.

Esempio

JavaScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

JavaScript (precedente)

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

TypeScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

Vedi anche

• Pianificatore

---

googletag.config.PrivacyTreatmentsConfig

Impostazioni per controllare i trattamenti della privacy del publisher.

Proprietà
treatments	Una serie di trattamenti della privacy del publisher da attivare.

Proprietà

---

cure

treatments: null | "disablePersonalization"[]

Una serie di trattamenti della privacy del publisher da attivare.

Esempio

JavaScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

JavaScript (precedente)

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

TypeScript

// Disable personalization across the entire page.
googletag.setConfig({
  privacyTreatments: { treatments: ["disablePersonalization"] },
});

---

googletag.config.PublisherProvidedSignalsConfig

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

Proprietà
taxonomies	Un oggetto contenente le mappature della tassonomia.

Esempio

JavaScript

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

JavaScript (precedente)

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '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 | 30-34'
      // '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

Proprietà

---

taxonomie

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Un oggetto contenente le mappature della tassonomia.

---

googletag.config.SlotSettingsConfig

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

Consente di impostare più funzionalità con una singola chiamata API per un singolo slot.

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 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 una funzionalità possono essere cancellate passando 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,
    });
  

Proprietà
adExpansion?	Impostazioni per controllare l'espansione dell'annuncio.
componentAuction?	Un array di aste di componenti da includere in un'asta di annunci on-device.
interstitial?	Impostazioni che controllano il comportamento delle aree annuncio interstitial.

Proprietà

---

Optional adExpansion

adExpansion?: null | AdExpansionConfig

Impostazioni per controllare l'espansione dell'annuncio.

---

Optional componentAuction

componentAuction?: null | ComponentAuctionConfig[]

Un array di aste di componenti da includere in un'asta di annunci on-device.

---

Optional interstitial

interstitial?: null | InterstitialConfig

Impostazioni che controllano il comportamento delle aree annuncio interstitial.

---

googletag.config.TaxonomyData

Un oggetto contenente i valori di una singola tassonomia.

Proprietà
values	Un elenco di valori Taxonomy.

Proprietà

---

values

values: string[]

Un elenco di valori Taxonomy.

---

googletag.enums

Questo è lo spazio dei nomi utilizzato da GPT per i tipi di enum.

Enumerazioni
OutOfPageFormat	Formati fuori pagina supportati da GPT.
TrafficSource	Sorgenti di traffico supportate da GPT.

Enumerazioni

---

OutOfPageFormat

OutOfPageFormat

Formati fuori pagina supportati da GPT.

Vedi anche

• defineOutOfPageSlot

Membri dell'enumerazione
BOTTOM_ANCHOR	Formato di ancoraggio in cui l'area si attacca alla parte inferiore dell'area visibile.
GAME_MANUAL_INTERSTITIAL	Formato interstitial manuale di gioco. Nota: l'interstitial manuale di gioco è un formato ad accesso limitato.
INTERSTITIAL	Formato della creatività interstitial web.
LEFT_SIDE_RAIL	Formato del laterale sinistro.
REWARDED	Formato con premio.
RIGHT_SIDE_RAIL	Formato del riquadro laterale destro.
TOP_ANCHOR	Formato di ancoraggio in cui l'area si attacca alla parte superiore dell'area visibile.

---

TrafficSource

TrafficSource

Sorgenti di traffico supportate da GPT.

Vedi anche

• PrivacySettingsConfig.trafficSource

Membri dell'enumerazione
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.events

Questo è lo spazio dei nomi utilizzato da GPT per gli eventi. Il codice può reagire a questi eventi utilizzando Service.addEventListener.

Interfacce
Event	Interfaccia di base per tutti gli eventi GPT.
EventTypeMap	Si tratta di uno pseudo-tipo che mappa un nome di evento al relativo tipo di oggetto evento per Service.addEventListener e Service.removeEventListener.
GameManualInterstitialSlotClosedEvent	Questo evento viene attivato quando un utente chiude uno slot interstitial manuale del gioco.
GameManualInterstitialSlotReadyEvent	Questo evento viene attivato quando uno slot interstitial manuale per i giochi è pronto per essere mostrato all'utente.
ImpressionViewableEvent	Questo evento viene attivato quando un'impressione diventa visibile in base ai criteri di Visualizzazione attiva.
RewardedSlotClosedEvent	Questo evento viene attivato quando un utente chiude uno spazio annuncio con premio.
RewardedSlotGrantedEvent	Questo evento viene attivato quando viene assegnato un premio per la visualizzazione di un annuncio con premio.
RewardedSlotReadyEvent	Questo evento viene attivato quando un annuncio con premio è pronto per essere visualizzato.
SlotOnloadEvent	Questo evento viene attivato quando l'iframe della creatività attiva il proprio evento di caricamento.
SlotRenderEndedEvent	Questo evento viene attivato quando il codice della creatività viene inserito in uno slot.
SlotRequestedEvent	Questo evento viene attivato quando viene richiesto un annuncio per una determinata area.
SlotResponseReceived	Questo evento viene attivato quando viene ricevuta una risposta all'annuncio per un determinato slot.
SlotVisibilityChangedEvent	Questo evento viene attivato ogni volta che cambia la percentuale sullo schermo dell'area di uno spazio pubblicitario.

---

googletag.events.Event

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento.
slot	Lo slot che ha attivato l'evento.

Vedi anche

• Listener di eventi correlati agli annunci

Proprietà

---

serviceName

serviceName: string

Nome del servizio che ha attivato l'evento.

---

slot

slot: Slot

Lo slot che ha attivato l'evento.

---

googletag.events.EventTypeMap

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

Proprietà
gameManualInterstitialSlotClosed	Alias per events.GameManualInterstitialSlotClosedEvent.
gameManualInterstitialSlotReady	Alias per events.GameManualInterstitialSlotReadyEvent.
impressionViewable	Alias per events.ImpressionViewableEvent.
rewardedSlotClosed	Alias per events.RewardedSlotClosedEvent.
rewardedSlotGranted	Alias per events.RewardedSlotGrantedEvent.
rewardedSlotReady	Alias per events.RewardedSlotReadyEvent.
slotOnload	Alias per events.SlotOnloadEvent.
slotRenderEnded	Alias per events.SlotRenderEndedEvent.
slotRequested	Alias per events.SlotRequestedEvent.
slotResponseReceived	Alias per events.SlotResponseReceived.
slotVisibilityChanged	Alias per events.SlotVisibilityChangedEvent.

Proprietà

---

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent

Alias per events.GameManualInterstitialSlotClosedEvent.

---

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent

Alias per events.GameManualInterstitialSlotReadyEvent.

---

impressionViewable

impressionViewable: ImpressionViewableEvent

Alias per events.ImpressionViewableEvent.

---

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent

Alias per events.RewardedSlotClosedEvent.

---

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent

Alias per events.RewardedSlotGrantedEvent.

---

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent

Alias per events.RewardedSlotReadyEvent.

---

slotOnload

slotOnload: SlotOnloadEvent

Alias per events.SlotOnloadEvent.

---

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent

Alias per events.SlotRenderEndedEvent.

---

slotRequested

slotRequested: SlotRequestedEvent

Alias per events.SlotRequestedEvent.

---

slotResponseReceived

slotResponseReceived: SlotResponseReceived

Alias per events.SlotResponseReceived.

---

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent

Alias per events.SlotVisibilityChangedEvent.

---

googletag.events.GameManualInterstitialSlotClosedEvent

Si estende Event

Questo evento viene attivato quando un'area annuncio interstitial manuale per giochi viene chiusa dall'utente.

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci
• Mostrare un annuncio interstitial manuale per giochi

---

googletag.events.GameManualInterstitialSlotReadyEvent

Si estende Event

Questo evento viene attivato quando uno slot interstitial manuale per giochi è pronto per essere mostrato all'utente.

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

Metodi
makeGameManualInterstitialVisible	Mostra all'utente l'annuncio interstitial manuale per i giochi.

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

// 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 correlati agli annunci
• Mostrare un annuncio interstitial manuale per giochi

Metodi

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void

Mostra all'utente l'annuncio interstitial manuale per i giochi.

---

googletag.events.ImpressionViewableEvent

Si estende Event

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci

---

googletag.events.RewardedSlotClosedEvent

Si estende Event

Questo evento viene attivato quando un utente chiude uno spazio annuncio con premio. Può essere attivato prima o dopo l'assegnazione di un premio. Per determinare se è stato concesso un premio, utilizza events.RewardedSlotGrantedEvent.

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci
• Mostrare un annuncio con premio

---

googletag.events.RewardedSlotGrantedEvent

Si estende Event

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

Proprietà
payload	Un oggetto contenente informazioni sul premio concesso.
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci
• Mostrare un annuncio con premio

Proprietà

---

payload

payload: null | RewardedPayload

Un oggetto contenente informazioni sul premio concesso.

---

googletag.events.RewardedSlotReadyEvent

Si estende Event

Questo evento viene attivato quando un annuncio con premio è pronto per essere visualizzato. Il publisher è responsabile di presentare all'utente un'opzione per visualizzare l'annuncio prima di mostrarlo.

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

Metodi
makeRewardedVisible	Mostra l'annuncio con premio.

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

// 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 correlati agli annunci
• Mostrare un annuncio con premio

Metodi

---

makeRewardedVisible

makeRewardedVisible(): void

Mostra l'annuncio con premio. Questo metodo non deve essere chiamato finché l'utente non ha dato il consenso per la visualizzazione dell'annuncio.

---

googletag.events.SlotOnloadEvent

Si estende Event

Questo evento viene attivato quando l'iframe della creatività attiva il relativo evento di caricamento. Quando esegui il rendering degli annunci rich media in modalità di rendering sincronizzato, non viene utilizzato alcun iframe, pertanto non verrà attivato alcun SlotOnloadEvent.

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci

---

googletag.events.SlotRenderEndedEvent

Si estende Event

Questo evento viene attivato quando il codice della creatività viene inserito in uno slot. Questo evento si verifica prima del recupero delle risorse della creatività, pertanto la creatività potrebbe non essere ancora visibile. Se devi sapere quando è terminato il caricamento di tutte le risorse della creatività per uno slot, utilizza events.SlotOnloadEvent.

Proprietà
advertiserId	ID inserzionista dell'annuncio visualizzato.
campaignId	L'ID della campagna dell'annuncio visualizzato.
companyIds	ID delle aziende che hanno fatto offerte per l'annuncio di backfill visualizzato.
creativeId	ID creatività dell'annuncio di prenotazione visualizzato.
creativeTemplateId	L'ID del modello di creatività dell'annuncio di prenotazione visualizzato.
isBackfill	Indica se un annuncio è un annuncio di backfill.
isEmpty	Indica se è stato restituito un annuncio per l'area.
labelIds	Ritiro .
lineItemId	ID elemento pubblicitario dell'annuncio di prenotazione visualizzato.
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
size	Indica le dimensioni in pixel della creatività visualizzata.
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot
slotContentChanged	Indica se i contenuti dell'area sono stati modificati con l'annuncio visualizzato.
sourceAgnosticCreativeId	ID creatività dell'annuncio di backfill o della prenotazione visualizzato.
sourceAgnosticLineItemId	ID elemento pubblicitario dell'annuncio di prenotazione o di backfill visualizzato.
yieldGroupIds	ID dei gruppi di rendimento per l'annuncio di backfill visualizzato.

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("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 (precedente)

// 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("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("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 correlati agli annunci

Proprietà

---

advertiserId

advertiserId: null | number

ID inserzionista dell'annuncio visualizzato. Il valore è null per gli spazi vuoti, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

campaignId

campaignId: null | number

L'ID della campagna dell'annuncio visualizzato. Il valore è null per gli spazi vuoti, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

companyIds

companyIds: null | number[]

ID delle aziende che hanno fatto offerte per l'annuncio di backfill visualizzato. Il valore è null per gli spazi vuoti, gli annunci basati su prenotazione e le creatività visualizzate da servizi diversi da PubAdsService.

---

creativeId

creativeId: null | number

ID creatività dell'annuncio di prenotazione visualizzato. Il valore è null per gli spazi vuoti, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

creativeTemplateId

creativeTemplateId: null | number

L'ID del modello di creatività dell'annuncio di prenotazione visualizzato. Il valore è null per gli spazi vuoti, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

isBackfill

isBackfill: boolean

Indica se un annuncio è un annuncio di backfill. Il valore è true se l'annuncio è un annuncio di backfill, false altrimenti.

---

isEmpty

isEmpty: boolean

Indica se è stato restituito un annuncio per l'area. Il valore è true se non è stato restituito alcun annuncio, false in caso contrario.

---

labelIds

labelIds: null | number[]
Ritiro: questo campo non viene più compilato.

---

lineItemId

lineItemId: null | number

ID elemento pubblicitario dell'annuncio di prenotazione visualizzato. Il valore è null per gli spazi vuoti, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

size

size: null | string | number[]

Indica le dimensioni in pixel della creatività visualizzata. Esempio: [728, 90]. Il valore è null per gli spazi pubblicitari vuoti.

---

slotContentChanged

slotContentChanged: boolean

Indica se i contenuti dell'area sono stati modificati con l'annuncio visualizzato. Il valore è true se i contenuti sono stati modificati, false altrimenti.

---

sourceAgnosticCreativeId

sourceAgnosticCreativeId: null | number

ID creatività dell'annuncio di backfill o della prenotazione visualizzato. Il valore è null se l'annuncio non è una prenotazione o un completamento automatico dell'elemento pubblicitario oppure se la creatività viene visualizzata da servizi diversi da PubAdsService.

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: null | number

ID elemento pubblicitario dell'annuncio di prenotazione o di backfill visualizzato. Il valore è null se l'annuncio non è una prenotazione o un completamento automatico dell'elemento pubblicitario oppure se la creatività viene visualizzata da servizi diversi da PubAdsService.

---

yieldGroupIds

yieldGroupIds: null | number[]

ID dei gruppi di rendimento per l'annuncio di backfill visualizzato. Il valore è null per gli spazi vuoti, gli annunci basati su prenotazione e le creatività visualizzate da servizi diversi da PubAdsService.

---

googletag.events.SlotRequestedEvent

Si estende Event

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci

---

googletag.events.SlotResponseReceived

Si estende Event

Questo evento viene attivato quando viene ricevuta una risposta all'annuncio per un determinato slot.

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci

---

googletag.events.SlotVisibilityChangedEvent

Si estende Event

Questo evento viene attivato ogni volta che cambia la percentuale sullo schermo dell'area di uno spazio pubblicitario. L'evento viene limitato e non verrà attivato più di una volta ogni 200 ms.

Proprietà
inViewPercentage	La percentuale dell'area dell'annuncio visibile.
serviceName	Nome del servizio che ha attivato l'evento. Ereditata da Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata da Event.slot

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

// 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 correlati agli annunci

Proprietà

---

inViewPercentage

inViewPercentage: number

La percentuale dell'area dell'annuncio visibile. Il valore è un numero compreso tra 0 e 100.

---

googletag.secureSignals

Questo è lo spazio dei nomi utilizzato da GPT per gestire gli indicatori sicuri.

Interfacce
BidderSignalProvider	Restituisce un indicatore sicuro per un offerente specifico.
PublisherSignalProvider	Restituisce un indicatore sicuro per un publisher specifico.
SecureSignalProvidersArray	Un'interfaccia per la gestione degli indicatori sicuri.

Alias del tipo
SecureSignalProvider	Interfaccia per restituire un indicatore sicuro per un offerente o un fornitore specifico.

Alias del tipo

---

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

Interfaccia per restituire un indicatore sicuro per un offerente o un fornitore specifico. È necessario specificare uno dei valori id o networkCode, non entrambi.

---

googletag.secureSignals.BidderSignalProvider

Restituisce un indicatore sicuro per un offerente specifico.

Un fornitore di indicatori sicuri per gli offerenti è costituito da due parti:

1. Una funzione di raccolta che restituisce un Promise che si risolve in un indicatore sicuro.
2. Un id che identifica l'offerente associato all'indicatore.

Per restituire un indicatore sicuro per un publisher, utilizza secureSignals.PublisherSignalProvider.

Proprietà
collectorFunction	Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.
id	Un identificatore univoco per il raccoglitore associato a questo indicatore sicuro, come registrato in Google Ad Manager.

Esempio

JavaScript

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

JavaScript (precedente)

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

Proprietà

---

collectorFunction

collectorFunction: (() => Promise<string>)

Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.

---

id

id: string

Un identificatore univoco per il raccoglitore associato a questo indicatore sicuro, come registrato in Google Ad Manager.

---

googletag.secureSignals.PublisherSignalProvider

Restituisce un indicatore sicuro per un publisher specifico.

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

1. Una funzione di raccolta che restituisce un Promise che si risolve in un indicatore sicuro.
2. Un networkCode che identifica il publisher associato all'indicatore.

Per restituire un indicatore sicuro per un offerente, utilizza secureSignals.BidderSignalProvider.

Proprietà
collectorFunction	Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.
networkCode	Il codice di rete (come visualizzato nel percorso dell'unità pubblicitaria) del publisher associato a questo indicatore sicuro.

Esempio

JavaScript

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

JavaScript (precedente)

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

Proprietà

---

collectorFunction

collectorFunction: (() => Promise<string>)

Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.

---

networkCode

networkCode: string

Il codice di rete (come visualizzato nel percorso dell'unità pubblicitaria) del publisher associato a questo indicatore sicuro.

---

googletag.secureSignals.SecureSignalProvidersArray

Un'interfaccia per la gestione degli indicatori sicuri.

Metodi
clearAllCache	Cancella tutti gli indicatori per tutti i collector dalla cache.
push	Aggiunge un nuovo secureSignals.SecureSignalProvider all'array di fornitori di indicatori e avvia il processo di generazione degli indicatori.

Metodi

---

clearAllCache

clearAllCache(): void

Cancella tutti i segnali per tutti i collezionisti dalla cache.

La chiamata a questo metodo potrebbe ridurre la probabilità che i segnali vengano inclusi nelle richieste di annunci per le visualizzazioni di pagina attuali e potenzialmente successive. Per questo motivo, deve essere chiamato solo quando si verificano modifiche dello stato significative, ad esempio eventi che indicano un nuovo utente (accesso, logout, registrazione e così via).

---

push

push(provider: SecureSignalProvider): void

Aggiunge un nuovo secureSignals.SecureSignalProvider all'array di fornitori di indicatori e avvia il processo di generazione degli indicatori.

Parametri
provider: SecureSignalProvider	L'oggetto secureSignals.SecureSignalProvider da aggiungere all'array.