Riferimento GPT

Esegue la sequenza di funzioni specificate negli argomenti in ordine.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

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

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

Esempio

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (precedente)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

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

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

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

• Automaticamente, utilizzando un indicatore di una piattaforma di gestione del consenso della versione 2.0 del TCF di IAB.
• Manualmente, impostando il valore di questo campo su true.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Mostrare un annuncio con limitazioni

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

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

Indica se le richieste rappresentano traffico organico o acquistato. Questo valore compila la dimensione Origine 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 (precedente)

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

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

TypeScript

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

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

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

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

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

Esempio

JavaScript

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

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

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

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

JavaScript (precedente)

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

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

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

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

TypeScript

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

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

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

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

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

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

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

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

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

TypeScript

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

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

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

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

Vedi anche

• Etichette personalizzate per bloccare gli annunci

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

Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

Vedi anche

• Targeting per coppie chiave-valore

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

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

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

Vedi anche

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

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

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

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

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

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

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

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

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. La modalità di richiesta singola deve essere impostata prima dell'attivazione del servizio.

Vedi anche

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

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

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

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

TypeScript

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

Vedi anche

• Attributi AdSense

Restituisce le chiavi degli attributi impostate su questo servizio.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

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

Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

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

Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

Indica se le richieste iniziali di annunci sono state disattivate o meno da una precedente chiamata PubAdsService.disableInitialLoad.

Recupera e mostra 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 comportarsi in modo imprevisto. Se vuoi, puoi utilizzare il metodo PubAdsService.disableInitialLoad per impedire a display di recuperare un annuncio.

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

Esempio

JavaScript

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

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

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

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

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

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

JavaScript (precedente)

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

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

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

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

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

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

TypeScript

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

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

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

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

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

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

Vedi anche

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

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

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

TypeScript

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

Vedi anche

• Attributi AdSense

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

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Etichette personalizzate per bloccare gli annunci

Attiva e disattiva il centratura orizzontale degli annunci. L'allineamento al centro è disattivato per impostazione predefinita. In gpt_mobile.js precedente, il centratura è attivata per impostazione predefinita.

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

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

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

Esempio

JavaScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

JavaScript (precedente)

googletag.pubads().setForceSafeFrame(true);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

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

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

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

Trasmette i dati sulla posizione dai siti web per consentirti di scegliere come target geografico gli elementi pubblicitari in base a località specifiche.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

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

Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

Vedi anche

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

Imposta il valore per l'ID fornito dal publisher.

Esempio

JavaScript

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

JavaScript (precedente)

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

TypeScript

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

Vedi anche

• Informazioni sugli identificatori forniti dai publisher

Imposta le preferenze a livello di pagina per la configurazione di SafeFrame. Eventuali chiavi non riconosciute nell'oggetto config 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 (precedente)

googletag.pubads().setForceSafeFrame(true);

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

var slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

TypeScript

googletag.pubads().setForceSafeFrame(true);

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

const slotConfig = { allowOverlayExpansion: false };

googletag.pubads().setSafeFrameConfig(pageConfig);

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

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

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

Vedi anche

• Visualizzare creatività utilizzando SafeFrame

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

Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

Vedi anche

• Targeting per coppie chiave-valore

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

Vedi anche

• Parametri URL del tag annuncio VAST

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

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

Esempio

JavaScript

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

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

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

JavaScript (precedente)

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

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

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

TypeScript

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

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

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

L'ID dell'inserzionista.

L'ID della campagna.

L'ID della creatività.

L'ID modello dell'annuncio.

L'ID della voce.

Il numero di articoli inclusi nel premio.

Il tipo di articolo incluso nel premio (ad es. "moneta").

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

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

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

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

• Visualizzare creatività utilizzando SafeFrame

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:

• events.GameManualInterstitialSlotClosedEvent
• events.GameManualInterstitialSlotReadyEvent
• events.ImpressionViewableEvent
• events.RewardedSlotClosedEvent
• events.RewardedSlotGrantedEvent
• events.RewardedSlotReadyEvent
• events.SlotOnloadEvent
• events.SlotRenderEndedEvent
• events.SlotRequestedEvent
• events.SlotResponseReceived
• events.SlotVisibilityChangedEvent

Esempio

JavaScript

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

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

JavaScript (precedente)

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

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

TypeScript

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

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

Vedi anche

• Listener di eventi annuncio

Recupera l'elenco degli slot associati a questo servizio.