Monitoraggio nel modulo incorporato (iFrame)

Se incorpori il tuo modulo nel tuo sito web tramite iFrame e desideri monitorare le conversioni (Google Tag Manager, Facebook Pixel, Etracker ecc.), il funzionamento è leggermente diverso rispetto a un normale modulo web. Ecco le domande più frequenti.

Dove viene eseguito lo script di tracciamento: sulla mia pagina o nell'iFrame?

Entrambe le opzioni sono possibili e presentano vantaggi diversi:

• Tracciamento sulla tua pagina (al di fuori dell'iFrame): traccia la visualizzazione della pagina del modulo, ma non rileva automaticamente l'invio del modulo (poiché l'invio avviene all'interno dell'iFrame).
• Tracking nel modulo (all'interno dell'iFrame, da propform): traccia l'invio in modo affidabile, poiché il codice viene eseguito direttamente con il modulo.

Raccomandazione: inserisci gli script di tracciamento direttamente nel modulo propform. Trovi i campi in Impostazioni modulo → Tracciamento:

• Google Tag Manager (ID contenitore)
• Facebook Pixel (ID)
• Etracker (ID account)

Tracciare la conversione dopo l'invio riuscito

Dopo un invio riuscito, il visitatore arriva sulla pagina di ringraziamento — lì propform inserisce un evento personalizzato nel dataLayer, a cui il tuo contenitore GTM può rispondere. Esempio di trigger in GTM:

• Tipo di trigger: Evento personalizzato
• Nome evento: onload_thank_you_page

Da questo puoi poi attivare, ad esempio, un tag di conversione di Google Ads o un evento del pixel di Meta (fbq('track', 'Lead')).

⚠️ Esiste anche un evento form_submit — ma si attiva già al clic sul pulsante di invio, anche se l'invio fallisce a causa di un campo obbligatorio. Per le conversioni usa quindi onload_thank_you_page. Tutti gli eventi in sintesi: capitolo sul tracciamento.

Cross-Origin: il mio tracciamento sul sito web non rileva l'invio dell'iFrame

Questo è normale e inevitabile: per impostazione predefinita, i browser bloccano l'accesso in lettura ai dati tra frame con domini diversi.

Soluzioni alternative:

• Inserire il tracciamento direttamente nel modulo (vedi sopra) — la soluzione più pulita
• Se vuoi reagire agli eventi del modulo dal tuo sito web: non appena Google Tag Manager è attivato nel modulo, propform invia inoltre gli eventi del modulo (form_onload, form_start_input, form_submit, form_abort, form_next_step, form_previous_step) alla pagina principale tramite postMessage come stringa JSON:

// Sulla pagina principale (il tuo sito web):
window.addEventListener('message', function (e) {
  try {
    var data = JSON.parse(e.data);
    if (data.event === 'form_submit') {
      // ad es. attivare il proprio tracciamento
    }
  } catch (err) { /* ignorare i messaggi estranei */ }
});

💡 Nota: form_submit si attiva al clic sul pulsante di invio. L'evento della pagina di ringraziamento (onload_thank_you_page) viene eseguito solo all'interno dell'iFrame nel dataLayer — la misurazione affidabile delle conversioni va quindi fatta nel modulo stesso (GTM/pixel nelle impostazioni del modulo).

Trasmettere i parametri URL dalla pagina principale all'iFrame

Se l'URL del tuo sito web ha dei propri parametri URL (ad es. ?region=berlin&kampagne=spring2026) e desideri precompilarli nel modulo incorporato, propform lo fa automaticamente:

• I parametri dell'URL principale vengono trasmessi all'iFrame
• Nel modulo funzionano come normali parametri URL (ad es. ?address[region]=berlin compila il campo "Regione di indirizzo")

Requisiti:

• I rispettivi campi nel modulo propform hanno l'opzione "Consenti precompilazione con parametri URL" attivata
• I nomi dei parametri seguono la convenzione di propform (?modul[feld]=wert)

Caso d'uso: Pagina di destinazione con ?region=berlin → il modulo di richiesta incorporato precompila automaticamente il campo "Regione" → l'utente non deve selezionarlo nuovamente.

> 💡 Se il trasferimento non funziona nella tua configurazione (codice di incorporamento precedente, script wrapper personalizzato): invia una breve e-mail a hello@propform.io — verificheremo il tuo snippet iFrame.

Consenso ai cookie / GDPR

> ⚠️ Importante: non appena attivi il tracciamento, in qualità di gestore del modulo sei responsabile della conformità al GDPR. Ciò significa che, prima di impostare i cookie di tracciamento, è necessario ottenere il consenso del visitatore.

Maggiori informazioni nel capitolo sul tracciamento e nel capitolo sulla protezione dei dati.

Webhook come alternativa al tracciamento del browser

Se desideri reagire a livello di server a ogni invio andato a buon fine (ad es. conteggiare la conversione nelle tue statistiche CRM), utilizza invece i webhook: sono più affidabili del tracciamento del browser, poiché non dipendono dagli adblocker o dal consenso ai cookie.

📖 Maggiori informazioni: Webhook