Riferimento GPT

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

Tipo di espressione
string	Il tipo di stringa primitiva.
string[]	Un tipo di array, in cui i valori possono essere solo stringhe.
number | string	Un tipo di unione, in cui il valore può essere un numero o una stringa.
Array<number | string>	Un tipo di array, in cui i valori sono un 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 quest'ordine.
Slot	Un tipo di oggetto, in cui il valore è un'istanza di googletag.Slot.
() => void	Un tipo di funzione senza argomenti definiti e senza valore restituito.

Per scoprire di più sui tipi e sulle espressioni di tipo supportati, consulta il manuale di TypeScript .

Annotazioni di tipo

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

Annotazione del tipo
param: string	Indica che param accetta o restituisce un valore stringa. Questa sintassi viene utilizzata per variabili, parametri, proprietà e tipi restituiti.
param?: number | string	Indica che param è facoltativo, ma accetta un numero o una stringa quando specificato. Questa sintassi viene utilizzata per parametri e 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 la gestione degli indicatori sicuri.

Interfacce
CommandArray	L'array di comandi accetta una sequenza di funzioni e le richiama in ordine.
CompanionAdsService	Servizio di annunci companion.
PrivacySettingsConfig	Oggetto di configurazione per le impostazioni della privacy.
PubAdsService	Servizi pubblicitari per publisher.
RequestHook	Funzione di callback richiamata prima di ogni richiesta di annuncio quando viene registrata tramite PubAdsService.registerRequestHook.
ResponseInformation	Un oggetto che rappresenta una singola risposta dell'annuncio.
RewardedPayload	Un oggetto che rappresenta il premio associato a un annuncio con premio.
Service	Classe di servizio di base che contiene metodi comuni per tutti i servizi.
SizeMappingBuilder	Builder per gli oggetti di specifica della mappatura delle dimensioni.
Slot	Slot è un oggetto che rappresenta una singola area annuncio in una pagina.

Alias del tipo
FluidSize	La stringa delle dimensioni in cui il contenitore dell'annuncio occupa il 100% della larghezza del div principale e poi ridimensiona l'altezza per adattarla ai contenuti della creatività.
GeneralSize	Una configurazione delle dimensioni valida per un'area annuncio, che può essere di una o più dimensioni.
MultiSize	Un elenco di singole dimensioni valide.
NamedSize	Dimensioni denominate che un'area annuncio può avere.
SingleSize	Una singola dimensione valida per un'area annuncio.
SingleSizeArray	Array di due numeri che rappresentano [larghezza, altezza].
SizeMapping	Una mappatura delle dimensioni dell'area visibile rispetto alle dimensioni degli annunci.
SizeMappingArray	Un elenco di mappature delle dimensioni.

Variabili
apiReady	Flag che indica che l'API GPT è stata caricata ed è 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 annunci fuori pagina con il percorso dell'unità pubblicitaria specificato.
defineSlot	Crea un'area annuncio con un percorso e una dimensione dell'unità pubblicitaria specifici e la associa all'ID di un elemento div nella pagina che conterrà l'annuncio.
destroySlots	Elimina le aree annunci specificate, rimuovendo tutti gli oggetti e i riferimenti correlati di queste aree da GPT.
disablePublisherConsole	Disattiva Google Publisher Console.
display	Indica ai servizi di slot di eseguire il rendering dello slot.
enableServices	Attiva tutti i servizi GPT definiti per le aree annuncio nella pagina.
getConfig	Recupera una copia bloccata delle opzioni di configurazione generali per la pagina impostata da setConfig.
getVersion	Restituisce la versione corrente di GPT.
openConsole	Apre Google Publisher Console.
pubads	Restituisce un riferimento a PubAdsService.
setAdIframeTitle	Imposta il titolo per tutti gli iframe dei contenitori di 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

---

FluidSize

FluidSize: "fluid"

La stringa delle dimensioni in cui il contenitore dell'annuncio occupa il 100% della larghezza del div principale e poi ridimensiona l'altezza per adattarla ai contenuti della creatività. In modo simile al comportamento dei normali elementi di blocco di una pagina. Utilizzato per gli annunci nativi e banner (consulta l'articolo correlato).

---

GeneralSize

GeneralSize: SingleSize | MultiSize

Una configurazione delle dimensioni valida per un'area annuncio, che può essere di una o più dimensioni.

---

MultiSize

MultiSize: SingleSize[]

Un elenco di singole dimensioni valide.

---

NamedSize

NamedSize: FluidSize | [FluidSize]

Dimensioni denominate che un'area annuncio può avere. Nella maggior parte dei casi, la dimensione è un rettangolo di dimensioni fisse, ma in alcuni casi abbiamo bisogno di altri tipi di specifiche di dimensione. Solo le seguenti sono dimensioni con nome valide:

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

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

Una singola dimensione valida per un'area annuncio.

---

SingleSizeArray

SingleSizeArray: [number, number]

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

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

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

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

Un elenco di mappature delle dimensioni.

Variabili

---

Const apiReady

apiReady: boolean | undefined

Flag che indica che l'API GPT è stata caricata ed è pronta per essere chiamata. Questa proprietà sarà semplicemente undefined finché l'API non sarà pronta.

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

---

Const cmd

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

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

La variabile googletag.cmd viene inizializzata su 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 passato. Questo meccanismo consente a GPT di ridurre la latenza percepita recuperando il codice JavaScript in modo asincrono e 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());
});

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 chiamato enableServices e PubAdsService non viene caricato e inizializzato.

---

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

Riferimento all'array dei fornitori di indicatori sicuri.

L'array dei fornitori di indicatori sicuri accetta una sequenza di funzioni di generazione di indicatori e le richiama in ordine. È destinato a sostituire un array standard utilizzato per mettere in coda le funzioni di generazione degli indicatori da richiamare una volta caricato GPT.

Esempio

JavaScript

window.googletag = window.googletag || { cmd: [] };
googletag.secureSignalProviders = googletag.secureSignalProviders || [];
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    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

• Condividi 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

Crea un'area annunci 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 da 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);

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

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

Parametri
adUnitPath: string	Percorso 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 creare uno slot.

---

defineSlot

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

Consente di creare un'area annuncio con un percorso e dimensioni dell'unità pubblicitaria specifici 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");

TypeScript

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

Vedi anche

• Inizia a utilizzare i Tag publisher di Google

Parametri
adUnitPath: string	Percorso unità pubblicitaria completo con il codice di rete e il codice dell'unità.
size: GeneralSize	Larghezza e altezza dell'area annunci aggiunta. Questa è la dimensione utilizzata nella richiesta di annuncio se non viene fornita una mappatura delle dimensioni adattabili o se le dimensioni dell'area visibile sono inferiori alle dimensioni più piccole fornite 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 creare uno slot.

---

destroySlots

destroySlots(slots?: Slot[]): boolean

Elimina le aree annunci specificate, rimuovendo tutti gli oggetti e i riferimenti correlati di queste aree da GPT. Questa API non supporta le aree di passback e le aree companion.

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

In particolare, la distruzione di un'area annuncio rimuove l'annuncio dalla visualizzazione di pagina di lunga durata di GPT, pertanto le richieste future non saranno influenzate da roadblock o esclusioni della concorrenza che coinvolgono questo annuncio. Se non chiami questa funzione prima di rimuovere il div di un'area annuncio dalla pagina, si verificherà un comportamento 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();

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 aree annuncio da distruggere. L'array è facoltativo; se non viene specificato, verranno eliminati tutti gli slot.

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

---

disablePublisherConsole

disablePublisherConsole(): void

Disattiva Google Publisher Console.

Vedi anche

• Google Publisher Console

---

display

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

Indica ai servizi di 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 consueto per ottenere questo risultato è inserirlo all'interno di un blocco di script nell'elemento div denominato nella chiamata al metodo.

Se viene utilizzata l'architettura di richiesta singola (SRA), tutte le aree annunci non recuperate al momento della chiamata di questo metodo verranno recuperate contemporaneamente. Per forzare la mancata visualizzazione di un'area annunci, è necessario rimuovere l'intero div.

Vedi anche

• Inizia a utilizzare i Tag publisher di Google
• Visualizza un annuncio di prova
• Controlla il caricamento e l'aggiornamento degli annunci

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

---

enableServices

enableServices(): void

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

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>

Recupera una copia bloccata delle opzioni di configurazione generali per la pagina impostata da setConfig.

Non tutte le proprietà setConfig() sono supportate da questo metodo. Le proprietà supportate sono:

• adsenseAttributes
• disableInitialLoad
• targeting

Esempio

JavaScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

TypeScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

Parametri
keys: string | string[]	Le chiavi delle opzioni di configurazione da recuperare.

Resi
Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>	Una copia bloccata delle opzioni di configurazione della pagina.

---

getVersion

getVersion(): string

Restituisce la versione corrente di GPT.

Vedi anche

• Cronologia delle versioni di GPT

Resi
string	La stringa della versione di GPT attualmente in esecuzione.

---

openConsole

openConsole(div?: string): void

Apre Google Publisher Console.

Esempio

JavaScript

// 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 fornito, la Publisher Console tenterà di aprirsi con i dettagli dell'area annuncio specificata in visualizzazione.

---

pubads

pubads(): PubAdsService

Restituisce un riferimento a PubAdsService.

Resi
PubAdsService	Il servizio Publisher Ads.

---

setAdIframeTitle

setAdIframeTitle(title: string): void

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

Esempio

JavaScript

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

Parametri
title: string	Il nuovo titolo per tutti gli iframe dei contenitori di 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 builder.

---

googletag.CommandArray

L'array di comandi accetta una sequenza di funzioni e le richiama in ordine. È destinato a sostituire un array standard utilizzato per mettere in coda le funzioni da richiamare una volta caricato GPT.

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

Metodi

---

push

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

Esegue in ordine la sequenza di funzioni specificata negli argomenti.

