# Tracciamento degli eventi

> Registra ciò che le persone fanno nella tua app e sul tuo sito come eventi di workspace o personalizzati, collegali ai contatti e ricevili nei webhook.

Il tracciamento degli eventi ti permette di registrare ciò che le persone fanno nel tuo prodotto: un ordine, un cambio di piano, una registrazione, la visualizzazione di un prodotto. Invii gli eventi dal tuo sito web con lo script di tracciamento o dai tuoi server con l’API. Emailit li salva accanto agli eventi che registra da sé, li collega ai contatti e può inviarli ai tuoi webhook.

Il tracciamento degli eventi è incluso nei piani Pro, Business e Custom. Con Pay as you go, l’invio di eventi e la definizione di eventi di workspace restituiscono `403` con `"error": "plan_required"`, e le richieste dello script di tracciamento vengono rifiutate.

## Tre ambiti di eventi

Ogni evento ha un tipo, e il suo prefisso ne indica l’**ambito**:

| Ambito | Tipo | Chi lo definisce | Esempio |
| --- | --- | --- | --- |
| Sistema | `<name>` | Emailit. Questi eventi registrano ciò che succede alle email, ai contatti e alle altre risorse. Non puoi inviarli. | `email.delivered` |
| Workspace | `w:<name>` | Il tuo workspace. Prima dichiari l’evento e il tipo di ogni proprietà, ed Emailit rifiuta gli eventi che non corrispondono. | `w:customer.type` |
| Personalizzato | `c:<name>` | Nessuno. Qualsiasi nome, con qualsiasi oggetto JSON come proprietà. | `c:order.completed` |

Usa un **evento di workspace** quando più sistemi inviano lo stesso evento e vuoi che restino coerenti, o quando le persone del tuo team si basano sui suoi campi. Usa un **evento personalizzato** quando vuoi mantenere la tua struttura dei dati, ad esempio il formato degli ordini del tuo negozio, senza dichiararla prima. Puoi iniziare con un evento personalizzato e definirlo in seguito come evento di workspace; i due sono tipi distinti, quindi `c:order.completed` e `w:order.completed` non si mescolano.

## Nomi degli eventi

I nomi hanno da 1 a 100 caratteri tra lettere, cifre, punti, trattini e trattini bassi, e iniziano con una lettera o una cifra: `customer.type`, `order-completed`, `cart_updated`. I nomi distinguono tra maiuscole e minuscole.

I nomi delle proprietà degli eventi di workspace seguono le stesse regole, ma senza punti, perché i filtri dei webhook e i template usano i punti per raggiungere i valori annidati.

## Come inviare gli eventi

| Da | Come | Credenziali |
| --- | --- | --- |
| Il tuo sito web | Lo [script di tracciamento](/it/docs/events/tracking-script/) | Una chiave di tracciamento pubblica, limitata ai tuoi siti |
| I tuoi server | [Invia un evento](/it/docs/api-reference/events/send/) o [Invia eventi in batch](/it/docs/api-reference/events/batch/) | Una chiave API con **Full Access** o **Events Only**. Vedi [Invia eventi dal tuo backend](/it/docs/events/send-events/). |
| Il pannello | **Send event** in **Email API → Events** | Il tuo account. Serve a testare un webhook o un’integrazione. |

Gli eventi che riguardano denaro, come ordini e pagamenti, è meglio inviarli dai tuoi server. Gli eventi del browser possono essere bloccati, e chiunque può inviare eventi con una chiave pubblica.

## Eventi e contatti

Un evento può indicare la persona a cui si riferisce, con `email` o con `contact_id`.

- I contatti vengono cercati, mai creati. Se nessun contatto ha quell’email, l’indirizzo viene comunque salvato e l’evento compare nell’attività del contatto quando lo crei.
- Un `contact_id` deve appartenere a un contatto del workspace.
- Gli eventi senza una persona possono contenere un `anonymous_id`. Lo script di tracciamento ne aggiunge uno a ogni evento che invia.

