Raccolta dati di Content Analytics
Questo articolo spiega nei dettagli come Content Analytics raccoglie i dati
Definizioni
Nel contesto del presente articolo sono utilizzate le definizioni seguenti:
-
Esperienza:
- Per il canale web, per esperienza si intende il contenuto di testo di un’intera pagina Web. Per la raccolta dati, Content Analytics registra l’Experience ID che si basa sull’URL della pagina. Successivamente, il testo sulla pagina viene acquisito tramite il servizio di recupero.
- Per il canale mobile, viene definita e tracciata un’esperienza nell’app mobile tramite l’estensione Content Analytics per Adobe Experience Platform Mobile SDK.
-
ID esperienza:
-
Per il canale web, l’ID esperienza è una combinazione univoca di URL rilevanti (URL di base più eventuali parametri che determinano il contenuto della pagina) e versione esperienza.
- Specifica, come parte della configurazione, quali parametri sono rilevanti per ogni URL completo specificato.
- Puoi definire un identificatore di versione da utilizzare, in modo da raccogliere correttamente le modifiche apportate alle esperienze.
-
Per il canale mobile, l’ID esperienza è il valore restituito dall’utilizzo della chiamata API
registerExperience.
-
-
Risorsa: un’immagine. Content Analytics registra l’URL della risorsa.
-
ID risorsa: l’URL della risorsa.
-
URL pertinente: l’URL di base più eventuali parametri che determinano il contenuto della pagina.
Funzionalità
Content Analytics richiede Experience Platform Edge Network Web SDK (per il canale web) e Experience Platform Edge Network Mobile SDK (per il canale mobile) per raccogliere i dati dell’evento contenuto. Questi dati evento vengono combinati con i dati comportamentali esistenti utilizzando Experience Platform Edge Network (Web SDK, Mobile SDK o Server API) o un connettore di origine Analytics, come Adobe AppMeasurement.
La libreria Content Analytics raccoglie dati quando:
- Content Analytics è incluso nella libreria Tag caricata nella pagina o utilizzata all’interno dell’app mobile.
- L’URL della pagina e l’URL della risorsa sono configurati nell’estensione Web Content Analytics, parte della libreria Tag inclusa.
- L’URL della risorsa, il percorso della risorsa o il percorso dell’esperienza non sono esclusi nell’estensione Content Analytics mobile.
Evento di Content Analytics
Questa sezione descrive le specifiche per gli eventi Web Content Analytics. Consulta Tracciamento dell’esperienza per informazioni dettagliate sugli eventi di Mobile Content Analytics.
Un evento di Content Analytics è costituito da:
-
Campi standard
- Marca temporale
- Identità
-
Visualizzazioni esperienza (se presenti e se configurate)
-
Clic sull’esperienza (se presenti e se configurati)
-
Visualizzazioni risorse (se presenti e se configurate)
-
Clic sulla risorsa (se presenti e se configurati)
Gli eventi di Content Analytics vengono raccolti come sequenza di:
Content Analytics raccoglie i dati in questo modo per riflettere tale sequenza, invece di raccogliere visualizzazioni o clic separatamente rispetto alla raccolta dell’evento immediatamente successivo alla visualizzazione o clic. Questo modo di raccogliere i dati di Content Analytics riduce anche la quantità di dati raccolti.
Visualizzazione o clic registrato
Una visualizzazione della risorsa viene registrata quando:
- La risorsa non è stata esclusa in base alla configurazione dell’estensione Content Analytics.
- La risorsa è visualizzata al 75%.
- La risorsa non è già stata registrata per questa pagina.
Un clic sulla risorsa viene registrato quando:
- La risorsa è stata visualizzata.
- La risorsa non è stata esclusa in base alla configurazione dell’estensione Content Analytics.
- Un clic diretto sulla risorsa, che è un collegamento, porta a un’altra pagina.
Una visualizzazione dell’esperienza viene visualizzata quando:
- Le esperienze sono abilitate nella configurazione di Content Analytics.
Un clic sull’esperienza viene registrato quando:
- Qualsiasi clic su un collegamento abilitato attiva un’esperienza.
Trigger per inviare un evento Content Analytics
Per ridurre il numero di richieste di rete inviate dalla pagina, Content Analytics raccoglie le informazioni ma non le invia immediatamente. Le informazioni relative all’interazione con i contenuti vengono raccolte e un evento contenente tali informazioni viene inviato solo quando si verifica uno dei seguenti trigger:
-
Web SDK o Adobe AppMeasurement inviano un evento.
-
La visibilità viene cambiata in nascosta, ad esempio:
- Scaricamenti della pagina
- Passaggio a un’altra scheda
- Riduzione a icona del browser
- Chiusura del browser
- Blocco dello schermo
-
Cambio dell’URL che determina la modifica dell’URL pertinente.
-
Le visualizzazioni delle risorse registrate e pronte per l’invio superano 32.
Identità
Questa sezione spiega come Content Analytics gestisce le identità.
Web
Content Analytics gestisce le identità per il canale web nel modo seguente:
- ECID viene popolato automaticamente nella porzione
identityMapdello schema Content Analytics. - Se sono necessari altri valori di identità in
identityMap, è necessario impostare questi valori nel callbackonBeforeEventSendall’interno dell’estensione Web SDK. - L’unione identità basata sui campi non è supportata perché lo schema è di proprietà del sistema. Pertanto, non è possibile aggiungere un altro campo allo schema per supportare l’unione identità basata sui campi
Per garantire che i dati di identità di Content Analytics e i dati di identità di SDK Web siano uniti correttamente a livello di campo, modificare il callback su Web SDK prima dell’invio dell’evento.
-
Passa alla proprietà Tags contenente l’estensione Adobe Experience Platform Web SDK e l’estensione Adobe Content Analytics.
-
Seleziona
Estensioni. -
Selezionare l’estensione Adobe Experience Platform Web SDK.
-
Seleziona Configura.
-
Nella sezione Istanze di SDK, scorri verso il basso fino a Raccolta dati - Attiva prima del callback di invio dell’evento.
-
Selezionare </> Fornisci il prima del codice callback di invio evento.
-
Aggiungi il seguente codice:
code language-javascript window.adobeContentAnalytics?.forwardEvent(content); content.xdm.identityMap = _satellite.getVar('identityMap'); if ((content.xdm.eventType === "content.contentEngagement") && (_satellite.getVar('identityMap') != null)) { return true; }
-
Seleziona Salva per salvare il codice.
-
Seleziona Salva per salvare l’estensione.
-
Pubblica gli aggiornamenti per la proprietà Tag.
Mobile
Per ulteriori informazioni su come utilizzare le identità nell’app mobile, consulta l’estensione Identità per il servizio Experience Cloud ID e l’estensione Identità per Edge Network mobile.
Non appena l’identità cambia nell’app mobile, il batch corrente dei dati di Content Analytics viene reimpostato per avviare una nuova raccolta di dati di Content Analytics per la nuova identità.
Schemi
Experience Platform raccoglie i dati di Content Analytics in set di dati basati su schemi Content Analytics specifici. Gli schemi di riferimento sono disponibili pubblicamente: