> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exoid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Concetti chiave

> Il vocabolario di Exoid: workspace, campagne, blocchi, codice domanda, quote, crediti e i tre stadi di una campagna.

Prima di costruire il tuo primo studio ti conviene fissare qualche termine. Sono le parole che ritrovi ovunque nella piattaforma e in questa documentazione: capirle una volta ti risparmia confusione dopo.

Gli oggetti stanno uno dentro l'altro: il workspace contiene le campagne, la campagna è un flusso di blocchi, e quello che torna indietro dai rispondenti si divide in tre tipi di risposta.

```mermaid theme={"dark"}
%%{init: {'theme':'base','themeVariables':{'fontFamily':'ui-sans-serif, -apple-system, system-ui, sans-serif','fontSize':'15px','lineColor':'#8891C7','primaryColor':'#4252FF','primaryTextColor':'#FFFFFF','primaryBorderColor':'#4252FF','clusterBkg':'transparent','clusterBorder':'#8891C7','titleColor':'#6B78FF','tertiaryTextColor':'#6B78FF','edgeLabelBackground':'transparent'}}}%%
flowchart LR
  W["Workspace"] --> C["Campagna"]
  C --> B["Blocchi"]
  C --> R["Risposte"]
  R --> RN["Normali"]
  R --> RS["Screened out"]
  R --> RD["Scartate"]

  classDef primary fill:#4252FF,stroke:#4252FF,color:#FFFFFF,rx:8,ry:8
  classDef step fill:#6B78FF,stroke:#6B78FF,color:#FFFFFF,rx:8,ry:8
  classDef soft fill:#2B34B8,stroke:#2B34B8,color:#FFFFFF,rx:8,ry:8
  classDef ghost fill:transparent,stroke:#8891C7,stroke-dasharray:4 4,color:#8891C7,rx:8,ry:8

  class W step
  class C primary
  class B step
  class R primary
  class RN,RS,RD soft
```

## Il glossario della piattaforma

| Concetto                      | In una riga                                                                                          |
| ----------------------------- | ---------------------------------------------------------------------------------------------------- |
| Workspace                     | Lo spazio della tua organizzazione: campagne, membri e impostazioni.                                 |
| Campagna / studio             | Un singolo studio, con nome, stato e flusso di blocchi.                                              |
| Blocco                        | L'unità minima del Builder: una domanda, un messaggio o una schermata finale.                        |
| Codice domanda                | L'identificativo di una domanda, che ritrovi nei risultati, negli export, nei filtri e negli script. |
| Canvas                        | La vista a nodi dove disegni il flusso.                                                              |
| Linear Builder                | La vista lineare alternativa: lista domande, preview e configurazione.                               |
| Condizione                    | La regola che indirizza il rispondente su percorsi diversi.                                          |
| Variabile di contesto         | Un valore dinamico `{{nome}}` inserito nei testi dell'intervista.                                    |
| Rispondente                   | Chi risponde all'intervista.                                                                         |
| Quota                         | Il tetto massimo di completamenti per un profilo di risposta.                                        |
| Crediti                       | La riserva a consumo, usata soprattutto per il recruiting dal panel.                                 |
| Modalità statistiche avanzate | L'impostazione che sblocca variabili, espressioni logiche, condizioni di visibilità ed export SPSS.  |

