Riferimento GPT

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

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

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

Annotazioni del tipo

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

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


Definizioni dei tipi

Tipi
SingleSize | MultiSize

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

SingleSize[]

Un elenco di singole dimensioni valide.

"fluid" | ["fluid"]

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

  • fluid: il contenitore di annunci occupa una larghezza del 100% dell'elemento div principale e poi ne ridimensiona l'altezza in base ai contenuti della creatività. Simile al comportamento degli elementi di blocco regolari su una pagina. Utilizzato per gli annunci nativi (consulta l'articolo correlato). Tieni presente che sia fluid sia ['fluid'] sono moduli accettabili per dichiarare le dimensioni di un'area flessibili.

SingleSizeArray | NamedSize

Una singola dimensione valida per uno spazio.

[number, number]

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

[SingleSizeArray, GeneralSize]

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

SizeMapping[]

Un elenco di mappature delle dimensioni.

"unhideWindow" | "navBar"

Attivatori di annunci interstitial supportati.

"disablePersonalization"

Trattamenti della privacy dei publisher supportati.

"IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

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

BidderSignalProvider | PublisherSignalProvider

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

Tipi di enum

Enum
googletag.enums.OutOfPageFormat
Formati fuori pagina supportati da GPT.
googletag.enums.TrafficSource
Sorgenti di traffico supportate da GPT.


googletag.enums.OutOfPageFormat

  • Formati fuori pagina supportati da GPT.

  • Vedi anche
  • Valori
    BOTTOM_ANCHOR
    Formato di ancoraggio in cui l'area si trova nella parte inferiore dell'area visibile.
    GAME_MANUAL_INTERSTITIAL
    Formato interstitial manuale dei giochi.

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


googletag.enums.TrafficSource

  • Sorgenti di traffico supportate da GPT.

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


googletag

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

Riepilogo variabili
apiReady
Flag che indica che l'API GPT è stata caricata e pronta per essere chiamata.
cmd
Riferimento alla coda globale dei comandi per l'esecuzione asincrona delle chiamate correlate a GPT.
pubadsReady
Flag che indica che PubAdsService è abilitato, caricato e pienamente operativo.
secureSignalProviders
Riferimento all'array dei fornitori di indicatori sicuri.
Riepilogo della funzione
companionAds
Restituisce un riferimento a CompanionAdsService.
defineOutOfPageSlot
Crea un'area annuncio fuori pagina con il percorso dell'unità pubblicitaria specificato.
defineSlot
Consente di creare un'area annuncio con un determinato percorso e dimensione dell'unità pubblicitaria e associarla all'ID di un elemento div nella pagina che conterrà l'annuncio.
destroySlots
Elimina le aree specificate, rimuovendo tutti gli oggetti correlati e i riferimenti a queste aree da GPT.
disablePublisherConsole
Disattiva la Google Publisher Console.
display
Indica ai servizi 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
Apre la Google Publisher Console.
pubads
Restituisce un riferimento a PubAdsService.
setAdIframeTitle
Imposta il titolo per tutti gli iframe del contenitore di annunci creati da PubAdsService da questo momento in poi.
setConfig
Imposta le opzioni di configurazione generali per la pagina.
sizeMapping
Crea una nuova SizeMappingBuilder.


googletag.apiReady

  • apiReady: boolean | undefined
  • Flag che indica che l'API GPT è stata 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 la modalità asincrona è utilizzare googletag.cmd per inserire in coda i callback per quando GPT è pronto. Questi callback non devono controllare googletag.apiReady poiché è garantito che vengano eseguiti una volta configurata l'API.

  • Esempio

    JavaScript

    if (window.googletag && googletag.apiReady) {
      // GPT API can be called safely.
    }
    

    JavaScript (legacy)

    if (window.googletag && googletag.apiReady) {
      // GPT API can be called safely.
    }
    

    TypeScript

    if (window.googletag && googletag.apiReady) {
      // GPT API can be called safely.
    }
    


googletag.cmd

  • cmd: Array<(this: typeof globalThis) => void> | CommandArray
  • Riferimento alla coda globale dei comandi per l'esecuzione asincrona delle chiamate correlate a GPT.

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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


googletag.pubadsReady

  • pubadsReady: boolean | undefined
  • Flag che indica che PubAdsService è abilitato, caricato e pienamente operativo. Questa proprietà sarà semplicemente undefined fino a quando non verrà chiamato enableServices e la PubAdsService non verrà caricata e inizializzata.


googletag.secureSignalProviders

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

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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


googletag.companionAds


googletag.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 da GPT, div è un OutOfPageFormat supportato.

  • Esempio

    JavaScript

    // Define a custom out-of-page ad slot.
    googletag.defineOutOfPageSlot("/1234567/sports", "div-1");
    
    // Define a GPT managed web interstitial ad slot.
    googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
    

    JavaScript (legacy)

    // 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: string
    Percorso unità pubblicitaria completo con il codice di rete e il codice dell'unità pubblicitaria.
    div?: string | OutOfPageFormat
    L'ID del div che conterrà questa unità pubblicitaria, oppure OutOfPageFormat.
  • Resi
    Slot | null
    L'area appena creata o null se non è possibile creare uno spazio.


googletag.defineSlot

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
    
    Vedi anche
  • Parametri
    adUnitPath: string
    Percorso unità pubblicitaria completo con il codice di rete e il codice unità.
    size: GeneralSize
    Larghezza e altezza dell'area aggiunta. Questa è la dimensione che viene utilizzata nella richiesta di annuncio se non viene fornita una mappatura delle dimensioni adattabile o se la dimensione dell'area visibile è inferiore a quella più piccola fornita nella mappatura.
    div?: string
    ID del div che conterrà l'unità pubblicitaria.
  • Resi
    Slot | null
    L'area appena creata o null se non è possibile creare uno spazio.


googletag.destroySlots

  • destroySlots(slots?: Slot[]): boolean
  • Elimina le aree specificate, rimuovendo tutti gli oggetti correlati e i riferimenti a queste aree da GPT. Questa API non supporta le aree di pass-back e le aree companion.

    Se si richiama questa API su un'area, l'annuncio viene cancellato e l'oggetto slot viene rimosso dallo stato interno gestito da GPT. La chiamata di altre funzioni nell'oggetto slot comporterà un comportamento indefinito. Tieni presente che il browser potrebbe comunque non liberare la memoria associata a quello spazio se alla pagina del publisher viene gestito un riferimento. La chiamata a questa API rende disponibile per il riutilizzo l'elemento div associato a quell'area.

    In particolare, l'eliminazione di un'area comporta la rimozione dell'annuncio dalla visualizzazione di pagina di lunga durata di GPT; di conseguenza, le richieste future non saranno influenzate da segnaposto o esclusioni competitive che coinvolgono questo annuncio. La mancata chiamata a questa funzione prima di rimuovere il div di un'area dalla pagina comporterà un comportamento indefinito.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    // 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
    slots?: Slot[]
    L'array di slot da eliminare. L'array è facoltativo; se non è specificato, verranno eliminati tutti gli slot.
  • Resi
    boolean
    true se gli slot sono stati eliminati, false altrimenti.


googletag.disablePublisherConsole


googletag.display

  • display(divOrSlot: string | Element | Slot): void
  • Indica ai servizi slot di eseguire il rendering dello slot. Ciascuna area annuncio deve essere visualizzata una sola volta per pagina. Tutte le aree devono essere definite e associate a un servizio prima di essere visualizzate. La chiamata alla funzione display non deve avvenire finché l'elemento non è presente nel DOM. In genere, questo metodo è possibile posizionarlo all'interno di un blocco di script all'interno dell'elemento div denominato nella chiamata al metodo.

    Se si utilizza un'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 un'area annuncio, è necessario rimuovere l'intero div.

  • Esempio

    JavaScript

    googletag.cmd.push(() => {
      googletag.display("div-1");
    });
    

    JavaScript (legacy)

    googletag.cmd.push(function () {
      googletag.display("div-1");
    });
    

    TypeScript

    googletag.cmd.push(() => {
      googletag.display("div-1");
    });
    
    Vedi anche
  • Parametri
    divOrSlot: string | Element | Slot
    L'ID dell'elemento div contenente l'area annuncio o l'elemento div oppure l'oggetto slot. Se viene fornito un elemento div, deve avere un "id". corrispondente all'ID trasmesso in defineSlot.


googletag.enableServices

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


googletag.getVersion

  • getVersion(): string
  • Restituisce la versione corrente di GPT.

  • Vedi anche
  • Resi
    string
    La stringa della versione GPT attualmente in esecuzione.


googletag.openConsole

  • openConsole(div?: string): void
  • Apre la Google Publisher Console.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    // 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
    div?: string
    Un ID div dell'area annuncio. Questo valore è facoltativo. Se fornita, Publisher Console tenterà di aprirsi con i dettagli dell'area annuncio specificata visualizzati.


googletag.pubads


googletag.setAdIframeTitle

  • setAdIframeTitle(title: string): void
  • Imposta il titolo per tutti gli iframe del contenitore di annunci creati da PubAdsService da questo momento in poi.

  • Esempio

    JavaScript

    googletag.setAdIframeTitle("title");
    

    JavaScript (legacy)

    googletag.setAdIframeTitle("title");
    

    TypeScript

    googletag.setAdIframeTitle("title");
    
  • Parametri
    title: string
    Il nuovo titolo per tutti gli iframe del contenitore di annunci.


googletag.setConfig


googletag.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 accodare le funzioni da richiamare dopo il caricamento di GPT.

Riepilogo del metodo
push
Esegue la sequenza di funzioni specificate negli argomenti in ordine.


push

  • push(...f: Array<(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 (legacy)

    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
    ...f: Array<(this: typeof globalThis) => void>
    Una funzione JavaScript da eseguire. L'associazione del runtime sarà sempre globalThis. Potresti passare una funzione freccia per mantenere il valore this del contesto normativo che lo include.
  • Resi
    number
    Il numero di comandi elaborati finora. È compatibile con il valore restituito di Array.push (la lunghezza attuale dell'array).


googletag.CompanionAdsService

Si estende Service

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

Riepilogo del metodo
addEventListener
Registra un listener che consente di impostare e chiamare una funzione JavaScript quando si verifica un determinato evento GPT nella pagina.
getSlots
Recupera l'elenco degli slot associati a questo servizio.
removeEventListener
Rimuove un listener registrato in precedenza.
setRefreshUnfilledSlots
Consente di impostare se le aree companion non riempite verranno sottoposte automaticamente a backfill.
Vedi anche


setRefreshUnfilledSlots

  • setRefreshUnfilledSlots(value: boolean): void
  • Consente di impostare se le aree companion che non sono state riempite verranno sottoposte automaticamente a backfill.

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

  • Esempio

    JavaScript

    googletag.companionAds().setRefreshUnfilledSlots(true);
    

    JavaScript (legacy)

    googletag.companionAds().setRefreshUnfilledSlots(true);
    

    TypeScript

    googletag.companionAds().setRefreshUnfilledSlots(true);
    
  • Parametri
    value: boolean
    true per eseguire automaticamente il backfill delle aree vuote, false per lasciarle invariate.


googletag.PrivacySettingsConfig

Oggetto di configurazione per le impostazioni della privacy.

Riepilogo proprietà
childDirectedTreatment
Indica se la pagina deve essere trattata come destinata ai minori.
limitedAds
Attiva la pubblicazione in modalità Annunci con limitazioni per soddisfare le esigenze di conformità alle normative dei publisher.
nonPersonalizedAds
Consente la pubblicazione in modalità di annunci non personalizzati per aiutare i publisher a rispettare le esigenze di conformità alle normative.
restrictDataProcessing
Attiva la pubblicazione in modalità di elaborazione limitata per soddisfare le esigenze di conformità alle normative 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


childDirectedTreatment


limitedAds

  • limitedAds: boolean
  • Consente la pubblicazione in modalità Annunci con limitazioni per facilitare la conformità alle normative 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 della versione 2.0 del TCF di IAB.
    • Manualmente, impostando il valore di questo campo su true.
    È possibile configurare manualmente gli annunci con limitazioni solo quando GPT viene caricato dall'URL degli annunci con limitazioni. Se provi a modificare questa impostazione quando il tag GPT è stato caricato dall'URL standard, verrà generato un avviso di 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 (legacy)

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


nonPersonalizedAds

  • nonPersonalizedAds: boolean
  • Consente la pubblicazione in modalità di annunci non personalizzati per aiutare i publisher a rispettare le esigenze di conformità alle normative.


restrictDataProcessing


trafficSource

  • trafficSource: TrafficSource
  • Indica se le richieste rappresentano traffico organico o acquistato. Questo valore compila la dimensione Sorgente di traffico nei report di Ad Manager. Se non viene configurato, la sorgente di traffico è impostata in modo predefinito su 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 (legacy)

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


underAgeOfConsent


googletag.PubAdsService

Si estende Service

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

Riepilogo del metodo
addEventListener
Registra un listener che consente di impostare e chiamare una funzione JavaScript quando si verifica un determinato evento GPT nella pagina.
clear
Rimuove gli annunci dalle aree specificate e li sostituisce con contenuti vuoti.
clearCategoryExclusions
Cancella tutte le etichette di esclusione della categoria di annunci a livello di pagina.
clearTargeting
Cancella i parametri di targeting personalizzato per una chiave specifica o per tutte le chiavi.
collapseEmptyDivs
Consente la compressione dei div delle aree annuncio in modo che non occupino spazio sulla pagina quando non ci sono contenuti dell'annuncio da visualizzare.
disableInitialLoad
Disattiva le richieste di annunci al caricamento pagina, ma consente la richiesta di annunci con una chiamata PubAdsService.refresh.
display
Crea e visualizza 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
Consente di attivare la modalità di richiesta singola per recuperare più annunci contemporaneamente.
enableVideoAds
Segnala al tag GPT che nella pagina saranno presenti annunci video.
get
Restituisce il valore per l'attributo AdSense associato alla chiave specificata.
getAttributeKeys
Restituisce le chiavi degli attributi che sono state impostate su questo servizio.
getSlots
Recupera l'elenco degli slot associati a questo servizio.
getTargeting
Restituisce uno specifico parametro di targeting per livello di servizio personalizzato che è stato impostato.
getTargetingKeys
Restituisce l'elenco di tutte le chiavi di targeting del livello di servizio personalizzate che sono state impostate.
isInitialLoadDisabled
Indica se le richieste iniziali di annunci sono state disattivate o meno da una precedente chiamata a PubAdsService.disableInitialLoad.
refresh
Recupera e visualizza nuovi annunci per aree specifiche o per tutte le aree della pagina.
removeEventListener
Rimuove un listener registrato in precedenza.
set
Imposta i valori per gli attributi AdSense che si applicano a tutte le aree annuncio nel servizio Annunci del publisher.
setCategoryExclusion
Imposta un'esclusione di categoria di annunci a livello di pagina per il nome dell'etichetta specificato.
setCentering
Attiva e disattiva il centraggio orizzontale degli annunci.
setForceSafeFrame
Consente di configurare se tutti gli annunci sulla pagina devono essere forzati per il rendering utilizzando un contenitore SafeFrame.
setLocation
Trasmette i dati sulla posizione dai siti web per consentirti di scegliere località specifiche come target geografico degli elementi pubblicitari.
setPrivacySettings
Consente di configurare 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
Consente di impostare i parametri di targeting personalizzato per una determinata chiave e applicati a tutte le aree annuncio del servizio Annunci del publisher.
setVideoContent
Consente di impostare le informazioni sui contenuti video da inviare insieme alle richieste di annunci ai fini del targeting e dell'esclusione di contenuti.
updateCorrelator
Modifica il correlatore inviato con le richieste di annunci, avviando effettivamente una nuova visualizzazione di pagina.


clear

  • clear(slots?: Slot[]): boolean
  • Rimuove gli annunci dalle aree specificate e li sostituisce con contenuti vuoti. Le aree saranno contrassegnate come non recuperate.

    In particolare, la cancellazione di un'area comporta la rimozione dell'annuncio dalla visualizzazione di pagina di lunga durata di GPT; in questo modo, le richieste future non saranno influenzate da GPT o esclusioni competitive 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 (legacy)

    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
    slots?: Slot[]
    La gamma di slot da cancellare. L'array è facoltativo; verranno cancellate tutte le aree annuncio se non specificato.
  • Resi
    boolean
    Restituisce true se le aree sono state cancellate, false in caso contrario.


clearCategoryExclusions

  • clearCategoryExclusions(): PubAdsService
  • Cancella tutte le etichette di esclusione della categoria di annunci a livello di pagina. È utile se vuoi aggiornare l'area annuncio.

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

    // 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
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


clearTargeting

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

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

    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
    key?: string
    Chiave del parametro di targeting. La chiave è facoltativa; tutti i parametri di targeting verranno cancellati se non sono specificati.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


collapseEmptyDivs

  • collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
  • Consente la compressione dei div delle aree annuncio in modo che non occupino spazio sulla pagina quando non ci sono contenuti dell'annuncio da visualizzare. Questa modalità deve essere impostata prima dell'attivazione del servizio.

  • Vedi anche
  • Parametri
    collapseBeforeAdFetch?: boolean
    Indica se comprimere le aree anche prima del recupero degli annunci. Questo parametro è facoltativo; Se non viene specificato, verrà utilizzato false come valore predefinito.
  • Resi
    boolean
    Restituisce true se la modalità di compressione div è stata attivata e false se non è possibile abilitarla, poiché il metodo è stato chiamato dopo l'attivazione del servizio.


disableInitialLoad


display

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

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
    
    Vedi anche
  • Parametri
    adUnitPath: string
    Il percorso dell'unità pubblicitaria dell'area da visualizzare.
    size: GeneralSize
    Larghezza e altezza dell'area.
    div?: string | Element
    L'ID del div contenente l'area oppure l'elemento div stesso.
    clickUrl?: string
    L'URL di clic da utilizzare per questa area.


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, vedi l'esempio relativo al caricamento lento.

    Nota: il recupero lento in SRA funziona solo se tutti gli slot non rientrano nel 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 (legacy)

    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
    config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }
    L'oggetto di configurazione consente la personalizzazione del comportamento lento. Per le configurazioni omesse verrà utilizzato un set predefinito da Google che verrà ottimizzato nel tempo. Per disattivare una determinata impostazione, ad esempio un margine di recupero, imposta il valore su -1.
    • fetchMarginPercent

      La distanza minima dall'area visibile corrente che deve essere occupata da un'area prima di recuperare l'annuncio come percentuale delle dimensioni dell'area visibile. Un valore 0 significa "quando l'area entra nell'area visibile", 100 significa "quando l'annuncio è a 1 area visibile" e così via.
    • renderMarginPercent

      La distanza minima dall'area visibile corrente che deve essere occupata da un'area prima che venga eseguito il rendering di un annuncio. In questo modo è possibile precaricare l'annuncio, ma attendere il rendering e il download di altre risorse secondarie. Il valore funziona esattamente come fetchMarginPercent come percentuale dell'area visibile.
    • mobileScaling

      Un moltiplicatore applicato ai margini sui dispositivi mobili. Ciò consente margini diversi sui dispositivi mobili e sui computer. Ad esempio, un valore pari a 2,0 moltiplicherà tutti i margini per 2 sui dispositivi mobili, aumentando la distanza minima che può avere un'area prima del recupero e del rendering.


enableSingleRequest

  • enableSingleRequest(): boolean
  • Consente di attivare la modalità di richiesta singola per recuperare più annunci contemporaneamente. Ciò richiede che tutte le aree di annunci del publisher siano definite e aggiunte a PubAdsService prima di abilitare il servizio. È necessario impostare la modalità di richiesta singola prima dell'attivazione del servizio.

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


enableVideoAds

  • enableVideoAds(): void
  • Segnala a GPT che nella pagina saranno presenti annunci video. Ciò consente vincoli di esclusione competitiva per gli annunci display e video. Se i contenuti del video sono noti, chiama PubAdsService.setVideoContent per poter utilizzare l'esclusione di contenuti per gli annunci display.


get

  • get(key: string): null | string
  • Restituisce il valore per l'attributo AdSense associato alla chiave specificata.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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: string
    Nome dell'attributo da cercare.
  • Resi
    null | string
    Valore attuale della chiave dell'attributo o null se la chiave non è presente.


getAttributeKeys

  • getAttributeKeys(): string[]
  • Restituisce le chiavi degli attributi che sono state 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 (legacy)

    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 impostata su questo servizio. L'ordine non è definito.


getTargeting

  • getTargeting(key: string): string[]
  • Restituisce uno specifico parametro di targeting per livello di servizio personalizzato che è stato impostato.

  • Esempio

    JavaScript

    googletag.pubads().setTargeting("interests", "sports");
    
    googletag.pubads().getTargeting("interests");
    // Returns ['sports'].
    
    googletag.pubads().getTargeting("age");
    // Returns [] (empty array).
    

    JavaScript (legacy)

    googletag.pubads().setTargeting("interests", "sports");
    
    googletag.pubads().getTargeting("interests");
    // Returns ['sports'].
    
    googletag.pubads().getTargeting("age");
    // Returns [] (empty array).
    

    TypeScript

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


getTargetingKeys

  • getTargetingKeys(): string[]
  • Restituisce l'elenco di tutte le chiavi di targeting del 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 (legacy)

    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'ordine non è definito.


isInitialLoadDisabled


refresh

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

    Per un comportamento corretto in tutti i browser, la chiamata a refresh deve essere preceduta da una chiamata display all'area annuncio. Se la chiamata a display viene omessa, l'aggiornamento potrebbe avere un comportamento imprevisto. Se lo desideri, puoi utilizzare il metodo PubAdsService.disableInitialLoad per interrompere il recupero di un annuncio da parte di display.

    L'aggiornamento di un'area rimuove il vecchio annuncio dalla visualizzazione di pagina di lunga durata di GPT, quindi le richieste future non saranno influenzate da GPT o esclusioni competitive che riguardano quell'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 (legacy)

    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
    slots?: null | Slot[]
    Gli slot da aggiornare. L'array è facoltativo; verranno aggiornate tutte le aree annuncio se non specificato.
    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 per breve tempo questo valore correlatore (attualmente per 30 secondi, ma soggetto a modifiche), in modo che le richieste con lo stesso correlatore ricevute a ridosso dell'una siano 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 di lunga durata di GPT, che riflette automaticamente gli annunci attualmente presenti sulla pagina e non ha 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 nel servizio Annunci per i publisher.

    Se questi dati vengono richiamati più di una volta per la stessa chiave, verranno sostituiti i valori impostati in precedenza per quella chiave. Tutti i valori devono essere impostati prima di chiamare display o refresh.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    googletag.pubads().set("adsense_background_color", "#FFFFFF");
    
    Vedi anche
  • Parametri
    key: string
    Il nome dell'attributo.
    value: string
    Valore dell'attributo.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


setCategoryExclusion

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

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


setCentering

  • setCentering(centerAds: boolean): void
  • Attiva e disattiva il centraggio orizzontale degli annunci. La centratura è disattivata per impostazione predefinita. Nella versione precedente di gpt_mobile.js, la centratura è attivata per impostazione predefinita.

    Questo metodo deve essere richiamato 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 (legacy)

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

    TypeScript

    // Make ads centered.
    googletag.pubads().setCentering(true);
    
  • Parametri
    centerAds: boolean
    true per centrare gli annunci, false per allinearli a sinistra.


setForceSafeFrame

  • setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
  • Consente di configurare se forzare il rendering di tutti gli annunci sulla pagina utilizzando un contenitore SafeFrame.

    Tieni presente quanto segue quando utilizzi questa API:

    • Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per le rispettive aree.
    • 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 viene sempre visualizzato utilizzando un contenitore SafeFrame indipendentemente dalla scelta effettuata nell'interfaccia utente di Google Ad Manager.
    • Tuttavia, se il criterio viene impostato su false o se non viene specificato, l'annuncio verrà visualizzato utilizzando un contenitore SafeFrame in base al tipo di creatività e alla 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 dagli iframe o che fanno affidamento sul rendering diretto 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 (legacy)

    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: boolean
    true per forzare la visualizzazione di tutti gli annunci sulla pagina in SafeFrame e false per modificare l'impostazione precedente in false. Se il criterio viene impostato su false se non specificato in precedenza, non ci sono modifiche.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stata chiamata la funzione.


setLocation

  • setLocation(address: string): PubAdsService
  • Trasmette i dati sulla posizione dai siti web per consentirti di scegliere località specifiche come target geografico degli elementi pubblicitari.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    // Postal code:
    googletag.pubads().setLocation("10001,US");
    
  • Parametri
    address: string
    Indirizzo in formato libero.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


setPrivacySettings

  • setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService
  • Consente di configurare tutte le impostazioni della privacy da una singola API utilizzando un oggetto di configurazione.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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: PrivacySettingsConfig
    Oggetto contenente la configurazione delle impostazioni della privacy.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stata chiamata la funzione.


setPublisherProvidedId

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

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


setSafeFrameConfig

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

    Se specificate, queste preferenze a livello di pagina verranno sostituite da quelle a livello di area annuncio.

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

    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: SafeFrameConfig
    L'oggetto di configurazione.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


setTargeting

  • setTargeting(key: string, value: string | string[]): PubAdsService
  • Consente di impostare i parametri di targeting personalizzato per una determinata chiave e applicati a tutte le aree annuncio del servizio Annunci del publisher. Se questa funzione viene richiamata più volte per la stessa chiave, i valori precedenti 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 (legacy)

    // 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: string
    Chiave del parametro di targeting.
    value: string | string[]
    Valore parametro di targeting o array di valori.
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stato chiamato il metodo.


setVideoContent

  • setVideoContent(videoContentId: string, videoCmsId: string): void
  • Consente di impostare le informazioni sui contenuti video da inviare insieme alle richieste di annunci ai fini del targeting e dell'esclusione di contenuti. Gli annunci video verranno attivati automaticamente quando verrà richiamato questo metodo. Per videoContentId e videoCmsId, utilizza i valori forniti al servizio di importazione dei contenuti di Google Ad Manager.

  • Vedi anche
  • Parametri
    videoContentId: string
    Il Content ID del video.
    videoCmsId: string
    L'ID CMS del video.


updateCorrelator

  • updateCorrelator(): PubAdsService
  • Modifica il correlatore inviato con le richieste di annunci, avviando effettivamente una nuova visualizzazione di pagina. Il correlatore è uguale per tutte le richieste di annunci provenienti da una visualizzazione di pagina ed è unico per tutte le visualizzazioni di pagina. Si applica solo alla modalità asincrona.

    Nota: non influisce sulla visualizzazione di pagina di lunga durata di GPT, che riflette automaticamente gli annunci effettivamente presenti nella pagina e non ha data di scadenza.

  • Esempio

    JavaScript

    // Assume that the correlator is currently 12345. All ad requests made
    // by this page will currently use that value.
    
    // Replace the current correlator with a new correlator.
    googletag.pubads().updateCorrelator();
    
    // The correlator will now be a new randomly selected value, different
    // from 12345. All subsequent ad requests made by this page will use
    // the new value.
    

    JavaScript (legacy)

    // Assume that the correlator is currently 12345. All ad requests made
    // by this page will currently use that value.
    
    // Replace the current correlator with a new correlator.
    googletag.pubads().updateCorrelator();
    
    // The correlator will now be a new randomly selected value, different
    // from 12345. All subsequent ad requests made by this page will use
    // the new value.
    

    TypeScript

    // Assume that the correlator is currently 12345. All ad requests made
    // by this page will currently use that value.
    
    // Replace the current correlator with a new correlator.
    googletag.pubads().updateCorrelator();
    
    // The correlator will now be a new randomly selected value, different
    // from 12345. All subsequent ad requests made by this page will use
    // the new value.
    
  • Resi
    PubAdsService
    L'oggetto di servizio su cui è stata chiamata la funzione.


googletag.ResponseInformation

Un oggetto che rappresenta una singola risposta a un annuncio.

Riepilogo proprietà
advertiserId
L'ID dell'inserzionista.
campaignId
L'ID della campagna.
creativeId
L'ID della creatività.
creativeTemplateId
L'ID modello dell'annuncio.
lineItemId
L'ID dell'elemento pubblicitario.
Vedi anche


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 modello dell'annuncio.


lineItemId

  • lineItemId: null | number
  • L'ID dell'elemento pubblicitario.


googletag.RewardedPayload

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

Riepilogo proprietà
amount
Il numero di articoli inclusi nel premio.
type
Il tipo di articolo incluso nel premio (ad es. "moneta").
Vedi anche


amount

  • amount: number
  • Il numero di articoli inclusi nel premio.


type

  • type: string
  • Il tipo di articolo incluso nel premio (ad es. "moneta").


googletag.SafeFrameConfig

Oggetto di configurazione per i container SafeFrame.

Riepilogo proprietà
allowOverlayExpansion
Indica se SafeFrame deve consentire l'espansione dei contenuti degli annunci sovrapponendo i contenuti della pagina.
allowPushExpansion
Indica se SafeFrame deve consentire l'espansione dei contenuti degli annunci trasferendo i contenuti della pagina.
sandbox
Indica se SafeFrame deve utilizzare l'attributo sandbox HTML5 per impedire la navigazione di primo livello senza interazione da parte dell'utente.
useUniqueDomain
Obsoleta. Indica se SafeFrame deve utilizzare sottodomini casuali per le creatività di prenotazione.
Vedi anche


allowOverlayExpansion

  • allowOverlayExpansion: boolean
  • Indica se SafeFrame deve consentire l'espansione dei contenuti degli annunci sovrapponendo i contenuti della pagina.


allowPushExpansion

  • allowPushExpansion: boolean
  • Indica se SafeFrame deve consentire l'espansione dei contenuti degli annunci trasferendo i contenuti della pagina.


sandbox

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


useUniqueDomain

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

    Nota: questa funzionalità è abilitata per impostazione predefinita.

  • Vedi anche


googletag.Service

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

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


addEventListener

  • addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (arg: EventTypeMap[K]) => void): Service
  • Registra un listener che consente di impostare e chiamare una funzione JavaScript quando si verifica un determinato evento GPT nella pagina. Sono supportati i seguenti eventi:

    Quando viene chiamato, un oggetto del tipo di evento appropriato viene passato al listener.

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

    // 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: K
    Una stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
    listener: (arg: EventTypeMap[K]) => void
    Funzione che prende un singolo argomento di oggetto evento.
  • Resi
    Service
    L'oggetto di servizio su cui è stato chiamato il metodo.


getSlots

  • getSlots(): Slot[]
  • Recupera l'elenco degli slot associati a questo servizio.

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


removeEventListener

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

  • Esempio

    JavaScript

    googletag.cmd.push(() => {
      // Define a new ad slot.
      googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());
    
      // Define a new function that removes itself via removeEventListener
      // after the impressionViewable event fires.
      const onViewableListener = (event) => {
        googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
        setTimeout(() => {
          googletag.pubads().refresh([event.slot]);
        }, 30000);
      };
    
      // Add onViewableListener as a listener for impressionViewable events.
      googletag.pubads().addEventListener("impressionViewable", onViewableListener);
      googletag.enableServices();
    });
    

    JavaScript (legacy)

    googletag.cmd.push(function () {
      // Define a new ad slot.
      googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());
    
      // Define a new function that removes itself via removeEventListener
      // after the impressionViewable event fires.
      var onViewableListener = function (event) {
        googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
        setTimeout(function () {
          googletag.pubads().refresh([event.slot]);
        }, 30000);
      };
    
      // Add onViewableListener as a listener for impressionViewable events.
      googletag.pubads().addEventListener("impressionViewable", onViewableListener);
      googletag.enableServices();
    });
    

    TypeScript

    googletag.cmd.push(() => {
      // Define a new ad slot.
      googletag
        .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")!
        .addService(googletag.pubads());
    
      // Define a new function that removes itself via removeEventListener
      // after the impressionViewable event fires.
      const onViewableListener = (event: googletag.events.ImpressionViewableEvent) => {
        googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
        setTimeout(() => {
          googletag.pubads().refresh([event.slot]);
        }, 30000);
      };
    
      // Add onViewableListener as a listener for impressionViewable events.
      googletag.pubads().addEventListener("impressionViewable", onViewableListener);
      googletag.enableServices();
    });
    
  • Parametri
    eventType: K
    Una stringa che rappresenta il tipo di evento generato da GPT. I tipi di evento sono sensibili alle maiuscole.
    listener: (event: EventTypeMap[K]) => void
    Funzione che prende un singolo argomento di oggetto evento.


