Installa i moduli sul tuo sito

Un solo tag script mostra sul sito tutti i moduli attivi del workspace. Questa pagina spiega dove inserirlo, come posizionare i moduli incorporati, come aprire un modulo dal tuo codice e come controllare che le risposte arrivino.

Prima di iniziare

• Crea e pubblica almeno un modulo. Sul sito compaiono solo i moduli attivi. Vedi Crea un modulo.
• Devi poter modificare l’HTML del sito, oppure aggiungere un tag HTML personalizzato nel tuo tag manager.

Aggiungi lo script

1. Copia lo snippet. In Email Marketing›Forms, seleziona Install. Lo snippet si trova anche nella pagina di ogni modulo, nel riquadro Installation. Ha questo aspetto, con la chiave pubblica del workspace nel percorso:

   HTML

   <script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script>

2. Aggiungilo a ogni pagina. Incollalo una volta nel layout o nel template condiviso del sito, idealmente subito prima del tag di chiusura </body>. Lo snippet è lo stesso per tutti i moduli del workspace, quindi lo installi una sola volta.

3. Pubblica i moduli. Popup, slide-in, moduli a pagina intera e banner attivi compaiono ora sul sito senza altro codice.

Lo script viene caricato in modo asincrono e non blocca la pagina. Se qualcosa non funziona, ad esempio per un errore di rete, non mostra nulla e la pagina continua a funzionare. Funziona anche quando viene aggiunto tramite un tag manager.

Se il sito usa una Content Security Policy, consenti https://js.emailit.com in script-src e connect-src.

Come compaiono i moduli in sovrimpressione

Per cambiare il ritardo, imposta display_delay_seconds nei settings del modulo con Aggiorna un modulo.

Quando un visitatore chiude un modulo, questo resta nascosto in quel browser per 7 giorni. Dopo che lo ha inviato, resta nascosto per un anno. Emailit lo ricorda nel local storage del browser, con la chiave emailit_forms_v1, e non imposta cookie. Se il local storage non è disponibile, i moduli compaiono a ogni caricamento di pagina.

Incorpora un modulo nella pagina

I moduli incorporati vengono mostrati all’interno dei contenuti, ad esempio nel footer o nella barra laterale di un blog. Oltre allo script, richiedono un elemento segnaposto:

1. Copia il segnaposto. Apri la pagina del modulo incorporato. Il riquadro Installation mostra il segnaposto con il token pubblico del modulo:

   HTML

   <div data-emailit-form="FORM_TOKEN"></div>

2. Posizionalo. Incolla il segnaposto dove deve comparire il modulo. Puoi usare lo stesso modulo in più punti.

3. Controlla lo script. Assicurati che nella pagina ci sia anche lo script.

Lo script compila ogni segnaposto data-emailit-form il cui token corrisponde a un modulo incorporato attivo. Osserva anche la pagina, quindi i segnaposto aggiunti in seguito, ad esempio da una single-page app, vengono compilati quando compaiono. I moduli incorporati compaiono sempre, che il visitatore li abbia già inviati o no.

Apri un modulo dal tuo codice

Chiama emailit("show", token) per aprire un popup, uno slide-in, un modulo a pagina intera o un banner quando vuoi tu, ad esempio da un pulsante:

<button type="button" onclick="emailit('show', 'FORM_TOKEN')">
  Join the newsletter
</button>

• Il modulo si apre subito, anche se il visitatore l’ha già chiuso o inviato in precedenza.
• Il modulo deve essere attivo e lo script deve essere nella pagina.
• Le chiamate fatte mentre lo script è ancora in caricamento vengono messe in coda ed eseguite quando è pronto.
• Per un modulo incorporato, show cerca di nuovo i suoi segnaposto nella pagina.

openForm funziona come alias di show.

Gestisci un modulo attivo

Aggiorna o ritira

Le modifiche salvate su un modulo attivo, o il suo ritiro, arrivano sul sito entro circa un minuto. Per togliere un modulo dal sito, apri la sua pagina e seleziona Unpublish. Torna allo stato di bozza e puoi pubblicarlo di nuovo in seguito.

Reimposta il token pubblico

Ogni modulo ha un token pubblico, mostrato come Public token nella sua pagina. Lo usano i segnaposto dei moduli incorporati e le chiamate emailit("show", ...). Per emetterne uno nuovo, chiama Reimposta il token pubblico:

curl https://api.emailit.com/v2/forms/frm_8Lq2Wx5nVb3Tk/reset-token \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Il vecchio token smette subito di funzionare, quindi aggiorna i segnaposto e il codice con il nuovo token della risposta. I moduli in sovrimpressione che compaiono automaticamente non sono interessati.

Controlla le risposte

Invia il modulo dal sito con i tuoi dati, poi apri la pagina del modulo nel pannello. Recent submissions elenca ogni risposta con l’ora di Created e il Payload: i valori inviati, indicizzati per nome della proprietà di ogni campo. Filtra l’elenco per data di creazione.

Insieme ai valori, Emailit memorizza con ogni risposta l’URL della pagina, il referrer, l’indirizzo IP del visitatore e lo user agent del suo browser. Indicalo nella tua informativa sulla privacy.

Per ora le risposte non vengono aggiunte ai contatti o alle liste. Vedi Risposte.

Risoluzione dei problemi

Vedi anche