Esempio

JavaScript

googletag.cmd.push(() => {
  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. L'associazione di runtime sarà sempre globalThis. Valuta la possibilità di passare una funzione freccia per mantenere il valore this del contesto lessicale di inclusione.

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

---

googletag.CompanionAdsService

Estende Service

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

Metodi
addEventListener	Registra un listener che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Ereditato dal metodo Service.addEventListener
getSlots	Recupera l'elenco degli slot associati a questo servizio. Ereditato dal metodo Service.getSlots
removeEventListener	Rimuove un listener registrato in precedenza. Ereditato dal metodo Service.removeEventListener
setRefreshUnfilledSlots	Imposta se le aree companion che non sono state riempite verranno riempite automaticamente.

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 riempite automaticamente con il backfill.

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

Esempio

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Parametri
value: boolean	true per eseguire automaticamente il backfill degli slot non riempiti, 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à annunci con limitazioni per aiutare i publisher a soddisfare le esigenze di conformità legale.
nonPersonalizedAds?	Consente la pubblicazione in modalità annunci non personalizzati per soddisfare le esigenze di conformità legale dei publisher.
restrictDataProcessing?	Consente di eseguire l'erogazione in modalità di trattamento dati limitato per soddisfare le esigenze di conformità legale dei publisher.
tagForAgeTreatment?	Il trattamento con limiti di età, che indica se la richiesta di annuncio deve essere trattata come destinata a bambini, adolescenti o non specificata.
trafficSource?	Indica se le richieste rappresentano traffico acquistato o organico.
underAgeOfConsent?	Indica se contrassegnare le richieste di annunci come provenienti da utenti di età inferiore a quella del consenso digitale.

Vedi anche

• Configura le impostazioni della privacy

Proprietà

---

Optional childDirectedTreatment

childDirectedTreatment?: 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à annunci con limitazioni per soddisfare le esigenze di conformità legale dei publisher.

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

• Automaticamente, utilizzando un indicatore di una piattaforma di gestione del consenso della 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. Se provi a modificare questa impostazione quando GPT è stato caricato dall'URL standard, verrà generato un avviso della 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,
});

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

• Visualizza un annuncio con limitazioni

---

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean

Consente la pubblicazione in modalità annunci non personalizzati per soddisfare le esigenze di conformità legale dei publisher.

---

Optional restrictDataProcessing

restrictDataProcessing?: boolean

Consente di eseguire l'erogazione in modalità di trattamento dati limitato per soddisfare le esigenze di conformità legale dei publisher.

---

Optional tagForAgeTreatment

tagForAgeTreatment?: TagForAgeTreatment

Il trattamento con limiti di età, che indica se la richiesta di annuncio deve essere trattata come destinata a bambini, adolescenti o non specificata.

Consulta il tuo consulente legale per determinare le impostazioni di trattamento dell'età per i tuoi utenti in base ai requisiti legali e normativi. Per ulteriori informazioni su questa impostazione, consulta questo articolo del Centro assistenza.

Impostando questa proprietà, dichiari che questa notifica è accurata e che hai l'autorizzazione ad agire per conto del proprietario del sito. Sei consapevole che l'utilizzo scorretto di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Esempio

JavaScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

TypeScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

---

Optional trafficSource

trafficSource?: TrafficSource

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

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

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?: 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

Estende Service

Servizi pubblicitari per publisher. Questo servizio viene utilizzato per recuperare e mostrare gli annunci dal tuo account Google Ad Manager.

Metodi
addEventListener	Registra un listener che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Ereditato dal metodo Service.addEventListener
clear	Rimuove gli annunci dalle aree annuncio specificate e li sostituisce con contenuti vuoti.
clearCategoryExclusions	Ritirato. Cancella tutte le etichette di esclusione delle categorie di annunci a livello di pagina.
clearTargeting	Ritirato. Cancella i parametri di targeting personalizzato per una chiave specifica o per tutte le chiavi.
collapseEmptyDivs	Ritirato. Consente di comprimere i div degli slot in modo che non occupino spazio sulla pagina quando non sono presenti contenuti dell'annuncio da visualizzare.
disableInitialLoad	Ritirato. Disattiva le richieste di annunci al caricamento della pagina, ma consente di richiedere gli annunci con una chiamata PubAdsService.refresh.
display	Crea e mostra un'area annuncio con il percorso e le dimensioni dell'unità pubblicitaria specificati.
enableLazyLoad	Ritirato. Attiva il caricamento lento in GPT come definito dall'oggetto di configurazione.
enableSingleRequest	Ritirato. Attiva la modalità di richiesta singola per recuperare più annunci contemporaneamente.
enableVideoAds	Ritirato. Indica a GPT che nella pagina saranno presenti annunci video.
get	Ritirato. Restituisce il valore dell'attributo AdSense associato alla chiave specificata.
getAttributeKeys	Ritirato. Restituisce le chiavi degli attributi impostate su questo servizio.
getSlots	Recupera l'elenco degli slot associati a questo servizio. Ereditato dal metodo Service.getSlots
getTargeting	Ritirato. Restituisce un parametro di targeting personalizzato specifico a livello di servizio che è stato impostato.
getTargetingKeys	Ritirato. Restituisce l'elenco di tutte le chiavi di targeting personalizzate a livello di servizio che sono state impostate.
isInitialLoadDisabled	Ritirato. Indica se le richieste iniziali di annunci sono state disattivate o meno da una chiamata PubAdsService.disableInitialLoad precedente.
refresh	Recupera e visualizza nuovi annunci per aree specifiche o per tutte le aree della pagina.
registerRequestHook	Registra un hook da eseguire in parallelo con altri hook registrati prima di ogni richiesta di annuncio nella pagina entro un timeout globale.
removeEventListener	Rimuove un listener registrato in precedenza. Ereditato dal metodo Service.removeEventListener
set	Ritirato. Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio nel servizio Publisher Ads.
setCategoryExclusion	Ritirato. Imposta un'esclusione di categorie di annunci a livello di pagina per il nome dell'etichetta specificato.
setCentering	Ritirato. Attiva e disattiva la centratura orizzontale degli annunci.
setForceSafeFrame	Ritirato. Configura se forzare il rendering di tutti gli annunci della pagina utilizzando un contenitore SafeFrame.
setLocation	Ritirato. Trasmette i dati sulla posizione dai siti web in modo da poter scegliere come target geografico degli elementi pubblicitari località specifiche.
setPrivacySettings	Consente di configurare tutte le impostazioni della privacy da un'unica API utilizzando un oggetto di configurazione.
setPublisherProvidedId	Imposta il valore per l'ID fornito dal publisher.
setSafeFrameConfig	Ritirato. Imposta le preferenze a livello di pagina per la configurazione di SafeFrame.
setTargeting	Ritirato. Imposta i parametri di targeting personalizzato per una determinata chiave che si applicano a tutte le aree annuncio dei servizi pubblicitari Publisher Ads.
setVideoContent	Ritirato. Imposta le informazioni sui contenuti video da inviare insieme alle richieste di annunci per scopi di targeting ed esclusione di 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 dalle aree annuncio specificate e li sostituisce con contenuti vuoti. Le aree verranno contrassegnate come non recuperate.

In particolare, la cancellazione di un'area rimuove l'annuncio dalla visualizzazione di pagina di lunga durata di GPT, pertanto le richieste future non saranno influenzate da roadblock 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();

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 aree annuncio da cancellare. L'array è facoltativo; se non viene specificato, verranno cancellate tutte le aree annuncio.

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

---

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Cancella tutte le etichette di esclusione di categorie di annunci a livello di pagina. Questa opzione è utile se vuoi aggiornare l'area annuncio.

Ritirato: utilizza PageSettingsConfig.categoryExclusion.

Esempio

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

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

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

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

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

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

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

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

Vedi anche

• Etichette personalizzate per bloccare annunci

Resi
PubAdsService	L'oggetto di 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.

Ritirato: utilizza PageSettingsConfig.targeting.

Esempio

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// 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 viene specificata, tutti i parametri di targeting verranno cancellati.

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

---

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

Consente di comprimere i div degli slot 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.

Ritirato: utilizza PageSettingsConfig.collapseDiv.

Vedi anche

• Comprimere le aree annuncio vuote
• Riduci al minimo la variazione del layout

Parametri
Optional collapseBeforeAdFetch: boolean	Indica se comprimere le aree annuncio 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 compressione div è stata attivata e false se non è possibile attivare la modalità di compressione 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 richiedere annunci con una chiamata PubAdsService.refresh. Questo valore deve essere impostato prima di attivare il servizio. È necessario utilizzare la modalità asincrona, altrimenti non sarà possibile richiedere annunci utilizzando refresh.

Metodo deprecato: utilizza PageSettingsConfig.disableInitialLoad.

Vedi anche

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

---

display

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

Crea e visualizza un'area annuncio con il percorso e le dimensioni dell'unità pubblicitaria specificati.

Questo metodo è un'abbreviazione equivalente alla chiamata di googletag.defineSlot seguita immediatamente da googletag.display.

Il comportamento di questo metodo dipende dall'attivazione o meno dell'architettura di richiesta singola (SRA):

• SRA attivata:tutte le aree annuncio definite fino al punto di questa chiamata verranno raggruppate e richieste insieme.
• SRA disattivata (impostazione predefinita): l'area annuncio verrà richiesta singolarmente.

Nota: quando viene chiamato questo metodo, viene creata un'istantanea dello stato dell'area annuncio e della pagina per garantire la coerenza durante l'invio della richiesta di annuncio e il rendering della risposta. Qualsiasi modifica apportata allo stato dell'area annuncio o della pagina dopo la chiamata di questo metodo (tra cui targeting, impostazioni della privacy, forza SafeFrame e così via) verrà applicata solo alle richieste display() o refresh() successive.

Esempio

JavaScript

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

TypeScript

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

Vedi anche