googletag.SizeMappingBuilder

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

Riepilogo del metodo
addSize
Aggiunge una mappatura da un array a dimensione singola (che rappresenta l'area visibile) a un array a una o più dimensioni che rappresenta l'area.
build
Crea una specifica della mappa delle dimensioni dalle mappature aggiunte a questo builder.
Vedi anche


addSize

  • addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
  • Aggiunge una mappatura da un array a dimensione singola (che rappresenta l'area visibile) a un array a una o più dimensioni che rappresenta l'area.

  • Esempio

    JavaScript

    // Mapping 1
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [728, 90])
      .addSize([640, 480], "fluid")
      .addSize([0, 0], [88, 31]) // All viewports < 640x480
      .build();
    
    // Mapping 2
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [])
      .addSize([640, 480], [120, 60])
      .addSize([0, 0], [])
      .build();
    
    // Mapping 2 will not show any ads for the following viewport sizes:
    // [1024, 768] > size >= [980, 690] and
    // [640, 480] > size >= [0, 0]
    

    JavaScript (legacy)

    // Mapping 1
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [728, 90])
      .addSize([640, 480], "fluid")
      .addSize([0, 0], [88, 31]) // All viewports < 640x480
      .build();
    
    // Mapping 2
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [])
      .addSize([640, 480], [120, 60])
      .addSize([0, 0], [])
      .build();
    
    // Mapping 2 will not show any ads for the following viewport sizes:
    // [1024, 768] > size >= [980, 690] and
    // [640, 480] > size >= [0, 0]
    

    TypeScript

    // Mapping 1
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [728, 90])
      .addSize([640, 480], "fluid")
      .addSize([0, 0], [88, 31]) // All viewports < 640x480
      .build();
    
    // Mapping 2
    googletag
      .sizeMapping()
      .addSize([1024, 768], [970, 250])
      .addSize([980, 690], [])
      .addSize([640, 480], [120, 60])
      .addSize([0, 0], [])
      .build();
    
    // Mapping 2 will not show any ads for the following viewport sizes:
    // [1024, 768] > size >= [980, 690] and
    // [640, 480] > size >= [0, 0]
    
  • Parametri
    viewportSize: SingleSizeArray
    Le dimensioni dell'area visibile per questa voce di mappatura.
    slotSize: GeneralSize
    Le dimensioni dell'area per questa voce di mappatura.
  • Resi
    SizeMappingBuilder
    Un riferimento a questo builder.


