DocumentazioneExperience PlatformGuida di SDK Web

clickCollection

Last update: Thu Jul 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Il clickCollection L'oggetto 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.

Richiede clickCollectionEnabled da attivare.

È supportato dall’SDK web 2.25.0 o versione successiva.

Le seguenti variabili sono disponibili nel clickCollection oggetto:

  • clickCollection.internalLinkEnabled: valore booleano che determina se i collegamenti all’interno del dominio corrente vengono tracciati automaticamente. Ad esempio: https://example.com/index.html a https://example.com/product.html.

  • clickCollection.downloadLinkEnabled: valore booleano che determina se la libreria tiene traccia dei collegamenti idonei come download in base al downloadLinkQualifier proprietà.

  • clickCollection.externalLinkEnabled: valore booleano che determina se i collegamenti a domini esterni vengono tracciati automaticamente. Ad esempio: https://example.com a https://example.net.

  • clickCollection.eventGroupingEnabled: valore booleano che determina se la libreria attende la pagina successiva per inviare i dati di tracciamento dei collegamenti. Al caricamento della pagina successiva, combina i dati di tracciamento dei collegamenti con l’evento di caricamento della pagina. L’abilitazione di questa opzione riduce il numero di eventi inviati all’Adobe. Se internalLinkEnabled è disattivato, quindi questa variabile non esegue alcuna operazione.

  • clickCollection.sessionStorageEnabled: valore booleano che determina se i dati di tracciamento dei collegamenti vengono memorizzati nell’archiviazione della sessione anziché nelle variabili locali. Se internalLinkEnabled o eventGroupingEnabled sono disattivati, quindi questa variabile non esegue alcuna operazione.

    L’Adobe consiglia vivamente di abilitare questa variabile quando si utilizza eventGroupingEnabled. Se eventGroupingEnabled è abilitato durante sessionStorageEnabled è disattivato, 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. Mentre è accettabile disabilitare sessionStorageEnabled nelle applicazioni a pagina singola, non è ideale per le pagine non SPA.

  • filterClickDetails: 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.

Fai clic sulle impostazioni della raccolta utilizzando l’estensione tag Web SDK

Seleziona la Abilita raccolta dati di clic casella di controllo configurazione dell’estensione tag. L’attivazione di questa casella di controllo mostra le seguenti opzioni relative alla raccolta di clic:

  • Collegamenti interni

    • Abilita raggruppamento eventi
    • Abilita archiviazione sessione

  • Collegamenti esterni

  • Collegamenti di download

  • Proprietà clic filtro

  1. Accedi a experience.adobe.com utilizzando le credenziali di Adobe ID.
  2. Accedi a Raccolta dati > Tag.
  3. Seleziona la proprietà tag desiderata.
  4. Accedi a Estensioni, quindi fai clic su Configura il Adobe Experience Platform Web SDK Card.
  5. Scorri verso il basso fino a Raccolta dati , quindi selezionare la casella di controllo Abilita raccolta dati di clic.
  6. Seleziona le impostazioni desiderate per la raccolta di clic.
  7. Clic Salva, quindi pubblica le modifiche.

Il Proprietà clic filtro callback apre un editor di codice personalizzato che consente di inserire il codice desiderato. Nell’editor di codice puoi accedere alle seguenti variabili:

  • content.clickedElement: elemento DOM su cui è stato fatto clic.
  • content.pageName: nome della pagina al momento del clic.
  • content.linkName: nome del collegamento su cui è stato fatto clic.
  • content.linkRegion: area del collegamento in cui è stato fatto clic.
  • content.linkType: tipo di collegamento (uscita, download o altro).
  • content.linkURL: URL di destinazione del collegamento su cui è stato fatto clic.
  • return true: chiude immediatamente il callback con i valori della variabile corrente.
  • return false: chiudi immediatamente il callback e interrompi la raccolta dei dati.

Qualsiasi variabile definita al di fuori di content possono essere utilizzati, ma non sono inclusi nel payload inviato ad Adobe.

Fai clic sulle impostazioni della raccolta utilizzando la libreria JavaScript dell’SDK per web

Imposta le variabili desiderate all'interno di clickCollection oggetto durante l'esecuzione di configure comando. Se non viene impostata, le impostazioni predefinite per questo oggetto dipendono dal valore di clickCollectionEnabled.

  • internalLinkEnabled: corrisponde a clickCollectionEnabled
  • downloadLinkEnabled: corrisponde a clickCollectionEnabled
  • externalLinkEnabled: corrisponde a clickCollectionEnabled
  • eventGroupingEnabled: valore predefinito false; deve essere abilitato in modo esplicito
  • sessionStorageEnabled: valore predefinito false; deve essere abilitato in modo esplicito
  • filterClickDetails: non contiene una funzione; deve essere registrato in modo esplicito
TIP
L’Adobe consiglia di abilitare eventGroupingEnabled, in quanto consente di ridurre il numero di eventi che vengono conteggiati ai fini dell’utilizzo contrattuale.
alloy("configure", {
  edgeConfigId: "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";
      }
    }
  }
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636