DocumentazioneAnalyticsGuida all'implementazione

Inviare dati ad Adobe Analytics utilizzando la libreria JavaScript dell’SDK per web

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente
  • Amministratore

Questo percorso di implementazione comporta una nuova installazione di Web SDK utilizzando la libreria JavaScript di Web SDK. Altri percorsi di implementazione sono trattati in pagine separate:

  • Estensione tag Web SDK: nuova installazione di Web SDK tramite l'estensione tag Web SDK. Simile all’approccio per la libreria JavaScript dell’SDK web (questa pagina), tranne per il fatto che gestisci l’implementazione utilizzando i tag in Raccolta dati di Adobe Experience Platform. Richiede il gruppo di campi ExperienceEvent di Adobe Analytics, che include le variabili Analytics tipiche da includere nello schema XDM.
  • Estensione Analytics all'estensione Web SDK: adotta un approccio fluido e metodico per passare dall'estensione tag Adobe Analytics all'estensione tag Web SDK. Questo approccio elimina la necessità di utilizzare XDM fino a quando l’organizzazione non è pronta a utilizzare i servizi Adobe Experience Platform, come il Customer Journey Analytics. Utilizzare l'oggetto data invece dell'oggetto xdm per inviare dati ad Adobe.
  • AppMeasurement alla libreria JavaScript dell'SDK Web: un approccio fluido e metodico per la migrazione all'SDK Web, ma non utilizza i tag. È invece possibile rimuovere manualmente la raccolta dati di Adobe Analytics (AppMeasurement.js) e sostituirla con la raccolta JavaScript di Web SDK (alloy.js).

Vantaggi e svantaggi di questo percorso di implementazione

L’utilizzo della libreria JavaScript dell’SDK web per inviare dati ad Adobe Analytics presenta sia vantaggi che svantaggi. Valuta attentamente ogni opzione per decidere quale approccio è meglio per la tua organizzazione.

Vantaggi
Svantaggi
  • Approccio diretto: questo percorso di implementazione è più semplice degli approcci che spostano le implementazioni Adobe Analytics esistenti. Se non hai un’implementazione Adobe Analytics corrente da preoccupare, compila i campi XDM dell’SDK per web applicabili.
  • Schema predefinito: se per la tua organizzazione non è necessario un tuo schema, puoi semplicemente utilizzare lo schema orientato verso Adobe Analytics. Questo concetto si applica anche quando ci si sposta verso il Customer Journey Analytics; il concetto di prop e eVar non si applica al Customer Journey Analytics, ma puoi continuare a utilizzare prop ed eVar come semplici dimensioni personalizzate.
  • Le modifiche all'implementazione richiedono l'intervento dello sviluppatore: se desideri apportare modifiche all'implementazione dell'SDK Web, devi collaborare con il team di sviluppo per modificare il codice sul tuo sito. L'approccio che utilizza l'estensione tag Web SDK evita questo svantaggio.
  • Bloccato per l'utilizzo di uno schema specifico: quando l'organizzazione passa al Customer Journey Analytics, è necessario scegliere di continuare a utilizzare lo schema Adobe Analytics o di eseguire la migrazione allo schema della propria organizzazione (che sarebbe un set di dati separato). Se la tua organizzazione desidera evitare sia lo schema Adobe Analytics che la migrazione a un set di dati separato durante il passaggio al Customer Journey Analytics, Adobe consiglia uno dei due metodi seguenti:
    • Utilizzare l'oggetto data: l'oggetto data consente di inviare dati ad Adobe Analytics senza essere conforme a uno schema XDM. Una volta creato lo schema dell'organizzazione, è possibile utilizzare la mappatura dello stream di dati per mappare i campi oggetto data su XDM. Sia l'estensione Analytics all'estensione Web SDK che l'AppMeasurement alla libreria Web SDK JavaScript utilizzano questo oggetto data.
    • Ignora completamente Adobe Analytics: se implementi l’SDK web, puoi inviare tali dati a un set di dati in Adobe Experience Platform per l’utilizzo in Customer Journey Analytics. Puoi utilizzare qualsiasi schema desiderato; Adobe Analytics non è coinvolto in questo flusso di lavoro e pertanto non richiede il gruppo di campi Adobe Analytics ExperienceEvent. Questo metodo si assume la minore quantità di debito tecnico, ma lascia anche completamente fuori dal quadro generale Adobe Analytics.