build

  • build(): null | SizeMappingArray
  • Crea una specifica della mappa delle dimensioni dalle mappature aggiunte a questo builder.

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

    Nota: il comportamento dello strumento di creazione dopo aver chiamato questo metodo non è definito.

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


googletag.Slot

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

Riepilogo del metodo
addService
Aggiunge un Service a questo spazio.
clearCategoryExclusions
Cancella tutte le etichette di esclusione della categoria di annunci a livello di area per questa area.
clearTargeting
Cancella i parametri di targeting personalizzati a livello di area annuncio specifici o tutti per questa area.
defineSizeMapping
Imposta un array di mappature da una dimensione minima dell'area visibile alle dimensioni dell'area per questa area.
get
Restituisce il valore dell'attributo AdSense associato alla chiave specificata per l'area.
getAdUnitPath
Restituisce il percorso completo dell'unità pubblicitaria, con il codice di rete e il percorso dell'unità pubblicitaria.
getAttributeKeys
Restituisce l'elenco di chiavi degli attributi impostate in questo slot.
getCategoryExclusions
Restituisce le etichette di esclusione della categoria di annunci per l'area.
getResponseInformation
Restituisce le informazioni sulla risposta all'annuncio.
getSlotElementId
Restituisce l'ID dell'area div fornito al momento della definizione dell'area.
getTargeting
Restituisce uno specifico parametro di targeting personalizzato impostato nell'area in questione.
getTargetingKeys
Restituisce l'elenco di tutte le chiavi di targeting personalizzato impostate nell'area.
set
Consente di impostare un valore per un attributo AdSense in questa area annuncio.
setCategoryExclusion
Consente di impostare un'etichetta di esclusione della categoria 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
Consente di impostare se l'area div deve essere nascosta quando non ci sono annunci al suo interno.
setConfig
Imposta le opzioni di configurazione generali per questo slot.
setForceSafeFrame
Consente di configurare se gli annunci in questa area devono essere forzati per essere visualizzati utilizzando un contenitore SafeFrame.
setSafeFrameConfig
Consente di impostare le preferenze a livello di area per la configurazione di SafeFrame.
setTargeting
Imposta un parametro di targeting personalizzato per questa area.
updateTargetingFromMap
Consente di impostare i parametri di targeting personalizzato per questa area da una mappa chiave:valore in un oggetto JSON.


addService

  • addService(service: Service): Slot
  • Aggiunge un Service a questo spazio.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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: Service
    Il servizio da aggiungere.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


clearCategoryExclusions

  • clearCategoryExclusions(): Slot
  • Cancella tutte le etichette di esclusione della categoria di annunci a livello di area 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 (legacy)

    // Set category exclusion to exclude ads with 'AirlineAd' labels.
    var slot = googletag
      .defineSlot("/1234567/sports", [160, 600], "div")
      .setCategoryExclusion("AirlineAd")
      .addService(googletag.pubads());
    
    // Make an ad request. No ad with 'AirlineAd' label will be returned
    // for the slot.
    
    // Clear category exclusions so all ads can be returned.
    slot.clearCategoryExclusions();
    
    // Make an ad request. Any ad can be returned for the slot.
    

    TypeScript

    // Set category exclusion to exclude ads with 'AirlineAd' labels.
    const slot = googletag
      .defineSlot("/1234567/sports", [160, 600], "div")!
      .setCategoryExclusion("AirlineAd")
      .addService(googletag.pubads());
    
    // Make an ad request. No ad with 'AirlineAd' label will be returned
    // for the slot.
    
    // Clear category exclusions so all ads can be returned.
    slot.clearCategoryExclusions();
    
    // Make an ad request. Any ad can be returned for the slot.
    
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


