Riferimento GPT

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

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

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

Annotare i tipi

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

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

googletag

Lo spazio dei nomi globale utilizzato dal Tag publisher di Google per la sua API.
Spazi dei nomi
config
Interfaccia di configurazione principale per le impostazioni a livello di pagina.
enums
Questo è lo spazio dei nomi utilizzato da GPT per i tipi di enum.
events
Questo è lo spazio dei nomi utilizzato da GPT per gli eventi.
secureSignals
Questo è lo spazio dei nomi utilizzato da GPT per gestire gli indicatori sicuri.
Interfacce
CommandArray
L'array di comandi accetta una sequenza di funzioni e le richiama in ordine.
CompanionAdsService
Servizio Annunci companion.
PrivacySettingsConfig
Oggetto di configurazione per le impostazioni della privacy.
PubAdsService
Servizio Annunci del publisher.
ResponseInformation
Un oggetto che rappresenta una singola risposta all'annuncio.
RewardedPayload
Un oggetto che rappresenta il premio associato a un annuncio con premio.
SafeFrameConfig
Oggetto di configurazione per i contenitori SafeFrame.
Service
Classe di servizio di base che contiene metodi comuni a tutti i servizi.
SizeMappingBuilder
Generatore di oggetti delle specifiche di mappatura delle dimensioni.
Slot
Slot è un oggetto che rappresenta una singola area annuncio in una pagina.
Alias del tipo
GeneralSize
Una configurazione delle dimensioni valida per uno spazio, che può essere una o più dimensioni.
MultiSize
Un elenco di singole dimensioni valide.
NamedSize
Dimensioni con nome che uno slot può avere.
SingleSize
Una singola dimensione valida per uno spazio.
SingleSizeArray
Array di due numeri che rappresentano [larghezza, altezza].
SizeMapping
Una mappatura delle dimensioni dell'area visibile alle dimensioni degli annunci.
SizeMappingArray
Un elenco di mappature delle dimensioni.
Variabili
apiReady
Indica che l'API GPT è caricata e pronta per essere chiamata.
cmd
Riferimento alla coda di comandi globale per l'esecuzione asincrona delle chiamate relative a GPT.
pubadsReady
Flag che indica che PubAdsService è attivato, caricato e completamente operativo.
secureSignalProviders
Riferimento all'array dei fornitori di indicatori sicuri.
Funzioni
companionAds
Restituisce un riferimento a CompanionAdsService.
defineOutOfPageSlot
Consente di creare un'area annuncio fuori pagina con il percorso dell'unità pubblicitaria specificato.
defineSlot
Consente di creare un'area annuncio con un determinato percorso e dimensioni dell'unità pubblicitaria e di associarla all'ID di un elemento div nella pagina che conterrà l'annuncio.
destroySlots
Distrugge gli slot specificati, rimuovendo tutti gli oggetti e i riferimenti correlati da GPT.
disablePublisherConsole
Disattiva la Google Publisher Console.
display
Indica ai servizi dello slot di eseguire il rendering dello slot.
enableServices
Attiva tutti i servizi GPT che sono stati definiti per le aree annuncio nella pagina.
getVersion
Restituisce la versione corrente di GPT.
openConsole
Viene aperta la Google Publisher Console.
pubads
Restituisce un riferimento a PubAdsService.
setAdIframeTitle
Imposta il titolo per tutti gli iframe dei contenitori degli annunci creati da PubAdsService, da questo momento in poi.
setConfig
Imposta le opzioni di configurazione generali per la pagina.
sizeMapping
Crea un nuovo SizeMappingBuilder.

Alias del tipo

GeneralSize

GeneralSize: SingleSize | MultiSize
Una configurazione delle dimensioni valida per uno spazio, che può essere una o più dimensioni.

MultiSize

MultiSize: SingleSize[]
Un elenco di singole dimensioni valide.

NamedSize

NamedSize: "fluid" | ["fluid"]
Dimensioni con nome che uno slot può avere. Nella maggior parte dei casi, la dimensione è un rettangolo di dimensioni fisse, ma in alcuni casi sono necessarie altre specifiche di dimensioni. Sono validi solo i seguenti formati con nome:
  • fluid: il contenitore dell'annuncio occupa il 100% della larghezza del div principale e poi ridimensiona la sua altezza in base ai contenuti della creatività. In modo simile al comportamento degli elementi di blocco standard in una pagina. Utilizzato per gli annunci nativi (vedi l'articolo correlato). Tieni presente che sia fluid che ['fluid'] sono forme accettabili per dichiarare una dimensione dell'area come fluida.

SingleSize

Una singola dimensione valida per uno spazio.

SingleSizeArray

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

SizeMapping

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

SizeMappingArray

SizeMappingArray: SizeMapping[]
Un elenco di mappature delle dimensioni.

Variabili

Const apiReady

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

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

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray
Riferimento alla coda di comando globale per l'esecuzione asincrona delle chiamate relative a GPT.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Const pubadsReady

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

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined
Riferimento all'array di fornitori di indicatori sicuri.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Funzioni

companionAds

companionAds(): CompanionAdsService
Restituisce un riferimento a CompanionAdsService.
Resi
CompanionAdsServiceIl servizio Annunci companion.

defineOutOfPageSlot

defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
Consente di creare un'area annuncio fuori pagina con il percorso dell'unità pubblicitaria specificato.

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

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

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

// Define a GPT managed web interstitial ad slot.
googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
Vedi anche
Parametri
adUnitPath: stringPercorso dell'unità pubblicitaria completo con il codice di rete e il codice dell'unità pubblicitaria.
Optional div: string | OutOfPageFormatID del div che conterrà questa unità pubblicitaria o OutOfPageFormat.
Resi
Slot | nullLo slot appena creato o null se non è possibile crearne uno.

defineSlot

defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null
Consente di creare un'area annuncio con un determinato percorso e dimensioni dell'unità pubblicitaria e di associarla all'ID di un elemento div nella pagina che conterrà l'annuncio.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
Vedi anche
Parametri
adUnitPath: stringPercorso dell'unità pubblicitaria completo con il codice di rete e il codice dell'unità.
size: GeneralSizeLarghezza e altezza dell'area aggiunta. Si tratta della dimensione utilizzata nella richiesta di annuncio se non viene fornita una mappatura delle dimensioni adattabili o se la dimensione dell'area visibile è inferiore alla dimensione più piccola indicata nella mappatura.
Optional div: stringID del div che conterrà questa unità pubblicitaria.
Resi
Slot | nullLo slot appena creato o null se non è possibile crearne uno.

destroySlots

destroySlots(slots?: Slot[]): boolean
Distrugge gli slot specificati, rimuovendo tutti gli oggetti e i riferimenti correlati da GPT. Questa API non supporta le aree annunci passback e le aree annunci companion.

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

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

JavaScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

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

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

JavaScript (precedente)

