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

# GHL lead e valore opportunità: ROAS, CAC e campagne

> Quali campi GHL legge Mattone per ogni studente, come vengono usati per calcolare ROAS e CAC e con quale frequenza i dati si aggiornano.

Mattone legge da GHL i dati di lead, valore delle opportunità e spesa pubblicitaria di ciascuno studente per calcolare automaticamente il ROAS (Return On Ad Spend) e il CAC (Customer Acquisition Cost). Questa pagina spiega quali campi vengono letti, a cosa servono e come la piattaforma li aggrega per produrre i KPI visibili nella dashboard.

## Dati letti da GHL

Per ogni studente collegato, la piattaforma legge periodicamente i seguenti campi dalla location GHL corrispondente:

| Campo GHL             | Cosa rappresenta                                                                           | Usato per                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| **Contact source**    | Il canale o la campagna da cui proviene il lead (es. Facebook Ads, Google Ads, organico)   | Attribuzione ROAS, collega ogni lead alla campagna che lo ha generato          |
| **Opportunity value** | Il valore stimato o effettivo del contratto associato al lead nella pipeline GHL           | Calcolo del CAC, rappresenta il ricavo potenziale o realizzato per deal        |
| **Pipeline stage**    | La fase del funnel in cui si trova il lead (es. Nuovo lead, In trattativa, Cliente chiuso) | Conversion tracking, traccia la progressione dal primo contatto alla chiusura  |
| **Campaign ID**       | L'identificativo della campagna pubblicitaria di provenienza del lead                      | Ad spend attribution, collega il lead alla spesa della campagna corrispondente |

## Come vengono usati

La piattaforma aggrega questi campi per ogni studente e calcola due metriche principali:

**ROAS (Return On Ad Spend)**
`ROAS = Valore totale opportunità chiuse / Spesa pubblicitaria totale`

Un ROAS superiore a 1 significa che per ogni euro speso in pubblicità ne rientra più di uno dal valore dei contratti. Mattone mostra il ROAS per campagna e aggregato per studente.

**CAC (Customer Acquisition Cost)**
`CAC = Spesa pubblicitaria totale / Numero di deal chiusi`

Indica quanto costa, in media, acquisire un cliente pagante. Questo dato viene usato durante le sessioni di review con lo studente per ottimizzare l'allocazione del budget pubblicitario.

**CPL (Costo Per Lead)** e **CPA (Costo Per Acquisizione)**
`CPL = Spesa pubblicitaria totale / Numero lead` · `CPA = Spesa pubblicitaria totale / Numero deal chiusi`

Il CPL dice quanto costa un contatto; il CPA quanto costa un deal chiuso. Insieme a ROAS e CAC completano il quadro dell'efficienza di spesa.

<Info>Esempio: 100 lead, spesa €1.460 → **CPL €14,60**. Se 5 deal → **CPA €292**. Se il valore opportunità totale è €10.000 → **ROAS 6,8×**.</Info>

## Come si valorizza un lead (due modelli)

Il **valore opportunità** che alimenta ROAS/CAC può essere:

1. **Fatturato lordo** dell'opportunità (quando è noto/chiuso).
2. **% del potenziale dell'immobile** (stima) finché il fatturato non è ancora chiuso.

La **spesa** pubblicitaria la inserisce il CSM (GHL non la conosce): senza spesa inserita, CPL/CPA/ROAS/CAC restano vuoti.

<Note>
  I dati GHL si aggiornano **ogni ora** tramite polling dell'API. Se un valore nella dashboard sembra errato o non aggiornato, attendi un ciclo completo di aggiornamento (massimo 60 minuti) prima di escalare. Se dopo un'ora il dato è ancora errato, verifica prima che l'Opportunity value sia compilato correttamente nel CRM GHL dello studente, un valore vuoto o zero produce ROAS e CAC non significativi.
</Note>