Documentation de référence sur GPT

Exécute la séquence de fonctions spécifiée dans les arguments dans l'ordre.

Exemple

JavaScript

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

JavaScript (ancien)

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

Détermine si les espaces publicitaires associés qui n'ont pas été remplis seront automatiquement remplis.

Cette méthode peut être appelée plusieurs fois au cours de la durée de vie de la page pour activer et désactiver le remplissage. Seuls les espaces publicitaires également enregistrés auprès de PubAdsService seront remplis. En raison de restrictions liées aux règles, cette méthode n'est pas conçue pour remplir les emplacements associés vides lorsqu'une vidéo Ad Exchange est diffusée.

Exemple

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (ancien)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Indique si la page doit être traitée comme étant destinée aux enfants. Définissez sur null pour effacer la configuration.

Permet de diffuser des annonces en mode annonces limitées pour aider les éditeurs à respecter les exigences réglementaires.

Vous pouvez demander à GPT de demander des annonces limitées de deux manières:

• Automatiquement, à l'aide d'un signal provenant d'une plate-forme de gestion du consentement conforme au TCF v2.0 de l'IAB.
• Manuellement, en définissant la valeur de ce champ sur true.

Exemple

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

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

Voir aussi

• Diffuser une annonce limitée

Active la diffusion en mode annonces non personnalisées pour aider les éditeurs à respecter les exigences réglementaires.

Permet à la diffusion de s'exécuter en mode de traitement restreint pour aider les éditeurs à répondre à leurs obligations réglementaires.

Indique si les requêtes représentent du trafic acheté ou généré par les résultats naturels. Cette valeur renseigne la dimension Source de trafic dans les rapports Ad Manager. Si ce champ n'est pas défini, la source de trafic est définie par défaut sur undefined dans les rapports.

Exemple

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

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

Indique si les demandes d'annonces doivent être marquées comme provenant d'utilisateurs n'ayant pas atteint l'âge de consentement. Définissez la valeur sur null pour effacer la configuration.

Supprime les annonces des emplacements donnés et les remplace par du contenu vide. Les emplacements seront marqués comme non récupérés.

En particulier, effacer un emplacement supprime l'annonce de la vue de page persistante du GPT. Les futures requêtes ne seront donc pas influencées par les obstacles ou les exclusions concurrentielles impliquant cette annonce.

Exemple

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

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

Efface tous les libellés d'exclusion de catégorie d'annonces au niveau de la page. Cette option est utile si vous souhaitez actualiser l'emplacement.

Exemple

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

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

Voir aussi

• Libellés personnalisés pour bloquer les annonces

Efface les paramètres de ciblage personnalisé pour une clé spécifique ou pour toutes les clés.

Exemple

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

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.

Voir aussi

• Ciblage par clé-valeurs

Active le repli des divs d'espace publicitaire afin qu'ils ne prennent aucun espace sur la page lorsqu'il n'y a aucune annonce à afficher. Ce mode doit être défini avant l'activation du service.

Voir aussi

• Réduire des espaces publicitaires vides
• Réduire le décalage de mise en page

Désactive les requêtes d'annonces au chargement de la page, mais permet de les demander avec un appel PubAdsService.refresh. Ce paramètre doit être défini avant d'activer le service. Le mode asynchrone doit être utilisé. Sinon, il sera impossible de demander des annonces à l'aide de refresh.

Voir aussi

• Contrôler le chargement et l'actualisation des annonces
• Contrôler le traitement par lot de l'architecture de demande simple

Crée et affiche un espace publicitaire avec le chemin d'accès et la taille du bloc d'annonces donnés. Cette méthode ne fonctionne pas avec le mode de requête unique.

Remarque:Lorsque cette méthode est appelée, un instantané de l'emplacement et de l'état de la page est créé pour assurer la cohérence lors de l'envoi de la requête d'annonce et de l'affichage de la réponse. Toutes les modifications apportées à l'état de l'espace publicitaire ou de la page après l'appel de cette méthode (y compris le ciblage, les paramètres de confidentialité, les cadres SafeFrame, etc.) ne s'appliqueront qu'aux requêtes display() ou refresh() ultérieures.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Voir aussi

• Diffuser une annonce test
• Contrôler le chargement et l'actualisation des annonces

