> ## Documentation Index
> Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoraggio conversioni

> Monitora iscrizioni al sito, demo e acquisti con l'SDK JavaScript di Scribe e attribuisci ogni conversione alla firma email che l'ha generata.

Il monitoraggio delle conversioni chiude il cerchio delle tue firme email. L'analisi delle firme mostra già visualizzazioni e clic. Con l'SDK JavaScript di Scribe puoi anche registrare ciò che accade dopo sul tuo sito — iscrizioni, demo prenotate e acquisti — e collegare ogni azione alla firma, al collaboratore e al link che l'hanno generata. Questo è il fondo del funnel: visualizzazioni, poi clic, poi conversioni.

In Scribe queste conversioni si chiamano **eventi**. Le registri con poche righe di JavaScript, e Scribe le attribuisce automaticamente grazie allo stesso monitoraggio dei clic che alimenta il resto delle tue analisi.

<Note>
  Il monitoraggio delle conversioni è disponibile sui piani a pagamento. Se il piano della tua area di lavoro non lo include, lo snippet di tracciamento non registra nulla.
</Note>

## Come funziona

1. Un destinatario clicca un link in una delle tue firme email.
2. Scribe lo reindirizza al tuo sito e aggiunge un parametro `scribe_click_id` all'URL di destinazione.
3. L'SDK di Scribe sulla tua landing page legge quel `scribe_click_id`, lo archivia in modalità first-party e lo allega a ogni evento registrato.
4. Quando il visitatore converte, chiami `scribe.track('signup')`. Scribe collega l'evento al clic di origine.

Il risultato: puoi vedere quali firme, collaboratori ed elementi cliccati producono conversioni e ricavi reali, non solo clic. L'attribuzione funziona a livello di mittente, firma ed elemento, e Scribe abbina una conversione a un clic fino a 30 giorni dopo il clic.

Se un evento arriva senza un `scribe_click_id` noto (traffico diretto, un link scaduto o un parametro rimosso), viene comunque registrato. Semplicemente non è attribuito a un clic.

## Prima di iniziare

Servono tre cose:

