mailinapp
Documentation menu

Blocco Valutazione

Una domanda di feedback a un tap — il blocco dietro le misurazioni in stile CSAT, CES e NPS. Strutturalmente è un sondaggio con un set di etichette diverso: ogni punteggio è al tempo stesso un controllo reale dentro l'email e un link semplice, così la valutazione funziona ovunque funzioni un sondaggio, con avvisi e una domanda di follow-up condizionale in più.

Come funziona

Come il blocco sondaggio, ogni punteggio viene renderizzato con due rappresentazioni contemporaneamente: un vero <form method="post"> per opzione ovunque funzionino gli invii dentro l'email, nascosto via CSS dietro un semplice link <a href> verso /v/[token]/act per tutto il resto. Quel link di fallback copre Outlook, o qualsiasi client che non riesca a inviare un modulo dentro l'email. Qualunque percorso si attivi, toccare un punteggio registra un'azione rate che porta quel valore. Viene deduplicato per destinatario esattamente come un voto di sondaggio: un id di documento Firestore deterministico fa sì che un destinatario che ritocca il proprio stesso link di conferma non abbia effetto, invece di generare una seconda riga. Inoltre non viene mai conteggiato su una semplice pre-lettura del link, solo sull'azione confermata.

Tre stili di visualizzazione condividono questo identico meccanismo di invio, quindi passare dall'uno all'altro non rompe né rimodella mai le risposte esistenti:

  • Stelle — la classica riga di 3–10 stelle (impostata da scala), ciascuna un punteggio toccabile da 1 fino alla scala.
  • Scala numerata — una riga in stile Likert di pulsanti numerati (anch'essa dimensionata da scala), con le tue didascalie etichetta bassa e etichetta alta a ciascun estremo, es. "Fortemente in disaccordo" → "Fortemente d'accordo".
  • NPS — una riga fissa 0–10, che ignora del tutto il campo scala (l'NPS ha sempre undici pulsanti), con etichette basso/alto che di default sono "Per niente probabile" e "Estremamente probabile" se le lasci vuote.

Altri due campi trasformano una semplice valutazione in un segnale operativo invece che in un semplice numero:

  • Soglia di avviso (valutazione ≤ N) — impostala e una risposta pari o inferiore a quella soglia viene segnalata nell'istante in cui arriva: imposta il flag lowScore sul payload del webhook e può attivare un avviso email in-app verso indirizzi che configuri sul progetto, senza bisogno di alcun passaggio Zapier/Make per il caso base. Ogni blocco di valutazione imposta la propria soglia in modo indipendente — una domanda CSAT 1–5 e una domanda CES 0–10 richiedono soglie diverse, e un progetto può avere più di un blocco valutazione.
  • Domanda di follow-up, posta quando valutazione ≤ N — un prompt opzionale a testo libero (es. "Cosa è andato storto?") che appare subito dopo l'invio di un punteggio basso che soddisfa la condizione. Questo appare solo sulla vista live ospitata, mai nell'HTML inviato via email — un'email statica non può ramificare il proprio contenuto in base a una risposta appena data, dato che non c'è un round-trip verso un server a lettura in corso. La risposta del follow-up arriva nelle tue risposte come una normale risposta a testo libero collegata allo stesso destinatario, sotto una colonna <domanda> — follow-up nell'esportazione CSV.

Altri campi configurabili: testo della domanda (con colore/dimensione font propri), colore di sfondo, padding, bordo, raggio del bordo, colore/dimensione font etichetta estremo, e una sovrascrittura colore per il chip (testo e sfondo) applicata a ogni pulsante punteggio. Se la data di chiusura o il limite di risposte del ciclo di vita del sondaggio del progetto è stato raggiunto, la vista live sostituisce i chip con equivalenti inerti e ingrigiti con una nota di chiusura. L'HTML inviato via email resta statico e non ne è influenzato, dato che quel controllo avviene solo quando la pagina viene aperta.

Le risposte vengono riepilogate automaticamente: conteggio delle risposte, media, e un istogramma completo (la distribuzione dietro la media — una media di 4,1 appare molto diversa a seconda che sia composta perlopiù da 4 o da un mix di 5 e 1), una ripartizione promotori/passivi/detrattori specifica per NPS e un punteggio −100…100 per i blocchi in stile NPS, oltre a un grafico dell'andamento delle risposte nel tempo. Vedi Riepiloghi CSAT, CES e NPS.

Esempi

Subject

How was your recent order?

Una domanda CSAT post-acquisto ("Come abbiamo fatto? 1–5 stelle") inserita verso il fondo di un'email di conferma spedizione è l'uso più semplice, specialmente con una soglia impostata a 2 così un'esperienza negativa viene instradata direttamente verso un'email di avviso invece di restare inosservata in una dashboard. Vedi Sondaggi e feedback NPS per il pattern più ampio. Un controllo trimestrale sulla salute della relazione funziona bene in stile NPS con una domanda di follow-up a ≤6 ("Cosa ti farebbe raccomandarci più volentieri?"), trasformando un numero passivo in un commento azionabile proprio dai clienti a rischio. Un'email di risoluzione ticket di supporto può porre una domanda in stile CES "Quanto è stato facile ottenere questa risoluzione?" su una scala numerata 1–7 con etichette basso/alto personalizzate, alimentando una metrica specificamente sullo sforzo piuttosto che sulla soddisfazione.

Come appare il fallback statico

<div id="em-rating-1" style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">How did we do?</p>
  <div>
    <span class="kn-fallback">
      <a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rating-1&blockType=rating&action=rate&rating=5"
         style="display:inline-block;margin:0 6px 6px 0;padding:8px 14px;border:1px solid #d1d5db;border-radius:6px;background-color:#ffffff;color:#111827;font-size:14px;text-decoration:none">
        5★
      </a>
    </span>
  </div>
</div>

Questo è il link di livello 2 per un singolo chip stella — visibile solo dove il <form> equivalente dentro l'email è nascosto via CSS — che punta a /v/[token]/act con il punteggio portato come parametro di query.

Vedi anche