// The calls to construct an ad and display contents.
var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
googletag.display("div-1");
var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

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

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

TypeScript

// The calls to construct an ad and display contents.
const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
googletag.display("div-1");
const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
googletag.display("div-2");

// This call to destroy only slot1.
googletag.destroySlots([slot1]);

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

// This call to destroy all slots.
googletag.destroySlots();
Parametri
Optional slots: Slot[]L'array di slot da distruggere. L'array è facoltativo; tutti gli slot verranno distrutti se non è specificato.
Resi
booleantrue se gli slot sono stati distrutti, false altrimenti.

disablePublisherConsole

disablePublisherConsole(): void
Disattiva Google Publisher Console.
Vedi anche

display

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

Se viene utilizzata l'architettura di richiesta singola (SRA), tutte le aree annuncio non recuperate al momento della chiamata di questo metodo verranno recuperate contemporaneamente. Per impedire la visualizzazione di uno spazio annuncio, è necessario rimuovere l'intero div.
Vedi anche
Parametri
divOrSlot: string | Element | SlotL'ID dell'elemento div contenente lo spazio pubblicitario o l'elemento div oppure l'oggetto spazio. Se viene fornito un elemento div, deve avere un attributo "id" che corrisponda all'ID passato a defineSlot.

enableServices

enableServices(): void
Attiva tutti i servizi GPT che sono stati definiti per le aree annuncio nella pagina.

getVersion

getVersion(): string
Restituisce la versione corrente di GPT.
Vedi anche
Resi
stringLa stringa della versione GPT attualmente in esecuzione.

openConsole

openConsole(div?: string): void
Viene aperta la Google Publisher Console.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

// Calling without div ID.
googletag.openConsole();
Vedi anche
Parametri
Optional div: stringUn ID div dell'area annuncio. Questo valore è facoltativo. Se specificato, la Publisher Console tenterà di aprirsi con i dettagli dell'area annuncio specificata in visualizzazione.

pubads

pubads(): PubAdsService
Restituisce un riferimento a PubAdsService.
Resi
PubAdsServiceIl servizio Annunci del publisher.

setAdIframeTitle

setAdIframeTitle(title: string): void
Imposta il titolo per tutti gli iframe dei contenitori degli annunci creati da PubAdsService, da questo momento in poi.
Esempio

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (precedente)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");
Parametri
title: stringIl nuovo titolo per tutti gli iframe del contenitore degli annunci.

setConfig

setConfig(config: PageSettingsConfig): void
Imposta le opzioni di configurazione generali per la pagina.
Parametri
config: PageSettingsConfig

sizeMapping

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 il GPT.
Metodi
push
Esegue la sequenza di funzioni specificate negli argomenti in ordine.

Metodi

push

push(...f: ((this: typeof globalThis) => void)[]): number
Esegue la sequenza di funzioni specificate negli argomenti in ordine.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.cmd.push(() => {
  googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
});
Parametri
Rest ...f: ((this: typeof globalThis) => void)[]Una funzione JavaScript da eseguire. La compilazione di runtime sarà sempre globalThis. Valuta la possibilità di passare una funzione freccia per mantenere il valore this del contesto lessicale che la racchiude.
Resi
numberIl numero di comandi elaborati finora. Questo è compatibile con il valore restituito di Array.push (la lunghezza corrente dell'array).

googletag.CompanionAdsService

Si estende Service
Servizio Annunci companion. Questo servizio viene utilizzato dagli annunci video per mostrare annunci companion.
Metodi
addEventListener
Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina.
getSlots
Visualizza l'elenco degli slot associati a questo servizio.
removeEventListener
Rimuove un ascoltatore registrato in precedenza.
setRefreshUnfilledSlots
Imposta se il backfill automatico verrà eseguito per gli slot companion che non sono stati compilati.
Vedi anche

Metodi

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void
Imposta se le aree companion che non sono state riempite verranno sottoposte a backfill automatico.

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

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (precedente)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);
Parametri
value: booleantrue per eseguire automaticamente il backfill degli slot non completati, false per lasciarli invariati.

googletag.PrivacySettingsConfig

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

Proprietà

Optional childDirectedTreatment

childDirectedTreatment?: null | boolean
Indica se la pagina deve essere trattata come destinata ai minori. Imposta su null per cancellare la configurazione.

Optional limitedAds

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

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

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Optional nonPersonalizedAds

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

Optional restrictDataProcessing

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

Optional trafficSource

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

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

Optional underAgeOfConsent

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

googletag.PubAdsService

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

Metodi

clear

clear(slots?: Slot[]): boolean
Rimuove gli annunci dagli slot specificati e li sostituisce con contenuti vuoti. Gli slot verranno contrassegnati come non recuperati.

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

JavaScript

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

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

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

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

JavaScript (precedente)

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

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

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

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

TypeScript

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

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

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

// This call to clear all slots.
googletag.pubads().clear();
Parametri
Optional slots: Slot[]L'array di slot da cancellare. L'array è facoltativo; se non è specificato, tutti gli slot verranno cancellati.
Resi
booleanRestituisce true se gli slot sono stati cancellati, false in caso contrario.

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService
Cancella tutte le etichette di esclusione delle categorie di annunci a livello di pagina. Questa opzione è utile se vuoi aggiornare l'area.
Esempio

JavaScript

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

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

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

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

JavaScript (precedente)

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

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

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

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

TypeScript

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

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

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

// Make ad requests. Any ad can be returned.
Vedi anche
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

clearTargeting

clearTargeting(key?: string): PubAdsService
Cancella i parametri di targeting personalizzato per una chiave specifica o per tutte le chiavi.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

googletag.pubads().clearTargeting();
// All targeting has been cleared.
Vedi anche
Parametri
Optional key: stringChiave del parametro di targeting. La chiave è facoltativa; se non è specificata, tutti i parametri di targeting verranno cancellati.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
Consente di comprimere i div delle aree in modo che non occupino spazio sulla pagina quando non sono presenti contenuti dell'annuncio da visualizzare. Questa modalità deve essere impostata prima dell'attivazione del servizio.
Vedi anche
Parametri
Optional collapseBeforeAdFetch: booleanIndica se comprimere gli slot anche prima del recupero degli annunci. Questo parametro è facoltativo. Se non viene fornito, verrà utilizzato false come valore predefinito.
Resi
booleanRestituisce true se la modalità di chiusura di div è stata attivata e false se non è possibile attivare la modalità di chiusura perché il metodo è stato chiamato dopo l'attivazione del servizio.

disableInitialLoad

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

display

display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
Crea e mostra un'area annuncio con il percorso e le dimensioni dell'unità pubblicitaria specificati. Questo metodo non funziona con la modalità di richiesta singola.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
Vedi anche
Parametri
adUnitPath: stringIl percorso dell'unità pubblicitaria della posizione da visualizzare.
size: GeneralSizeLarghezza e altezza della sezione.
Optional div: string | ElementL'ID del div contenente lo slot o l'elemento div stesso.
Optional clickUrl: stringL'URL di clic da utilizzare in questo slot.

enableLazyLoad

enableLazyLoad(config?: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}): void
Attiva il caricamento lento in GPT come definito dall'oggetto config. Per esempi più dettagliati, consulta l'esempio di caricamento lento.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().enableLazyLoad({
  // Fetch slots within 5 viewports.
  fetchMarginPercent: 500,
  // Render slots within 2 viewports.
  renderMarginPercent: 200,
  // Double the above values on mobile.
  mobileScaling: 2.0,
});
Vedi anche
Parametri
Optional config: {
  fetchMarginPercent?: number;
  mobileScaling?: number;
  renderMarginPercent?: number;
}		L'oggetto di configurazione consente di personalizzare il comportamento lazy. Per le configurazioni omesse verrà utilizzato un valore predefinito impostato da Google che verrà ottimizzato nel tempo. Per disattivare una determinata impostazione, ad esempio un margine di recupero, imposta il valore su -1.
  • fetchMarginPercent

    La distanza minima dall'area visibile corrente che deve avere uno slot prima del recupero dell'annuncio in percentuale delle dimensioni dell'area visibile. Un valore pari a 0 significa "quando l'area entra nell'area visibile", 100 significa "quando l'annuncio è a 1 area visibile di distanza" e così via.
  • renderMarginPercent

    La distanza minima dall'area visibile corrente che deve avere uno spazio prima di poter visualizzare un annuncio. In questo modo è possibile eseguire il pre-caricamento dell'annuncio, ma attendere il rendering e il download di altre risorse secondarie. Il valore funziona esattamente come fetchMarginPercent in percentuale del viewport.
  • mobileScaling

    Un moltiplicatore applicato ai margini sui dispositivi mobili. In questo modo, i margini possono variare da un dispositivo mobile a un computer. Ad esempio, un valore di 2,0 moltiplica per 2 tutti i margini sui dispositivi mobili, aumentando la distanza minima che può avere uno slot prima del recupero e del rendering.

enableSingleRequest

enableSingleRequest(): boolean
Attiva la modalità di richiesta singola per il recupero di più annunci contemporaneamente. Per poter attivare il servizio, è necessario definire e aggiungere tutti gli slot annunci del publisher a PubAdsService. La modalità di richiesta singola deve essere impostata prima dell'attivazione del servizio.
Vedi anche
Resi
booleanRestituisce true se è stata attivata la modalità di richiesta singola e false se non è possibile attivarla perché il metodo è stato chiamato dopo l'attivazione del servizio.

enableVideoAds

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

get

get(key: string): null | string
Restituisce il valore dell'attributo AdSense associato alla chiave specificata.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().get("adsense_background_color");
// Returns '#FFFFFF'.
Vedi anche
Parametri
key: stringNome dell'attributo da cercare.
Resi
null | stringValore corrente per la chiave dell'attributo o null se la chiave non è presente.

getAttributeKeys

getAttributeKeys(): string[]
Restituisce le chiavi degli attributi impostate su questo servizio.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
googletag.pubads().set("adsense_border_color", "#AABBCC");
googletag.pubads().getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].
Resi
string[]Array di chiavi degli attributi impostate su questo servizio. L'ordinamento non è definito.

getTargeting

getTargeting(key: string): string[]
Restituisce un parametro di targeting a livello di servizio personalizzato specifico che è stato impostato.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

googletag.pubads().getTargeting("age");
// Returns [] (empty array).
Parametri
key: stringLa chiave di targeting da cercare.
Resi
string[]I valori associati a questa chiave o un array vuoto se non esiste questa chiave.

getTargetingKeys

getTargetingKeys(): string[]
Restituisce l'elenco di tutte le chiavi di targeting a livello di servizio personalizzate che sono state impostate.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

googletag.pubads().getTargetingKeys();
// Returns ['interests', 'colors'].
Resi
string[]Array di chiavi di targeting. L'ordinamento non è definito.

isInitialLoadDisabled

isInitialLoadDisabled(): boolean
Restituisce se le richieste iniziali di annunci sono state disattivate correttamente da una chiamata PubAdsService.disableInitialLoad precedente.
Resi
booleanRestituisce true se una chiamata precedente a PubAdsService.disableInitialLoad è andata a buon fine, false in caso contrario.

aggiorna

refresh(slots?: null | Slot[], options?: {
  changeCorrelator: boolean;
}): void
Recupera e mostra nuovi annunci per aree specifiche o per tutte le aree della pagina. Funziona solo in modalità di rendering asincrono.

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

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

JavaScript

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

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

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

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

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

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

JavaScript (precedente)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

// This call to refresh fetches a new ad for each slot, without
// changing the correlator.
googletag.pubads().refresh(null, { changeCorrelator: false });
Vedi anche
Parametri
Optional slots: null | Slot[]Le caselle da aggiornare. L'array è facoltativo; se non è specificato, verranno aggiornati tutti gli slot.
Optional options: {
  changeCorrelator: boolean;
}		Opzioni di configurazione associate a questa chiamata di aggiornamento.
  • changeCorrelator

    Specifica se deve essere generato o meno un nuovo correlatore per il recupero degli annunci. I nostri ad server mantengono questo valore del correlatore per breve tempo (attualmente per 30 secondi, ma soggetto a modifiche), in modo che le richieste con lo stesso correlatore ricevute in momenti ravvicinati vengano considerate una singola visualizzazione di pagina. Per impostazione predefinita, viene generato un nuovo correlatore per ogni aggiornamento.

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

set

set(key: string, value: string): PubAdsService
Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio del servizio Annunci per i publisher.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().set("adsense_background_color", "#FFFFFF");
Vedi anche
Parametri
key: stringIl nome dell'attributo.
value: stringValore dell'attributo.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): PubAdsService
Imposta un'esclusione di categorie di annunci a livello di pagina per il nome dell'etichetta specificato.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

// Label = AirlineAd.
googletag.pubads().setCategoryExclusion("AirlineAd");
Vedi anche
Parametri
categoryExclusion: stringL'etichetta di esclusione della categoria di annunci da aggiungere.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setCentering

setCentering(centerAds: boolean): void
Attiva e disattiva il centratura orizzontale degli annunci. Il centratura è disattivata per impostazione predefinita. In gpt_mobile.js precedente, il centratura è attivata per impostazione predefinita.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

