JavaScript personalizzato (codici di tracciamento)

Panoramica

L’opzione JavaScript personalizzato ti permette di integrare i tuoi script di tracciamento o di analisi direttamente nella tua esperienza Drimify.
Viene generalmente utilizzata per strumenti come Facebook Pixel, Google Analytics, Google Tag Manager o altri servizi di terze parti che richiedono uno snippet JavaScript.
Trovi questa opzione nel pannello Impostazioni del progetto, nella sezione JavaScript personalizzato.

⚠️ Importante: è supportato solo JavaScript lato client. Non è possibile utilizzare script lato server o backend.

A cosa serve

Puoi utilizzare JavaScript personalizzato per:

• Monitorare le visualizzazioni di pagina e il comportamento degli utenti
• Attivare eventi al caricamento dell’esperienza
• Integrare il monitoraggio delle conversioni (ad esempio, gli eventi di Facebook Pixel)
• Collegare la tua esperienza a strumenti di analisi o di marketing
• Aggiungere logiche personalizzate a schermate specifiche

Hai così la massima flessibilità per collegare Drimify agli strumenti di tracciamento che preferisci.

Come aggiungere uno script

1. Apri il progetto nella bacheca di Drimify.
2. Vai su Impostazioni.
3. Scorri fino alla sezione JavaScript personalizzato.
4. Incolla il codice JavaScript direttamente nel campo.
5. Assicurati che l’impostazione sia stata salvata e pubblica l’esperienza, se non l’hai già fatto.

Lo script verrà inserito automaticamente nell’esperienza pubblicata.

Esempio: Facebook Pixel

Ecco un esempio di script di tracciamento standard di Facebook Pixel che puoi aggiungere:

<!-- Facebook Pixel Codice -->
<script>
  !function(f,b,e,v,n,t,s)
  {if(f.fbq)return;n=f.fbq=function(){n.callMethod?
  n.callMethod.apply(n,arguments):n.queue.push(arguments)};
  if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
  n.queue=[];t=b.createElement(e);t.async=!0;
  t.src=v;s=b.getElementsByTagName(e)[0];
  s.parentNode.insertBefore(t,s)}(window, document,'script',
  'https://connect.facebook.net/en_US/fbevents.js');
  fbq('init', 'YOUR_PIXEL_ID');
  fbq('track', 'PageView');
</script>

Sostituisci YOUR_PIXEL_ID con l’ID effettivo del tuo Facebook Pixel.

Monitorare un lead o una conversione quando qualcuno si registra

Il codice JavaScript personalizzato viene eseguito una sola volta, al caricamento dell’esperienza. Le esperienze Drimify sono applicazioni a pagina singola: l’indirizzo nel browser non cambia passando da una schermata all’altra. Di conseguenza, né uno script inserito in questo campo né una regola basata sull’URL in Gestione eventi di Meta possono rilevare il momento in cui un partecipante invia il modulo di registrazione. Utilizza invece una delle due configurazioni seguenti.

Opzione 1: i giocatori aprono direttamente il link del gioco (ad esempio, da un’inserzione Meta)

1. Nella fase Integrazioni dell’app, collega un webhook e attiva Dopo l’invio del modulo. Il webhook si attiva ogni volta che un partecipante invia un modulo. Consulta Configurazione delle integrazioni webhook all’interno della tua app.
2. Configura il webhook in modo che invii le richieste al tuo endpoint o a uno strumento di automazione, quindi inoltra ogni chiamata a Meta come evento Lead tramite l’API Conversions di Meta (o un’API lato server equivalente della tua piattaforma pubblicitaria).

Mantieni il codice base del Pixel nel campo JavaScript personalizzato per monitorare le visite al gioco.

Opzione 2: il gioco è incorporato nel tuo sito web

Carica il Pixel sulla tua pagina e attiva l’evento tramite le callback del codice di integrazione HTML (widget). La callback onComplete viene eseguita quando il partecipante raggiunge l’ultima schermata. Se il modulo di registrazione si trova prima della schermata finale, ogni esecuzione di onComplete corrisponde quindi a un partecipante registrato:

widget.onComplete = function (event) {
  fbq('track', 'Lead');
};

Per Calendario Dell'Avvento, Combo™ o Percorso Dinamico™, utilizza invece onRouteChange e il raggiungimento della schermata finale. Consulta Integrazione avanzata del codice di integrazione HTML (widget) tramite l’API.

Ambito di esecuzione

• Gli script vengono eseguiti nel browser del partecipante.
• Lo script viene eseguito dopo il caricamento dell’esperienza, garantendo la compatibilità con la maggior parte dei servizi di analisi.

Note sulla sicurezza

• Gli script dannosi o invasivi sono severamente vietati.
• Utilizza solo codice JavaScript proveniente da fornitori affidabili.
• Gli script devono rispettare il GDPR e le altre normative applicabili in materia di privacy.
• È tua responsabilità informare i partecipanti di eventuali attività di tracciamento o raccolta di dati.

Risoluzione dei problemi

Lo script non viene eseguito?

• Assicurati che il codice sia racchiuso tra i tag <script>, se necessario.
• Verifica che non ci siano errori di sintassi.
• Per il tracciamento basato sugli eventi, verifica che i trigger degli eventi siano posizionati correttamente.
• Controlla nella piattaforma di analisi se l’evento è stato ricevuto.

Hai bisogno di aiuto?

Se hai dubbi su come integrare uno script specifico, contatta il fornitore del servizio di tracciamento (Facebook, Google, ecc.) per ricevere istruzioni.
Se ritieni che lo script sia configurato correttamente ma non funzioni, contatta il nostro team di supporto e spiega nel dettaglio cosa stai cercando di ottenere.

Aggiornato il: 29/10/2026