* **Un piano a pagamento** che includa il monitoraggio delle conversioni.
* **Monitoraggio abilitato** per la tua area di lavoro. È la stessa impostazione che alimenta le analisi di visualizzazioni e clic della firma. Attivalo solo quando disponi del consenso necessario (vedi [Privacy e consenso](#privacy-and-consent)).
* **Il tuo Event Tracking ID.** È un identificatore pubblico e non segreto della tua area di lavoro. Può essere inserito senza rischi nell'HTML del tuo sito.

<Steps>
  <Step title="Copiare l'Event Tracking ID">
    In Scribe, apri **Impostazioni**, vai alla scheda **Area di lavoro** e copia il valore alla voce **Event Tracking ID**. Già che sei lì, verifica che **Monitoraggio** sia abilitato.
  </Step>

  <Step title="Aggiungere l'SDK al sito">
    Usa lo snippet script per un sito web classico o il pacchetto npm per un'app o una single-page app. Entrambi espongono la stessa API `scribe.track(...)`.

    **Opzione A. Snippet script.** Aggiungilo a ogni pagina da monitorare, subito prima del tag di chiusura `</head>`. Lo snippet si inizializza automaticamente da `data-workspace`, quindi non serve alcuna chiamata a `init()`.

    ```html theme={null}
    <!-- Scribe conversion tracking -->
    <script src="https://cdn-1.scribe-mail.com/v1/tracking.js"
            data-workspace="YOUR_EVENT_TRACKING_ID" async></script>
    ```

    **Opzione B. npm o yarn.** Installa il pacchetto e inizializzalo una volta all'avvio dell'app.

    ```bash theme={null}
    npm install @scribemail/js
    # or: yarn add @scribemail/js
    ```

    ```js theme={null}
    import scribe from '@scribemail/js';

    scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }); // once, at app startup
    ```

    L'importazione del modulo non ha effetti collaterali (è compatibile con il server-side rendering). Nulla viene inviato finché non chiami `init()`.
  </Step>

  <Step title="Registrare la prima conversione">
    Chiama `scribe.track` dove avviene una conversione, per esempio nel gestore di riuscita della registrazione.

    ```js theme={null}
    scribe.track('signup', { value: 99.0, currency: 'USD', plan: 'pro' });
    ```

    L'SDK cattura per te l'attribuzione dei clic Scribe dall'URL di destinazione, raggruppa gli eventi in batch e li invia in modo affidabile, anche quando il visitatore lascia la pagina.
  </Step>

  <Step title="Verifica che funzioni">
    Attiva l'evento sul tuo sito, poi apri **Analytics** in Scribe. Le conversioni compaiono insieme a visualizzazioni e clic, suddivise per firma, collaboratore, campagna e paese.
  </Step>
</Steps>

## Riferimento dell'SDK

### `scribe.track(name, metadata)`

Registra un evento. `name` è obbligatorio, per esempio `signup`, `demo_booked` o `purchase`.

```js theme={null}
scribe.track('purchase', {
  value: 149.0,           // optional, monetary value of the conversion
  currency: 'EUR',        // optional, ISO currency code
  event_id: 'order_8821', // optional, your own id, used for idempotency
  plan: 'team',           // any other key becomes an event "property"
  seats: 5
});
```

* `value`, `currency` e `event_id` sono campi di primo livello riconosciuti.
* **Ogni altra chiave** diventa parte dei `properties` dell'evento. Mantieni le proprietà come valori scalari semplici (stringhe, numeri, booleani). Non inserire dati personali come email o numeri di telefono nelle proprietà: Scribe rimuove automaticamente le chiavi che sembrano dati personali.
* Fornisci il tuo `event_id` per rendere un invio sicuro da ritentare. Lo stesso `event_id` ricevuto due volte entro 24 ore viene registrato una sola volta.

### `scribe.identify(userId, traits)`

Associa il visitatore a uno dei tuoi utenti, così puoi vedere quali firme acquisiscono quali clienti. Utile per il lavoro B2B e account-based.

```js theme={null}
scribe.identify('user_42', { email: 'ada@example.com', name: 'Ada', plan: 'pro' });
```

Dopo una chiamata `identify`, le chiamate `track` successive sono associate a quell'utente. Chiama `scribe.reset()` al logout per rimuovere l'identità.

### `scribe.flush()`

Gli eventi vengono raggruppati e inviati automaticamente, e sempre alla chiusura della pagina. Chiama `flush()` solo se devi forzare l'invio immediato del batch corrente.

### Attributi dello snippet

Quando usi lo snippet script, configuralo con gli attributi `data-*`:

| Attributo            | Obbligatorio | Descrizione                                                                                                |
| -------------------- | ------------ | ---------------------------------------------------------------------------------------------------------- |
| `data-workspace`     | Sì           | Il tuo ID di Event Tracking.                                                                               |
| `data-consent`       | No           | Imposta su `"denied"` per disattivare l'archiviazione first-party finché il visitatore non dà il consenso. |
| `data-cookie-domain` | No           | Imposta il tuo dominio apex per condividere l'identità tra i sottodomini.                                  |

### Content Security Policy

Se il sito imposta una Content Security Policy, aggiungi gli host di Scribe alla lista consentita:

```
script-src  https://cdn-1.scribe-mail.com;
connect-src https://t.scribe-mail.com;
```

<Tip>
  Devi registrare un evento autorevole dal tuo backend, come un pagamento confermato dal server? Scribe accetta eventi anche tramite l'API con una chiave API `events:write`, che mantiene i valori di fatturato affidabili anziché forniti dal client. Per i dettagli, consulta la [API Reference](/api-reference/introduction).
</Tip>

## Casi d'uso: trasforma le conversioni in crescita

Il monitoraggio delle conversioni trasforma le firme email in un canale di acquisizione misurabile. Ecco come i team mettono i dati al lavoro, anche alimentando le campagne di remarketing a pagamento.

### Avvia campagne di remarketing su Google Ads e Meta Ads

Attiva i pixel di conversione delle piattaforme pubblicitarie nello stesso punto in cui chiami `scribe.track`, così una singola conversione arriva contemporaneamente su Scribe, Google Ads e Meta. Scribe indica che la conversione proviene da una firma email; Google e Meta usano lo stesso segnale per le offerte e i pubblici.

```js theme={null}
function onSignupComplete(plan, price) {
  // 1. Attribute the conversion to the email signature that drove it
  scribe.track('signup', { value: price, currency: 'USD', plan });

  // 2. Send the same conversion to your ad platforms for bidding and audiences
  // gtag('event', 'conversion', { send_to: 'AW-XXXXXXXXX/abc', value: price, currency: 'USD' });
  // fbq('track', 'CompleteRegistration', { value: price, currency: 'USD' });
}
```

### Costruisci pubblici di retargeting ad alta intenzione

Le persone che hanno cliccato sulla firma e sono arrivate sul sito senza convertire sono contatti caldi. Usa Scribe per confermare il traffico generato dalle firme, poi effettua il retargeting di questi visitatori con un'offerta mirata su Google e Meta. Poiché il traffico arriva dalle tue stesse email, questi pubblici tendono a convertire meglio rispetto al prospecting a freddo.

### Genera pubblici lookalike e simili a partire da chi ha convertito

Il miglior pubblico di partenza sono le persone che hanno già convertito tramite un canale affidabile. Estrai i visitatori acquisiti dalle firme (filtra per firma, collaboratore o campagna), caricali come Pubblico personalizzato su Meta o come lista Customer Match su Google Ads e crea pubblici Lookalike o Simili a partire da questo seme di alta qualità.

### Escludi i clienti esistenti dalla spesa di acquisizione

Smetti di pagare per acquisire persone che si sono già iscritte o hanno già acquistato. Esporta chi ha convertito e aggiungili come lista di esclusione o soppressione sulle tue campagne di prospecting, così il budget va a prospect davvero nuovi.

### Ottimizza per il fatturato, non solo per i clic

Passa un vero `value` e `currency` con ogni conversione. Con il fatturato associato, puoi passare Google e Meta al bidding basato sul valore e, in Scribe, puoi classificare firme, collaboratori e campagne in base al fatturato che generano, non solo ai clic.

### Dimostra il canale e riassegna il budget

Il monitoraggio delle conversioni ti permette di confrontare il fatturato generato dalle firme email con i tuoi canali a pagamento negli stessi termini. Quando una campagna di firma supera una campagna a pagamento, hai i numeri per spostare il budget verso ciò che funziona.

## Chiedi a un agente AI di configurarlo

Non devi collegare tutto a mano. Se usi un assistente AI per la scrittura di codice (come Claude Code, Cursor o un agente simile nel tuo editor), incolla un prompt come questo, con il tuo Event Tracking ID e le conversioni che ti interessano:

```text theme={null}
Install the Scribe conversion tracking SDK on my website.

- If this is an app or single-page app, add the @scribemail/js package and call
  scribe.init({ id: 'YOUR_EVENT_TRACKING_ID' }) once at startup. If it is a plain
  HTML site, add the https://cdn-1.scribe-mail.com/v1/tracking.js script with
  data-workspace="YOUR_EVENT_TRACKING_ID" before </head> instead.
- Call scribe.track('signup', { value, currency }) from my signup success handler
  and scribe.track('purchase', { value, currency }) from my checkout confirmation.
- If I have logged-in users, call scribe.identify(userId, { email, plan }) after login.
- Add https://cdn-1.scribe-mail.com and https://t.scribe-mail.com to my Content
  Security Policy if I have one.
```

Una volta che le conversioni iniziano ad arrivare, un agente connesso al [server MCP di Scribe](/it/ai-agents/connect) può leggerti e spiegarti i risultati. Chiedigli cose come "which signatures and teammates drove the most conversions and revenue this month?" o "list the visitors my signatures acquired this week." Vedi [Scribe per agenti AI](/it/ai-agents) e la [skill di analytics di Scribe](/it/ai-agents/skills) per scoprire cosa può recuperare il tuo assistente.

## Privacy e consenso

Il monitoraggio delle conversioni è progettato per rispettare i tuoi visitatori e i tuoi obblighi:

* **Gli indirizzi IP sono anonimizzati.** Scribe applica un hash all'IP prima di archiviarlo. Gli IP grezzi non vengono mai conservati.
* **Nessun dato personale nelle proprietà.** Le chiavi che sembrano dati personali (email, telefono, password, token, numeri di carta e simili) vengono rimosse automaticamente dalle proprietà degli eventi. Usa `identify` quando vuoi deliberatamente associare un utente.
* **Archiviazione subordinata al consenso.** Imposta `data-consent="denied"` (snippet) o `consent: false` (npm `init`) per impedire all'SDK di archiviare l'identificatore di clic finché il visitatore non fornisce il consenso.
* **Ottieni il consenso prima di attivare il monitoraggio.** L'impostazione di monitoraggio dell'area di lavoro comporta la stessa responsabilità di qualsiasi pixel di analisi. Assicurati di avere il consenso richiesto dalla tua area geografica prima di attivarla.

## Articoli correlati

* [Panoramica delle analisi](/it/analytics-overview): visualizzazioni, clic, reach e CTR nella tua area di lavoro.
* [Dashboard delle analisi](/it/analytics-dashboard): leggi le conversioni accanto a visualizzazioni e clic in ogni scheda.
* [Analisi della firma](/it/signature-analytics): performance di una singola firma.
* [Campagne marketing](/it/marketing-overview): avvia e misura le campagne banner all'interno delle firme.
* [Scribe per gli agenti AI](/it/ai-agents): lascia che un assistente configuri il monitoraggio e riferisca sulle conversioni.