Documentation Experience Platform Collecte de données

`advertising` (Web SDK) advertising

Dernière mise à jour : 6 novembre 2026

Créé pour :

Intermédiaire
Développeur

L’objet advertising configure l’intégration de Web SDK à Adobe Advertising. Web SDK utilise ces paramètres pour mesurer les conversions de clics publicitaires et d’affichages publicitaires, et pour ajouter des identifiants publicitaires aux événements.

Conversions de clics publicitaires : aucune configuration n’est requise. Lorsqu’un visiteur arrive sur une page avec un paramètre de chaîne de requête s_kwcid ou ef_id, Web SDK enregistre une conversion par clic publicitaire.
Conversions d’affichage publicitaire : nécessite au moins un annonceur activé dans advertiserSettings. Web SDK collecte les identifiants publicitaires disponibles et envoie les conversions d’affichage publicitaire à ces annonceurs.

Web SDK ne traite pas les conversions publicitaires et ne définit pas les cookies publicitaires tant que le visiteur n’a pas donné son consentement. Le composant Advertising est inclus dans la bibliothèque SDK Web standard. Si vous créez une version personnalisée, incluez le composant Advertising.

Propriétés properties

Propriété

Type

Par défaut

Description

enabled

Booléen

true

Active ou désactive Adobe Advertising à l’exécution. Voir Désactiver Advertising au moment de l’exécution. Disponible dans Web SDK version 2.37.0 ou ultérieure.

dspEnabled

Booléen

false

Définissez cette variable sur true si vous utilisez Adobe Advertising Demand-side Platform (DSP). Lorsqu’elles sont true, les conversions d’affichage publicitaire incluent les ID universels ID5 et RampID si vous définissez id5PartnerId ou rampIdJSPath.

advertiserSettings

Tableau d’objets

Publicitaires pour lesquels mesurer les conversions d’affichage publicitaire. Chaque objet contient une chaîne advertiserId et une valeur booléenne enabled, qui sont toutes deux obligatoires. Web SDK utilise uniquement les annonceurs dont le enabled est défini sur true.

id5PartnerId

Chaîne

Identifiant partenaire ID5 de votre organisation. Ce paramètre permet à Web SDK de collecter les identifiants universels ID5.

rampIdJSPath

Chaîne

Chemin d’accès au code JavaScript LiveRamp RampID de votre organisation (ats.js). Ce paramètre permet à Web SDK de collecter les identifiants universels RampID.

Exemple example

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  advertising: {
    dspEnabled: true,
    advertiserSettings: [
      { advertiserId: "12345", enabled: true },
      { advertiserId: "67890", enabled: false }
    ],
    id5PartnerId: "1234",
    rampIdJSPath: "https://example.com/ats.js"
  }
});

Désactiver Advertising au moment de l’exécution enabled

Définissez advertising.enabled sur false pour désactiver Adobe Advertising sans supprimer le composant Advertising de votre bibliothèque. Lorsque enabled est false, Web SDK :

N’envoie aucune conversion de clic publicitaire ou de vue publicitaire.
N’ajoute aucun identifiant publicitaire aux événements, même lorsqu’une commande sendEvent définit handleAdvertisingData sur "auto" ou "wait".
n’effectue aucun appel Surfer ID, ID5 ou RampID, de sorte qu’aucun script publicitaire ni iframe n’est chargé ;
Ne lit ni n’écrit de cookies publicitaires. Les cookies publicitaires existants restent inchangés.

Web SDK ignore les autres propriétés de l’objet advertising lorsqu’enabled est false.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  advertising: {
    enabled: false
  }
});

La propriété enabled accepte uniquement les valeurs booléennes. D’autres valeurs, telles que les chaînes "true" ou "false", entraînent l’échec de la commande configure.

Utilisez cette propriété lorsque vous souhaitez désactiver Advertising sans recréer votre bibliothèque ou pour l’activer ou le désactiver de manière conditionnelle, par exemple pour des pages spécifiques. Pour supprimer entièrement le code Advertising de votre bibliothèque, excluez plutôt le composant Advertising d’une version personnalisée.

Ajout d’identifiants publicitaires aux événements handle-advertising-data

Par défaut, Web SDK n’ajoute pas d’identifiants publicitaires aux événements que vous envoyez à l’aide de sendEvent. Pour les ajouter, définissez advertising.handleAdvertisingData dans la commande sendEvent sur l’une des valeurs suivantes :

"disabled" : valeur par défaut. Web SDK n’ajoute pas d’ID de publicité à l’événement.
"auto" : Web SDK ajoute les identifiants publicitaires qu’il a déjà collectés, tels que les identifiants des conversions précédentes.
"wait" : Web SDK tente également de collecter les identifiants publicitaires qui ne sont pas encore disponibles et les attend brièvement avant d’envoyer l’événement.

alloy("sendEvent", {
  xdm: {
    eventType: "web.webpagedetails.pageViews"
  },
  advertising: {
    handleAdvertisingData: "auto"
  }
});

Web SDK ajoute des identifiants publicitaires à un événement uniquement lorsque le visiteur a donné son consentement, qu’au moins un annonceur est activé dans advertiserSettings et que l’URL de la page ne contient pas de paramètres de clic publicitaire.

Configuration d’Advertising à l’aide de l’extension de balise Web SDK tag-extension

Ces paramètres peuvent être configurés dans l’extension de balise Web SDK à l’aide des paramètres d’Adobe Advertising 🔗.

recommendation-more-help

experience-platform-help-collection

advertising (Web SDK) advertising