clearTargeting

  • clearTargeting(key?: string): Slot
  • Cancella i parametri di targeting personalizzati a livello di area annuncio specifici o tutti 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 (legacy)

    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
    key?: string
    Chiave del parametro di targeting. La chiave è facoltativa; tutti i parametri di targeting verranno cancellati se non sono specificati.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


defineSizeMapping

  • defineSizeMapping(sizeMapping: SizeMappingArray): Slot
  • Imposta un array di mappature da una dimensione minima dell'area visibile alle dimensioni dell'area per questa area.

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

    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: SizeMappingArray
    Array di mappature delle dimensioni. Puoi utilizzare SizeMappingBuilder per crearlo. Ogni mappatura delle dimensioni è un array di due elementi: SingleSizeArray e GeneralSize.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


get

  • get(key: string): null | string
  • Restituisce il valore dell'attributo AdSense associato alla chiave specificata per l'area. Per visualizzare gli attributi del livello di servizio ereditati da questa area annuncio, 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 (legacy)

    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: string
    Nome dell'attributo da cercare.
  • Resi
    null | string
    Valore attuale della chiave dell'attributo o null se la chiave non è presente.


getAdUnitPath

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    const slot = googletag
      .defineSlot("/1234567/sports", [160, 600], "div")!
      .addService(googletag.pubads());
    
    slot.getAdUnitPath();
    // Returns '/1234567/sports'.
    
  • Resi
    string
    Percorso unità pubblicitaria.