// Make ads centered.
googletag.pubads().setCentering(true);
Parametri
centerAds: booleantrue per allineare gli annunci al centro, false per allinearli a sinistra.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
Configura se è necessario forzare il rendering di tutti gli annunci nella 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 i rispettivi slot.
  • L'impostazione a livello di area, se specificata, sostituirà sempre l'impostazione a livello di pagina.
  • Se impostato su true (a livello di area annuncio o di pagina), l'annuncio verrà sempre visualizzato utilizzando un contenitore SafeFrame, indipendentemente dalla scelta effettuata nell'interfaccia utente di Google Ad Manager.
  • Tuttavia, se impostato su false o lasciato non specificato, l'annuncio verrà visualizzato utilizzando un contenitore SafeFrame a seconda del tipo di creatività e della selezione effettuata nell'interfaccia utente di Google Ad Manager.
  • Questa API deve essere utilizzata con cautela in quanto potrebbe influire sul comportamento delle creatività che tentano di uscire dai propri iframe o che si basano sul loro rendering direttamente nella pagina di un publisher.
Esempio

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (precedente)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

googletag.display("div-1");
googletag.display("div-2");
Vedi anche
Parametri
forceSafeFrame: booleantrue per forzare il rendering di tutti gli annunci nella pagina in SafeFrame e false per impostare su false l'impostazione precedente. Se non è stato specificato in precedenza, l'impostazione su false non cambia nulla.
Resi
PubAdsServiceL'oggetto servizio su cui è stata chiamata la funzione.

setLocation

setLocation(address: string): PubAdsService
Trasmette i dati sulla posizione dai siti web in modo da poter scegliere come target geografico degli elementi pubblicitari località specifiche.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

// Postal code:
googletag.pubads().setLocation("10001,US");
Parametri
address: stringIndirizzo in formato libero.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService
Consente la configurazione di tutte le impostazioni della privacy da un'unica API utilizzando un oggetto config.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

// Clear the configuration for childDirectedTreatment.
googletag.pubads().setPrivacySettings({
  childDirectedTreatment: null,
});
Vedi anche
Parametri
privacySettings: PrivacySettingsConfigOggetto contenente la configurazione delle impostazioni della privacy.
Resi
PubAdsServiceL'oggetto servizio su cui è stata chiamata la funzione.

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService
Imposta il valore per l'ID fornito dal publisher.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
Vedi anche
Parametri
ppid: stringUn ID alfanumerico fornito dal publisher. Deve avere una lunghezza compresa tra 32 e 150 caratteri.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setSafeFrameConfig

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

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

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

JavaScript (precedente)

googletag.pubads().setForceSafeFrame(true);

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

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

googletag.display("div-1");
googletag.display("div-2");
Vedi anche
Parametri
config: SafeFrameConfigL'oggetto di configurazione.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setTargeting

setTargeting(key: string, value: string | string[]): PubAdsService
Imposta i parametri di targeting personalizzato per una determinata chiave che si applicano a tutti gli spazi pubblicitari del servizio Publisher Ads. Se la chiami più volte per la stessa chiave, i vecchi valori verranno sovrascritti. Queste chiavi sono definite nel tuo account Google Ad Manager.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

// Example with multiple values for a key inside in an array.
googletag.pubads().setTargeting("interests", ["sports", "music"]);
Vedi anche
Parametri
key: stringChiave del parametro di targeting.
value: string | string[]Valore del parametro di targeting o array di valori.
Resi
PubAdsServiceL'oggetto servizio su cui è stato chiamato il metodo.

setVideoContent

setVideoContent(videoContentId: string, videoCmsId: string): void
Imposta le informazioni sui contenuti video da inviare insieme alle richieste di annunci a fini di targeting ed esclusione dei contenuti. Gli annunci video verranno attivati automaticamente quando viene chiamato questo metodo. Per videoContentId e videoCmsId, utilizza i valori forniti al servizio di importazione dei contenuti di Google Ad Manager.
Vedi anche
Parametri
videoContentId: stringL'ID dei contenuti video.
videoCmsId: stringL'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 è lo stesso per tutte le richieste di annunci provenienti da una visualizzazione di pagina ed è univoco in tutte le visualizzazioni di pagina. Si applica solo alla modalità asincrona.

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

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

// The correlator will now be a new randomly selected value, different
// from 12345. All subsequent ad requests made by this page will use
// the new value.
Resi
PubAdsServiceL'oggetto servizio su cui è stata chiamata la funzione.

googletag.ResponseInformation

Un oggetto che rappresenta una singola risposta all'annuncio.
Proprietà
advertiserId
L'ID dell'inserzionista.
campaignId
L'ID della campagna.
creativeId
L'ID della creatività.
creativeTemplateId
L'ID del modello dell'annuncio.
lineItemId
L'ID della voce.
Vedi anche

Proprietà

advertiserId

advertiserId: null | number
L'ID dell'inserzionista.

campaignId

campaignId: null | number
L'ID della campagna.

creativeId

creativeId: null | number
L'ID della creatività.

creativeTemplateId

creativeTemplateId: null | number
L'ID del modello dell'annuncio.

lineItemId

lineItemId: null | number
L'ID della voce.

googletag.RewardedPayload

Un oggetto che rappresenta il premio associato a un annuncio con premio
Proprietà
amount
Il numero di articoli inclusi nel premio.
type
Il tipo di elemento incluso nel premio (ad esempio, "coin").
Vedi anche

Proprietà

amount

amount: number
Il numero di articoli inclusi nel premio.

type

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

googletag.SafeFrameConfig

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

Proprietà

Optional allowOverlayExpansion

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

Optional allowPushExpansion

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

Optional sandbox

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

Optional useUniqueDomain

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

Nota: questa funzionalità è attiva per impostazione predefinita.
Vedi anche

googletag.Service

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

Metodi

addEventListener

addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((arg: EventTypeMap[K]) => void)): Service
Registra un ascoltatore che ti consente di configurare e chiamare una funzione JavaScript quando si verifica un evento GPT specifico nella pagina. Sono supportati i seguenti eventi: Quando viene chiamato, al listener viene passato un oggetto del tipo di evento appropriato.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

// 2. Adding an event listener with slot specific logic.
// Listeners operate at service level, which means that you cannot add
// a listener for an event for a specific slot only. You can, however,
// programmatically filter a listener to respond only to a certain ad
// slot, using this pattern:
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  if (event.slot === targetSlot) {
    // Slot specific logic.
  }
});
Vedi anche
Parametri
eventType: KUna stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
listener: ((arg: EventTypeMap[K]) => void)Funzione che accetta un singolo argomento oggetto evento.
Resi
ServiceL'oggetto servizio su cui è stato chiamato il metodo.

getSlots

getSlots(): Slot[]
Visualizza l'elenco degli slot associati a questo servizio.
Resi
Slot[]Slot nell'ordine in cui sono stati aggiunti al servizio.

removeEventListener

removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: ((event: EventTypeMap[K]) => void)): void
Rimuove un ascoltatore registrato in precedenza.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

  // Add onViewableListener as a listener for impressionViewable events.
  googletag.pubads().addEventListener("impressionViewable", onViewableListener);
  googletag.enableServices();
});
Parametri
eventType: KUna stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
listener: ((event: EventTypeMap[K]) => void)Funzione che accetta un singolo argomento oggetto evento.

googletag.SizeMappingBuilder

