Installazione: aggiungi lo script mandera

Installa mandera sul tuo sito web, verifica che il tracciamento funzioni e risolvi i problemi di configurazione più comuni.

mandera inizia a raccogliere dati non appena lo snippet di tracciamento viene caricato sul tuo sito web. Aggiungilo a tutte le pagine che vuoi monitorare, poi verifica l'installazione nel tuo browser e nella dashboard di mandera.

Usi un CMS o un website builder specifico? Seleziona il tuo sistema qui sotto per andare direttamente alla guida di configurazione pertinente:

Prima di installare

Di cosa hai bisogno

Prima di installare mandera, assicurati di avere:

accesso alla tua dashboard mandera
un sito web creato in mandera
il codice di tracciamento per quel sito web
accesso al tuo CMS, tag manager o codice del sito web

Puoi trovare il tuo codice di tracciamento esatto nella tua dashboard mandera, alla voce Settings.

Dove mettere lo snippet

Lo snippet di tracciamento mandera va aggiunto al <head> sezione del tuo sito web.

Per la maggior parte dei siti web, lo snippet dovrebbe caricarsi su ogni pagina pubblica che vuoi che mandera monitori. A seconda della tua configurazione, puoi aggiungerlo tramite il tuo CMS, il tag manager o l'header globale del sito.

Impostazioni generali

Codice di tracciamento

Per iniziare a raccogliere i dati, aggiungi lo snippet di tracciamento mandera al tuo sito web.

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

I valori nel tuo snippet sono generati per il tuo sito web. Non copiare i valori di esempio sopra.

Mantieni lo snippet esattamente come appare nella tua dashboard di mandera. Se uno dei valori richiesti manca o è stato modificato, mandera potrebbe non ricevere i dati dal tuo sito web.

Attributi richiesti

Il frammento ha bisogno di queste parti per funzionare correttamente:

Parte	Cosa fa
`sorgente`	Carica lo script di analisi mandera.
`mandera-org`	Collega lo script alla tua organizzazione.
`id-proprietà-dati`	Collega lo script al sito web che hai creato in mandera.
`in attesa`	Lascia che lo script si carichi senza bloccare il tuo sito.

Metodi di installazione

Google Tag Manager

Usa questo metodo se il tuo sito web utilizza già Google Tag Manager.

Apri Google Tag Manager.
Scegli il container per il tuo sito web.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con questi passaggi.

Assicurati che il container di Google Tag Manager sia già installato sul tuo sito web. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Manuale HTML

Usa questo metodo se puoi modificare il codice del tuo sito web direttamente.

Apri il modello HTML globale per il tuo sito web.
Trova il <head> sezione.
Incolla lo snippet di tracciamento mandera prima della chiusura </head> etichetta.
Salva e distribuisci le tue modifiche.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con questi passaggi.

Se il tuo sito usa template diversi per i diversi tipi di pagine, assicurati che lo snippet sia presente in tutti i template che vuoi monitorare.

Applicazioni a pagina singola

Le applicazioni a pagina singola sono pienamente supportate. mandera rileva i cambiamenti di percorso sul lato client e li conta come visualizzazioni di pagina, quindi le app realizzate con React, Vue, Next.js o framework simili non richiedono alcuna configurazione aggiuntiva. Solo i cambiamenti di percorso vengono conteggiati come nuove visualizzazioni di pagina, mentre le pagine visualizzate per meno di tre secondi vengono considerate “rumore” e ignorate, tranne l’ultima pagina di una visita.

Disabilita il tracciamento

mandera filtra automaticamente le tue visite alla dashboard e il traffico dei bot, quindi non devi escludere te stesso. Per impedire a mandera di monitorare completamente il tuo sito web, rimuovi lo snippet di tracciamento dal tuo CMS, dal tag manager o dal template. I dati già raccolti rimangono disponibili nella tua dashboard.

Controlla la configurazione

Apri il tuo sito web

Apri una pagina pubblica qualsiasi dove lo snippet dovrebbe essere attivo.

Apri gli strumenti per sviluppatori del browser

Apri gli strumenti per sviluppatori nel tuo browser e vai alla scheda Network.

3. Ricarica la pagina

Ricarica la pagina mentre la scheda Rete è aperta.

4. Cerca lo script mandera

Cerca analytics.js oppure il tuo mandera web URL. Se lo script viene visualizzato con lo stato "operativo", significa che lo snippet si sta caricando.

5. Controlla la dashboard mandera

Apri l'Analytics Suite in mandera e controlla se iniziano a comparire i dati.

I dati potrebbero non apparire subito. Se lo script carica correttamente ma non compaiono dati, continua con i passaggi di risoluzione problemi qui sotto.

Risoluzione dei problemi

Non ci sono dati nel campo mandera

Controlla prima questi punti:

