DocumentazioneExperience PlatformGuida di SDK Web

clickCollectionEnabled

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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.

Logica di tracciamento automatico dei collegamenti

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

Selezionare la casella di controllo Abilita raccolta dati su clic durante la configurazione dell'estensione tag.

  1. Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
  2. Passa a Raccolta dati > Tag.
  3. Seleziona la proprietà tag desiderata.
  4. Passa a Estensioni, quindi fai clic su Configura nella scheda Adobe Experience Platform Web SDK.
  5. Scorri verso il basso fino alla sezione Raccolta dati, quindi seleziona la casella di controllo Abilita raccolta dati su clic.
  6. Fai clic su Salva, quindi pubblica le modifiche.

Abilitare il tracciamento automatico dei collegamenti utilizzando la libreria JavaScript dell’SDK per web library

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

alloy(configure, {
  edgeConfigId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636