DocumentazioneExperience PlatformRaccolta dati

clickCollection

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

L'oggetto clickCollection contiene diverse variabili che consentono di controllare i dati di collegamento raccolti automaticamente. Utilizzare queste variabili quando si desidera includere o escludere tipi di collegamenti dalla raccolta dati. È supportato dal Web SDK versione 2.25.0 o successiva.

Questa variabile richiede tutti i seguenti elementi:

  • clickCollectionEnabled deve essere abilitato.
  • Se si utilizza clickCollection.filterClickDetails, il metodo obsoleto onBeforeLinkClickSend deve essere vuoto.
  • Il payload dell'evento deve contenere un valore in xdm.web.webPageDetails.name a un certo punto della visita del visitatore.

Se l’implementazione non soddisfa tutti i requisiti di cui sopra, questo oggetto non esegue alcuna operazione.

Nell'oggetto clickCollection sono disponibili le seguenti proprietà:

Proprietà
Tipo
Descrizione
internalLinkEnabled
boolean
Determina se tenere traccia automaticamente dei collegamenti all'interno del dominio corrente. Ad esempio, da https://example.com/index.html a https://example.com/product.html verrebbe considerato un collegamento interno.
downloadLinkEnabled
boolean
Determina se la libreria tiene traccia dei collegamenti qualificati come download in base alla proprietà downloadLinkQualifier.
externalLinkEnabled
boolean
Determina se tenere traccia automaticamente dei collegamenti ai domini esterni. Ad esempio, da https://example.com a https://example.net verrebbe considerato un collegamento esterno.
eventGroupingEnabled
boolean

Determina se la libreria attende il successivo evento "visualizzazione pagina" per inviare i dati di tracciamento dei collegamenti. La libreria considera un evento come 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

Al caricamento dell’evento "visualizzazione pagina", la libreria combina i dati di tracciamento dei collegamenti memorizzati con il resto dei dati di quell’evento. L’abilitazione di questa opzione riduce il numero totale di eventi inviati ad Adobe. Se internalLinkEnabled è disabilitato, questa variabile non esegue alcuna operazione.

sessionStorageEnabled
boolean
Determina se i dati di tracciamento dei collegamenti vengono memorizzati nell'archiviazione della sessione anziché nelle variabili locali. Se internalLinkEnabled o eventGroupingEnabled sono disabilitati, questa variabile non esegue alcuna operazione.
Adobe consiglia vivamente di abilitare questa variabile quando si utilizza eventGroupingEnabled al di fuori delle applicazioni a pagina singola. Se eventGroupingEnabled è abilitato mentre sessionStorageEnabled è disabilitato, facendo clic su una nuova pagina si verifica la perdita dei dati di tracciamento dei collegamenti, in quanto non vengono conservati nell'archiviazione della sessione. Poiché le applicazioni a pagina singola in genere non passano a una nuova pagina, l’archiviazione della sessione non è necessaria per le pagine di applicazioni a pagina singola.
filterClickDetails
function
Funzione di callback che fornisce controlli completi sui dati di tracciamento dei collegamenti raccolti. Puoi utilizzare questa funzione di callback per modificare, offuscare o interrompere l’invio dei dati di tracciamento dei collegamenti. Questo callback è utile quando si desidera omettere informazioni specifiche, ad esempio informazioni personali identificabili all'interno di collegamenti.

Se non si imposta questo oggetto nel comando configure, le impostazioni predefinite per questo oggetto dipendono dal valore di clickCollectionEnabled:

  • internalLinkEnabled: corrisponde a clickCollectionEnabled
  • downloadLinkEnabled: corrisponde a clickCollectionEnabled
  • externalLinkEnabled: corrisponde a clickCollectionEnabled
  • eventGroupingEnabled: impostazione predefinita false; deve essere abilitata in modo esplicito
  • sessionStorageEnabled: impostazione predefinita false; deve essere abilitata in modo esplicito
  • filterClickDetails: non contiene una funzione; deve essere registrato in modo esplicito
TIP
Adobe consiglia di abilitare eventGroupingEnabled quando internalLinkEnabled è abilitato, in quanto riduce il numero di eventi che vengono conteggiati ai fini dell'utilizzo contrattuale.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: true,
  clickCollection: {
    internalLinkEnabled: true,
    downloadLinkEnabled: true,
    externalLinkEnabled: true,
    eventGroupingEnabled: true,
    sessionStorageEnabled: true,
    filterClickDetails: function(content) {
      // If the link is a clickable telephone number, anonymize it
      if(content.linkUrl?.includes("tel:")) {
        content.linkName = content.linkUrl = "Phone number";
      }
      // If the link is an email address, anonymize it
      if(content.linkUrl?.includes("mailto:")) {
        content.linkName = content.linkUrl = "Email address";
      }
    }
  }
});

Configurare la raccolta di clic per l'estensione tag Web SDK

Queste impostazioni possono essere configurate nell'estensione tag Web SDK utilizzando Impostazioni di configurazione raccolta dati.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1