• Visualizza un annuncio di prova
• Controlla il caricamento e l'aggiornamento degli annunci

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

---

enableLazyLoad

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

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

Nota:il recupero lento in SRA funziona solo se tutte le aree annuncio si trovano al di fuori del margine di recupero.

Metodo deprecato:utilizza PageSettingsConfig.lazyLoad.

Esempio

JavaScript

googletag.setConfig({
  lazyLoad: {
    // 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.setConfig({
  lazyLoad: {
    // 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à alle aree annuncio "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 set predefinito 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 un'area annuncio deve avere prima di recuperare l'annuncio come percentuale delle dimensioni dell'area visibile. Un valore pari a 0 indica "quando l'area annuncio entra nell'area visibile", 100 indica "quando l'annuncio si trova a una distanza di un'area visibile" e così via. renderMarginPercent La distanza minima dall'area visibile corrente che un'area deve avere prima di eseguire il rendering di un annuncio. In questo modo, l'annuncio viene precaricato, ma il rendering e il download di altre risorse secondarie vengono posticipati. Il valore funziona esattamente come fetchMarginPercent come percentuale dell'area visibile. mobileScaling Un moltiplicatore applicato ai margini sui dispositivi mobili. In questo modo, i margini possono variare tra dispositivi mobili e computer. Ad esempio, un valore di 2,0 moltiplicherà tutti i margini per 2 sui dispositivi mobili, aumentando la distanza minima che un'area annuncio può avere prima del recupero e del rendering.

---

enableSingleRequest

enableSingleRequest(): boolean

Attiva la modalità di richiesta singola per recuperare più annunci contemporaneamente. Ciò richiede che tutte le aree annuncio del publisher siano definite e aggiunte a PubAdsService prima di attivare il servizio. La modalità di richiesta singola deve essere impostata prima dell'attivazione del servizio.

Metodo deprecato: utilizza PageSettingsConfig.singleRequest al suo posto.

Vedi anche

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

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

---

enableVideoAds

enableVideoAds(): void

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

Deprecato: utilizza PageSettingsConfig.videoAds.

---

get

get(key: string): string

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

Ritirato: utilizza googletag.getConfig al suo posto.

Esempio

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Vedi anche

• Attributi AdSense

Parametri
key: string	Nome dell'attributo da cercare.

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

---

getAttributeKeys

getAttributeKeys(): string[]

Restituisce le chiavi degli attributi impostate su questo servizio.

Metodo deprecato: utilizza googletag.getConfig al suo posto.

Esempio

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

Resi
string[]	Array di chiavi di attributo 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.

Metodo deprecato: utilizza googletag.getConfig al suo posto.

Esempio

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["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 una chiave di questo tipo.

---

getTargetingKeys

getTargetingKeys(): string[]

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

Metodo deprecato: utilizza googletag.getConfig al suo posto.

Esempio

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// 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 o meno da una chiamata PubAdsService.disableInitialLoad precedente.

Deprecato: utilizza googletag.getConfig.

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

---

refresh

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

Recupera e visualizza 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 dell'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 un'area rimuove il vecchio annuncio dalla visualizzazione di pagina di lunga durata di GPT, pertanto le richieste future non saranno influenzate da roadblock 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 });

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

• Controlla il caricamento e l'aggiornamento degli annunci
• Aggiorna le aree annunci

Parametri
Optional slots: Slot[]	Le aree annuncio da aggiornare. L'array è facoltativo; se non viene specificato, verranno aggiornate tutte le aree annuncio.
Optional options: {   changeCorrelator: boolean; }	Opzioni di configurazione associate a questa chiamata di aggiornamento. changeCorrelator Specifica se generare o meno un nuovo correlatore per il recupero degli annunci. I nostri ad server mantengono questo valore correlatore per un breve periodo (attualmente 30 secondi, ma soggetto a modifiche), in modo che le richieste con lo stesso correlatore ricevute a breve distanza l'una dall'altra vengano considerate come una singola visualizzazione di pagina. Per impostazione predefinita, viene generato un nuovo correlatore per ogni aggiornamento. Nota:questa opzione non ha alcun effetto sulla visualizzazione di pagina di lunga durata di GPT, che riflette automaticamente gli annunci attualmente presenti sulla pagina e non ha una data di scadenza.

---

registerRequestHook

registerRequestHook(hook: RequestHook, hookId: string): (() => void)

Experimental Registra un hook da eseguire in parallelo con altri hook registrati prima di ogni richiesta di annuncio sulla pagina entro un timeout globale.

Esempio

JavaScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

TypeScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

Parametri
hook: RequestHook	Una funzione che accetta un oggetto contenente l'elenco degli slot richiesti e restituisce una promise che si risolve una volta completate tutte le azioni asincrone.
hookId: string	Un ID per etichettare l'hook per una diagnostica migliorata.

Resi
(() => void)	Una funzione per annullare la registrazione dell'hook.

---

set

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

Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio nel servizio Publisher Ads.

Se chiami questo metodo più di una volta 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.

Ritirato: utilizza PageSettingsConfig.adsenseAttributes.

Esempio

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

Vedi anche

• Attributi AdSense

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

Resi
PubAdsService	L'oggetto di 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.

Deprecato: utilizza PageSettingsConfig.categoryExclusion.

Esempio

JavaScript

// Label = AirlineAd.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

TypeScript

// Label = AirlineAd.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

Vedi anche

• Etichette personalizzate per bloccare annunci

Parametri
categoryExclusion: string	L'etichetta di esclusione delle categorie di annunci da aggiungere.

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

---

setCentering

setCentering(centerAds: boolean): void

Attiva e disattiva il centraggio orizzontale degli annunci. La centratura è disattivata per impostazione predefinita. In gpt_mobile.js precedente, il centramento è attivato per impostazione predefinita.

Questo metodo deve essere richiamato prima di chiamare display o refresh perché verranno centrati solo gli annunci richiesti dopo la chiamata di questo metodo.

Ritirato: utilizza PageSettingsConfig.centering.

Esempio

JavaScript

// Make ads centered.
googletag.setConfig({
  centering: true,
});

TypeScript

// Make ads centered.
googletag.setConfig({
  centering: true,
});

Parametri
centerAds: boolean	true per centrare gli annunci, false per allinearli a sinistra.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService

Configura se forzare il rendering di tutti gli annunci della pagina utilizzando un contenitore SafeFrame.

Tieni presente quanto segue quando utilizzi questa API:

• Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per le rispettive aree annuncio.
• 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 se non viene 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 rendering diretto in una pagina del publisher.

Deprecata: utilizza PageSettingsConfig.safeFrame.

Esempio

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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

• Visualizza creatività con SafeFrame

Parametri
forceSafeFrame: boolean	true per forzare il rendering di tutti gli annunci della pagina in SafeFrame e false per modificare l'impostazione precedente in false. Se imposti questo valore su false quando non è stato specificato in precedenza, non cambierà nulla.

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

---

setLocation

setLocation(address: string): PubAdsService

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

Metodo deprecato: utilizza PageSettingsConfig.location al suo posto.

Esempio

JavaScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

TypeScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

Parametri
address: string	Indirizzo in formato libero.

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

---

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

Consente di configurare tutte le impostazioni della privacy da un'unica 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,
});

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

• Configura le impostazioni della privacy
• Visualizza un annuncio con limitazioni

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

Resi
PubAdsService	L'oggetto di 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");

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 22 e 150 caratteri.

Resi
PubAdsService	L'oggetto di 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 di configurazione 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 annuncio, se specificate.

Ritirato: utilizza PageSettingsConfig.safeFrame.

Esempio

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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

• Visualizza creatività con SafeFrame

Parametri
config: SafeFrameConfig	L'oggetto di configurazione.

Resi
PubAdsService	L'oggetto di 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 tutte le aree annuncio dei servizi pubblicitari. Se chiami questo metodo più volte per la stessa chiave, i valori precedenti verranno sovrascritti. Queste chiavi sono definite nel tuo account Google Ad Manager.

Ritirato: utilizza PageSettingsConfig.targeting.

Esempio

JavaScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

TypeScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

Vedi anche

• Targeting per coppie chiave-valore

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

Resi
PubAdsService	L'oggetto di 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 per scopi di targeting ed esclusione di contenuti. Gli annunci video verranno attivati automaticamente quando viene chiamato questo metodo. Per videoContentId e videoCmsId, utilizza i valori forniti al servizio di importazione di contenuti di Google Ad Manager.

Ritirato: utilizza PageSettingsConfig.videoAds.

Vedi anche

• Parametri URL dei tag annuncio VAST

Parametri
videoContentId: string	L'ID 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 per tutte le visualizzazioni di pagina. Si applica solo alla modalità asincrona.

Nota:non ha alcun effetto sulla visualizzazione di pagina di lunga durata di GPT, che riflette automaticamente gli annunci effettivamente presenti sulla pagina e non ha una 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.

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 di servizio su cui è stata chiamata la funzione.

---

googletag.RequestHook

Funzione di callback richiamata prima di ogni richiesta di annuncio quando viene registrata tramite PubAdsService.registerRequestHook.

---

googletag.ResponseInformation

Un oggetto che rappresenta una singola risposta dell'annuncio.

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

Vedi anche

• Slot.getResponseInformation

Proprietà

---

advertiserId

advertiserId: number

L'ID dell'inserzionista.

---

campaignId

campaignId: number

L'ID della campagna.

---

creativeId

creativeId: number

L'ID della creatività.

---

creativeTemplateId

creativeTemplateId: number

L'ID modello dell'annuncio.

---

lineItemId

lineItemId: number

L'ID elemento pubblicitario.

---

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, "moneta").

Vedi anche

• Visualizza 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, "moneta").

---

googletag.Service

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

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

Metodi

---

addEventListener

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

Registra un listener 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

Un oggetto del tipo di evento appropriato viene passato al listener quando viene chiamato.

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

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 annuncio

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

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