Generatore di oggetti delle specifiche di mappatura delle dimensioni. Questo generatore è fornito per aiutarti a creare facilmente le specifiche delle dimensioni.
Metodi
addSize
Aggiunge una mappatura da un array di dimensioni singole (che rappresenta la visualizzazione) a un array di dimensioni singole o multiple che rappresenta l'area.
build
Genera una specifica della mappa delle dimensioni dalle mappature aggiunte a questo generatore.
Vedi anche

Metodi

addSize

addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
Aggiunge una mappatura da un array di dimensioni singole (che rappresenta la visualizzazione) a un array di dimensioni singole o multiple che rappresenta lo slot.
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 &lt; 640x480
  .build();

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

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

JavaScript (precedente)

// Mapping 1
googletag
  .sizeMapping()
  .addSize([1024, 768], [970, 250])
  .addSize([980, 690], [728, 90])
  .addSize([640, 480], "fluid")
  .addSize([0, 0], [88, 31]) // All viewports &lt; 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 &lt; 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: SingleSizeArrayLe dimensioni dell'area visibile per questa voce di mappatura.
slotSize: GeneralSizeLe dimensioni dell'area per questa voce di mappatura.
Resi
SizeMappingBuilderUn riferimento a questo generatore.

build

build(): null | SizeMappingArray
Genera una specifica della mappa delle dimensioni dalle mappature aggiunte a questo generatore.

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

Nota: il comportamento del builder dopo l'chiamata di questo metodo non è definito.
Resi
null | SizeMappingArrayIl risultato creato da questo generatore. Può essere nullo se sono state fornite mappature delle dimensioni non valide.

googletag.Slot

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

Metodi

addService

addService(service: Service): Slot
Aggiunge un servizio a questo slot.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());
Vedi anche
Parametri
service: ServiceIl servizio da aggiungere.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

clearCategoryExclusions

clearCategoryExclusions(): Slot
Cancella tutte le etichette di esclusione delle categorie di annunci a livello di area annuncio per questa area.
Esempio

JavaScript

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

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

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

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

JavaScript (precedente)

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

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

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

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

TypeScript

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

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

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

// Make an ad request. Any ad can be returned for the slot.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

clearTargeting

clearTargeting(key?: string): Slot
Cancella uno o tutti i parametri di targeting personalizzato a livello di area per questa area.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

slot.clearTargeting();
// All targeting has been cleared.
Vedi anche
Parametri
Optional key: stringChiave del parametro di targeting. La chiave è facoltativa; se non è specificata, tutti i parametri di targeting verranno cancellati.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot
Imposta un array di mappature da una dimensione minima dell'area visibile alla dimensione dello slot per questo slot.
Esempio

JavaScript

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

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

slot.defineSizeMapping(mapping);

JavaScript (precedente)

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

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

slot.defineSizeMapping(mapping);

TypeScript

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

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

slot.defineSizeMapping(mapping!);
Vedi anche
Parametri
sizeMapping: SizeMappingArrayArray di mappature delle dimensioni. Puoi utilizzare SizeMappingBuilder per crearlo. Ogni mappatura delle taglie è un array di due elementi: SingleSizeArray e GeneralSize.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

get

get(key: string): null | string
Restituisce il valore dell'attributo AdSense associato alla chiave specificata per questo spazio. Per visualizzare gli attributi a livello di servizio ereditati da questo slot, utilizza PubAdsService.get.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.get("adsense_background_color");
// Returns '#FFFFFF'.
Vedi anche
Parametri
key: stringNome dell'attributo da cercare.
Resi
null | stringValore corrente per la chiave dell'attributo o null se la chiave non è presente.

getAdUnitPath

getAdUnitPath(): string
Restituisce il percorso completo dell'unità pubblicitaria, con il codice di rete e il percorso dell'unità pubblicitaria.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.getAdUnitPath();
// Returns '/1234567/sports'.
Resi
stringPercorso dell'unità pubblicitaria.

getAttributeKeys

getAttributeKeys(): string[]
Restituisce l'elenco delle chiavi degli attributi impostate in questo slot. Per visualizzare le chiavi degli attributi a livello di servizio ereditati da questo slot, utilizza PubAdsService.getAttributeKeys.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.getAttributeKeys();
// Returns ['adsense_background_color', 'adsense_border_color'].
Resi
string[]Array di chiavi degli attributi. L'ordinamento non è definito.

getCategoryExclusions

getCategoryExclusions(): string[]
Restituisce le etichette di esclusione delle categorie di annunci per questo spazio.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.getCategoryExclusions();
// Returns ['AirlineAd', 'TrainAd'].
Resi
string[]Le etichette di esclusione delle categorie di annunci per questo spazio o un array vuoto se non ne sono state impostate.

getResponseInformation

getResponseInformation(): null | ResponseInformation
Restituisce le informazioni sulla risposta all'annuncio. Questo valore si basa sull'ultima risposta all'annuncio per lo slot. Se viene chiamata quando lo slot non contiene annunci, viene restituito null.
Resi
null | ResponseInformationLe informazioni più recenti sulla risposta all'annuncio o null se lo spazio non contiene annunci.

getSlotElementId

getSlotElementId(): string
Restituisce l'ID dell'area div specificata al momento della definizione.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.getSlotElementId();
// Returns 'div'.
Resi
stringID area annuncio div.

getTargeting

getTargeting(key: string): string[]
Restituisce un parametro di targeting personalizzato specifico impostato su questo slot. I parametri di targeting a livello di servizio non sono inclusi.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

slot.getTargeting("age");
// Returns [] (empty array).
Parametri
key: stringLa chiave di targeting da cercare.
Resi
string[]I valori associati a questa chiave o un array vuoto se non esiste questa chiave.

getTargetingKeys

getTargetingKeys(): string[]
Restituisce l'elenco di tutte le chiavi di targeting personalizzate impostate in questo slot. Le chiavi di targeting a livello di servizio non sono incluse.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.getTargetingKeys();
// Returns ['interests', 'allow_expandable'].
Resi
string[]Array di chiavi di targeting. L'ordinamento non è definito.

set

set(key: string, value: string): Slot
Imposta un valore per un attributo AdSense in questa area annuncio. Verranno sostituiti tutti i valori impostati a livello di servizio per questa chiave.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .set("adsense_background_color", "#FFFFFF")
  .addService(googletag.pubads());
Vedi anche
Parametri
key: stringIl nome dell'attributo.
value: stringValore dell'attributo.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot
Imposta un'etichetta di esclusione di categorie di annunci a livello di area in questa area.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

// Label = AirlineAd
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setCategoryExclusion("AirlineAd")
  .addService(googletag.pubads());
Vedi anche
Parametri
categoryExclusion: stringL'etichetta di esclusione della categoria di annunci da aggiungere.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setClickUrl