IMPORTANT
Questo metodo di implementazione richiede l’utilizzo di uno schema configurato per Adobe Analytics. Se la tua organizzazione prevede di utilizzare il tuo schema con Customer Journey Analytics in futuro, l’utilizzo dello schema Adobe Analytics può creare confusione per gli amministratori di dati o gli architetti. Esistono diverse opzioni per attenuare questo ostacolo:
  • Puoi utilizzare lo schema Adobe Analytics in CJA. CJA non ha un concetto di proprietà o eVar; vengono trattate come qualsiasi altro campo schema. Inoltre, l’utilizzo dello schema Adobe Analytics in CJA può rendere più difficile l’utilizzo di altri servizi della piattaforma, come Adobe Journey Optimizer o Real-time Customer Data Platform.
  • Puoi utilizzare l’oggetto dati, in modo simile a un flusso di lavoro di migrazione. L’utilizzo dell’oggetto dati richiede la mappatura di ogni campo dell’oggetto dati su un campo dello schema XDM.
  • Puoi saltare completamente l’implementazione di Adobe Analytics e inviare dati a Adobe Experience Platform utilizzando il tuo schema. Questo approccio è ideale a lungo termine e consente all’organizzazione di iniziare a utilizzare il Customer Journey Analytics.

Passaggi necessari per implementare la libreria JavaScript dell’SDK Web

Panoramica ad alto livello dei compiti di implementazione:

Come implementare Adobe Analytics utilizzando il flusso di lavoro Web SDK, come descritto in questa sezione.

Attività
Ulteriori informazioni
1
Assicurati di aver definito una suite di rapporti.
Report Suite Manager
2
Imposta schemi. Per standardizzare la raccolta dati da utilizzare nelle applicazioni che sfruttano Adobe Experience Platform, Adobe ha creato lo standard aperto e pubblicamente documentato Experience Data Model (XDM).
Panoramica dell’interfaccia utente degli schemi
3
Crea un livello dati per gestire il tracciamento dei dati sul tuo sito Web.
Creare un livello di dati
4
Installare la versione standalone predefinita. Puoi fare riferimento alla libreria (alloy.js) nel CDN direttamente nella tua pagina oppure scaricarla e ospitarla nella tua infrastruttura. In alternativa, è possibile utilizzare il pacchetto NPM.
Installazione della versione standalone predefinita e Utilizzo del pacchetto NPM
5
Configura uno stream di dati. Un flusso di dati rappresenta la configurazione lato server durante l’implementazione di Adobe Experience Platform Web SDK.
Configurare uno stream di dati
6
Aggiungi un servizio Adobe Analytics allo stream di dati. Tale servizio controlla se e come i dati vengono inviati ad Adobe Analytics e a quali suite di rapporti in particolare.
Aggiungere il servizio Adobe Analytics a uno stream di dati
7
Configura Web SDK. Verificare che la libreria installata nel passaggio 4 sia configurata correttamente con l'ID dello stream di dati (precedentemente noto come ID configurazione edge (edgeConfigId)), l'ID organizzazione (orgId) e altre opzioni disponibili. Assicurati che la mappatura delle variabili sia corretta.
Configura Web SDK
Mappatura variabile oggetto XDM
8
Esegui comandi e/o traccia eventi. Una volta implementato il codice di base nella pagina web, puoi iniziare a eseguire comandi ed eventi di tracciamento con l’SDK.
Inviare eventi
9
Estendi e convalida l'implementazione prima di eseguirne il push in produzione.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690