Lo snippet è installato sulla pagina che stai testando
il pezzo è dentro il <head> sezione
L'ID dell'organizzazione non è cambiato
l'ID del sito web non è cambiato
La cache del tuo sito è stata svuotata
le tue modifiche al tag manager sono state pubblicate
il tuo browser o ad blocker non sta bloccando lo script

Lo script non compare nella scheda Network

Se non trovi lo script nella scheda di Rete, è probabile che lo snippet non venga caricato.

Controlla se è stato aggiunto al template, al campo del CMS o al container del tag manager giusto.

Lo script compare, ma i dati non si vedono ancora

Se lo script si carica ma non vengono visualizzati dati, controlla se la pagina è pubblica, se in mandera è stato selezionato il sito web corretto e se lo snippet appartiene allo stesso sito web che stai visualizzando.

Solo alcune pagine vengono tracciate

Se in mandera compaiono solo alcune pagine, è possibile che lo snippet non sia installato a livello globale.

Aggiungilo all'header globale o a tutti i template pertinenti.

Il Tag Manager Google non attiva il tag

Controlla se il tag utilizza il trigger "tutte le pagine", se il contenitore è stato pubblicato e se il contenitore Google Tag Manager viene caricato sul sito web.

Guide specifiche per CMS

WordPress

mandera è compatibile con i temi classici di WordPress, i temi a blocchi e le configurazioni headless di WordPress. Scegli il metodo più adatto al tuo sito web.

Metodo 1: Aggiungi lo snippet all'intestazione del tuo tema

Puoi aggiungere lo snippet mandera direttamente nel file del tuo tema intestazione.php file.

In WordPress, vai su Aspetto → Editor file tema.
Apri la intestazione.php file.
Incolla lo snippet mandera prima della chiusura </head> etichetta.
Sostituisci i valori segnaposto con quelli della tua dashboard mandera.
Clicca su Aggiorna File.
Apri il tuo sito web e verifica l'installazione.

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Se aggiorni o cambi tema, potresti dover aggiungere di nuovo il frammento.

Metodo 2: Usa un plugin per l'iniezione di header

Puoi anche installare mandera senza modificare i file del tema.

Installa un plugin tipo WPCode o Header Footer Code Manager.
Apri le impostazioni del plugin.
Incolla lo snippet mandera nella sezione “Header”.
Salva le modifiche.
Svuota la cache del tuo sito se usi un plugin di caching.
Apri il tuo sito web e verifica l'installazione.

Questo metodo di solito è più stabile durante gli aggiornamenti del tema perché lo snippet è gestito dal plugin.

Metodo 3: Aggiungi lo snippet tramite functions.php

Puoi anche aggiungere lo snippet programmaticamente tramite il tema functions.php file.

function mandera_tracking_script() {
    ?>
    <script
      src="https://<your-mandera-web-url>/analytics.js"
      mandera-org="ORG_ID"
      data-property-id="PROPERTY_ID"
      async
    ></script>
    <?php
}
add_action('wp_head', 'mandera_tracking_script');

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Per le configurazioni di produzione, potresti voler salvare questi valori come opzioni o costanti WordPress invece di inserirli direttamente nel tema.

Senza testina WordPress

Se usi WordPress come CMS headless con un framework frontend come Next.js, Nuxt o Gatsby, installa mandera nella tua applicazione frontend al posto del backend WordPress.

Aggiungi il codice al tuo frontend <head> sezione. Se il tuo frontend usa il routing lato client, dai anche un'occhiata alla nota sulle single-page application qui sopra.

Shopify

Puoi installare mandera su Shopify aggiungendo lo snippet di tracciamento al tuo negozio online. La configurazione consigliata è quella di caricare lo snippet a livello globale, in modo che appaia sulle pagine pubbliche che vuoi che mandera monitori.

Di solito include pagine come la tua homepage, le pagine dei prodotti, le pagine delle collezioni e le pagine di contenuto.

Metodo 1: Aggiungi lo snippet al tuo tema Shopify

Usa questo metodo se hai accesso al codice del tuo tema Shopify e vuoi installare mandera direttamente nel tema attivo.

Prima di modificare il codice del tuo tema, valuta di duplicare il tuo tema attivo come backup.

Apri la tua area di amministrazione di Shopify.
Vai su Negozio online → Temi.
Trova il tuo tema attivo.
Apri il menu temi e scegli Modifica codice.
Nella cartella Layout, apri theme.liquid.
Trova la chiusura </head> etichetta.
Incolla lo snippet di tracciamento mandera proprio prima della chiusura </head> etichetta.
Salva le modifiche.
Apri il tuo negozio in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo frammento prima della chiusura </head> in theme.liquid:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Se in seguito aggiorni, duplichi o cambi il tuo tema Shopify, controlla se lo snippet mandera è ancora presente nel tema attivo.

