Documentazione Experience Platform Raccolta dati

`advertising` (Web SDK) advertising

Ultimo aggiornamento: 6 novembre 2026

Creato per:

Intermedio
Sviluppatore

L’oggetto advertising configura l’integrazione Web SDK con Adobe Advertising. Web SDK utilizza queste impostazioni per misurare le conversioni di click-through e view-through e per aggiungere ID pubblicitari agli eventi.

Conversioni click-through: nessuna configurazione richiesta. Quando un visitatore arriva su una pagina con un parametro della stringa di query s_kwcid o ef_id, Web SDK registra una conversione click-through.
Conversioni view-through: è necessario almeno un inserzionista abilitato in advertiserSettings. Web SDK raccoglie gli ID pubblicitari disponibili e invia conversioni view-through per tali inserzionisti.

Il Web SDK non elabora le conversioni pubblicitarie o non imposta i cookie pubblicitari fino a quando il visitatore non dà il consenso. Il componente Advertising è incluso nella libreria standard di Web SDK. Se crei una build personalizzata, includi il componente Advertising.

Proprietà properties

Proprietà

Tipo

Predefinito

Descrizione

enabled

Booleano

true

Attiva o disattiva Adobe Advertising in fase di runtime. Vedi Disattivare Advertising in fase di esecuzione. Disponibile in Web SDK versione 2.37.0 o successiva.

dspEnabled

Booleano

false

Impostare su true se si utilizza Adobe Advertising Demand-side Platform (DSP). Quando true, le conversioni view-through includono ID5 e ID universali RampID se si impostano id5PartnerId o rampIdJSPath.

advertiserSettings

Array di oggetti

Gli inserzionisti per i quali misurare le conversioni view-through. Ogni oggetto contiene una stringa advertiserId e un valore booleano enabled ed entrambi sono obbligatori. Web SDK utilizza solo gli inserzionisti con enabled impostato su true.

id5PartnerId

Stringa

ID del partner ID5 della tua organizzazione. Questa impostazione consente a Web SDK di raccogliere gli ID universali ID5.

rampIdJSPath

Stringa

Percorso del codice JavaScript LiveRamp RampID della tua organizzazione (ats.js). Questa impostazione consente a Web SDK di raccogliere RampID ID universali.

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

Disattiva Advertising in fase di runtime enabled

Imposta advertising.enabled su false per disattivare Adobe Advertising senza rimuovere il componente Advertising dalla libreria. Quando enabled è false, Web SDK:

Non invia conversioni click-through o view-through.
Non aggiunge ID pubblicitari agli eventi, anche quando un comando sendEvent imposta handleAdvertisingData su "auto" o "wait".
Non effettua chiamate ID surfista, ID5 o RampID, quindi non vengono caricati script pubblicitari o iframe.
Non legge o scrive cookie pubblicitari. I cookie pubblicitari esistenti vengono lasciati invariati.

Web SDK ignora le altre proprietà nell’oggetto advertising mentre enabled è false.

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

La proprietà enabled accetta solo valori booleani. Altri valori, ad esempio le stringhe "true" o "false", causano errori nel comando configure.

Utilizza questa proprietà quando vuoi disattivare Advertising senza ricostruire la libreria, oppure per attivarlo o disattivarlo in modo condizionale, ad esempio per pagine specifiche. Per rimuovere completamente il codice Advertising dalla libreria, escludi invece il componente Advertising da una build personalizzata.

Aggiungere ID pubblicitari agli eventi handle-advertising-data

Per impostazione predefinita, Web SDK non aggiunge ID pubblicitari agli eventi inviati con sendEvent. Per aggiungerli, impostare advertising.handleAdvertisingData nel comando sendEvent su uno dei seguenti valori:

"disabled": valore predefinito. Web SDK non aggiunge ID pubblicitari all’evento.
"auto": Web SDK aggiunge ID pubblicitari già raccolti, ad esempio ID di conversioni precedenti.
"wait": Web SDK tenta inoltre di raccogliere ID pubblicitari non ancora disponibili e li attende brevemente prima di inviare l’evento.

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

Web SDK aggiunge ID pubblicitari a un evento solo quando il visitatore ha dato il consenso, almeno un inserzionista è abilitato in advertiserSettings e l’URL della pagina non contiene parametri di click-through.

Configurare Advertising utilizzando l’estensione tag Web SDK tag-extension

Queste impostazioni possono essere configurate nell’estensione tag Web SDK utilizzando impostazioni Adobe Advertising.

recommendation-more-help

experience-platform-help-collection

advertising (Web SDK) advertising