getAttributeKeys

  • getAttributeKeys(): string[]
  • Restituisce l'elenco di chiavi degli attributi impostate in questo slot. Per visualizzare le chiavi degli attributi del livello di servizio ereditati da questa area annuncio, 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 (legacy)

    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'ordine non è definito.


getCategoryExclusions

  • getCategoryExclusions(): string[]
  • Restituisce le etichette di esclusione della categoria di annunci per l'area.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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 della categoria di annunci per l'area annuncio o un array vuoto se non ne è stata impostata nessuna.


getResponseInformation

  • getResponseInformation(): null | ResponseInformation
  • Restituisce le informazioni sulla risposta all'annuncio. Si basa sull'ultima risposta all'annuncio per l'area. Se viene richiamato quando l'area non ha annunci, verrà restituito null.

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


getSlotElementId

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

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

    TypeScript

    const slot = googletag
      .defineSlot("/1234567/sports", [160, 600], "div")!
      .addService(googletag.pubads());
    
    slot.getSlotElementId();
    // Returns 'div'.
    
  • Resi
    string
    ID slot div.


getTargeting

  • getTargeting(key: string): string[]
  • Restituisce uno specifico parametro di targeting personalizzato impostato nell'area in questione. 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 (legacy)

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

    TypeScript

    const slot = googletag
      .defineSlot("/1234567/sports", [160, 600], "div")!
      .setTargeting("allow_expandable", "true")
      .addService(googletag.pubads());
    
    slot.getTargeting("allow_expandable");
    // Returns ['true'].
    
    slot.getTargeting("age");
    // Returns [] (empty array).
    
  • Parametri
    key: string
    La chiave di targeting da cercare.
  • Resi
    string[]
    I valori associati a questa chiave o un array vuoto se questa chiave non esiste.


getTargetingKeys

  • getTargetingKeys(): string[]
  • Restituisce l'elenco di tutte le chiavi di targeting personalizzato impostate nell'area. 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 (legacy)

    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'ordine non è definito.


set

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

    Se questo metodo viene chiamato più di una volta per la stessa chiave, verranno sostituiti i valori impostati in precedenza per quella chiave. 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 (legacy)

    // 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: string
    Il nome dell'attributo.
    value: string
    Valore dell'attributo.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


setCategoryExclusion

  • setCategoryExclusion(categoryExclusion: string): Slot
  • Consente di impostare un'etichetta di esclusione della categoria di annunci a livello di area su questa area.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    // 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: string
    L'etichetta di esclusione della categoria di annunci da aggiungere.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


setClickUrl

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

    I server di Google Ad Manager registrano comunque un clic anche se l'URL dei clic viene sostituito. Qualsiasi URL pagina di destinazione associato alla creatività pubblicata viene aggiunto al valore fornito. Le chiamate successive sovrascrivono il valore. 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 (legacy)

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

    TypeScript

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


setCollapseEmptyDiv

  • setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
  • Consente di impostare se l'area div deve essere nascosta quando non ci sono annunci nell'area. Questa operazione sostituisce le impostazioni del 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 (legacy)

    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: boolean
    Indica se comprimere l'area se non viene restituito alcun annuncio.
    collapseBeforeAdFetch?: boolean
    Indica se comprimere l'area anche prima del recupero di un annuncio. Ignorata se la compressione non è true.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


setConfig

  • setConfig(slotConfig: SlotSettingsConfig): void
  • Imposta le opzioni di configurazione generali per questo slot.

  • Parametri
    slotConfig: SlotSettingsConfig
    L'oggetto di configurazione.


setForceSafeFrame

  • setForceSafeFrame(forceSafeFrame: boolean): Slot
  • Consente di configurare se forzare il rendering degli annunci in quest'area utilizzando un contenitore SafeFrame.

    Tieni presente quanto segue quando utilizzi questa API:

    • Questa impostazione verrà applicata solo alle richieste di annunci successive effettuate per le rispettive aree.
    • 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 viene sempre visualizzato utilizzando un contenitore SafeFrame indipendentemente dalla scelta effettuata nell'interfaccia utente di Google Ad Manager.
    • Tuttavia, se il criterio viene impostato su false o se non viene specificato, l'annuncio verrà visualizzato utilizzando un contenitore SafeFrame in base al tipo di creatività e alla 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 dagli iframe o che fanno affidamento sul rendering diretto nella pagina di un publisher.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

    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: boolean
    true per forzare il rendering di tutti gli annunci in quest'area in SafeFrame e false per disattivare un'impostazione a livello di pagina (se presente). Se il criterio viene impostato su false se non è specificato a livello di pagina, non ci sono modifiche.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


setSafeFrameConfig

  • setSafeFrameConfig(config: null | SafeFrameConfig): Slot
  • Consente di impostare le preferenze a livello di area per la configurazione di SafeFrame. Eventuali chiavi non riconosciute nell'oggetto di configurazione verranno ignorate. Se per una chiave riconosciuta viene trasmesso un valore non valido per una chiave riconosciuta, l'intera configurazione verrà ignorata.

    Se specificate, queste preferenze a livello di area andranno a sovrascrivere qualsiasi preferenza 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 (legacy)

    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 | SafeFrameConfig
    L'oggetto di configurazione.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


setTargeting

  • setTargeting(key: string, value: string | string[]): Slot
  • Imposta un parametro di targeting personalizzato per questa area. Se questo metodo viene chiamato più volte per la stessa chiave, i valori precedenti verranno sovrascritti. I valori impostati qui sovrascriveranno 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 (legacy)

    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: string
    Chiave del parametro di targeting.
    value: string | string[]
    Valore parametro di targeting o array di valori.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