Metodo 2: Usa un'app di codice personalizzato

Se non vuoi modificare direttamente il codice del tuo tema, puoi usare un'app di Shopify che ti permette di aggiungere codice personalizzato all'intestazione del tuo negozio.

Usa questo metodo se il tuo negozio usa già un'app per intestazione, piè di pagina o codice personalizzato di fiducia, o se preferisci una configurazione "no-code".

Installa o apri la tua app di codice personalizzato in Shopify.
Fai un nuovo pezzo di codice.
Scegli la sezione Head come posizione.
Incolla lo snippet di tracciamento mandera nel campo del codice.
Imposta lo snippet per caricarlo su tutte le pagine dello store che vuoi misurare.
Salva e abilita lo snippet.
Apri il tuo negozio in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che l'app carichi lo snippet sulle pagine pubbliche del tuo negozio online. Se l'app aggiunge il codice solo a determinati modelli o pagine, mandera potrebbe raccogliere dati solo da quelle aree.

Metodo 3: Usa il Tag Manager Google

Se il tuo negozio Shopify utilizza già Google Tag Manager, puoi aggiungere lo snippet mandera tramite GTM invece di modificare direttamente il codice del tema.

Apri Google Tag Manager.
Seleziona il container usato sul tuo negozio Shopify.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo negozio Shopify in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container di Tag Manager Google sia già installato sul tuo negozio Shopify. Se il container GTM non si carica, non si caricherà nemmeno lo snippet mandera.

Le pagine del checkout di Shopify

La configurazione standard mandera è pensata per le pagine pubbliche del tuo negozio Shopify.

Le pagine di checkout, post-acquisto e di stato dell'ordine potrebbero comportarsi in modo diverso, poiché Shopify gestisce queste aree separatamente dal tema standard del negozio. Per la configurazione di base di mandera, verifica innanzitutto che lo snippet si carichi correttamente su pagine come la home page, le pagine dei prodotti, quelle delle collezioni e le pagine di contenuto.

Se hai bisogno di misurare eventi o dati di fatturato relativi al checkout, potrebbe essere necessario un setup specifico per Shopify.

Risoluzione problemi per Shopify

Se non compaiono dati in mandera, controlla prima questi punti:

lo snippet è stato aggiunto al tema Shopify attivo o a un'app di codice personalizzato globale
lo snippet è inserito nella sezione head
i valori della tua dashboard mandera sono stati copiati alla lettera
Le modifiche al tuo Shopify sono state salvate e pubblicate
il tuo negozio è pubblico e non protetto da password
il tuo browser o ad blocker non sta bloccando lo script
La tua app con codice personalizzato o il container Google Tag Manager è attivo
Lo snippet non è installato due volte

Se di recente hai cambiato o aggiornato il tema, riapri il tema attivo e controlla se lo snippet mandera è ancora presente.

Wix

Puoi installare mandera su Wix aggiungendo lo snippet di tracciamento come codice personalizzato nella tua dashboard di Wix. In questo modo lo snippet verrà caricato su tutte le pagine pubbliche che vuoi che mandera monitori.

Usa questo metodo se il tuo sito è stato creato con Wix e hai accesso alle impostazioni del sito.

Prima di installare: Assicurati che il tuo sito Wix sia pubblicato e collegato a un dominio. Le impostazioni del codice personalizzato potrebbero dipendere dalla configurazione e dal piano di Wix.

Metodo 1: Aggiungi lo snippet tramite Codice personalizzato

Il modo consigliato per installare mandera su Wix è aggiungere lo snippet di tracciamento nella sezione head del tuo sito.

Apri il tuo pannello di controllo Wix.
Seleziona il sito web su cui vuoi installare mandera.
Vai a Settings.
Apri Codice personalizzato sotto Sviluppo e integrazioni.
Clicca su + Aggiungi codice personalizzato.
Incolla lo snippet di tracciamento mandera nel campo del codice.
Assegna al codice un nome chiaro, ad esempio “mandera analytics”.
Sotto "Aggiungi codice alle pagine", seleziona "Tutte le pagine".
Scegli se il codice deve caricarsi una volta per visita o per ogni pagina aperta da un visitatore.
Sotto Codice Luogo in, seleziona Testa.
Clicca Applica.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo snippet al campo Wix Custom Code:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Per la maggior parte dei siti Wix, "Tutte le pagine" è l'opzione migliore perché applica lo snippet anche alle nuove pagine che creerai in futuro.

Wix potrebbe chiederti se il codice debba caricarsi una volta per visita o su ogni pagina che un visitatore apre. Per una configurazione di base di mandera, inizia selezionando “Carica il codice una volta per visita”, se questa opzione è disponibile. Dopo l’installazione, verifica che lo script compaia nella scheda “Rete” del tuo browser e che i dati inizino ad apparire in mandera.