setClickUrl(value: string): Slot
Imposta l'URL di clic a cui gli utenti verranno reindirizzati dopo aver fatto clic sull'annuncio.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setClickUrl("http://www.example.com?original_click_url=")
  .addService(googletag.pubads());
Parametri
value: stringL'URL di clic da impostare.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setCollapseEmptyDiv

setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
Imposta se l'area annuncio div deve essere nascosta quando non è presente alcun annuncio. Questo valore sostituisce le impostazioni a livello di servizio.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setCollapseEmptyDiv(true)
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// only after GPT detects that no ads are available for the slot.
Vedi anche
Parametri
collapse: booleanIndica se comprimere l'area se non viene restituito alcun annuncio.
Optional collapseBeforeAdFetch: booleanIndica se comprimere l'area anche prima del recupero di un annuncio. Ignorato se collapse non è true.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setConfig

setConfig(slotConfig: SlotSettingsConfig): void
Imposta le opzioni di configurazione generali per questo slot.
Parametri
slotConfig: SlotSettingsConfigL'oggetto di configurazione.

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot
Configura se gli annunci in questa area devono essere forzati a essere visualizzati utilizzando un contenitore SafeFrame.

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setForceSafeFrame(true)
  .addService(googletag.pubads());
Vedi anche
Parametri
forceSafeFrame: booleantrue per forzare il rendering di tutti gli annunci in questa area in SafeFrame e false per disattivare un'impostazione a livello di pagina (se presente). Se non specificato a livello di pagina, l'impostazione false non cambia nulla.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setSafeFrameConfig

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

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

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (precedente)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

googletag.display("div-1");
googletag.display("div-2");
Vedi anche
Parametri
config: null | SafeFrameConfigL'oggetto di configurazione.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

setTargeting

setTargeting(key: string, value: string | string[]): Slot
Imposta un parametro di targeting personalizzato per questo spazio. La chiamata di questo metodo più volte per la stessa chiave sovrascriverà i valori precedenti. I valori impostati qui sostituiranno i parametri di targeting impostati a livello di servizio. Queste chiavi sono definite nel tuo account Google Ad Manager.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

// Example with multiple values for a key inside in an array.
slot.setTargeting("interests", ["sports", "music"]);
Vedi anche
Parametri
key: stringChiave del parametro di targeting.
value: string | string[]Valore del parametro di targeting o array di valori.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

updateTargetingFromMap

updateTargetingFromMap(map: {
  [adUnitPath: string]: string | string[];
}): Slot
Imposta i parametri di targeting personalizzato per questo slot da una mappa chiave:valore in un oggetto JSON. È come chiamare Slot.setTargeting per tutti i valori chiave dell'oggetto. Queste chiavi sono definite nel tuo account Google Ad Manager.

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

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});
Parametri
map: {
  [adUnitPath: string]: string | string[];
}		Mappa chiave:valore del parametro di targeting.
Resi
SlotL'oggetto area su cui è stato chiamato il metodo.

googletag.config

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

Alias del tipo

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar"
Attivatori di annunci interstitial supportati.

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"
Trattamenti della privacy del publisher supportati.

Tassonomia

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"
Tassonomie supportate per gli indicatori forniti dal publisher (PPS).
Vedi anche

googletag.config.AdExpansionConfig

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

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Proprietà

Optional abilitato

enabled?: null | boolean
Indica se l'espansione dell'annuncio è attivata o disattivata.

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

googletag.config.ComponentAuctionConfig

Un oggetto che rappresenta un'asta di un singolo componente in un'asta di annunci on-device.
Proprietà
auctionConfig
Un oggetto di configurazione dell'asta per l'asta del componente.
configKey
La chiave di configurazione associata a questa asta di componenti.
Vedi anche

Proprietà

auctionConfig

auctionConfig: null | {
  auctionSignals?: unknown;
  decisionLogicURL: string;
  interestGroupBuyers?: string[];
  perBuyerExperimentGroupIds?: {
    [buyer: string]: number;
  };
  perBuyerGroupLimits?: {
    [buyer: string]: number;
  };
  perBuyerSignals?: {
    [buyer: string]: unknown;
  };
  perBuyerTimeouts?: {
    [buyer: string]: number;
  };
  seller: string;
  sellerExperimentGroupId?: number;
  sellerSignals?: unknown;
  sellerTimeout?: number;
  trustedScoringSignalsURL?: string;
}
Un oggetto di configurazione dell'asta per questa asta del componente.

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

JavaScript

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

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

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

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

JavaScript (precedente)

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

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

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

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

TypeScript

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

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

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

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

configKey

configKey: string
La chiave di configurazione associata all'asta di questo componente.

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

googletag.config.InterstitialConfig

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

Proprietà

Optional requireStorageAccess

requireStorageAccess?: null | boolean
Indica se è necessario il consenso per lo spazio di archiviazione locale per la visualizzazione di questo annuncio interstitial.

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

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

Optional trigger

triggers?: null | Partial<Record<InterstitialTrigger, boolean>>
La configurazione dell'attivatore interstitial per questo annuncio interstitial.

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

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

googletag.config.PageSettingsConfig

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

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

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

Esempi:
  • Vengono modificate solo le funzionalità specificate nella chiamata googletag.setConfig. 
      // Configure feature alpha.
  googletag.setConfig({
      alpha: {...}
  });

  // Configure feature bravo. Feature alpha is unchanged.
  googletag.setConfig({
     bravo: {...}
  });
  • Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a googletag.setConfig. 
      // Configure feature charlie to echo = 1, foxtrot = true.
  googletag.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  googletag.setConfig({
      charlie: {
          echo: 2
      }
  });
  • Tutte le impostazioni di una funzionalità possono essere cancellate passando null. 
      // Configure features delta, golf, and hotel.
  googletag.setConfig({
      delta: {...},
      golf: {...},
      hotel: {...},
  });

  // Feature delta and hotel are cleared, but feature golf remains set.
  googletag.setConfig({
      delta: null,
      hotel: null,
  });
Proprietà
adExpansion?
Impostazioni per controllare l'espansione dell'annuncio.
adYield?
Deprecato. 
pps?
Impostazioni per controllare gli indicatori forniti dal publisher (PPS).
privacyTreatments?
Impostazioni per controllare i trattamenti della privacy del publisher.
threadYield?
Impostazione per controllare se GPT deve restituire il thread JS durante il rendering delle creatività.

Proprietà

Optional adExpansion

adExpansion?: null | AdExpansionConfig
Impostazioni per controllare l'espansione dell'annuncio.

Optional adYield

adYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"

Optional pps

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

Optional privacyTreatments

privacyTreatments?: null | PrivacyTreatmentsConfig
Impostazioni per controllare i trattamenti della privacy del publisher.

Optional threadYield

threadYield?: null | "DISABLED" | "ENABLED_ALL_SLOTS"
Impostazione per controllare se GPT deve cedere il thread JS durante il rendering delle creatività.

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

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

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

googletag.config.PrivacyTreatmentsConfig