updateTargetingFromMap

  • updateTargetingFromMap(map: {  [adUnitPath: string]: string | string[] }): Slot
  • Consente di impostare i parametri di targeting personalizzato per questa area da una mappa chiave:valore in un oggetto JSON. Equivale a chiamare Slot.setTargeting per tutte le coppie chiave-valore dell'oggetto. Queste chiavi sono definite nel tuo account Google Ad Manager.

    Note:

    • In caso di sovrascrittura, verrà mantenuto solo l'ultimo valore.
    • Se il valore è un array, tutti i valori precedenti verranno sovrascritti e non uniti.
    • 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 (legacy)

    var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");
    
    slot.updateTargetingFromMap({
      color: "red",
      interests: ["sports", "music", "movies"],
    });
    

    TypeScript

    const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div")!;
    
    slot.updateTargetingFromMap({
      color: "red",
      interests: ["sports", "music", "movies"],
    });
    
  • Parametri
    map: {  [adUnitPath: string]: string | string[] }
    Mappa chiave:valore del parametro di targeting.
  • Resi
    Slot
    L'oggetto slot su cui è stato chiamato il metodo.


googletag,config,AdExpansionConfig

Impostazioni per controllare l'espansione dell'annuncio.

Riepilogo proprietà
enabled
Indica se l'espansione degli annunci è attivata o disattivata.
Esempio

JavaScript

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

JavaScript (legacy)

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

TypeScript

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


enabled


googletag,config,ComponentAuctionConfig

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

Riepilogo proprietà
auctionConfig
Un oggetto di configurazione dell'asta per l'asta di questo componente.
configKey
La chiave di configurazione associata all'asta di questo componente.
Vedi anche


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 per questa asta del componente.

    Se questo valore viene impostato su null, qualsiasi configurazione esistente per l'elemento 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 (legacy)

    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 da impostare sovrascriverà le configurazioni precedenti.


googletag,config,InterstitialConfig

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

Riepilogo proprietà
triggers
La configurazione dell'attivatore interstitial per questo annuncio interstitial.


triggers

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

    L'impostazione del valore di un attivatore interstitial su true lo attiverà, mentre false lo disattiverà. In questo modo verranno sostituiti i valori predefiniti configurati in Google Ad Manager.

  • Esempio

    JavaScript

    // Define a GPT managed web interstitial ad slot.
    const interstitialSlot = googletag.defineOutOfPageSlot(
      "/1234567/sports",
      googletag.enums.OutOfPageFormat.INTERSTITIAL
    );
    
    // Enable optional interstitial triggers.
    // Change this value to false to disable.
    const enableTriggers = true;
    
    interstitialSlot.setConfig({
      interstitial: {
        triggers: {
          navBar: enableTriggers,
          unhideWindow: enableTriggers,
        },
      },
    });
    

    JavaScript (legacy)

    // 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 all'interno del tipo PageSettingsConfig di seguito.

Esempi:

  • Vengono modificate solo le funzionalità specificate nella chiamata setConfig.
      // Configure feature alpha.
      googletag.setConfig({
          alpha: {...}
      });
    
      // Configure feature bravo. Feature alpha is unchanged.
      googletag.setConfig({
         bravo: {...}
      });
    
  • Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a setConfig.
      // Configure feature charlie to echo = 1, foxtrot = true.
      googletag.setConfig({
          charlie: {
              echo: 1,
              foxtrot: true,
          }
      });
    
      // Update feature charlie to echo = 2. Since foxtrot was not specified,
      // the value is cleared.
      googletag.setConfig({
          charlie: {
              echo: 2
          }
      });
    
  • Tutte le impostazioni di un elemento possono essere cancellate trasmettendo null.
      // Configure features delta, golf, and hotel.
      googletag.setConfig({
          delta: {...},
          golf: {...},
          hotel: {...},
      });
    
      // Feature delta and hotel are cleared, but feature golf remains set.
      googletag.setConfig({
          delta: null,
          hotel: null,
      });
    

Riepilogo proprietà
adExpansion
Impostazioni per controllare l'espansione dell'annuncio.
adYield
Obsoleta. .
pps
Impostazioni per controllare gli indicatori forniti dal publisher (PPS).
privacyTreatments
Impostazioni per controllare il trattamento della privacy dei publisher.
threadYield
Impostazione per stabilire se GPT deve generare il thread JS durante il rendering delle creatività.


adExpansion

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


adYield

  • adYield: null | "DISABLED" | "ENABLED_ALL_SLOTS"


pps


privacyTreatments

  • privacyTreatments: null | PrivacyTreatmentsConfig
  • Impostazioni per controllare il trattamento della privacy dei publisher.


threadYield

  • threadYield: null | "DISABLED" | "ENABLED_ALL_SLOTS"
  • Impostazione per stabilire se GPT deve generare il thread JS durante il rendering delle creatività.

    GPT restituirà solo i browser che supportano l'API Scheduler.postTask.

    Valori supportati:

    • null (predefinito): GPT restituirà il thread JS per le aree al di fuori dell'area visibile.
    • ENABLED_ALL_SLOTS: GPT restituirà il thread JS per tutte le aree, a prescindere dal fatto che l'area si trovi all'interno dell'area visibile.
    • DISABLED: GPT non restituisce 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 (legacy)

    // 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 il trattamento della privacy dei publisher.

Riepilogo proprietà
treatments
Una gamma di opzioni di protezione della privacy per i publisher da attivare.


treatments

  • treatments: "disablePersonalization"[]
  • Una gamma di opzioni di protezione della privacy per i publisher da attivare.

  • Esempio

    JavaScript

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

    JavaScript (legacy)

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

Riepilogo proprietà
taxonomies
Un oggetto contenente mappature della tassonomia.
Esempio

JavaScript

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

JavaScript (legacy)

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

TypeScript

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


taxonomies


googletag,config,SlotSettingsConfig

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

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

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

Esempi:

  • Vengono modificate solo le funzionalità specificate nella chiamata Slot.setConfig.
      const slot = googletag.defineSlot("/1234567/example", [160, 600]);
    
      // Configure feature alpha.
      slot.setConfig({
          alpha: {...}
      });
    
      // Configure feature bravo. Feature alpha is unchanged.
      slot.setConfig({
         bravo: {...}
      });
    
  • Tutte le impostazioni di una determinata funzionalità vengono aggiornate a ogni chiamata a Slot.setConfig.
      // Configure feature charlie to echo = 1, foxtrot = true.
      slot.setConfig({
          charlie: {
              echo: 1,
              foxtrot: true,
          }
      });
    
      // Update feature charlie to echo = 2. Since foxtrot was not specified,
      // the value is cleared.
      slot.setConfig({
          charlie: {
              echo: 2
          }
      });
    
  • Tutte le impostazioni di un elemento possono essere cancellate trasmettendo null.
      // Configure features delta, golf, and hotel.
      slot.setConfig({
          delta: {...},
          golf: {...},
          hotel: {...},
      });
    
      // Feature delta and hotel are cleared, but feature golf remains set.
      slot.setConfig({
          delta: null,
          hotel: null,
      });
    

Riepilogo proprietà
adExpansion
Impostazioni per controllare l'espansione dell'annuncio.
componentAuction
Una serie di aste di componenti da includere in un'asta dell'annuncio on-device.
interstitial
Impostazioni che controllano il comportamento dell'area annuncio interstitial.


adExpansion

  • adExpansion: AdExpansionConfig
  • Impostazioni per controllare l'espansione dell'annuncio.


componentAuction

  • componentAuction: ComponentAuctionConfig[]
  • Una serie di aste di componenti da includere in un'asta dell'annuncio on-device.


interstitial

  • interstitial: InterstitialConfig
  • Impostazioni che controllano il comportamento dell'area annuncio interstitial.


googletag,config,TaxonomyData

Un oggetto contenente i valori di una singola Tassonomia.

Riepilogo proprietà
values
Un elenco di valori della Tassonomia.


values

  • values: string[]
  • Un elenco di valori della Tassonomia.