Se noti che le modifiche alla pagina non si vedono come previsto, controlla la configurazione e prova l'opzione di caricamento alternativa.

Metodo 2: Usa un'app di codice personalizzato

Se non riesci ad accedere alle impostazioni native del Codice personalizzato in Wix, puoi usare un'app Wix affidabile che ti permette di aggiungere codice personalizzato alla sezione head del tuo sito.

Usa questo metodo solo se l'app può inserire lo snippet globalmente nell'intestazione.

Installa o apri la tua app di codice personalizzato in Wix.
Crea un nuovo snippet di codice personalizzato.
Incolla lo snippet di tracciamento mandera nel campo del codice.
Imposta il posizionamento sulla testa.
Applica lo snippet a tutte le pagine pubbliche che vuoi misurare.
Salva e abilita lo snippet.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Se l'app aggiunge codice solo a una singola pagina, a un iframe o a un elemento incorporato visibile, non è adatta all'installazione base di mandera.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito web Wix utilizza già Google Tag Manager, puoi installare mandera anche tramite GTM.

Apri Google Tag Manager.
Seleziona il contenitore usato sul tuo sito Wix.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito Wix in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container del Tag Manager Google sia già collegato al tuo sito web Wix. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Risoluzione problemi per Wix

Se non compaiono dati in mandera, controlla prima questi punti:

Il tuo sito Wix è pubblicato
Il tuo sito Wix è collegato a un dominio
lo snippet è stato aggiunto tramite Codice personalizzato o un'app di codice personalizzato globale
il frammento si trova nella sezione head
lo snippet è applicato a tutte le pagine pertinenti
i valori della tua dashboard mandera sono stati copiati alla lettera
le tue modifiche sono state applicate e salvate
il tuo browser o ad blocker non sta bloccando lo script
Lo snippet non è installato due volte

Se lo script non compare nella scheda Network, riapri le impostazioni di Custom Code di Wix e controlla se lo snippet è attivo, inserito nella sezione giusta e applicato alle pagine corrette.

Joomla

mandera può essere installato su Joomla aggiungendo lo snippet di tracciamento nella sezione head del tuo sito web. A seconda della configurazione di Joomla, puoi farlo tramite le impostazioni del template, i file del template o il Tag Manager Google.

Usa il metodo che si adatta meglio al tuo sito e ai permessi che hai in Joomla.

Prima di installare: assicurati di avere accesso alla tua area amministratore di Joomla e di sapere quale template o stile di template è attivo nelle pagine che vuoi misurare.

Metodo 1: Usa le impostazioni di codice personalizzato del tuo template

Molti template e framework di template di Joomla includono un campo per codice personalizzato per gli script che dovrebbero essere aggiunti alla sezione head del tuo sito web.

Usa questo metodo se il tuo template attivo offre un campo come Codice personalizzato, Codice nell'intestazione, Prima o simili.

Apri la tua area di amministrazione di Joomla.
Vai su Sistema o Estensioni, a seconda della tua versione di Joomla.
Apri la sezione Modelli o Stili Modello Sito.
Scegli il template o lo stile di template attivo usato dal tuo sito web.
Cerca una sezione tipo Codice personalizzato, Codice nell'intestazione o simile nelle impostazioni del template.
Incolla lo snippet di tracciamento mandera nel campo relativo alla sezione head.
Salva le modifiche.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo snippet nel campo codice personalizzato per la sezione head:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Se il tuo sito web utilizza diversi stili di template per le varie pagine, ripeti la configurazione per ogni stile di template che vuoi che mandera monitori.

Metodo 2: Aggiungi il frammento al tuo file template

Se il tuo modello non include un campo codice personalizzato, puoi aggiungere lo snippet mandera direttamente nel file del modello.

Usa questo metodo solo se ti senti a tuo agio a modificare i file del modello o se hai il supporto di uno sviluppatore.

Apri la tua area di amministrazione di Joomla.
Vai su Sistema o Estensioni, a seconda della tua versione di Joomla.
Apri la sezione Modelli.
Seleziona il modello del sito attivo.
Apri il file del template principale, solitamente index.php.
Trova la chiusura </head> etichetta.
Incolla lo snippet di tracciamento mandera proprio prima della chiusura </head> etichetta.
Salva le modifiche.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Non modificare i file del core di Joomla. Il frammento va aggiunto tramite il tuo template o le impostazioni del template, non tramite l'installazione del core di Joomla.

Se in seguito aggiorni, sostituisci o cambi il tuo template Joomla, controlla se lo snippet mandera è ancora presente.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito Joomla utilizza già Google Tag Manager, puoi aggiungere lo snippet mandera tramite GTM invece di modificare il tuo template.

Apri Google Tag Manager.
Seleziona il container usato sul tuo sito Joomla.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito Joomla in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container Google Tag Manager sia già installato sul tuo sito Joomla. Se il container GTM non si carica, non si caricherà nemmeno lo snippet mandera.

Risoluzione problemi per Joomla

Se non compaiono dati in mandera, controlla prima questi punti:

il frammento di codice è stato aggiunto al template Joomla attivo o allo stile del template
il frammento si trova nella sezione head
i valori della tua dashboard mandera sono stati copiati alla lettera
Le modifiche apportate a Joomla sono state salvate
La cache del tuo sito è stata svuotata
La cache dei tuoi template o il plugin di ottimizzazione non impediscono il caricamento dello snippet
il template corretto è usato nella pagina che stai testando
il tuo browser o ad blocker non sta bloccando lo script
Lo snippet non è installato due volte

Se lo script non compare nella scheda Rete, controlla se la pagina che stai testando utilizza uno stile di template diverso. In Joomla, voci di menu diverse possono utilizzare stili di template diversi, quindi potrebbe essere necessario aggiungere lo snippet in più di un punto.

TYPO3

mandera può essere installato su TYPO3 aggiungendo lo snippet di tracciamento nella sezione head del tuo sito web. A seconda della tua configurazione, puoi farlo tramite TypoScript, il pacchetto del tuo sito o il Tag Manager Google.

Usa il metodo che si adatta meglio alla tua configurazione TYPO3 e ai tuoi permessi.

Prima di procedere all'installazione: assicurati di avere accesso al backend di TYPO3, di sapere dove viene gestita la configurazione principale di TypoScript e di poter svuotare la cache di TYPO3 dopo aver apportato delle modifiche.

Metodo 1: Aggiungi lo snippet tramite headerData di TypoScript

Il modo più semplice per installare mandera su TYPO3 è aggiungere lo snippet di tracciamento completo tramite headerData di TypoScript.

Usa questo metodo se puoi modificare la configurazione TypoScript del tuo sito web e vuoi incollare lo snippet completo mandera in TYPO3.

Apri il tuo backend TYPO3.
Vai al modulo Template.
Seleziona la pagina principale o la radice del sito in cui è configurata la tua impostazione principale di TypoScript.
Apri l'editor di configurazione di TypoScript.
Incolla il blocco TypoScript qui sotto nel tuo file di configurazione.
Sostituisci i valori segnaposto con quelli della tua dashboard mandera.
Salva le modifiche.
Svuota la cache di TYPO3.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo blocco alla tua configurazione TypoScript:

page.headerData.999 = TEXT
page.headerData.999.value (

)

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Se intestazione pagina 999 Se quel numero è già in uso nella tua configurazione, scegline un altro che non sia già stato utilizzato.

Metodo 2: Aggiungi lo script tramite includeJS

Se la tua installazione di TYPO3 è gestita da uno sviluppatore o tramite un pacchetto del sito, lo script mandera può essere aggiunto anche tramite pagina.includiJS.

Usa questo metodo se preferisci gestire il file JavaScript esterno tramite TypoScript invece di incollare il tag script completo all'interno di headerData.

Apri il backend di TYPO3 o i file del pacchetto del tuo sito.
Apri la configurazione principale di TypoScript del tuo sito web.
Incolla il blocco TypoScript qui sotto nel tuo file di configurazione.
Sostituisci i valori segnaposto con quelli della tua dashboard mandera.
Salva le modifiche.
Svuota la cache di TYPO3.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo blocco alla tua configurazione TypoScript:

page.includeJS {
  mandera = https:///analytics.js
  mandera.async = 1
  mandera.data.mandera-org = ORG_ID
  mandera.data.data-property-id = PROPERTY_ID
}

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Questo metodo è particolarmente utile per le installazioni TYPO3 gestite dagli sviluppatori, dove gli script vengono gestiti centralmente tramite TypoScript o un pacchetto del sito.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito web TYPO3 utilizza già il Tag Manager Google, puoi aggiungere lo snippet mandera tramite GTM invece di modificare la configurazione del template TYPO3.

Apri Google Tag Manager.
Scegli il container usato sul tuo sito TYPO3.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito web TYPO3 in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container Google Tag Manager sia già installato sul tuo sito web TYPO3. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Risoluzione problemi per TYPO3

Se non compaiono dati in mandera, controlla prima questi punti:

il pezzo è stato aggiunto al setup TypoScript attivo
lo snippet è aggiunto nella sezione head
i valori della tua dashboard mandera sono stati copiati alla lettera
la cache di TYPO3 è stata svuotata
il tuo pacchetto del sito o il processo di deployment include le ultime modifiche
la pagina che stai testando usa la stessa configurazione TypoScript
il tuo browser o ad blocker non sta bloccando lo script
Lo snippet non è installato due volte