---

getSlots

getSlots(): Slot[]

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

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 eventi sono sensibili alle maiuscole.
listener: ((event: EventTypeMap[K]) => void)	Funzione che accetta un singolo argomento dell'oggetto evento.

---

googletag.SizeMappingBuilder

Builder per gli oggetti di specifica della mappatura delle dimensioni. Questo builder viene fornito per aiutarti a creare facilmente le specifiche delle dimensioni.

Metodi
addSize	Aggiunge una mappatura da un array di dimensioni singole (che rappresenta l'area visibile) a un array di dimensioni singole o multiple che rappresenta l'area annuncio.
build	Crea una specifica della mappa delle dimensioni dalle mappature aggiunte a questo builder.

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 l'area visibile) a un array di dimensioni singole o multiple che rappresenta l'area annuncio.

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]

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 annuncio per questa voce di mappatura.

Resi
SizeMappingBuilder	Un riferimento a questo builder.

---

build

build(): SizeMappingArray

Crea una specifica di mappatura delle dimensioni dalle mappature aggiunte a questo builder.

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 la chiamata di questo metodo non è definito.

Resi
SizeMappingArray	Il risultato creato da questo builder. Può essere null 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	Ritirato.  Cancella tutte le etichette di esclusione di categorie di annunci a livello di area per questa area.
clearTargeting	Ritirato. Cancella parametri di targeting personalizzati specifici o tutti i parametri di targeting personalizzati a livello di area per questa area.
defineSizeMapping	Imposta un array di mappature da una dimensione minima dell'area visibile alla dimensione dell'area annuncio per questa area annuncio.
get	Ritirato. Restituisce il valore dell'attributo AdSense associato alla chiave specificata per questa area.
getAdUnitPath	Restituisce il percorso completo dell'unità pubblicitaria, con il codice di rete e il percorso dell'unità pubblicitaria.
getAttributeKeys	Ritirato. Restituisce l'elenco delle chiavi degli attributi impostate in questa area annuncio.
getCategoryExclusions	Ritirato. Restituisce le etichette di esclusione delle categorie di annunci per questa area.
getConfig	Recupera una copia bloccata delle opzioni di configurazione generali per l'area annuncio impostata da setConfig.
getResponseInformation	Restituisce le informazioni sulla risposta all'annuncio.
getSlotElementId	Restituisce l'ID dello slot div fornito al momento della definizione dello slot.
getTargeting	Ritirato. Restituisce un parametro di targeting personalizzato specifico impostato su questa area annuncio.
getTargetingKeys	Ritirato. Restituisce l'elenco di tutte le chiavi di targeting personalizzato impostate su questa area annuncio.
set	Ritirato. Imposta un valore per un attributo AdSense in questa area annuncio.
setCategoryExclusion	Ritirato. Imposta un'etichetta di esclusione di categorie di annunci a livello di area annuncio in questa area.
setClickUrl	Ritirato. Imposta l'URL di clic a cui gli utenti verranno reindirizzati dopo aver fatto clic sull'annuncio.
setCollapseEmptyDiv	Ritirato. Imposta se l'area div deve essere nascosta quando non contiene annunci.
setConfig	Imposta le opzioni di configurazione generali per questo slot.
setForceSafeFrame	Ritirato. Configura se forzare o meno il rendering degli annunci in questa area utilizzando un contenitore SafeFrame.
setSafeFrameConfig	Ritirato. Imposta le preferenze a livello di area per la configurazione di SafeFrame.
setTargeting	Ritirato. Imposta un parametro di targeting personalizzato per questa area annuncio.
updateTargetingFromMap	Ritirato. Imposta i parametri di targeting personalizzato per questa area annuncio 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());

TypeScript

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

Vedi anche

• Inizia a utilizzare i Tag publisher di Google
• Visualizza un annuncio di prova

Parametri
service: Service	Il servizio da aggiungere.

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

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

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

Deprecato: utilizza SlotSettingsConfig.categoryExclusion al suo posto.

Esempio

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

// 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")!
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

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

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

---

clearTargeting

clearTargeting(key?: string): Slot

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

Ritirato: utilizza SlotSettingsConfig.targeting.

Esempio

JavaScript

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

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

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

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// 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 viene specificata, tutti i parametri di targeting verranno cancellati.

Resi
Slot	L'oggetto slot 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 dell'area annuncio per questa area annuncio.

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

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 crearla. Ogni mappatura delle dimensioni è un array di due elementi: SingleSizeArray e GeneralSize.

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

---

get

get(key: string): string

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

Metodo deprecato: utilizza googletag.Slot.getConfig.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Vedi anche

• Attributi AdSense

Parametri
key: string	Nome dell'attributo da cercare.

Resi
string	Valore corrente della 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'.

TypeScript

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

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

Resi
string	Percorso unità pubblicitaria.

---

getAttributeKeys

getAttributeKeys(): string[]

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

Metodo deprecato: utilizza googletag.Slot.getConfig al suo posto.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

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

---

getCategoryExclusions

getCategoryExclusions(): string[]

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

Deprecato: utilizza googletag.Slot.getConfig al suo posto.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

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

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

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

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>

Recupera una copia bloccata delle opzioni di configurazione generali per l'area annuncio impostata da setConfig.

Non tutte le proprietà setConfig() sono supportate da questo metodo. Le proprietà supportate sono:

• adsenseAttributes
• categoryExclusion
• targeting

Esempio

JavaScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

TypeScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

Parametri
keys: string | string[]	Le chiavi delle opzioni di configurazione da recuperare.

Resi
Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>	Una copia bloccata delle opzioni di configurazione per lo slot.

---

getResponseInformation

getResponseInformation(): ResponseInformation

Restituisce le informazioni sulla risposta all'annuncio. Questo si basa sull'ultima risposta dell'annuncio per l'area annuncio. Se viene richiamato quando l'area annuncio non contiene annunci, verrà restituito null.

Resi
ResponseInformation	Le informazioni più recenti sulla risposta dell'annuncio o null se l'area non contiene annunci.

---

getSlotElementId

getSlotElementId(): string

Restituisce l'ID dello slot div fornito al momento della definizione dello slot.

Esempio

JavaScript

const 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 slot div.

---

getTargeting

getTargeting(key: string): string[]

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

Metodo deprecato: utilizza googletag.Slot.getConfig.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

TypeScript

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

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["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 una chiave di questo tipo.

---

getTargetingKeys

getTargetingKeys(): string[]

Restituisce l'elenco di tutte le chiavi di targeting personalizzato impostate su questa area annuncio. Le chiavi di targeting a livello di servizio non sono incluse.

Ritirato: utilizza googletag.Slot.getConfig.

Esempio

JavaScript

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

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

TypeScript

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

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// 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. In questo modo, verranno sostituiti tutti i valori impostati a livello di servizio per questa chiave.

Se chiami questo metodo più di una volta 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.

Ritirato: utilizza SlotSettingsConfig.adsenseAttributes.

Esempio

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

Vedi anche

• Attributi AdSense

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

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

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

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

Deprecato: utilizza SlotSettingsConfig.categoryExclusion al suo posto.

Esempio

JavaScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

Vedi anche

• Etichette personalizzate per bloccare annunci

Parametri
categoryExclusion: string	L'etichetta di esclusione delle categorie di annunci da aggiungere.

Resi
Slot	L'oggetto slot 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 di 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. Questa opzione funziona solo per le richieste non SRA.

Ritirato: utilizza SlotSettingsConfig.clickUrl.

Esempio

JavaScript

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

TypeScript

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

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

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

---

setCollapseEmptyDiv

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

Imposta se l'area annuncio div deve essere nascosta quando non contiene annunci. Questa impostazione esegue l'override delle impostazioni a livello di servizio.

Ritirato: utilizza SlotSettingsConfig.collapseDiv.

Esempio

JavaScript

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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
• Riduci al minimo la variazione 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 la compressione non è true.

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

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): Slot

Imposta le opzioni di configurazione generali per questo slot.

Parametri
slotConfig: SlotSettingsConfig	L'oggetto di configurazione.

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

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

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

Tieni presente quanto segue quando utilizzi questa API:

• Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per le rispettive aree annuncio.
• 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 se non viene 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 rendering diretto in una pagina del publisher.

Deprecato: utilizza SlotSettingsConfig.safeFrame.

Esempio

JavaScript

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

• Visualizza creatività con 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). L'impostazione di questo valore su false, se non specificato a livello di pagina, non cambierà nulla.

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

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): Slot

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

Queste preferenze a livello di area, se specificate, sostituiranno qualsiasi preferenza a livello di pagina.

Ritirato: utilizza SlotSettingsConfig.safeFrame.

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

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

• Visualizza creatività con SafeFrame

Parametri
config: SafeFrameConfig	L'oggetto di configurazione.

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

---

setTargeting

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

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

Deprecato: utilizza SlotSettingsConfig.targeting.

Esempio

JavaScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

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

TypeScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

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

Vedi anche

• Targeting per coppie chiave-valore

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

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

---

updateTargetingFromMap

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

Imposta i parametri di targeting personalizzato per questa area annuncio da una mappa chiave:valore in un oggetto JSON. Questa operazione equivale a chiamare Slot.setTargeting per tutte le coppie chiave-valore dell'oggetto. Queste chiavi sono definite nel tuo account Google Ad Manager.

Note:

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

Deprecato: utilizza SlotSettingsConfig.targeting.

Esempio

JavaScript