Gli eventi collegati a un contatto compaiono nella sezione **Activity log** del contatto, accanto alle email che ha ricevuto. Lì gli eventi di workspace con un titolo mostrano il titolo.

## Dove finiscono gli eventi

- **Il log degli eventi.** **Email API → Events** elenca ogni evento nella scheda **Log**. Filtra per **Scope** per vedere solo gli eventi di sistema, di workspace o personalizzati. Con l’API, usa il parametro `scope` di [Elenca gli eventi](/it/docs/api-reference/events/list/).
- **Webhook.** Un webhook può sottoscrivere un tipo come `c:order.completed`, oppure tutti gli eventi di workspace o personalizzati con `w:*` e `c:*`. Un webhook con **All events** attivo non li riceve, a meno che tu non scelga anche questi. Vedi [Tipi di evento](/it/docs/webhooks/event-types/#workspace-and-custom-events).
- **Contatti.** Vedi [Eventi e contatti](#events-and-contacts).
- **Automazioni.** Un [trigger](/it/docs/automations/triggers/#custom-event) **Custom event** avvia un’esecuzione per il contatto dell’evento, facoltativamente solo quando le sue proprietà corrispondono. Gli stessi eventi possono terminare le esecuzioni, soddisfare obiettivi e far riprendere i passaggi **Wait until**. Lo fanno solo gli eventi che invii dal tuo server con l’[API degli eventi](/it/docs/events/send-events/): chiunque abbia la tua chiave di tracciamento pubblica può attribuire a un visitatore l’identità che vuole, quindi gli eventi dello [script di tracciamento](/it/docs/events/tracking-script/#identify-visitors) vengono registrati e arrivano ai webhook, ma non avviano, non terminano e non fanno avanzare le esecuzioni. Il trigger **Custom event** è incluso nei piani Business e Custom, mentre le condizioni di uscita, gli obiettivi e le attese su questi eventi sono inclusi nei piani Pro, Business e Custom. Vedi [Condizioni di uscita e obiettivi](/it/docs/automations/exits-and-goals/).

## Conservazione

Gli eventi rientrano nei **Logs** del workspace, quindi vengono conservati per il periodo di conservazione dei log del piano, poi eliminati. Vedi [Conservazione dei dati](/it/docs/data-retention/). Conserva nei tuoi sistemi gli ordini e gli altri dati che ti servono più a lungo.

## Limiti

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Tipi di eventi di workspace e personalizzati | — | 100 | 1000 | Illimitati |
| Script di tracciamento del sito web | — | Incluso | Incluso | Incluso |

- I **tipi di evento** sono i tipi distinti di eventi di workspace e personalizzati che un workspace invia, come `c:order.completed` e `w:customer.type`. I tipi già inviati in precedenza continuano a funzionare. Quando il workspace ha usato il numero di tipi previsto dal piano, gli eventi di un nuovo tipo vengono rifiutati con `422`.
- Eventi di workspace: tanti quanti i tipi di evento del piano, ciascuno con un massimo di 50 proprietà.
- Proprietà degli eventi personalizzati fino a 32 KB di JSON, annidate fino a 8 livelli.
- Fino a 100 eventi per richiesta batch.
- 25 chiavi di tracciamento per workspace.

Per gli altri limiti, vedi [Limiti e quote](/it/docs/limits/#other-limits).

## Vedi anche

  - [Eventi di workspace](/it/docs/events/workspace-events/): Definisci gli eventi e i tipi delle loro proprietà.
  - [Invia eventi dal tuo backend](/it/docs/events/send-events/): Registra eventi con l’API.
  - [Script di tracciamento](/it/docs/events/tracking-script/): Invia eventi dal tuo sito web.
  - [API degli eventi](/it/docs/api-reference/events/): Invia, elenca e recupera gli eventi.

---
Fonte: https://emailit.com/it/docs/events/