clickCollectionEnabled

Ultimo aggiornamento: 21 maggio 2025
  • Argomenti:

Creato per:

  • Sviluppatore

La proprietà clickCollectionEnabled è un valore booleano che determina se Web SDK raccoglie automaticamente i dati di collegamento. Se non si imposta questa variabile, il suo valore predefinito è true, il che significa che i dati di tracciamento dei collegamenti vengono raccolti automaticamente per impostazione predefinita. L'impostazione di questa proprietà su false è utile nei casi in cui si preferisce tenere traccia manualmente dei dati di collegamento.

Quando clickCollectionEnabled è abilitato, i seguenti elementi XDM vengono compilati automaticamente con i dati:

  • xdm.web.webInteraction.name
  • xdm.web.webInteraction.type
  • xdm.web.webInteraction.URL

I collegamenti interni, i collegamenti di download e i collegamenti di uscita vengono tracciati automaticamente per impostazione predefinita quando questo valore booleano è abilitato. Se desideri un maggiore controllo sul tracciamento automatico dei collegamenti, Adobe consiglia di utilizzare l'oggetto clickCollection.

Supporto per Shadow DOM elementi aperti

Il Web SDK supporta il tracciamento automatico dei clic per i collegamenti all'interno di elementi DOM shadow aperti.

Molti siti Web moderni utilizzano Componenti Web per creare elementi riutilizzabili e incapsulati dell'interfaccia utente. Questi componenti utilizzano spesso una tecnologia denominata Shadow DOM per mantenere la struttura interna e gli stili separati dal resto della pagina.

Esistono due tipi di DOM ombra:

  • Open Shadow DOM: La struttura interna è accessibile a JavaScript in esecuzione sulla pagina. Questo significa che altri script possono interagire con il contenuto del componente o esaminarlo.
  • DOM shadow chiuso: La struttura interna è nascosta da JavaScript all'esterno del componente, rendendolo inaccessibile per il tracciamento o la manipolazione.

Web SDK tiene traccia automaticamente dei clic sugli elementi <a> e <area> all'interno di DOM shadow aperti, come avviene per i collegamenti nel documento principale. In questo modo i clic sui collegamenti all'interno dei componenti Web che utilizzano Shadow DOM aperti verranno inclusi nei dati di analisi. I clic all'interno di DOM shadow chiusi non vengono tracciati, in quanto la struttura interna è nascosta dal codice JavaScript che opera all'esterno del componente.

Logica di tracciamento automatico dei collegamenti

Il Web SDK tiene traccia di tutti i clic sugli elementi HTML <a> e <area> se non dispone di un attributo onClick. I clic vengono acquisiti con un listener di eventi di clic capture allegato al documento. Quando si fa clic su un collegamento valido, viene eseguita la logica seguente in ordine:

  1. Se il collegamento corrisponde ai criteri basati sui valori in downloadLinkQualifier o se contiene un attributo HTML download, xdm.web.webInteraction.type è impostato su "download" (se clickCollection.downloadLinkEnabled è abilitato).
  2. Se il dominio di destinazione del collegamento è diverso dal window.location.hostname corrente, xdm.web.webInteraction.type è impostato su "exit" (se clickCollection.exitLinkEnabled è abilitato).
  3. Se il collegamento non è idoneo per "download" o "exit", xdm.web.webInteraction.type è impostato su "other".

In tutti i casi, xdm.web.webInteraction.name è impostato sull'etichetta di testo del collegamento e xdm.web.webInteraction.URL è impostato sull'URL di destinazione del collegamento. Se desideri impostare anche il nome del collegamento sull'URL, puoi sovrascrivere questo campo XDM utilizzando il callback filterClickDetails nell'oggetto clickCollection.

Abilitare il tracciamento automatico dei collegamenti tramite l’estensione tag Web SDK

Questa variabile viene gestita automaticamente dall’estensione tag; non è necessario impostarla esplicitamente. Se durante la configurazione dell'estensione tag viene selezionato uno dei seguenti elementi, vengono raccolti i dati di tracciamento dei collegamenti applicabili:

  • Raccogliere i clic sul collegamento interno
  • Raccogli i clic sul collegamento esterno
  • Raccogli clic sul collegamento di download

Per ulteriori informazioni, vedere clickCollection.