DocumentazioneExperience PlatformTag

Impostazioni di configurazione della raccolta dati data-collection

Last update: Fri Feb 13 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Questa sezione di configurazione consente di determinare come vengono raccolti i dati nell’estensione.

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
  2. Passa a Data Collection > Tags.
  3. Seleziona la proprietà tag desiderata.
  4. Passa a Extensions, quindi seleziona Configure nella scheda Adobe Experience Platform Web SDK.
  5. Scorri verso il basso fino alla sezione Data collection.

Immagine che mostra le impostazioni di raccolta dati dellestensione tag Web SDK nellinterfaccia utente Tag.

Sono disponibili le seguenti opzioni:

On before event send callback

Funzione di callback per valutare e modificare il payload inviato ad Adobe. Nell’editor di codice puoi accedere alle seguenti variabili:

  • content.xdm: payload XDM per l'evento.
  • content.data: payload dell'oggetto dati per l'evento.
  • return true: uscire immediatamente dal callback e inviare dati ad Adobe con i valori correnti nell'oggetto content.
  • return false: uscire immediatamente dal callback e interrompere l'invio di dati ad Adobe.

È possibile utilizzare qualsiasi variabile definita al di fuori di content, ma non è inclusa nel payload inviato ad Adobe.

WARNING
Questo callback consente l’utilizzo di codice personalizzato. Se un codice incluso nel callback genera un'eccezione non rilevata, l'elaborazione per l'evento si interrompe. Dati non inviati ad Adobe.
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};

// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";

// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();

// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;

// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
  return true;
}

// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
  return false;
}
TIP
Evita di restituire false nel primo evento di una pagina. La restituzione di false sul primo evento può avere un impatto negativo sulla personalizzazione.

Questo callback è l'equivalente del tag onBeforeEventSend nella libreria JavaScript.

Una casella di controllo che abilita la raccolta di dati di tracciamento dei collegamenti interni al sito o alla proprietà. Questa casella di controllo è l'equivalente del tag clickCollection.internalLinkEnabled nella libreria JavaScript. Quando si attiva questa casella di controllo, vengono visualizzate le opzioni di raggruppamento degli eventi:

  • No event grouping: i dati di tracciamento dei collegamenti vengono inviati ad Adobe in eventi separati. I clic sui collegamenti inviati in eventi separati possono aumentare l’utilizzo contrattuale dei dati inviati a Adobe Experience Platform.
  • Event grouping using session storage: archivia i dati di tracciamento dei collegamenti nell'archivio della sessione fino al prossimo evento "visualizzazione pagina". Al successivo evento considerato come "visualizzazione pagina", i dati di tracciamento dei collegamenti memorizzati vengono uniti al payload dell’evento "visualizzazione pagina". Adobe consiglia di abilitare questa impostazione durante il tracciamento dei collegamenti interni.
  • Event grouping using local object: archivia i dati di tracciamento dei collegamenti in un oggetto locale fino al successivo evento "visualizzazione pagina". Se un visitatore passa a una nuova pagina del browser, i dati di tracciamento dei collegamenti andranno persi. Questa impostazione è particolarmente utile nel contesto delle applicazioni a pagina singola.

La libreria di tag considera un dato evento una "visualizzazione pagina" quando i seguenti elementi sono inclusi nel payload:

  • xdm.web.webPageDetails.name contiene un valore stringa
  • xdm.web.webPageDetails.pageViews.value è maggiore di 0

Casella di controllo che abilita la raccolta di collegamenti esterni. Questa casella di controllo è l'equivalente del tag clickCollection.externalLinkEnabled nella libreria JavaScript.

Casella di controllo che abilita la raccolta di collegamenti di download. Questa casella di controllo è l'equivalente del tag clickCollection.downloadLinkEnabled nella libreria JavaScript.

Un’espressione regolare che qualifica un URL di collegamento come collegamento di download. Questa stringa è l'equivalente del tag downloadLinkQualifier nella libreria JavaScript.

Filter click properties

Funzione di callback per valutare e modificare le proprietà relative ai clic prima della raccolta. Questa funzione viene eseguita prima di On before event send callback ed è l'equivalente tag di clickCollection.filterClickDetails nella libreria JavaScript. Nell’editor di codice puoi accedere alle seguenti variabili:

  • content.clickedElement: elemento DOM su cui è stato fatto clic.
  • content.pageName: nome della pagina quando si è verificato il clic.
  • content.linkName: nome del collegamento su cui è stato fatto clic.
  • content.linkRegion: area del collegamento su cui è stato fatto clic.
  • content.linkType: tipo di collegamento (uscita, download o altro).
  • content.linkURL: URL di destinazione del collegamento su cui è stato fatto clic.
  • return true: uscire immediatamente dal callback con i valori della variabile corrente.
  • return false: uscire immediatamente dal callback e interrompere la raccolta dei dati.
  • È possibile utilizzare qualsiasi variabile definita al di fuori di content, ma non è inclusa nel payload inviato ad Adobe.
TIP
Il campo On before link click send è un callback obsoleto visibile solo per le proprietà per le quali è già configurato. Equivale al tag onBeforeLinkClickSend nella libreria JavaScript. Utilizza il callback Filter click properties per filtrare o regolare i dati di clic, oppure utilizza On before event send callback per filtrare o regolare il payload complessivo inviato ad Adobe. Se sono impostati sia il callback Filter click properties che il callback On before link click send, verrà eseguito solo il callback Filter click properties.

Impostazioni di contesto

Raccogli automaticamente le informazioni sui visitatori, compilando specifici campi XDM. È possibile scegliere All default context information o Specific context information. Equivale al tag context nella libreria JavaScript.

  • Web: raccoglie informazioni sulla pagina corrente.
  • Device: raccoglie informazioni sul dispositivo dell'utente.
  • Environment: raccoglie informazioni sul browser dell'utente.
  • Place context: raccoglie informazioni sulla posizione dell'utente.
  • High entropy user-agent hints: raccoglie informazioni più dettagliate sul dispositivo dell'utente.
  • Send referrer to Adobe Analytics only once per page view: impedisce l'invio ad Adobe Analytics di dati di riferimento duplicati.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743