Impostazioni per controllare i trattamenti della privacy del publisher.
Proprietà
treatments
Una serie di trattamenti della privacy del publisher da attivare.

Proprietà

cure

treatments: null | "disablePersonalization"[]
Una serie di trattamenti per la privacy del publisher da attivare.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

googletag.config.PublisherProvidedSignalsConfig

Oggetto di configurazione degli indicatori forniti dal publisher (PPS).
Proprietà
taxonomies
Un oggetto contenente le mappature della tassonomia.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Proprietà

taxonomie

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>
Un oggetto contenente le mappature della tassonomia.

googletag.config.SlotSettingsConfig

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

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

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

Esempi:
  • Vengono modificate solo le funzionalità specificate nella chiamata Slot.setConfig. 
      const slot = googletag.defineSlot("/1234567/example", [160, 600]);

  // Configure feature alpha.
  slot.setConfig({
      alpha: {...}
  });

  // Configure feature bravo. Feature alpha is unchanged.
  slot.setConfig({
     bravo: {...}
  });
  • Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a Slot.setConfig. 
      // Configure feature charlie to echo = 1, foxtrot = true.
  slot.setConfig({
      charlie: {
          echo: 1,
          foxtrot: true,
      }
  });

  // Update feature charlie to echo = 2. Since foxtrot was not specified,
  // the value is cleared.
  slot.setConfig({
      charlie: {
          echo: 2
      }
  });
  • Tutte le impostazioni di una funzionalità possono essere cancellate passando null. 
      // Configure features delta, golf, and hotel.
  slot.setConfig({
      delta: {...},
      golf: {...},
      hotel: {...},
  });

  // Feature delta and hotel are cleared, but feature golf remains set.
  slot.setConfig({
      delta: null,
      hotel: null,
  });
Proprietà
adExpansion?
Impostazioni per controllare l'espansione dell'annuncio.
componentAuction?
Un array di aste di componenti da includere in un'asta di annunci on-device.
interstitial?
Impostazioni che controllano il comportamento delle aree annuncio interstitial.

Proprietà

Optional adExpansion

adExpansion?: null | AdExpansionConfig
Impostazioni per controllare l'espansione dell'annuncio.

Optional componentAuction

componentAuction?: null | ComponentAuctionConfig[]
Un array di aste di componenti da includere in un'asta di annunci on-device.

Optional interstitial

interstitial?: null | InterstitialConfig
Impostazioni che controllano il comportamento delle aree annuncio interstitial.

googletag.config.TaxonomyData

Un oggetto contenente i valori di una singola tassonomia.
Proprietà
values
Un elenco di valori Taxonomy.

Proprietà

values

values: string[]
Un elenco di valori Taxonomy.

googletag.enums

Questo è lo spazio dei nomi utilizzato da GPT per i tipi di enum.
Enumerazioni
OutOfPageFormat
Formati fuori pagina supportati da GPT.
TrafficSource
Sorgenti di traffico supportate da GPT.

Enumerazioni

OutOfPageFormat

OutOfPageFormat
Formati fuori pagina supportati da GPT.
Vedi anche
Membri dell'enumerazione
BOTTOM_ANCHOR
Formato di ancoraggio in cui l'area si attacca alla parte inferiore dell'area visibile.
GAME_MANUAL_INTERSTITIAL
Formato interstitial manuale di gioco.

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

TrafficSource

TrafficSource
Sorgenti di traffico supportate da GPT.
Vedi anche
Membri dell'enumerazione
ORGANIC
Inserimento di URL diretti, ricerca su sito o download di app.
PURCHASED
Traffico reindirizzato da proprietà diverse da quelle possedute (attività acquisite o altrimenti incentivate).

googletag.events

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

googletag.events.Event

Interfaccia di base per tutti gli eventi GPT. Tutti gli eventi GPT riportati di seguito avranno i seguenti campi.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Vedi anche

Proprietà

serviceName

serviceName: string
Nome del servizio che ha attivato l'evento.

slot

slot: Slot
Lo slot che ha attivato l'evento.

googletag.events.EventTypeMap

Si tratta di uno pseudo-tipo che mappa un nome di evento al relativo tipo di oggetto evento per Service.addEventListener e Service.removeEventListener. È documentato solo a scopo di riferimento e sicurezza del tipo.
Proprietà
gameManualInterstitialSlotClosed
gameManualInterstitialSlotReady
impressionViewable
rewardedSlotClosed
rewardedSlotGranted
rewardedSlotReady
slotOnload
slotRenderEnded
slotRequested
slotResponseReceived
slotVisibilityChanged

Proprietà

gameManualInterstitialSlotClosed

gameManualInterstitialSlotReady

impressionViewable

rewardedSlotClosed

rewardedSlotGranted

rewardedSlotReady

slotOnload

slotRenderEnded

slotRequested

slotResponseReceived

slotResponseReceived: SlotResponseReceived
Alias per events.SlotResponseReceived.

slotVisibilityChanged

googletag.events.GameManualInterstitialSlotClosedEvent

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

Nota: l'interstitial manuale di gioco è un formato ad accesso limitato.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
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.
    }
  });
}

JavaScript (precedente)

// This listener is called when a game manual interstitial slot is closed.
var 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", function (event) {
    var slot = event.slot;
    console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

// This listener is called when a game manual 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

googletag.events.GameManualInterstitialSlotReadyEvent

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

Nota: l'interstitial manuale di gioco è un formato ad accesso limitato.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Metodi
makeGameManualInterstitialVisible
Mostra all'utente l'annuncio interstitial manuale per i giochi.
Esempio

JavaScript

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

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

JavaScript (precedente)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// 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", function (event) {
    var slot = event.slot;
    console.log(
      "Game manual interstital slot",
      slot.getSlotElementId(),
      "is ready to be displayed.",
    );

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

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

TypeScript

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

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

Metodi

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): void
Mostra all'utente l'annuncio interstitial manuale per i giochi.

googletag.events.ImpressionViewableEvent

Si estende Event
Questo evento viene attivato quando un'impressione diventa visibile in base ai criteri di Visualizzazione attiva.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

googletag.events.RewardedSlotClosedEvent

Si estende Event
Questo evento viene attivato quando un utente chiude uno spazio annuncio con premio. Può essere attivato prima o dopo l'assegnazione di un premio. Per determinare se è stato concesso un premio, utilizza events.RewardedSlotGrantedEvent.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
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.
    }
  });
}

JavaScript (precedente)

var 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", function (event) {
    var 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

googletag.events.RewardedSlotGrantedEvent

Si estende Event
Questo evento viene attivato quando viene concesso un premio per la visualizzazione di un annuncio con premio. Se l'annuncio viene chiuso prima che vengano soddisfatti i criteri per l'assegnazione di un premio, questo evento non viene attivato.
Proprietà
payload
Un oggetto contenente informazioni sul premio concesso.
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
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.
    }
  });
}