const 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 slot 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 degli annunci.
AdSenseAttributesConfig	Impostazioni per controllare il comportamento degli annunci AdSense.
AutoRefreshConfig	Impostazioni di configurazione dell'aggiornamento automatico.
ContinueButtonConfig	Impostazioni per configurare il comportamento del pulsante Continua.
InterstitialConfig	Un oggetto che definisce il comportamento di una singola area annunci interstitial.
LazyLoadConfig	Impostazioni per controllare l'utilizzo del caricamento lento in GPT.
PageSettingsConfig	Interfaccia di configurazione principale per le impostazioni a livello di pagina.
PrivacyTreatmentsConfig	Impostazioni per controllare i trattamenti per la privacy dei publisher.
PublisherProvidedSignalsConfig	Oggetto di configurazione degli indicatori forniti dal publisher (PPS).
SafeFrameConfig	Impostazioni per controllare SafeFrame in GPT.
SlotSettingsConfig	Interfaccia di configurazione principale per le impostazioni a livello di area.
TaxonomyData	Un oggetto contenente i valori per una singola tassonomia.
VideoAdsConfig	Impostazioni per configurare le impostazioni relative agli annunci video.

Alias del tipo
CollapseDivBehavior	Valori supportati per controllare il comportamento di compressione delle aree annunci.
InterstitialTrigger	Attivatori di annunci interstitial supportati.
PrivacyTreatment	Trattamenti per la privacy dei publisher supportati.
Taxonomy	Tassonomie supportate per gli indicatori forniti dal publisher (PPS).

Alias del tipo

---

CollapseDivBehavior

CollapseDivBehavior: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"

Valori supportati per controllare il comportamento di compressione delle aree annunci.

Vedi anche

• PageSettingsConfig.collapseDiv
• SlotSettingsConfig.collapseDiv

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar" | "inactivity" | "endOfArticle" | "continueReading" | "backward"

Attivatori di annunci interstitial supportati.

Nota: a partire dal 15 giugno 2026, l'attivatore backward non sarà più supportato e la sua attivazione non avrà alcun effetto. Per saperne di più, consulta le note di rilascio di GPT.

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Trattamenti per la privacy dei 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 degli annunci.

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

TypeScript

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

Proprietà

---

Optional abilitato

enabled?: boolean

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

L'impostazione di questo valore sostituisce l'impostazione predefinita configurata in Google Ad Manager.

Vedi anche

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

---

googletag.config.AdSenseAttributesConfig

Impostazioni per controllare il comportamento degli annunci AdSense.

Questi attributi possono essere utilizzati per eseguire l'override delle impostazioni lato server in base alla richiesta.

Proprietà
adsense_ad_format?	Formato dell'annuncio AdSense.
adsense_channel_ids?	ID canali AdSense.
adsense_test_mode?	Indica se la modalità di test è attivata o meno.
document_language?	Lingua della pagina in cui vengono visualizzati gli annunci.
page_url?	URL della pagina in cui vengono visualizzati gli annunci.

Vedi anche

• PageSettingsConfig.adsenseAttributes
• SlotSettingsConfig.adsenseAttributes

Proprietà

---

Optional adsense_ad_format

adsense_ad_format?: "120x240_as" | "120x600_as" | "125x125_as" | "160x600_as" | "180x150_as" | "200x200_as" | "234x60_as" | "250x250_as" | "300x250_as" | "336x280_as" | "468x60_as" | "728x90_as"

Formato dell'annuncio AdSense.

---

Optional adsense_channel_ids

adsense_channel_ids?: string

ID canale AdSense.

I valori consentiti sono gli ID canale separati da "+".

Esempio: 271828183+314159265

Vedi anche

• Monitora il rendimento delle unità pubblicitarie con i canali personalizzati

---

Optional adsense_test_mode

adsense_test_mode?: "on"

Indica se la modalità di test è attivata o meno.

Se impostato su on, gli annunci vengono contrassegnati come solo di test e non verranno inclusi nel conteggio o nella fatturazione. Questa impostazione deve essere disattivata per il traffico di produzione, non di test.

---

Optional document_language

document_language?: string

Lingua della pagina in cui vengono visualizzati gli annunci.

I valori consentiti sono codici lingua ISO 639-1 validi.

Esempio: en

Vedi anche

• Elenco dei codici lingua ISO 639

---

Optional page_url

page_url?: string

URL della pagina in cui vengono visualizzati gli annunci.

I valori consentiti sono URL validi.

Esempio: http://www.example.com

---

googletag.config.AutoRefreshConfig

Impostazioni di configurazione dell'aggiornamento automatico.

Proprietà
backForwardCache?	Indica se GPT aggiornerà automaticamente un'area annuncio visualizzata attivamente quando la pagina viene ripristinata dalla cache back-forward.
heavyAds?	Se GPT aggiornerà automaticamente un'area annunci se l'intervento relativo ad annunci pesanti di Chrome viene attivato nell'iframe dell'annuncio dell'area.

Proprietà

---

Optional backForwardCache

backForwardCache?: boolean

Indica se GPT aggiornerà automaticamente un'area annuncio visualizzata attivamente quando la pagina viene ripristinata dalla cache back-forward. Il valore predefinito è true.

Esempio

JavaScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Vedi anche

• Cache back-forward

---

Optional heavyAds

heavyAds?: boolean

Se GPT aggiornerà automaticamente un'area annunci se l'intervento relativo ad annunci pesanti di Chrome viene attivato nell'iframe dell'annuncio dell'area. Il valore predefinito è true.

Esempio

JavaScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Vedi anche

• Informazioni sugli interventi di Chrome sugli annunci pesanti

---

googletag.config.ContinueButtonConfig

Impostazioni per configurare il comportamento del pulsante Continua.

Proprietà
backgroundColor?	Il colore di sfondo del pulsante.
font?	La famiglia di caratteri del testo del pulsante.
fontColor?	Il colore del testo del pulsante.
freqCapIntervalMinutes?	L'intervallo della quota limite in minuti.
targetId?	L'ID dell'elemento HTML su cui eseguire il rendering/attivare il pulsante Continua.

Vedi anche

• SlotSettingsConfig.continueButton

Proprietà

---

Optional backgroundColor

backgroundColor?: string

Il colore di sfondo del pulsante.

Esempio: 'blue', '#94B1FF'

---

Optional font

font?: string

La famiglia di caratteri del testo del pulsante.

Esempio: 'Arial'

---

Optional fontColor

fontColor?: string

Il colore del testo del pulsante.

Esempio: 'white', '#B73B87'

---

Optional freqCapIntervalMinutes

freqCapIntervalMinutes?: number

L'intervallo della quota limite in minuti.

Deve essere un numero intero maggiore o uguale a 1.

---

Optional targetId

targetId?: string

L'ID dell'elemento HTML su cui eseguire il rendering/attivare il pulsante Continua.

---

googletag.config.InterstitialConfig

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

Proprietà
requireStorageAccess?	Se è necessario il consenso per l'archiviazione locale per visualizzare questo annuncio interstitial.
triggers?	La configurazione dell'attivatore dell'interstitial per questo annuncio interstitial.

Proprietà

---

Optional requireStorageAccess

requireStorageAccess?: boolean

Indica se è necessario il consenso per lo spazio di archiviazione locale per visualizzare 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 pubblicazione di annunci interstitial. Se imposti questa proprietà su true, disattivi il comportamento predefinito e ti assicuri che gli annunci interstitial vengano mostrati solo agli utenti che hanno fornito il consenso all'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
  },
});

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

• Gestisci il traffico degli interstitial per il web

---

Optional trigger

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

La configurazione dell'attivatore di interstitial per questo annuncio interstitial.

Se imposti il valore di un attivatore di interstitial su true, l'attivatore verrà abilitato, mentre se lo imposti su false, verrà disabilitato. In questo modo, 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,
    },
  },
});

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

• Visualizza un annuncio interstitial per il web

---

googletag.config.LazyLoadConfig

Impostazioni per controllare l'utilizzo del caricamento lento in GPT.

Proprietà
fetchMarginPercent?	La distanza minima dall'area visibile corrente che un'area annuncio deve avere prima di richiedere un annuncio, espressa come percentuale delle dimensioni dell'area visibile.
mobileScaling?	Un moltiplicatore applicato ai margini sui dispositivi mobili.
renderMarginPercent?	La distanza minima dall'area visibile corrente che un'area deve avere prima di eseguire il rendering di un annuncio, espressa come percentuale delle dimensioni dell'area visibile.

Vedi anche

• PageSettingsConfig.lazyLoad

Proprietà

---

Optional fetchMarginPercent

fetchMarginPercent?: number

La distanza minima dall'area visibile corrente che un'area deve avere prima di richiedere un annuncio, espressa come percentuale delle dimensioni dell'area visibile.

Utilizzata insieme a renderMarginPercent, questa impostazione consente di eseguire il precaricamento di un annuncio, ma di attendere il rendering e il download di altre risorse secondarie. Pertanto, questo valore deve essere sempre maggiore o uguale a renderMarginPercent.

Un valore pari a 0 indica "quando l'area annuncio entra nell'area visibile", 100 indica "quando l'annuncio si trova a un'area visibile di distanza" e così via.

---

Optional mobileScaling

mobileScaling?: number

Un moltiplicatore applicato ai margini sui dispositivi mobili. Questo moltiplicatore viene applicato sia a fetchMarginPercent che a renderMarginPercent.

In questo modo, è possibile impostare margini diversi su dispositivi mobili e computer, dove le dimensioni dell'area visibile e le velocità di scorrimento potrebbero essere diverse. Ad esempio, un valore pari a 2,0 moltiplicherà tutti i margini per 2 sui dispositivi mobili, aumentando la distanza minima che un'area annuncio può avere dall'area visibile prima del recupero e del rendering.

---

Optional renderMarginPercent

renderMarginPercent?: number

La distanza minima dall'area visibile corrente che un'area deve avere prima di eseguire il rendering di un annuncio, espressa come percentuale delle dimensioni dell'area visibile.

Utilizzata insieme a fetchMarginPercent, questa impostazione consente di eseguire il precaricamento di un annuncio, ma di attendere il rendering e il download di altre risorse secondarie. Pertanto, questo valore deve essere sempre inferiore o uguale a fetchMarginPercent.

