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:
xdm.web.webInteraction.namexdm.web.webInteraction.typexdm.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.
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:
- Se il collegamento corrisponde ai criteri basati sui valori in
downloadLinkQualifiero se contiene un attributo HTMLdownload,xdm.web.webInteraction.typeè impostato su"download"(seclickCollection.downloadLinkEnabledè abilitato). - Se il dominio di destinazione del collegamento è diverso dal
window.location.hostnamecorrente,xdm.web.webInteraction.typeè impostato su"exit"(seclickCollection.exitLinkEnabledè abilitato). - 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.
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
});
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. Altri script possono interagire con il componente o esaminarne il contenuto.
- 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. Questo monitoraggio assicura che i clic sui collegamenti all'interno dei componenti Web che utilizzano Shadow DOM aperti siano 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.
Attivare o disattivare la raccolta di clic per l'estensione tag Web SDK
Per informazioni su come eseguire queste azioni utilizzando i tag, vedere Impostazioni di configurazione della raccolta dati nella documentazione dell'estensione Web SDK.