Active le chargement paresseux dans GPT, comme défini par l'objet de configuration. Pour obtenir des exemples plus détaillés, consultez l'exemple de chargement différé.

Remarque:Le chargement différé dans SRA ne fonctionne que si tous les emplacements se trouvent en dehors de la marge de récupération.

Exemple

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

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

Voir aussi

• Bonnes pratiques pour les annonces: donnez la priorité aux espaces publicitaires "importants"
• Chargement différé

Active le mode de requête unique pour extraire plusieurs annonces en même temps. Pour ce faire, vous devez définir et ajouter tous les emplacements d'annonces de l'éditeur au PubAdsService avant d'activer le service. Le mode de requête unique doit être défini avant l'activation du service.

Voir aussi

• Bonnes pratiques Ads: utiliser correctement l'architecture de demande simple
• Contrôler le traitement par lot de l'architecture de demande simple

Indique à GPT que des annonces vidéo seront présentes sur la page. Cela permet d'appliquer des contraintes d'exclusion réciproque sur les annonces display et vidéo. Si le contenu vidéo est connu, appelez PubAdsService.setVideoContent afin de pouvoir utiliser l'exclusion de contenu pour les annonces display.

Renvoie la valeur de l'attribut AdSense associé à la clé donnée.

Exemple

JavaScript

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

JavaScript (ancien)

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

Voir aussi

• Attributs AdSense

Renvoie les clés d'attributs définies sur ce service.

Exemple

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

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

Renvoie un paramètre de ciblage personnalisé au niveau du service spécifique qui a été défini.

Exemple

JavaScript

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

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

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

JavaScript (ancien)

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

Affiche la liste de toutes les clés de ciblage personnalisé au niveau du service qui ont été définies.

Exemple

JavaScript

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

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

JavaScript (ancien)

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

Indique si les demandes initiales d'annonces ont bien été désactivées par un appel PubAdsService.disableInitialLoad précédent.

Extrait et affiche de nouvelles annonces pour certains espaces publicitaires de la page ou pour l'ensemble de ceux-ci. Ne fonctionne que en mode de rendu asynchrone.

Pour un comportement correct dans tous les navigateurs, l'appel de refresh doit être précédé d'un appel à display l'emplacement d'annonce. Si l'appel à display est omis, l'actualisation peut se comporter de manière inattendue. Si vous le souhaitez, vous pouvez utiliser la méthode PubAdsService.disableInitialLoad pour empêcher display d'extraire une annonce.

L'actualisation d'un espace supprime l'ancienne annonce de la vue de page persistante de GPT. Les futures requêtes ne seront donc pas influencées par les obstacles ou les exclusions concurrentielles impliquant cette annonce.

Exemple

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

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

Voir aussi

• Contrôler le chargement et l'actualisation des annonces
• Actualiser les espaces publicitaires

Définit des valeurs pour les attributs AdSense qui s'appliquent à tous les espaces publicitaires dans le service Annonces d'éditeur.

Si vous appelez cette méthode plusieurs fois pour la même clé, les valeurs précédemment définies pour cette clé seront ignorées. Toutes les valeurs doivent être définies avant d'appeler display ou refresh.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Voir aussi

• Attributs AdSense

Définit une exclusion de catégorie d'annonces au niveau de la page pour le nom d'étiquette donné.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Voir aussi

• Libellés personnalisés pour bloquer les annonces

Active et désactive le centrage horizontal des annonces. Le centrage est désactivé par défaut. Dans l'ancienne version gpt_mobile.js, le centrage est activé par défaut.

Cette méthode doit être appelée avant d'appeler display ou refresh, car seules les annonces demandées après l'appel de cette méthode seront centrées.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Détermine si toutes les annonces de la page doivent s'afficher d'office à l'aide d'un conteneur SafeFrame.

Veuillez tenir compte des points suivants lorsque vous utilisez cette API:

• Ce paramètre ne s'applique qu'aux demandes d'annonces ultérieures effectuées pour les emplacements respectifs.
• Si un paramètre au niveau de l'espace est spécifié, il remplace toujours le paramètre au niveau de la page.
• Si la valeur est true (au niveau de l'espace publicitaire ou de la page), l'annonce est toujours affichée dans un conteneur SafeFrame, quel que soit le choix effectué dans l'interface utilisateur de Google Ad Manager.
• Toutefois, si la valeur est définie sur false ou n'est pas spécifiée, l'annonce sera affichée dans un conteneur SafeFrame en fonction du type de création et de la sélection effectuée dans l'interface utilisateur de Google Ad Manager.
• Utilisez cette API avec précaution, car elle peut avoir un impact sur le comportement des créations qui tentent de sortir de leurs iFrames ou qui s'appuient sur leur affichage direct sur la page d'un éditeur.

Exemple

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

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

Voir aussi

• Afficher des créations à l'aide de cadres SafeFrame

Transmet des informations de localisation provenant de sites Web afin que vous puissiez géocibler des éléments de campagne sur des zones géographiques spécifiques.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Permet de configurer tous les paramètres de confidentialité à partir d'une seule API à l'aide d'un objet de configuration.

Exemple

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

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

Voir aussi

• Configurer les paramètres de confidentialité
• Afficher une annonce limitée

Définit la valeur de l'identifiant fourni par l'éditeur.

Exemple

JavaScript

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

JavaScript (ancien)

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

TypeScript

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

Voir aussi

• À propos des identifiants fournis par l'éditeur

Définit les préférences de configuration des cadres SafeFrame au niveau de la page. Toutes les clés non reconnues de l'objet de configuration sont ignorées. L'intégralité de la configuration sera ignorée si une valeur non valide est transmise pour une clé reconnue.

Ces préférences au niveau de la page seront remplacées par les préférences au niveau de l'espace, le cas échéant.

Exemple

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

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

Voir aussi

• Afficher des créations à l'aide de cadres SafeFrame

Définit des paramètres de ciblage personnalisé pour une clé donnée qui s'appliquent à tous les emplacements publicitaires du service Annonces pour les éditeurs. Si vous appelez cette méthode plusieurs fois pour la même clé, les anciennes valeurs seront écrasées. Ces clés sont définies dans votre compte Google Ad Manager.

Exemple

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

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

Voir aussi

• Ciblage par clé-valeurs

Définit les informations sur le contenu vidéo à envoyer avec les demandes d'annonces à des fins de ciblage et d'exclusion de contenu. Les annonces vidéo seront automatiquement activées lorsque cette méthode sera appelée. Pour videoContentId et videoCmsId, utilisez les valeurs fournies au service d'ingestion de contenu Google Ad Manager.

Voir aussi

• Paramètres d'URL du tag d'emplacement publicitaire VAST

Modifie le corrélateur envoyé avec les demandes d'annonces, ce qui lance une nouvelle page vue. Le corrélateur est le même pour toutes les demandes d'annonces provenant d'une page vue et unique pour chaque page vue. Ne s'applique qu'au mode asynchrone.

Remarque:Cela n'a aucun effet sur la page vue de longue durée de GPT, qui reflète automatiquement les annonces réellement sur la page et n'a pas de délai d'expiration.

Exemple

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

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

ID de l'annonceur.

Identifiant de la campagne.

Identifiant de la création.

ID du modèle de l'annonce.

Identifiant de la ligne.

Le nombre d'éléments inclus dans la récompense.

Type d'élément inclus dans la récompense (par exemple, "pièce").

Indique si les cadres SafeFrame doivent permettre au contenu de l'annonce de se développer en se superposant au contenu de la page.

Indique si SafeFrame doit autoriser le contenu de l'annonce à se développer en poussant le contenu de la page.

Indique si SafeFrame doit utiliser l'attribut HTML5 sandbox pour empêcher la navigation de niveau supérieur sans interaction de l'utilisateur. La seule valeur valide est true (vous ne pouvez pas forcer la valeur false). Notez que l'attribut bac à sable désactive les plug-ins (par exemple, Flash).

Indique si SafeFrame doit utiliser des sous-domaines aléatoires pour les créations de réservation. Transmettez null pour effacer la valeur stockée.

Remarque: Cette fonctionnalité est activée par défaut.

Voir aussi

• Afficher des créations à l'aide de cadres SafeFrame

Enregistre un écouteur qui vous permet de configurer et d'appeler une fonction JavaScript lorsqu'un événement GPT spécifique se produit sur la page. Les événements suivants sont acceptés:

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

Exemple

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

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

Voir aussi

• Écouteurs d'événements d'annonces

Obtenez la liste des créneaux horaires associés à ce service.