Un valore pari a 0 indica "quando l'area annuncio entra nell'area visibile", 100 indica "quando l'annuncio si trova a un'area visibile di distanza" e così via.

---

googletag.config.PageSettingsConfig

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

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

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

Esempi:

• Vengono modificate solo le funzionalità specificate nella chiamata 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 degli annunci.
adsenseAttributes?	Impostazione per configurare gli attributi AdSense.
adYield?	Deprecato.
autoRefresh?	Impostazione per configurare il comportamento di aggiornamento automatico degli annunci.
categoryExclusion?	Impostazione per configurare le esclusioni di categorie di annunci.
centering?	Impostazione per controllare il centraggio orizzontale degli annunci.
collapseDiv?	Impostazione per controllare il comportamento di compressione delle aree annunci.
disableInitialLoad?	Impostazione per controllare quando vengono richiesti gli annunci.
lazyLoad?	Impostazioni per controllare l'utilizzo del caricamento lento in GPT.
location?	Impostazione per il targeting geografico degli elementi pubblicitari in base alle posizioni geografiche.
pps?	Impostazioni per controllare gli indicatori forniti dal publisher (PPS).
privacyTreatments?	Impostazioni per controllare i trattamenti per la privacy dei publisher.
requestHookTimeoutMs?	Impostazione per controllare il tempo massimo di attesa di GPT per il completamento di tutti gli hook di richiesta registrati prima di procedere con una richiesta di annuncio.
safeFrame?	Impostazioni per controllare l'utilizzo di SafeFrame in GPT.
singleRequest?	Impostazione per attivare o disattivare l'architettura di richiesta singola (SRA).
targeting?	Impostazione per controllare il targeting per coppie chiave-valore.
threadYield?	Impostazione per controllare se GPT deve cedere il thread JS durante la richiesta e il rendering delle creatività.
videoAds?	Impostazioni per controllare gli annunci video.

Proprietà

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Impostazioni per controllare l'espansione degli annunci.

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

Impostazione per configurare gli attributi AdSense.

Gli attributi AdSense configurati tramite questa impostazione verranno applicati a tutte le aree annunci della pagina. Questa impostazione può essere chiamata più volte per definire più valori degli attributi o sovrascrivere i valori esistenti.

Le modifiche agli attributi AdSense si applicano solo agli annunci richiesti dopo la chiamata di questo metodo. Per questo motivo, è consigliabile chiamare questo metodo prima di qualsiasi chiamata a googletag.display o PubAdsService.refresh.

Esempio

JavaScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

TypeScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

---

Optional adYield

adYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

Deprecato: utilizza threadYield. Questo verrà rimosso nel prossimo futuro.

---

Optional autoRefresh

autoRefresh?: AutoRefreshConfig

Impostazione per configurare il comportamento di aggiornamento automatico degli annunci.

Esempio

JavaScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

Impostazione per configurare le esclusioni di categorie di annunci.

Esempio

JavaScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

TypeScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

Vedi anche

• Etichette personalizzate per bloccare annunci

---

Optional centering

centering?: boolean

Impostazione per controllare il centraggio orizzontale degli annunci. La centratura è disattivata per impostazione predefinita.

Le modifiche alla centratura orizzontale si applicano solo alle richieste di annuncio effettuate dopo la chiamata di questo metodo. Per questo motivo, è consigliabile chiamare questo metodo prima di qualsiasi chiamata a googletag.display o PubAdsService.refresh.

Esempio

JavaScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

TypeScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

---

Optional collapseDiv

collapseDiv?: CollapseDivBehavior

Impostazione per controllare il comportamento di compressione delle aree annunci.

Un'area annunci compressa non occupa spazio nella pagina.

Valori supportati:

• null (valore predefinito): l'area non verrà compressa.
• DISABLED: l'area non verrà compressa, indipendentemente dal fatto che venga restituito o meno un annuncio.
• BEFORE_FETCH: l'area annunci inizierà compressa e si espanderà quando viene restituito un annuncio.
• ON_NO_FILL: l'area annunci inizierà espansa e verrà compressa se non viene restituito alcun annuncio.

Esempio

JavaScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

TypeScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

Vedi anche

• Comprimere le aree annuncio vuote
• Riduci al minimo la variazione del layout

---

Optional disableInitialLoad

disableInitialLoad?: boolean

Impostazione per controllare quando vengono richiesti gli annunci.

Per impostazione predefinita, il metodo googletag.display registra le aree annuncio e richiede gli annunci per queste aree. Tuttavia, in alcuni casi potrebbe essere preferibile separare queste azioni per controllare con maggiore precisione quando vengono caricati i contenuti degli annunci.

Se attivi questa impostazione, non verranno richiesti annunci per le aree annuncio registrate quando viene chiamato il metodo display(). Per avviare una richiesta di annuncio, è invece necessario effettuare una chiamata separata a PubAdsService.refresh.

Questo metodo deve essere chiamato prima di chiamare googletag.enableServices.

Esempio

JavaScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

TypeScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

Vedi anche

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

---

Optional lazyLoad

lazyLoad?: LazyLoadConfig

Impostazioni per controllare l'utilizzo del caricamento lento in GPT.

Il caricamento lento è una tecnica per ritardare la richiesta e il rendering degli annunci finché non si avvicinano all'area visibile dell'utente. Per un esempio più dettagliato, consulta l'esempio di caricamento lento.

Nota: se singleRequest è abilitato, il recupero lento funziona solo quando tutte le aree annuncio si trovano al di fuori del margine di recupero.

Tutte le impostazioni di caricamento lento non specificate quando viene chiamato setConfig() utilizzeranno un valore predefinito impostato da Google. Queste impostazioni predefinite potrebbero essere perfezionate nel tempo. Per disattivare una determinata impostazione, imposta il valore su null.

Esempio

JavaScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

TypeScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

Vedi anche

• Best practice per gli annunci: dai la priorità alle aree annuncio "importanti"
• Caricamento lento

---

Optional location

location?: string

Impostazione per il targeting geografico degli elementi pubblicitari in base alle posizioni geografiche.

Esempio

JavaScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

TypeScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

Vedi anche

• Scegli le posizioni geografiche target per la pubblicazione

---

Optional pps

pps?: PublisherProvidedSignalsConfig

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

---

Optional privacyTreatments

privacyTreatments?: PrivacyTreatmentsConfig

Impostazioni per controllare i trattamenti per la privacy dei publisher.

---

Optional Experimental requestHookTimeoutMs

requestHookTimeoutMs?: number | "auto"

Impostazione per controllare il tempo massimo di attesa di GPT per il completamento di tutti gli hook di richiesta registrati prima di procedere con una richiesta di annuncio.

Tutti gli hook di richiesta registrati vengono eseguiti in parallelo. Questo timeout definisce il limite massimo di tempo per cui il processo di richiesta di annuncio verrà messo in pausa in attesa del completamento delle esecuzioni parallele.

Valori supportati:

• Numero positivo in millisecondi: il periodo di attesa personalizzato.
• 'auto': GPT utilizza un timeout ottimizzato da Google.
• null: disattiva i timeout (GPT attende indefinitamente il completamento degli hook).

Esempio

JavaScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

TypeScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

---

Optional safeFrame

safeFrame?: SafeFrameConfig

Impostazioni per controllare l'utilizzo di SafeFrame in GPT.

I valori configurati tramite questa impostazione verranno applicati a tutte le aree annuncio della pagina. Le singole aree annuncio possono sostituire questi valori tramite SlotSettingsConfig.safeFrame.

Esempio

JavaScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

TypeScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

---

Optional singleRequest

singleRequest?: boolean

Impostazione per attivare o disattivare l'architettura di richiesta singola (SRA).

Quando l'SRA è attivata, tutte le aree annuncio definite prima di una chiamata googletag.display o PubAdsService.refresh verranno raggruppate in un'unica richiesta di annuncio. Ciò offre vantaggi in termini di rendimento, ma è anche necessario per garantire che i roadblock e le esclusioni competitive vengano rispettati.

Quando l'SRA è disattivata, ogni area annuncio viene richiesta singolarmente. Questo è il comportamento predefinito di GPT.

Questo metodo deve essere chiamato prima di chiamare googletag.enableServices.

Esempio

JavaScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

TypeScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

Vedi anche

• Informazioni sui roadblock
• Best practice per gli annunci: utilizza correttamente l'architettura di richiesta singola
• Controlla il raggruppamento SRA

---

Optional targeting

targeting?: Record<string, string | string[]>

Impostazione per controllare il targeting per coppie chiave-valore.

Il targeting configurato tramite questa impostazione verrà applicato a tutte le aree annuncio della pagina. Questa impostazione può essere chiamata più volte per definire più coppie chiave-valore di targeting o sovrascrivere i valori esistenti. Le chiavi di targeting sono definite nel tuo account Google Ad Manager.

Esempio

JavaScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

TypeScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

Vedi anche

• Targeting per coppie chiave-valore

---

Optional threadYield

threadYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

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

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

Valori supportati:

• null (predefinito): GPT cederà il thread JS per le aree annuncio al di fuori dell'area visibile.
• ENABLED_ALL_SLOTS: GPT cederà il thread JS per tutte le aree annuncio, indipendentemente dal fatto che l'area annuncio si trovi o meno nell'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 });

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

• Scheduler

---

Optional videoAds

videoAds?: VideoAdsConfig

Impostazioni per controllare gli annunci video.

Esempio

JavaScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

TypeScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

Vedi anche

• Importazione di contenuti video

---

googletag.config.PrivacyTreatmentsConfig

Impostazioni per controllare i trattamenti per la privacy dei publisher.

Proprietà
treatments	Un array di trattamenti per la privacy dei publisher da attivare.

Proprietà

---

trattamenti

treatments: "disablePersonalization"[]