<AccordionGroup>
  <Accordion title="Workspace" icon="building-2">
    In Exoid ogni azienda lavora dentro un workspace: lo spazio in cui si creano gli studi, si gestiscono i collaboratori e si analizzano i dati.

    Il workspace ha un nome, un logo, un paese di fatturazione e un elenco di membri con ruoli diversi. Tutte le campagne appartengono a un workspace, e così i crediti e i limiti del piano.

    Il menu laterale del workspace è Dashboard, Membri, Docs, Impostazioni e Supporto.
  </Accordion>

  <Accordion title="Campagna / studio" icon="file-text">
    La campagna è il tuo studio. Ha un nome identificativo, uno stato e un flusso di blocchi.

    Gli stati sono tre:

    * **Bozza** — stato iniziale. L'intervista non è accessibile ai rispondenti.
    * **Live** — l'intervista è pubblica e si può condurre tramite link o canali di distribuzione.
    * **Chiuso** — disattivata manualmente o al raggiungimento dei limiti definiti. Resta visibile ma non accetta nuove risposte.
  </Accordion>

  <Accordion title="Blocco" icon="rows-3">
    Il blocco è l'unità del Builder. Può essere una domanda (scelta multipla, slider, rating, matrice…), un messaggio informativo non interattivo o una schermata finale.

    Ogni blocco ha un punto di uscita in basso e un punto di ingresso in alto. Trascini il connettore dall'uscita di un blocco all'ingresso di un altro per definire il percorso dell'intervista.
  </Accordion>

  <Accordion title="Codice domanda" icon="hash">
    Ogni domanda porta un codice — `Q1_ETA`, `SQ_HYPE_CLIENTE` — che imposti nelle opzioni del blocco. È il nome con cui la domanda ricompare ovunque: le colonne della tabella delle risposte, i file di export, i filtri e i cluster di confronto nei risultati, e l'API `questions.<CODICE>.responseValue` negli script.

    Scegli codici che riconoscerai ancora in un foglio Excel fra sei mesi, e impostali prima di iniziare a raccogliere.
  </Accordion>

  <Accordion title="Canvas e Builder visuale" icon="layout-dashboard">
    Il canvas è la vista a nodi in cui costruisci il flusso. I blocchi si spostano liberamente con drag & drop e si riallineano con il comando Auto Layout, senza modificare le logiche.

    Dalla toolbar del canvas gestisci anche zoom, schermo intero, import ed export JSON della struttura, impostazioni, tema e cronologia delle versioni.
  </Accordion>

  <Accordion title="Linear Builder" icon="list">
    La vista lineare alternativa, divisa in tre aree: a sinistra la lista delle domande, al centro la preview live di ciò che vedrà il rispondente, a destra la configurazione del blocco selezionato.

    È la vista giusta per lavorare su logiche e condizioni di visibilità. Per cambiare la struttura (eliminare o riordinare i blocchi) devi tornare al Builder visuale.
  </Accordion>

  <Accordion title="Condizione" icon="git-branch">
    Una condizione decide dove indirizzare il rispondente in base alle sue risposte. Si compone sempre di tre elementi: domanda di riferimento, operatore e valore da verificare.

    Più condizioni si combinano con **AND** (tutte vere) o **OR** (almeno una vera). Con il comando **Go To** il Builder crea automaticamente il collegamento tra i nodi.
  </Accordion>

  <Accordion title="Variabile di contesto" icon="braces">
    Un valore dinamico che inserisci nei titoli e nelle descrizioni delle domande con la sintassi `{{nome_variabile}}`. Durante l'intervista il sistema sostituisce il placeholder con il valore corrente.

    Una variabile ha una di tre origini: impostata a mano, presa da un parametro URL, oppure riempita con la risposta a una domanda. L'ultimo valore assegnato sovrascrive il precedente.
  </Accordion>

  <Accordion title="Rispondente" icon="users-round">
    Chi risponde all'intervista. Le risposte raccolte si dividono in tre tipologie, che restano separate in analisi ed export:

    * **Risposte normali** — il campione completo e valido.
    * **Risposte screened out** — rispondenti esclusi per criteri di screener o di quota.
    * **Risposte scartate** — risposte eliminate manualmente o per qualità, mantenute per verifiche dedicate.
  </Accordion>

  <Accordion title="Quota" icon="percent">
    Il tetto massimo di completamenti per un profilo di risposta. Quando la quota è piena, l'intervista si interrompe automaticamente per i rispondenti successivi che rientrano in quella condizione.

    Serve a raccogliere campioni bilanciati senza controllarli a mano. Ogni quota ha un nome, un numero massimo di rispondenti e un insieme di condizioni; si configura nelle impostazioni della campagna, scheda Quota.
  </Accordion>

  <Accordion title="Crediti" icon="credit-card">
    Una riserva a consumo che integra il piano di abbonamento invece di sostituirlo. Il piano definisce la capacità strutturale dell'account; i crediti coprono le attività variabili.

    L'uso principale è il reclutamento dei partecipanti dal panel integrato. Il contatore nella Dashboard divide il saldo in **Disponibili** e **Riservati**: i riservati sono già impegnati dalle campagne in corso.
  </Accordion>

  <Accordion title="Modalità statistiche avanzate" icon="sigma">
    Un'impostazione della campagna che struttura i dati per l'analisi statistica professionale. Quando è attiva ottieni:

    * tempi di risposta (totale, per domanda, inizio e fine);
    * dati tecnici del rispondente (dispositivo, sistema operativo, browser, provenienza del traffico);
    * variabili tipizzate per software statistici ed export SPSS `.sav`;
    * variabili di contesto e condizioni di visibilità;
    * espressioni logiche avanzate tra domande.
  </Accordion>
</AccordionGroup>

<Info>
  La **Modalità statistiche avanzate** è il prerequisito ricorrente di molte funzioni della piattaforma. Se una funzione risulta non disponibile, controlla prima questa impostazione: [Modalità statistiche avanzate](/it/avanzate/statistiche-avanzate).
</Info>

## I tre stadi di una campagna

Quando apri una campagna, la barra in alto ha tre stadi: **Costruisci › Condividi › Risultati**. Nel primo costruisci l'intervista, nel secondo la porti davanti alle persone — lì stanno sia il riquadro per copiare il link sia il reclutamento dei partecipanti — e nel terzo leggi quello che è tornato indietro.

## Il ciclo di vita dello studio

<Steps>
  <Step title="Configura il workspace">
    Crea l'organizzazione o accetta l'invito a un workspace esistente, poi invita i membri del team e assegna i ruoli.
  </Step>

  <Step title="Costruisci il flusso">
    Aggiungi i blocchi nel Builder, collegali tra loro e definisci condizioni, variabili e tema grafico.
  </Step>

  <Step title="Pubblica">
    Porta la campagna da Bozza a Live. Da questo momento le persone possono iniziare a rispondere.
  </Step>

  <Step title="Distribuisci o recluta">
    Diffondi il link pubblico sui tuoi canali, oppure recluta rispondenti qualificati dal panel globale.
  </Step>

  <Step title="Analizza">
    Leggi il Riepilogo, filtra sulle risposte alle singole domande, confronta cluster di rispondenti e interroga i dati.
  </Step>

  <Step title="Condividi ed esporta">
    Condividi i risultati con il team o esporta il dataset nel formato che ti serve.
  </Step>
</Steps>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Il tuo primo studio" icon="rocket" href="/it/quickstart">
    Metti in pratica questi concetti in un percorso guidato end-to-end.
  </Card>

  <Card title="Il Builder" icon="pencil-ruler" href="/it/builder/panoramica">
    Entra nel canvas e scopri come si compone un flusso di blocchi.
  </Card>
</CardGroup>


## Related topics

- [Cosa puoi fare con Exoid](/it/funzionalita.md)
- [Il tuo primo studio](/it/quickstart.md)
- [Documentazione Exoid](/it/index.md)