Aggiungere codice script nelle pagine del sito per supportare la telemetria

Articolo
07/26/2024

In questo articolo viene descritto come aggiungere il codice script sul lato client alle pagine del sito per supportare la raccolta di telemetria sul lato client.

L'analisi dei dati Web è uno strumento essenziale se si desidera comprendere come i clienti interagiscono con il sito e prendono decisioni che consentono di ottimizzare l'esperienza per la massima conversione. Molti pacchetti di analisi dei dati Web sono disponibili per consentire il raggiungimento di questi obiettivi, ad esempio Google Analytics, Clicky, Moz Analytics e KISSMetrics. La maggior parte dei pacchetti di analisi dei dati Web richiede l'aggiunta di codice script sul lato client nell'elemento <head> del codice HTML per tutte le pagine del sito.

Nota

Le istruzioni fornite in questo articolo si applicano anche all'altra funzionalità personalizzata sul lato client che Microsoft Dynamics 365 Commerce non offre in modalità nativa.

Creare un frammento riutilizzabile per il codice script

Un frammento consente di riutilizzare il codice script incorporato o esterno in tutte le pagine del sito, indipendentemente dal modello che utilizzano.

Creare un frammento riutilizzabile per il codice script inline

Per creare un frammento riutilizzabile per il codice di script inline in Creazione di siti Web, attenersi alla seguente procedura.

Andare a Frammenti quindi selezionare Nuovo.
Nella finestra di dialogo Nuovo frammento selezionare Script inline.
Sotto Nome frammento, inserire un nome per il frammento, quindi selezionare OK.
Sotto il frammento creato, selezionare il modulo Script inline predefinito.
Nel riquadro delle proprietà sulla destra, sotto Script inline, inserire lo script lato client. Quindi configurare altre opzioni come richiesto.
Selezionare Salva e quindi selezionare Fine modifica.
Selezionare Pubblica

Creare un frammento riutilizzabile per il codice script esterno

Per creare un frammento riutilizzabile per il codice di script esterno in Creazione di siti Web, attenersi alla seguente procedura.

Andare a Frammenti quindi selezionare Nuovo.
Nella finestra di dialogo Nuovo frammento selezionare Script esterno.
Sotto Nome frammento, inserire un nome per il frammento, quindi selezionare OK.
Sotto il frammento creato, selezionare il modulo Script esterno predefinito.
Nel riquadro delle proprietà sulla destra, sotto Origine script, aggiungere un URL esterno o relativo per l'origine dello script esterno. Quindi configurare altre opzioni come richiesto.
Selezionare Salva e quindi selezionare Fine modifica.
Selezionare Pubblica

Nota

Se i criteri di sicurezza dei contenuti (CSP) sono abilitati per il tuo sito, assicurati che tutti gli URL esterni vengano aggiunti alla direttiva CSP script-src in Creazione di siti Web di Commerce. Per altre informazioni, vedere Gestire i criteri di sicurezza del contenuto (CSP).

Aggiungere un frammento che includa il codice dello script in un modello

Per aggiungere un frammento che includa codice di script in un modello in Creazione di siti Web, attenersi alla seguente procedura.

Passare a Modelli e aprire il modello per le pagine che si desidera aggiungere al codice script.
Nel riquadro sinistro, espandere la gerarchia dei modelli per visualizzare lo slot Intestazione HTML.
Nello slot Intestazione HTML selezionare il pulsante con i puntini di sospensione (...) quindi selezionare Aggiungi frammento.
Selezionare il frammento creato per il codice script.
Selezionare Salva e quindi selezionare Fine modifica.
Selezionare Pubblica

Aggiungere uno script esterno o uno script inline direttamente a un modello

Se si desidera inserire uno script inline o esterno direttamente in un set di pagine controllate da un singolo modello, non è necessario creare prima un frammento.

Aggiungere uno script inline direttamente a un modello

Per aggiungere uno script inline direttamente a un modello in Creazione di siti Web, attenersi alla seguente procedura.

Passare a Modelli e aprire il modello per le pagine che si desidera aggiungere al codice script.
Nel riquadro sinistro, espandere la gerarchia dei modelli per visualizzare lo slot Intestazione HTML.
Nello slot Intestazione HTML selezionare il pulsante con i puntini di sospensione (...) quindi selezionare Aggiungi modulo.
Nella finestra di dialogo Aggiungi modulo selezionare Script inline.
Nel riquadro delle proprietà sulla destra, sotto Script inline, inserire lo script lato client. Quindi configurare altre opzioni come richiesto.
Selezionare Salva e quindi selezionare Fine modifica.
Selezionare Pubblica

Aggiungere uno script esterno direttamente a un modello

Per aggiungere uno script esterno direttamente a un modello in Creazione di siti Web, attenersi alla seguente procedura.

Passare a Modelli e aprire il modello per le pagine che si desidera aggiungere al codice script.
Nel riquadro sinistro, espandere la gerarchia dei modelli per visualizzare lo slot Intestazione HTML.
Nello slot Intestazione HTML selezionare il pulsante con i puntini di sospensione (...) quindi selezionare Aggiungi modulo.
Nella finestra di dialogo Aggiungi modulo selezionare Script esterno.
Nel riquadro delle proprietà sulla destra, sotto Origine script, aggiungere un URL esterno o relativo per l'origine dello script esterno. Quindi configurare altre opzioni come richiesto.
Selezionare Salva e quindi selezionare Fine modifica.
Selezionare Pubblica