clickCollectionEnabled

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:

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:

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:

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 tag-extension

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:

Per ulteriori informazioni, vedere clickCollection.

Abilitare il tracciamento automatico dei collegamenti utilizzando la libreria JavaScript di Web SDK library

Impostare il valore booleano clickCollectionEnabled durante l'esecuzione del comando configure. Se si omette questa proprietà durante la configurazione del Web SDK, per impostazione predefinita viene utilizzato true. Impostare questo valore su false se si preferisce impostare xdm.web.webInteraction.type e xdm.web.webInteraction.value manualmente.

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