Un array di trattamenti per la privacy dei publisher da attivare.

Esempio

JavaScript

// 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 mappature di Taxonomy o null per cancellare la configurazione.

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

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à

---

tassonomie

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Un oggetto contenente mappature di Taxonomy o null per cancellare la configurazione.

---

googletag.config.SafeFrameConfig

Impostazioni per controllare SafeFrame in GPT.

Proprietà
allowOverlayExpansion?	Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio sovrapponendoli ai contenuti della pagina.
allowPushExpansion?	Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio spostando i contenuti della pagina.
forceSafeFrame?	Indica se forzare il rendering degli annunci utilizzando un contenitore SafeFrame.
sandbox?	Indica se SafeFrame deve utilizzare l'attributo sandbox HTML5 per impedire la navigazione di livello superiore senza l'interazione dell'utente.
useUniqueDomain?	Ritirato. Indica se SafeFrame deve utilizzare sottodomini casuali per le creatività di prenotazione.

Vedi anche

• PageSettingsConfig.safeFrame
• SlotSettingsConfig.safeFrame

Proprietà

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

Indica se SafeFrame deve consentire l'espansione dei contenuti dell'annuncio sovrapponendoli ai contenuti della pagina.

---

Optional allowPushExpansion

allowPushExpansion?: boolean

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

---

Optional forceSafeFrame

forceSafeFrame?: boolean

Indica se forzare il rendering degli annunci utilizzando un contenitore SafeFrame.

---

Optional sandbox

sandbox?: boolean

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

---

Optional useUniqueDomain

useUniqueDomain?: boolean

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

Nota: questa funzionalità è attiva per impostazione predefinita.

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

Vedi anche

• Visualizza creatività con SafeFrame

---

googletag.config.SlotSettingsConfig

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

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

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

Esempi:

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

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

• Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a Slot.setConfig.

    // Configure feature charlie to echo = 1, foxtrot = true.
    slot.setConfig({
        charlie: {
            echo: 1,
            foxtrot: true,
        }
    });
  
    // Update feature charlie to echo = 2. Since foxtrot was not specified,
    // the value is cleared.
    slot.setConfig({
        charlie: {
            echo: 2
        }
    });

• Tutte le impostazioni di 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 configurare l'espansione dell'annuncio.
adsenseAttributes?	Impostazione per configurare gli attributi AdSense.
categoryExclusion?	Impostazione per configurare le esclusioni di categorie di annunci.
clickUrl?	Impostazione per configurare l'URL a cui verranno reindirizzati gli utenti dopo aver fatto clic sull'annuncio.
collapseDiv?	Impostazione per configurare il comportamento di compressione dell'area annuncio.
continueButton?	Impostazioni per configurare il comportamento del pulsante Continua per gli annunci durante la pausa dei contenuti.
interstitial?	Impostazioni che configurano il comportamento delle aree annuncio interstitial.
safeFrame?	Impostazioni per configurare l'utilizzo di SafeFrame in GPT.
targeting?	Impostazione per configurare il targeting per coppie chiave-valore.

Proprietà

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Impostazioni per configurare l'espansione dell'annuncio.

Vedi anche

• Espansione dell'annuncio

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

Impostazione per configurare gli attributi AdSense.

Gli attributi AdSense configurati tramite questa impostazione verranno applicati solo all'area annuncio. Questa impostazione può essere chiamata più volte per definire più valori degli attributi o sovrascrivere i valori esistenti.

Le modifiche agli attributi AdSense si applicano solo agli annunci richiesti dopo la chiamata di questo metodo. Per questo motivo, è consigliabile chiamare questo metodo prima di qualsiasi chiamata a googletag.display o PubAdsService.refresh.

Esempio

JavaScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

TypeScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

Impostazione per configurare le esclusioni di categorie di annunci.

Esempio

JavaScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

TypeScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

Vedi anche

• Etichette personalizzate per bloccare annunci

---

Optional clickUrl

clickUrl?: string

Impostazione per configurare l'URL a cui verranno reindirizzati gli utenti dopo aver fatto clic sull'annuncio.

I server di 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. Se imposti questo valore più di una volta, qualsiasi valore configurato in precedenza verrà sovrascritto. Se passi null, il valore verrà cancellato.

Nota: questa impostazione si applica solo alle richieste non SRA.

Esempio

JavaScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

TypeScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

---

Optional collapseDiv

collapseDiv?: CollapseDivBehavior

Impostazione per configurare il comportamento di compressione dell'area annuncio.

Un'area annuncio compressa non occupa spazio nella pagina.

Valori supportati:

• null (valore predefinito): l'area non verrà compressa.
• DISABLED: l'area non verrà compressa, indipendentemente dal fatto che venga restituito o meno un annuncio.
• BEFORE_FETCH: l'area annunci inizierà compressa e si espanderà quando viene restituito un annuncio.
• ON_NO_FILL: l'area annunci inizierà espansa e verrà compressa se non viene restituito alcun annuncio.

Esempio

JavaScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

TypeScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

Vedi anche

• Comprimere le aree annuncio vuote
• Riduci al minimo la variazione del layout

---

Optional continueButton

continueButton?: ContinueButtonConfig

Impostazioni per configurare il comportamento del pulsante Continua per gli annunci durante la pausa dei contenuti.

Queste impostazioni consentono di personalizzare l'aspetto e il comportamento delle interazioni di uscita e di continuazione della lettura associate ai formati di pausa dei contenuti.

Tutte le impostazioni del pulsante Continua non specificate quando viene chiamato setConfig() utilizzeranno un valore predefinito impostato da Google.

Per disattivare o cancellare tutte le impostazioni del pulsante Continua, passa null.

Esempio

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

---

Optional interstitial

interstitial?: InterstitialConfig

Impostazioni che configurano il comportamento dell'area annuncio interstitial.

Vedi anche

• Gestisci il traffico degli interstitial per il web

---

Optional safeFrame

safeFrame?: SafeFrameConfig

Impostazioni per configurare l'utilizzo di SafeFrame in GPT.

I valori configurati tramite questa impostazione verranno applicati solo all'area annuncio e sostituiranno i valori impostati tramite PageSettingsConfig.safeFrame.

Esempio

JavaScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

TypeScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

---

Optional targeting

targeting?: Record<string, string | string[]>

Impostazione per configurare il targeting per coppie chiave-valore.

Il targeting configurato tramite questa impostazione verrà applicato solo all'area annuncio. Questa impostazione può essere chiamata più volte per definire più coppie chiave-valore di targeting o sovrascrivere i valori esistenti. Le chiavi di targeting sono definite nel tuo account Google Ad Manager.

Esempio

JavaScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

TypeScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

Vedi anche

• Targeting per coppie chiave-valore

---

googletag.config.TaxonomyData

Un oggetto contenente i valori per una singola tassonomia.

Proprietà
values	Un elenco di valori di tassonomia.

Proprietà

---

values

values: readonly string[]

Un elenco di valori di tassonomia.

---

googletag.config.VideoAdsConfig

Impostazioni per configurare le impostazioni relative agli annunci video.

Proprietà
enableVideoAds	Se gli annunci video saranno presenti nella pagina.
videoCmsId?	L'ID dell'origine di contenuto video.
videoContentId?	L'ID contenuti video.

Vedi anche

• PageSettingsConfig.videoAds

Proprietà

---

enableVideoAds

enableVideoAds: boolean

Indica se gli annunci video saranno presenti nella pagina.

Se impostato su true, attiva i vincoli di esclusione dei contenuti sugli annunci display e video.

Se i contenuti video sono noti, imposta videoContentId e videoCmsId sui valori forniti al servizio di importazione di contenuti di Google Ad Manager per utilizzare l'esclusione dei contenuti per gli annunci display.

---

Optional videoCmsId

videoCmsId?: string

L'ID origine di contenuto video.

Si tratta di un valore univoco assegnato dal servizio di importazione di contenuti di Google Ad Manager per identificare l'origine di contenuto video specificata da videoContentId.

Vedi anche

• cmsid (ID origine di contenuto)

---

Optional videoContentId

videoContentId?: string

L'ID dei contenuti video.

Si tratta di un valore univoco che identifica un determinato video dall'origine di contenuto specificata da videoCmsId. Questo valore viene assegnato dal CMS che ospita i tuoi contenuti video.

Vedi anche

• vid (ID video)

---

googletag.enums

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

Enumerazioni
OutOfPageFormat	Formati fuori pagina supportati da GPT.
TagForAgeTreatment	Impostazioni del trattamento in base all'età supportate da GPT.
TrafficSource	Sorgenti di traffico supportate da GPT.

Enumerazioni

---

OutOfPageFormat

OutOfPageFormat

Formati fuori pagina supportati da GPT.

Vedi anche

• defineOutOfPageSlot

Membri dell'enumerazione
AD_INTENTS	Formato degli annunci per intenzione.
BOTTOM_ANCHOR	Formato ancorato in cui l'area annuncio rimane fissa nella parte inferiore dell'area visibile.
GAME_MANUAL_INTERSTITIAL	Formato interstitial manuale per giochi. Nota: l'interstitial manuale per giochi è un formato ad accesso limitato.
INTERSTITIAL	Formato della creatività interstitial per il web.
LEFT_SIDE_RAIL	Formato laterale sinistro.
REWARDED	Formato con premio.
RIGHT_SIDE_RAIL	Formato laterale destro.
TOP_ANCHOR	Formato ancorato in cui l'area annuncio rimane fissa nella parte superiore dell'area visibile.

---

TagForAgeTreatment

TagForAgeTreatment

Impostazioni del trattamento in base all'età supportate da GPT.

Vedi anche

• PrivacySettingsConfig.tagForAgeTreatment

Membri dell'enumerazione
CHILD	Indica che le richieste di annunci devono essere soggette al trattamento "bambini".
TEEN	Indica che le richieste di annunci devono essere soggette al trattamento in base all'età degli adolescenti.
UNSPECIFIED	Valore predefinito. Indica che alla richiesta di annuncio non si applica alcun indicatore di trattamento con limiti di età specifico.