googletag,events,Event

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Vedi anche


serviceName

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


slot

  • slot: Slot
  • L'area che ha attivato l'evento.


googletag,events,EventTypeMap

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

Riepilogo proprietà
gameManualInterstitialSlotClosed
gameManualInterstitialSlotReady
impressionViewable
rewardedSlotClosed
rewardedSlotGranted
rewardedSlotReady
slotOnload
slotRenderEnded
slotRequested
slotResponseReceived
slotVisibilityChanged


gameManualInterstitialSlotClosed


gameManualInterstitialSlotReady


impressionViewable


rewardedSlotClosed


rewardedSlotGranted


rewardedSlotReady


slotOnload


slotRenderEnded


slotRequested


slotResponseReceived


slotVisibilityChanged


googletag,events,GameManualInterstitialSlotClosedEvent

Si estende Event

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

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Esempio

JavaScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

JavaScript (legacy)

// This listener is called when a game manual interstial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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


googletag,events,GameManualInterstitialSlotReadyEvent

Si estende Event

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

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Riepilogo del metodo
makeGameManualInterstitialVisible
Mostra all'utente l'annuncio interstitial manuale del gioco.
Esempio

JavaScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (legacy)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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


makeGameManualInterstitialVisible

  • makeGameManualInterstitialVisible(): void
  • Mostra all'utente l'annuncio interstitial manuale del gioco.


googletag,events,ImpressionViewableEvent

Si estende Event

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area 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 (legacy)

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

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

TypeScript

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

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


googletag,events,RewardedSlotClosedEvent

Si estende Event

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Esempio

JavaScript

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

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

JavaScript (legacy)

// This listener is called when the user closes a rewarded ad slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

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

TypeScript

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

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


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

Riepilogo proprietà
payload
Un oggetto contenente informazioni sul premio concesso.
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Esempio

JavaScript

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

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

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

JavaScript (legacy)

// This listener is called whenever a reward is granted for a
// rewarded ad.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", function (event) {
  var _a, _b;
  var slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

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

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

TypeScript

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

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

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


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 offrire all'utente la possibilità di visualizzare l'annuncio prima di farlo.

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area che ha attivato l'evento.
Riepilogo del metodo
makeRewardedVisible
Mostra l'annuncio con premio.
Esempio

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

JavaScript (legacy)

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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


makeRewardedVisible

  • makeRewardedVisible(): void
  • Mostra l'annuncio con premio. Questo metodo non deve essere chiamato finché l'utente non ha acconsentito a visualizzare l'annuncio.


googletag,events,SlotOnloadEvent

Si estende Event

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area 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 (legacy)

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

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

TypeScript

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

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


googletag,events,SlotRenderEndedEvent

Si estende Event

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

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

JavaScript

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

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

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

JavaScript (legacy)

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

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

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

TypeScript

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

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

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


advertiserId

  • advertiserId: null | number
  • ID inserzionista dell'annuncio visualizzato. Il valore è null per aree vuote, annunci backfill e creatività visualizzate da servizi diversi da PubAdsService.


campaignId

  • campaignId: null | number
  • ID campagna dell'annuncio visualizzato. Il valore è null per aree vuote, annunci backfill e creatività visualizzate da servizi diversi da PubAdsService.


companyIds

  • companyIds: null | number[]
  • ID delle aziende che fanno offerte per l'annuncio di backfill con rendering eseguito. Il valore è null per aree vuote, annunci basati su prenotazione e creatività visualizzate da servizi diversi da PubAdsService.


creativeId

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


creativeTemplateId

  • creativeTemplateId: null | number
  • ID modello di creatività dell'annuncio di prenotazione visualizzato. Il valore è null per aree vuote, annunci backfill e creatività visualizzate da servizi diversi da PubAdsService.


isBackfill

  • isBackfill: boolean
  • Indica se un annuncio era un annuncio backfill. Il valore è true se l'annuncio era un annuncio backfill, false in caso contrario.


isEmpty

  • isEmpty: boolean
  • Se un annuncio è stato restituito per l'area. Il valore è true se non è stato restituito alcun annuncio, altrimenti false.


labelIds

  • labelIds: null | number[]
  • ID etichetta dell'annuncio visualizzato. Il valore è null per aree vuote, annunci backfill e creatività visualizzate da servizi diversi da PubAdsService.


lineItemId

  • lineItemId: null | number
  • ID dell'elemento pubblicitario dell'annuncio con prenotazione visualizzato. Il valore è null per aree vuote, annunci backfill e 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 per le aree annuncio vuote è null.


slotContentChanged

  • slotContentChanged: boolean
  • 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 prenotazione o backfill visualizzato. Il valore è null se l'annuncio non è un backfill di una prenotazione o di un elemento pubblicitario oppure se la creatività viene visualizzata da servizi diversi da PubAdsService.


sourceAgnosticLineItemId

  • sourceAgnosticLineItemId: null | number
  • ID dell'elemento pubblicitario dell'annuncio di prenotazione o backfill visualizzato. Il valore è null se l'annuncio non è un backfill di una prenotazione o di un 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 con rendering eseguito. Il valore è null per aree vuote, annunci basati su prenotazione e 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.

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area 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 (legacy)

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

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

TypeScript

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

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


googletag,events,SlotResponseReceived

Si estende Event

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

Riepilogo proprietà
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area 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 (legacy)

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

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

TypeScript

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

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


googletag,events,SlotVisibilityChangedEvent

Si estende Event

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

Riepilogo proprietà
inViewPercentage
Percentuale dell'area dell'annuncio visibile.
serviceName
Nome del servizio che ha attivato l'evento.
slot
L'area 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 (legacy)

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

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

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

TypeScript

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

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

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


inViewPercentage

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


googletag,secureSignals,BidderSignalProvider

Restituisce un indicatore sicuro per uno specifico offerente.

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

  1. Una funzione del collettore, che restituisce un Promise che si risolve in un segnale sicuro.
  2. Un id che identifica l'offerente associato all'indicatore.
Per restituire un indicatore sicuro per un publisher, utilizza invece secureSignals.PublisherSignalProvider.

Riepilogo proprietà
collectorFunction
.
id
Un identificatore univoco per il raccoglitore associato a questo indicatore sicuro, 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 (legacy)

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

TypeScript

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


collectorFunction

  • collectorFunction: () => Promise<string>


id

  • id: string
  • Un identificatore univoco per il raccoglitore associato a questo indicatore sicuro, 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 del collettore, che restituisce un Promise che si risolve in un segnale sicuro.
  2. Un networkCode che identifica il publisher associato all'indicatore.
Per restituire un indicatore sicuro per un offerente, utilizza invece secureSignals.BidderSignalProvider.

Riepilogo proprietà
collectorFunction
.
networkCode
Il codice di rete (come indicato 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 (legacy)

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

TypeScript

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


collectorFunction

  • collectorFunction: () => Promise<string>


networkCode

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


googletag,secureSignals,SecureSignalProvidersArray

Un'interfaccia per la gestione di indicatori sicuri.

Riepilogo del metodo
clearAllCache
Cancella dalla cache tutti i segnali per tutti i raccoglitori.
push
Aggiunge un nuovo secureSignals.SecureSignalProvider all'array del fornitore di indicatori e inizia il processo di generazione dei segnali.


clearAllCache

  • clearAllCache(): void
  • Cancella dalla cache tutti gli indicatori per tutti i raccoglitori.

    La chiamata di questo metodo può ridurre la probabilità che gli indicatori vengano inclusi nelle richieste di annunci per le visualizzazioni di pagina correnti e potenzialmente successive. Per questo motivo deve essere chiamato solo quando si verificano cambiamenti significativi di stato, ad esempio eventi che indicano la presenza di un nuovo utente (accesso, disconnessione, registrazione e così via).


push