DocumentazioneAnalyticsGuida all'implementazione

Inviare dati ad Adobe Analytics utilizzando la libreria JavaScript di Web SDK

Last update: Sat Sep 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente
  • Amministratore

Questo percorso di implementazione prevede 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 alla libreria JavaScript di Web SDK (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 per estensione Web SDK: adotta un approccio semplice 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 Customer Journey Analytics. Utilizzare l'oggetto data invece dell'oggetto xdm per inviare dati ad Adobe.
  • Libreria JavaScript da AppMeasurement a Web SDK: approccio semplice e sistematico per la migrazione al Web SDK, ma senza l'utilizzo di 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 di Web SDK 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 di Web SDK 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 Customer Journey Analytics; il concetto di prop ed eVar non si applica a 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 si desidera apportare modifiche all'implementazione di Web SDK, è necessario collaborare con il team di sviluppo per modificare il codice sul sito. L'approccio che utilizza l'estensione tag Web SDK evita questo svantaggio.
  • Bloccato per l'utilizzo di uno schema specifico: quando l'organizzazione si sposta su 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 trasferimento a 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 la libreria AppMeasurement a Web SDK JavaScript utilizzano questo oggetto data.
    • Ignora completamente Adobe Analytics: se implementi il Web SDK, 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 lo schema personalizzato 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 di 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. Si tratta di un approccio ideale a lungo termine che consente all’organizzazione di iniziare a utilizzare Customer Journey Analytics.

Passaggi necessari per implementare la libreria JavaScript di Web SDK

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 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 (datastreamId)), l'ID organizzazione (orgId) e altre opzioni disponibili. Assicurati che la mappatura delle variabili sia corretta.
Configura il mapping della variabile oggetto XDM del Web SDK
8
Esegui comandi e/o traccia eventi. Dopo aver implementato il codice di base nella pagina Web, puoi iniziare a eseguire comandi ed eventi di tracciamento con SDK.
Inviare eventi
9
Estendi e convalida l'implementazione prima di eseguirne il push in produzione.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690