ARTICOLO NUMERO 51 · CRM E QUALITÀ DEL DATO
CRM fotovoltaico: come creare un dizionario dei campi
Un campo è affidabile soltanto se marketing, commerciale e integrazioni gli attribuiscono lo stesso significato. Il dizionario rende espliciti nome, definizione, formato, valori ammessi e responsabile dell’aggiornamento.
“Lead qualificato” può significare richiesta valida per il marketing, contatto raggiunto per il commerciale oppure opportunità accettata dal responsabile vendite. Se la stessa etichetta indica eventi diversi, dashboard, costi e passaggi fra strumenti diventano incomparabili. Il rimedio non è aggiungere un’altra colonna: è definire un dizionario dei campi.
Il dizionario separa etichetta, significato e formato
Un dizionario dati è un registro delle proprietà usate nel processo. Per ogni campo chiarisce che cosa rappresenta, quale formato accetta, chi lo alimenta e quando può cambiare. Può vivere in Google Sheets anche quando il sistema operativo è un CRM: il foglio documenta le regole, non sostituisce necessariamente l’applicazione.
La distinzione è concreta. “Data lead” può essere una data senza ora, un timestamp di ricezione o la data di importazione. “Provincia” può essere testo libero, sigla normalizzata o valore ricavato dal CAP. Senza una scelta esplicita, due integrazioni possono compilare lo stesso campo in modi incompatibili.
Le colonne minime del dizionario
| Colonna | Domanda a cui risponde |
|---|---|
| Nome interno | Quale chiave usano API e integrazioni? |
| Etichetta visibile | Che cosa legge l’operatore? |
| Definizione | Quale evento o attributo rappresenta? |
| Tipo e valori ammessi | Testo, numero, data, sì/no o elenco controllato? |
| Fonte | Modulo, campagna, integrazione o operatore? |
| Responsabile | Chi può correggerlo e in quale momento? |
| Regola per il vuoto | “Non noto” è diverso da “non applicabile”? |
La documentazione ufficiale HubSpot mostra che il tipo di proprietà determina come l’informazione viene raccolta e conservata: testo, numero, data, casella singola o selezione da un elenco non sono intercambiabili. Per gli elenchi, etichetta e nome interno hanno inoltre ruoli diversi nelle interfacce e nelle integrazioni.
Esempio: “esito appuntamento” non è una nota libera
Supponiamo che il team debba distinguere appuntamento prenotato, svolto, rinviato, annullato e no-show. Nel dizionario, il campo potrebbe essere definito come “ultimo esito osservato dell’appuntamento collegato all’opportunità”, con un elenco controllato e un responsabile preciso. La data dell’appuntamento resta in un campo separato; le note non sostituiscono l’esito.
Se il registro è in Google Sheets, le regole di convalida possono proporre un menu a discesa e rifiutare valori non previsti. Google documenta sia gli elenchi inseriti manualmente sia quelli alimentati da un intervallo. Questo riduce varianti come “non presentato”, “assente” e “no show”, ma non corregge una definizione sbagliata: prima viene il significato, poi il controllo tecnico.
Procedura di adozione senza perdere lo storico
- Inventaria i campi esistenti nel CRM, nei moduli, nelle integrazioni e nei fogli: non partire dai nomi desiderati, ma da ciò che viene realmente scritto.
- Raggruppa duplicati e omonimi. Due campi diversi possono contenere la stessa informazione; uno stesso nome può avere significati diversi.
- Scegli un campo canonico per ogni informazione e compila tutte le colonne del dizionario prima di modificare il sistema.
- Definisci valori ammessi, distinzione fra vuoto e “non noto”, formato delle date e proprietà che non devono essere sovrascritte. La guida sulle sovrascritture in Google Sheets affronta quest’ultimo rischio.
- Mappa i campi vecchi verso quelli canonici e prova la trasformazione su un campione copiato. Non riscrivere lo storico se la corrispondenza non è verificabile.
- Aggiorna moduli, automazioni e report; poi controlla che gli eventi temporali e i parametri UTM mantengano la loro semantica.
Il dizionario è una regola di lavoro, non un file dimenticato
Ogni nuova proprietà dovrebbe avere un proprietario, una motivazione e una versione della definizione. Se una voce cambia significato, la data della modifica va registrata: altrimenti i report prima e dopo il cambiamento sembrano confrontabili ma misurano eventi diversi.
Conviene inoltre distinguere i campi raccolti dal modulo, quelli calcolati dalle integrazioni e quelli aggiornati dal commerciale. Calendario Pieno coordina campagne e referente; non effettua direttamente le chiamate del team cliente. Il dizionario rende visibile questo confine e impedisce di attribuire automaticamente a marketing dati che dipendono dall’operatività commerciale.
Fonti ufficiali consultate il 5 novembre 2026: editor delle proprietà HubSpot, tipi di campo delle proprietà HubSpot e menu a discesa e convalida dati in Google Sheets. Le fonti descrivono funzioni di piattaforma; schema e procedura proposti sono analisi editoriale di Calendario Pieno, non uno standard universale.
← Torna a tutti gli articoli