JavaScript (precedente)

var 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", function (event) {
    var _a, _b;
    var slot = event.slot;
    console.group("Reward granted for slot", slot.getSlotElementId(), ".");

    // Log details of the reward.
    console.log("Reward type:", (_a = event.payload) === null || _a === void 0 ? void 0 : _a.type);
    console.log(
      "Reward amount:",
      (_b = event.payload) === null || _b === void 0 ? void 0 : _b.amount,
    );
    console.groupEnd();

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

TypeScript

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

Proprietà

payload

payload: null | RewardedPayload
Un oggetto contenente informazioni sul premio concesso.

googletag.events.RewardedSlotReadyEvent

Si estende Event
Questo evento viene attivato quando un annuncio con premio è pronto per essere visualizzato. Il publisher è responsabile di presentare all'utente un'opzione per visualizzare l'annuncio prima di mostrarlo.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
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.
    }
  });
}

JavaScript (precedente)

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
var 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", function (event) {
    var slot = event.slot;
    console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.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

Metodi

makeRewardedVisible

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

googletag.events.SlotOnloadEvent

Si estende Event
Questo evento viene attivato quando l'iframe della creatività attiva il relativo evento di caricamento. Quando viene eseguito il rendering degli annunci rich media in modalità di rendering sincronizzato, non viene utilizzato alcun iframe, pertanto non verrà attivato alcun SlotOnloadEvent.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

googletag.events.SlotRenderEndedEvent

Si estende Event
Questo evento viene attivato quando il codice della creatività viene inserito in uno slot. Questo evento si verifica prima del recupero delle risorse della creatività, pertanto la creatività potrebbe non essere ancora visibile. Se devi sapere quando è terminato il caricamento di tutte le risorse della creatività per uno slot, valuta la possibilità di utilizzare events.SlotOnloadEvent.
Proprietà
advertiserId
ID inserzionista dell'annuncio visualizzato.
campaignId
L'ID della campagna dell'annuncio visualizzato.
companyIds
ID delle aziende che hanno fatto offerte per l'annuncio di backfill visualizzato.
creativeId
ID creatività dell'annuncio di prenotazione visualizzato.
creativeTemplateId
L'ID del modello di creatività dell'annuncio di prenotazione visualizzato.
isBackfill
Indica se un annuncio era di backfill.
isEmpty
Indica se è stato restituito un annuncio per l'area.
labelIds
Deprecato. 
lineItemId
ID elemento pubblicitario dell'annuncio di prenotazione visualizzato.
serviceName
Nome del servizio che ha attivato l'evento.
size
Indica le dimensioni in pixel della creatività visualizzata.
slot
Lo slot che ha attivato l'evento.
slotContentChanged
Indica se i contenuti dell'area sono stati modificati con l'annuncio visualizzato.
sourceAgnosticCreativeId
ID creatività dell'annuncio di backfill o della prenotazione visualizzato.
sourceAgnosticLineItemId
ID elemento pubblicitario dell'annuncio di prenotazione o di backfill visualizzato.
yieldGroupIds
ID dei gruppi di rendimento per l'annuncio di backfill visualizzato.
Esempio

JavaScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

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

JavaScript (precedente)

// This listener is called when a slot has finished rendering.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", function (event) {
  var slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

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

TypeScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

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

Proprietà

advertiserId

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

campaignId

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

companyIds

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

creativeId

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

creativeTemplateId

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

isBackfill

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

isEmpty

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

labelIds

labelIds: null | number[]

lineItemId

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

size

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

slotContentChanged

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

sourceAgnosticCreativeId

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

sourceAgnosticLineItemId

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

yieldGroupIds

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

googletag.events.SlotRequestedEvent

Si estende Event
Questo evento viene attivato quando viene richiesto un annuncio per una determinata area.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

googletag.events.SlotResponseReceived

Si estende Event
Questo evento viene attivato quando viene ricevuta una risposta all'annuncio per un determinato slot.
Proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

googletag.events.SlotVisibilityChangedEvent

Si estende Event
Questo evento viene attivato ogni volta che cambia la percentuale sullo schermo dell'area di uno spazio pubblicitario. L'evento viene limitato e non verrà attivato più di una volta ogni 200 ms.
Proprietà
inViewPercentage
La percentuale dell'area dell'annuncio visibile.
serviceName
Nome del servizio che ha attivato l'evento.
slot
Lo slot che ha attivato l'evento.
Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

Proprietà

inViewPercentage

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

googletag.secureSignals

Questo è lo spazio dei nomi utilizzato da GPT per gestire gli indicatori sicuri.
Interfacce
BidderSignalProvider
Restituisce un indicatore sicuro per un offerente specifico.
PublisherSignalProvider
Restituisce un indicatore sicuro per un publisher specifico.
SecureSignalProvidersArray
Un'interfaccia per la gestione degli indicatori sicuri.
Alias del tipo
SecureSignalProvider
Interfaccia per restituire un indicatore sicuro per un offerente o un fornitore specifico.

Alias del tipo

SecureSignalProvider

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

googletag.secureSignals.BidderSignalProvider

Restituisce un indicatore sicuro per un offerente specifico.

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

  1. Una funzione di raccolta che restituisce un Promise che si risolve in un indicatore sicuro.
  2. Un id che identifica l'offerente associato all'indicatore.
Per restituire un indicatore sicuro per un publisher, utilizza secureSignals.PublisherSignalProvider.
Proprietà
collectorFunction
Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.
id
Un identificatore univoco per il collettore associato a questo indicatore sicuro, come registrato in Google Ad Manager.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

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 collettore associato a questo indicatore sicuro, come registrato in Google Ad Manager.

googletag.secureSignals.PublisherSignalProvider

Restituisce un indicatore sicuro per un publisher specifico.

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

  1. Una funzione di raccolta che restituisce un Promise che si risolve in un indicatore sicuro.
  2. Un networkCode che identifica il publisher associato all'indicatore.
Per restituire un indicatore sicuro per un offerente, utilizza secureSignals.BidderSignalProvider.
Proprietà
collectorFunction
Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.
networkCode
Il codice di rete (come visualizzato nel percorso dell'unità pubblicitaria) del publisher associato a questo indicatore sicuro.
Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Proprietà

collectorFunction

collectorFunction: (() => Promise<string>)
Una funzione che restituisce un Promise che si risolve in un indicatore sicuro.

networkCode

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

googletag.secureSignals.SecureSignalProvidersArray

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

Metodi

clearAllCache

clearAllCache(): void
Cancella tutti i segnali per tutti i collezionisti dalla cache.

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

push

push(provider: SecureSignalProvider): void
Aggiunge un nuovo secureSignals.SecureSignalProvider all'array di fornitori di indicatori e avvia il processo di generazione degli indicatori.
Parametri
provider: SecureSignalProviderL'oggetto secureSignals.SecureSignalProvider da aggiungere all'array.