Se lo script non compare nella scheda Network, controlla che la pagina che stai testando usi una configurazione del sito, una configurazione del template o una condizione TypoScript diversa. In TYPO3, diverse parti di un sito web possono utilizzare configurazioni TypoScript differenti.

Squarespace

mandera può essere installato su Squarespace aggiungendo lo snippet di tracciamento tramite Code Injection. In questo modo lo snippet verrà caricato su tutte le pagine pubbliche che vuoi che mandera monitori.

Usa questo metodo se il tuo sito web è costruito con Squarespace e hai accesso alle impostazioni del sito.

Prima di installare: assicurati che il tuo sito Squarespace sia pubblicato e che il tuo piano supporti l'iniezione di codice.

Metodo 1: aggiungi lo snippet tramite iniezione di codice

Il modo consigliato per installare mandera su Squarespace è aggiungere lo snippet di tracciamento nel campo "Header Code Injection".

Apri la tua bacheca Squarespace.
Seleziona il sito web su cui vuoi installare mandera.
Vai a Settings.
Apri Avanzate.
Iniezione di codice aperta.
Incolla lo snippet di tracciamento mandera nel campo "Header".
Salva le modifiche.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo snippet nel campo Header:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Il codice inserito nel campo "Header" viene caricato nella sezione head del tuo sito Squarespace. Questo è il posto migliore dove inserire lo snippet di tracciamento mandera, perché in questo modo verrà caricato globalmente su tutte le pagine pubbliche che vuoi monitorare.

Metodo 2: Aggiungi lo snippet a una pagina specifica

Se vuoi prima provare mandera solo su una pagina specifica di Squarespace, puoi aggiungere lo snippet di tracciamento tramite l'inserimento di codice a livello di pagina.

Usa questo metodo solo a scopo di test o per le pagine in cui mandera deve essere limitato a un'area specifica del tuo sito web.

Apri la tua bacheca Squarespace.
Vai su Pagine.
Seleziona la pagina in cui vuoi installare mandera.
Apri le impostazioni della pagina.
Apri Avanzate.
Incolla lo snippet di tracciamento mandera nel campo del codice dell'intestazione della pagina.
Salva le modifiche.
Apri la pagina in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Se vuoi che mandera monitori l'intero sito web, usa invece il metodo globale "Header Code Injection". L'installazione a livello di pagina si applica solo alla pagina selezionata.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito web Squarespace utilizza già il Tag Manager Google, puoi aggiungere lo snippet mandera tramite GTM invece di inserirlo direttamente tramite la funzione "Code Injection" di Squarespace.

Apri Google Tag Manager.
Seleziona il contenitore usato sul tuo sito Squarespace.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito Squarespace in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container di Google Tag Manager sia già installato sul tuo sito web Squarespace. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Pagine di checkout

La configurazione standard mandera è pensata per le pagine del tuo sito web pubblico su Squarespace.

Le pagine di checkout potrebbero comportarsi in modo diverso perché Squarespace le gestisce separatamente dalle normali pagine del sito web. Per la configurazione di base di mandera, verifica innanzitutto che lo snippet si carichi correttamente sulle pagine pubbliche, come la homepage, le pagine dei servizi, quelle dei prodotti, i post del blog e le landing page.

Se devi misurare le aree relative al checkout, dai un'occhiata alla tua configurazione Squarespace separatamente e verifica cosa è possibile fare con il tuo piano e la configurazione del tuo negozio.

Risoluzione problemi di Squarespace

Se non compaiono dati in mandera, controlla prima questi punti:

Il tuo sito Squarespace è online
il tuo piano supporta l'iniezione di codice
il frammento è stato aggiunto al campo Iniezione codice intestazione
i valori della tua dashboard mandera sono stati copiati alla lettera
le tue modifiche sono state salvate
La pagina che stai testando è pubblica
il tuo browser o ad blocker non sta bloccando lo script
Lo snippet non è installato due volte
Il Tag Manager Google viene pubblicato se hai installato mandera tramite GTM

Se lo script non compare nella scheda Rete, riapri le impostazioni di Code Injection e controlla se lo snippet è ancora attivo nel campo Header.

Drupal

mandera può essere installato su Drupal aggiungendo lo snippet di tracciamento nella sezione head del tuo sito web. A seconda della configurazione di Drupal, puoi farlo tramite un modulo di codice personalizzato, il tuo tema o il Tag Manager Google.

Usa il metodo che si adatta meglio al tuo sito e ai permessi che hai su Drupal.

Prima di installare: assicurati di avere accesso all'area amministrativa di Drupal e di sapere se il tuo sito web è gestito tramite un tema personalizzato, un pacchetto del sito o moduli contribuiti.

Metodo 1: Usa un modulo di codice personalizzato o script nell'header

Il modo più semplice per installare mandera su molti siti web Drupal è usare un modulo affidabile che ti permetta di aggiungere script alla sezione head del tuo sito.

Usa questo metodo se il tuo sito Drupal usa già codice personalizzato, script nell'header, o un modulo per l'header/footer, oppure se il tuo sviluppatore te lo consiglia.

Apri la tua area di amministrazione di Drupal.
Vai alla sezione moduli o configurazione dove si mettono gli script personalizzati nell'header.
Crea un nuovo script o apri il campo per gli script della testa.
Incolla lo snippet di tracciamento mandera nel campo della sezione head.
Applica lo snippet globalmente o a tutte le pagine pubbliche che vuoi misurare.
Salva le modifiche.
Svuota la cache di Drupal.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo pezzettino nella sezione head:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Usa solo moduli che sono fidati e mantenuti per la tua versione di Drupal. Se non sei sicuro di quale modulo usare, chiedi al tuo sviluppatore Drupal o all'amministratore del sito prima di installare un nuovo modulo.

Metodo 2: Aggiungi lo script tramite il tuo tema Drupal

Se il tuo sito web Drupal è gestito da uno sviluppatore, lo script mandera può essere aggiunto tramite il tema attivo o il pacchetto del sito.

Usa questo metodo se tu o il tuo sviluppatore potete modificare i file del tema.

Apri il tuo tema Drupal o il pacchetto del sito.
Apri il tema librerie.yml file.
Aggiungi lo script mandera come libreria JavaScript esterna.
Assicurati che la libreria sia caricata nell'header.
Allega la libreria globalmente attraverso il tuo tema info.yml file o un'altra impostazione del tema globale.
Sostituisci i valori segnaposto con quelli della tua dashboard mandera.
Salva e distribuisci le tue modifiche.
Svuota la cache di Drupal.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo blocco al tuo librerie.yml file:

mandera:
  header: true
  js:
    https:///analytics.js:
      type: external
      attributes:
        async: true
        mandera-org: ORG_ID
        data-property-id: PROPERTY_ID

Allega la libreria globalmente nel tuo tema info.yml file:

librerie:
  - yourtheme/mandera

Sostituisci il tuo tema con il nome della macchina del tuo tema Drupal attivo. Sostituisci anche ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Questo metodo è super utile per i siti Drupal, dove gli script sono gestiti in un unico posto tramite un tema, un sottotema o un processo di deploy.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito web Drupal utilizza già Google Tag Manager, puoi aggiungere lo snippet mandera tramite GTM invece di modificare la configurazione del tema Drupal.

Apri Google Tag Manager.
Scegli il container usato sul tuo sito Drupal.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito Drupal in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container del Tag Manager Google sia già installato sul tuo sito Drupal. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Risoluzione dei problemi per Drupal

Se non compaiono dati in mandera, controlla prima questi punti:

lo snippet è stato aggiunto all'installazione attiva di Drupal
il frammento si trova nella sezione head
lo snippet viene applicato globalmente o a tutte le pagine pertinenti
i valori della tua dashboard mandera sono stati copiati alla lettera
la cache di Drupal è stata svuotata
il tuo tema, sottotema o pacchetto del sito include le ultime modifiche
il tuo modulo di codice personalizzato è attivo e configurato a dovere
il tuo browser o ad blocker non sta bloccando lo script
Lo snippet non è installato due volte

Se lo script non compare nella scheda Network, verifica se la pagina che stai testando utilizza un tema, dominio, versione linguistica o configurazione del sito diversa. I siti web Drupal possono avere configurazioni diverse per sezioni diverse, quindi lo snippet potrebbe dover essere aggiunto tramite la configurazione globale del tema o del sito.

Webflow

Puoi installare mandera su Webflow aggiungendo lo snippet di tracciamento al codice personalizzato a livello di sito. In questo modo lo snippet verrà caricato su tutte le pagine pubbliche che vuoi che mandera monitori.

Usa questo metodo se il tuo sito è su Webflow e hai accesso alle impostazioni del sito.

Prima di installare: Assicurati che il tuo sito Webflow sia pubblicato e che il tuo piano del sito o dello spazio di lavoro supporti il codice personalizzato.

Metodo 1: Aggiungi lo snippet tramite il sito Settings

Il modo consigliato per installare mandera su Webflow è aggiungere lo snippet di tracciamento nel campo "Codice Head" a livello di sito.

Apri la tua dashboard di Webflow.
Seleziona il sito web su cui vuoi installare mandera.
Apri il sito Settings.
Vai alla scheda Codice personalizzato.
Incolla lo snippet di tracciamento mandera nel campo "Codice Head".
Salva le modifiche.
Pubblica il tuo sito Webflow.
Apri il tuo sito web in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo snippet al campo "Codice nella testa del sito" ovunque:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Il codice inserito nel campo "Codice di intestazione per tutto il sito" viene caricato su tutto il tuo sito Webflow. Questa è l'opzione migliore per la configurazione standard mandera, perché lo snippet dovrebbe essere disponibile su ogni pagina pubblica che vuoi monitorare.

Metodo 2: Aggiungi lo snippet a una pagina specifica

Se vuoi provare mandera solo su una pagina Webflow per ora, puoi aggiungere lo snippet di tracciamento tramite il codice personalizzato a livello di pagina.

Usa questo metodo solo a scopo di test o per le pagine in cui mandera deve essere limitato a una parte specifica del tuo sito web.

Apri il tuo progetto Webflow nel Designer.
Apri il pannello Pagine.
Seleziona la pagina in cui vuoi installare mandera.
Apri le impostazioni della pagina.
Scorri fino alla sezione Codice personalizzato.
Incolla lo snippet di tracciamento mandera all’interno di <head> campo tag.
Salva le modifiche.
Pubblica il tuo sito Webflow.
Apri la pagina in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Aggiungi questo snippet alla pagina Inside <head> Etichetta:

<script
  src="https://<your-mandera-web-url>/analytics.js"
  mandera-org="ORG_ID"
  data-property-id="PROPERTY_ID"
  async
></script>

Sostituisci ID_ORG, ID_PROPRIETÀ e lo script URL con i valori della tua dashboard mandera.

Se vuoi che mandera monitori l'intero sito web, usa invece il metodo del codice Head a livello di sito. L'installazione a livello di pagina si applica solo alla pagina selezionata.

Metodo 3: Usa il Tag Manager Google

Se il tuo sito Webflow utilizza già Google Tag Manager, puoi aggiungere lo snippet mandera tramite GTM invece di inserirlo direttamente tramite il codice personalizzato di Webflow.

Apri Google Tag Manager.
Scegli il contenitore usato sul tuo sito Webflow.
Crea un nuovo tag.
Scegli un tag HTML personalizzato.
Incolla lo snippet di tracciamento mandera nel campo HTML.
Imposta il trigger su tutte le pagine.
Salva e pubblica il contenitore.
Apri il tuo sito Webflow in una nuova scheda del browser.
Verifica l'installazione con i passaggi sopra.

Assicurati che il container di Google Tag Manager sia già installato sul tuo sito Webflow. Se il container non si carica, non si caricherà nemmeno lo snippet mandera.

Elementi di incorporamento codice di Webflow

Non usare un normale elemento "Code Embed" per l'installazione di base di mandera. Gli elementi "Code Embed" sono utili per i codici incorporati visibili o per i contenuti delle pagine, ma lo snippet di tracciamento di mandera va caricato a livello globale nella sezione <head> del tuo sito web.

Risoluzione problemi per Webflow

Se non compaiono dati in mandera, controlla prima questi punti:

Il tuo sito Webflow è pubblicato
Il tuo sito o piano di lavoro supporta codice personalizzato
lo snippet è stato aggiunto al campo Codice testata del sito
i valori della tua dashboard mandera sono stati copiati alla lettera
le tue modifiche sono state salvate e pubblicate
La pagina che stai testando è pubblica
il tuo browser o ad blocker non sta bloccando lo script
Il Tag Manager Google viene pubblicato se hai installato mandera tramite GTM
Lo snippet non è installato due volte

Se lo script non compare nella scheda Network, apri di nuovo le impostazioni del codice personalizzato di Webflow e controlla se lo snippet è ancora attivo nel campo Codice Head. Poi pubblica di nuovo il sito e testa il sito live, non solo l'anteprima di Webflow.

Cosa viene dopo

Dai un'occhiata ai tuoi primi dati

Una volta installato lo snippet, mandera può raccogliere i dati analitici del tuo sito web. Questi dati vengono visualizzati nella suite di analisi e aiutano il sistema a comprendere il traffico, le fonti e le pagine.

La stessa configurazione supporta anche il sistema mandera, più ampio. I dati analitici possono alimentare il contesto, le intuizioni del SEO e le opportunità di crescita non appena le parti correlate del tuo spazio di lavoro saranno pronte.

Continua con le guide di sistema

Dopo l'installazione, apri la suite di analisi e controlla se iniziano a comparire i dati. Poi segui le guide di sistema per capire come mandera utilizza quei dati nei flussi di lavoro relativi all'analisi, a SEO, al contesto e alla crescita.

Relativo

Iniziamo
Analytics Suite
Settings
Concetti chiave
Come seguiamo
Aiuto

Ultimo aggiornamento: 12 giugno 2026