---

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 tuo 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 evento al tipo di oggetto evento corrispondente per Service.addEventListener e Service.removeEventListener.
GameManualInterstitialSlotClosedEvent	Questo evento viene attivato quando un'area annuncio interstitial manuale per giochi viene chiusa dall'utente.
GameManualInterstitialSlotReadyEvent	Questo evento viene attivato quando un'area interstitial manuale per giochi è pronta per essere mostrata 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'area annuncio con premio viene chiusa dall'utente.
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.
RewardedSlotVideoCompletedEvent	Questo evento viene attivato al termine della riproduzione di un annuncio video con premio.
SlotOnloadEvent	Questo evento viene attivato quando l'iframe della creatività attiva il relativo evento di caricamento.
SlotRenderEndedEvent	Questo evento viene attivato quando il codice della creatività viene inserito in un'area annuncio.
SlotRequestedEvent	Questo evento viene attivato quando viene richiesto un annuncio per un'area specifica.
SlotResponseReceived	Questo evento viene attivato quando viene ricevuta una risposta all'annuncio per un determinato spazio.
SlotVisibilityChangedEvent	Questo evento viene attivato ogni volta che cambia la percentuale sullo schermo dell'area di un'area annunci.

---

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 annuncio

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 evento al tipo di oggetto evento corrispondente per Service.addEventListener e Service.removeEventListener. È documentato solo per riferimento e per motivi di sicurezza dei tipi.

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.
rewardedSlotVideoCompleted	Alias per events.RewardedSlotVideoCompletedEvent.
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.

---

rewardedSlotVideoCompleted

rewardedSlotVideoCompleted: RewardedSlotVideoCompletedEvent

Alias per events.RewardedSlotVideoCompletedEvent.

---

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

Estende Event

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

Nota: l'interstitial manuale per giochi è un formato ad accesso limitato.

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

Esempio

JavaScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

TypeScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

Vedi anche

• Listener di eventi annuncio
• Mostra un annuncio interstitial manuale per giochi

---

googletag.events.GameManualInterstitialSlotReadyEvent

Estende Event

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

Nota: l'interstitial manuale per giochi è un formato ad accesso limitato.

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

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

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
    const slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

Vedi anche

• Listener di eventi annuncio
• Mostra un annuncio interstitial manuale per giochi

Metodi

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): boolean

Mostra l'annuncio interstitial manuale per giochi all'utente. Indica se l'annuncio è stato visualizzato correttamente.

Resi
boolean

---

googletag.events.ImpressionViewableEvent

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 dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.
  }
});

TypeScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

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

Vedi anche

• Listener di eventi annuncio

---

googletag.events.RewardedSlotClosedEvent

Estende Event

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

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

Esempio

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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.
    }
  });
}

TypeScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

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

Vedi anche

• Listener di eventi annuncio
• Visualizza un annuncio con premio

---

googletag.events.RewardedSlotGrantedEvent

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 la concessione di un premio, questo evento non verrà attivato.

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

Esempio

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.
    }
  });
}

TypeScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
    const slot = event.slot;
    console.group("Reward granted for slot", slot.getSlotElementId(), ".");

    // Log details of the reward.
    console.log("Reward type:", event.payload?.type);
    console.log("Reward amount:", event.payload?.amount);
    console.groupEnd();

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

Vedi anche

• Listener di eventi annuncio
• Visualizza un annuncio con premio

Proprietà

---

payload

payload: RewardedPayload

Un oggetto contenente informazioni sul premio concesso.

---

googletag.events.RewardedSlotReadyEvent

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 dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.
    }
  });
}

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
    const slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

Vedi anche

• Listener di eventi annuncio
• Visualizza un annuncio con premio

Metodi

---

makeRewardedVisible

makeRewardedVisible(): boolean

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

Resi
boolean	Indica se l'annuncio con premio è stato visualizzato correttamente.

---

googletag.events.RewardedSlotVideoCompletedEvent

Estende Event

Questo evento viene attivato al termine della riproduzione di un annuncio video con premio.

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

Esempio

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

TypeScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

Vedi anche

• Listener di eventi annuncio
• Visualizza un annuncio con premio

---

googletag.events.SlotOnloadEvent

Estende Event

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.
  }
});

TypeScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

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

Vedi anche

• Listener di eventi annuncio

---

googletag.events.SlotRenderEndedEvent

Estende Event

Questo evento viene attivato quando il codice della creatività viene inserito in un'area annuncio. Questo evento si verifica prima del recupero delle risorse della creatività, pertanto quest'ultima potrebbe non essere ancora visibile. Se hai bisogno di sapere quando è terminato il caricamento di tutte le risorse della creatività per un'area annuncio, prendi in considerazione l'evento events.SlotOnloadEvent.

Proprietà
advertiserId	ID inserzionista dell'annuncio visualizzato.
campaignId	ID campagna dell'annuncio visualizzato.
companyIds	ID delle aziende che hanno fatto un'offerta per l'annuncio di backfill visualizzato.
creativeId	ID creatività dell'annuncio basato su prenotazione visualizzato.
creativeTemplateId	ID del modello di creatività dell'annuncio basato su prenotazione visualizzato.
isBackfill	Indica se un annuncio era un annuncio di backfill.
isEmpty	Indica se è stato restituito un annuncio per l'area annuncio.
labelIds	Deprecato.
lineItemId	ID voce dell'annuncio basato su prenotazione visualizzato.
responseIdentifier	L'identificatore della risposta è un identificatore univoco della risposta all'annuncio.
serviceName	Nome del servizio che ha attivato l'evento. Ereditata dalla proprietà Event.serviceName
size	Indica le dimensioni in pixel della creatività visualizzata.
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà Event.slot
slotContentChanged	Indica se i contenuti dell'area annuncio sono stati modificati con l'annuncio visualizzato.
sourceAgnosticCreativeId	ID creatività dell'annuncio di prenotazione o di backfill visualizzato.
sourceAgnosticLineItemId	ID voce 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.
  }
});

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 annuncio

Proprietà

---

advertiserId

advertiserId: number

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

---

campaignId

campaignId: number

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

---

companyIds

companyIds: number[]

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

---

creativeId

creativeId: number

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

---

creativeTemplateId

creativeTemplateId: number

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

---

isBackfill

isBackfill: boolean

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

---

isEmpty

isEmpty: boolean

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

---

labelIds

labelIds: number[]

Deprecato: questo campo non viene più compilato.

---

lineItemId

lineItemId: number

ID voce dell'annuncio basato su prenotazione visualizzato. Il valore è null per le aree annuncio vuote, gli annunci di backfill e le creatività visualizzate da servizi diversi da PubAdsService.

---

responseIdentifier

responseIdentifier: string

L'identificatore della risposta è un identificatore univoco della risposta all'annuncio. Questo valore può essere utilizzato per identificare e bloccare l'annuncio nel Centro revisione annunci (ARC).

---

size

size: string | number[]

Indica le dimensioni in pixel della creatività visualizzata. Esempio: [728, 90]. Il valore è null per le aree annuncio vuote.

---

slotContentChanged

slotContentChanged: boolean

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

---

sourceAgnosticCreativeId

sourceAgnosticCreativeId: number

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

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: number

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

---

yieldGroupIds

yieldGroupIds: number[]

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

---

googletag.events.SlotRequestedEvent

Estende Event

Questo evento viene attivato quando viene richiesto un annuncio per un'area specifica.

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.
  }
});

TypeScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

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

Vedi anche

• Listener di eventi annuncio

---

googletag.events.SlotResponseReceived

Estende Event

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

Proprietà
serviceName	Nome del servizio che ha attivato l'evento. Ereditata dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.
  }
});

TypeScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

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

Vedi anche

• Listener di eventi annuncio

---

googletag.events.SlotVisibilityChangedEvent

Estende Event

Questo evento viene attivato ogni volta che cambia la percentuale sullo schermo dell'area di un'area annunci. L'evento è 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 dalla proprietà Event.serviceName
slot	Lo slot che ha attivato l'evento. Ereditata dalla proprietà 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.
  }
});

TypeScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

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

Vedi anche

• Listener di eventi annuncio

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 la gestione degli 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 la restituzione di un indicatore sicuro per un offerente o un fornitore specifico.

Alias del tipo

---

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

Interfaccia per la restituzione di un indicatore sicuro per un offerente o un fornitore specifico. È necessario fornire id o networkCode, ma non entrambi.

---

googletag.secureSignals.BidderSignalProvider

Restituisce un indicatore sicuro per un offerente specifico.

Un fornitore di indicatori sicuri per gli offerenti è composto 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 invece 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");
  },
});

TypeScript

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

Vedi anche

• Condividi 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 è composto 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 invece 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");
  },
});

TypeScript

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

Vedi anche

• Condividi 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 dalla cache tutti gli indicatori per tutti i raccoglitori.
push	Aggiunge un nuovo secureSignals.SecureSignalProvider all'array del fornitore di indicatori e avvia la procedura di generazione degli indicatori.

Metodi

---

clearAllCache

clearAllCache(): void

Cancella dalla cache tutti gli indicatori per tutti i raccoglitori.

La chiamata a questo metodo potrebbe ridurre la probabilità che gli indicatori vengano inclusi nelle richieste di annunci per le visualizzazioni di pagina attuali e, eventualmente, successive. Per questo motivo, il metodo deve essere chiamato solo in caso di modifiche di stato significative, come eventi che indicano un nuovo utente (accesso, disconnessione, iscrizione e così via).

---

push

push(provider: SecureSignalProvider): void

Aggiunge un nuovo secureSignals.SecureSignalProvider all'array del fornitore di indicatori e avvia la procedura di generazione degli indicatori.

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