Impostazioni di configurazione della raccolta dati data-collection
Questa sezione di configurazione consente di determinare come vengono raccolti i dati nell’estensione.
- Accedi a CX Enterprise utilizzando le credenziali Adobe ID.
- Passa a Raccolta dati > Tag.
- Seleziona la proprietà tag desiderata.
- Passa a Estensioni, quindi seleziona Configura nella scheda Adobe Experience Platform Web SDK.
- Scorri verso il basso fino alla sezione Raccolta dati.
Sono disponibili le seguenti opzioni:
Il prima del callback di invio dell’evento
Funzione di callback per valutare e modificare il payload inviato ad Adobe. Nell’editor di codice puoi accedere alle seguenti variabili:
content.xdm: payload XDM per l’evento.content.data: payload dell’oggetto dati per l’evento.return true: uscire immediatamente dal callback e inviare dati ad Adobe con i valori correnti nell’oggettocontent.return false: uscire immediatamente dal callback e interrompere l’invio di dati ad Adobe.
È possibile utilizzare qualsiasi variabile definita al di fuori di content, ma non è inclusa nel payload inviato ad Adobe.
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};
// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";
// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();
// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;
// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
return true;
}
// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
return false;
}
false nel primo evento di una pagina. La restituzione di false sul primo evento può avere un impatto negativo sulla personalizzazione.Questo callback è l’equivalente del tag onBeforeEventSend nella libreria JavaScript.
Raccogliere i clic sul collegamento interno
Una casella di controllo che abilita la raccolta di dati di tracciamento dei collegamenti interni al sito o alla proprietà. Questa casella di controllo è l’equivalente del tag clickCollection.internalLinkEnabled nella libreria JavaScript. Quando si attiva questa casella di controllo, vengono visualizzate le opzioni di raggruppamento degli eventi:
- Nessun raggruppamento di eventi: i dati di tracciamento dei collegamenti vengono inviati ad Adobe in eventi separati. I clic sui collegamenti inviati in eventi separati possono aumentare l’utilizzo contrattuale dei dati inviati a Adobe Experience Platform.
- Raggruppamento eventi tramite archiviazione sessione: archivia i dati di tracciamento dei collegamenti nell’archiviazione sessione fino al prossimo evento “visualizzazione pagina”. Al successivo evento considerato come “visualizzazione pagina”, i dati di tracciamento dei collegamenti memorizzati vengono uniti al payload dell’evento “visualizzazione pagina”. Adobe consiglia di abilitare questa impostazione durante il tracciamento dei collegamenti interni.
- Raggruppamento eventi tramite oggetto locale: memorizzare i dati di tracciamento dei collegamenti in un oggetto locale fino al successivo evento “visualizzazione pagina”. Se un visitatore passa a una nuova pagina del browser, i dati di tracciamento dei collegamenti andranno persi. Questa impostazione è particolarmente utile nel contesto delle applicazioni a pagina singola.
La libreria di tag considera un dato evento una “visualizzazione pagina” quando i seguenti elementi sono inclusi nel payload:
xdm.web.webPageDetails.namecontiene un valore stringaxdm.web.webPageDetails.pageViews.valueè maggiore di0
Raccogli i clic sul collegamento esterno
Casella di controllo che abilita la raccolta di collegamenti esterni. Questa casella di controllo è l’equivalente del tag clickCollection.externalLinkEnabled nella libreria JavaScript.
Raccogli clic sul collegamento di download
Casella di controllo che abilita la raccolta di collegamenti di download. Questa casella di controllo è l’equivalente del tag clickCollection.downloadLinkEnabled nella libreria JavaScript.
Qualificatore collegamento di download
Un’espressione regolare che qualifica un URL di collegamento come collegamento di download. Questa stringa è l’equivalente del tag downloadLinkQualifier nella libreria JavaScript.
Proprietà clic filtro
Funzione di callback per valutare e modificare le proprietà relative ai clic prima della raccolta. Questa funzione viene eseguita prima del callback di invio On prima dell’evento ed è l’equivalente del tag clickCollection.filterClickDetails nella libreria JavaScript. Nell’editor di codice puoi accedere alle seguenti variabili:
content.clickedElement: elemento DOM su cui è stato fatto clic.content.pageName: nome della pagina quando si è verificato il clic.content.linkName: nome del collegamento su cui è stato fatto clic.content.linkRegion: area del collegamento su 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: uscire immediatamente dal callback con i valori della variabile corrente.return false: uscire immediatamente dal callback e interrompere la raccolta dei dati.- È possibile utilizzare qualsiasi variabile definita al di fuori di
content, ma non è inclusa nel payload inviato ad Adobe.
onBeforeLinkClickSend nella libreria JavaScript. Utilizza il callback Proprietà clic filtro per filtrare o modificare i dati dei clic oppure utilizza il callback Attivato prima dell'invio dell'evento per filtrare o modificare il payload complessivo inviato ad Adobe. Se sono impostati sia il callback Proprietà clic filtro che il callback Attivato prima del clic collegamento invia, verrà eseguito solo il callback Proprietà clic filtro.Impostazioni di contesto
Raccogli automaticamente le informazioni sui visitatori, compilando specifici campi XDM. Puoi scegliere Tutte le informazioni di contesto predefinite o Informazioni di contesto specifiche. Equivale al tag context nella libreria JavaScript.
- Web: raccoglie informazioni sulla pagina corrente.
- Dispositivo: raccoglie informazioni sul dispositivo dell’utente.
- Ambiente: raccoglie informazioni sul browser dell’utente.
- Contesto del luogo: raccoglie informazioni sulla posizione dell’utente.
- Hint utente-agente entropici elevati: raccoglie informazioni più dettagliate sul dispositivo dell’utente.
- Invia il referente ad Adobe Analytics una sola volta per visualizzazione di pagina: impedisce l’invio ad Adobe Analytics di dati di referente duplicati.