# Segmenti tracciati

> I segmenti tracciati registrano chi entra e chi esce, e quando. Avvia automazioni e invia webhook a ogni ingresso e uscita, e segui la crescita di un segmento. Alpha: aperti solo al team di Emailit.

Un segmento tracciato è un [segmento](/it/docs/segments/) che memorizza anche i suoi membri. Quando un contatto inizia o smette di corrispondere alle sue regole, Emailit registra il cambiamento, così puoi:

- avviare [automazioni](#start-automations) quando qualcuno entra o esce,
- ricevere [webhook](#webhooks) per ingressi e uscite,
- vedere la [crescita](#growth-and-the-joined-column) del segmento nel tempo e quando è entrato ogni contatto.

Conteggi, elenco dei contatti e campagne funzionano come per qualsiasi segmento: valutano le regole in tempo reale e non usano mai i membri memorizzati.

> **I segmenti sono in alpha:** I segmenti, tracciati o no, sono aperti solo al team di Emailit mentre li testiamo. Vedi [Chi può usare i segmenti](/it/docs/segments/#who-can-use-segments).

I segmenti tracciati sono inclusi nei piani Pro, Business e Custom e rientrano nello stesso [limite di segmenti](/it/docs/segments/#limits) degli altri segmenti.

## Crea un segmento tracciato

Quando crei un segmento, scegli **Tracked segment** in **Type**. Con Pay as you go l’opzione è disattivata e mostra **Upgrade**. Con l’API, passa `"tracked": true` a [Crea un segmento](/it/docs/api-reference/segments/create/).

In seguito il tipo non si può cambiare, in nessuna delle due direzioni. Per tracciare un segmento esistente, crea un nuovo segmento tracciato con le stesse regole. **Duplicate** mantiene il tipo dell’originale.

Subito dopo la creazione, un segmento tracciato mostra **Recording current members** mentre Emailit memorizza tutti quelli che corrispondono già (nell’API `tracking.status` è `syncing`). Questo primo conteggio non invia eventi né avvia automazioni: contano come cambiamenti solo i contatti che entrano o escono dopo.

## Come vengono aggiornati i membri

| Cosa succede | Quando si aggiornano i membri | `reason` |
| --- | --- | --- |
| Un contatto viene creato, modificato o eliminato, si iscrive o si disiscrive, oppure un passaggio di un’automazione lo modifica | Di solito entro un minuto | `contact` |
| Un’importazione di contatti termina, oppure una lista viene eliminata | Al termine, per l’intero segmento | `contact` |
| Regole che si spostano nel tempo, come **Created** negli ultimi 30 giorni, e modifiche che non producono eventi dei contatti | Ogni giorno alle 00:30 UTC, per l’intero segmento | `schedule` |
| Modifichi l’origine o i filtri del segmento | Subito dopo il salvataggio | `segment_updated` |

Ogni ingresso o uscita viene registrato con il suo `reason`. I cambiamenti causati dalla modifica del segmento vengono inviati ai webhook ma non avviano automazioni, così un cambio di regole non esegue un’automazione per tutti i contatti che coinvolge. I contatti che escono perché sono stati eliminati non inviano eventi.

## Avvia automazioni

Due trigger dei contatti partono da un segmento tracciato:

| Trigger | Chiave API | Avvia un’esecuzione quando |
| --- | --- | --- |
| **Added to segment** | `contact.added_to_segment` | Un contatto entra nel segmento. |
| **Removed from segment** | `contact.removed_from_segment` | Un contatto esce dal segmento. |

Scegli il segmento in **Tracked segment** nel trigger. Vengono elencati solo i segmenti tracciati, e solo questi si possono usare. Di solito le esecuzioni partono entro un minuto dall’ingresso o dall’uscita.

Per **Added to segment**, seleziona **Also start for contacts already in the segment when the automation is first started** per eseguire l’automazione anche per i membri attuali. Succede una sola volta, al primo avvio dell’automazione, per i membri registrati in quel momento. Le impostazioni delle esecuzioni dell’automazione, come `allow_reentry` e `cooldown_seconds`, valgono comunque. Vedi [Usa l’API](/it/docs/automations/#use-the-api).

Gli ingressi e le uscite possono anche terminare le esecuzioni (**Removed from segment** come condizione di uscita), soddisfare obiettivi e far riprendere i passaggi **Wait until**. Vedi [Condizioni di uscita e obiettivi](/it/docs/automations/exits-and-goals/).

Un segmento usato da un’automazione non si può eliminare finché non modifichi quell’automazione. Vedi [Trigger delle automazioni](/it/docs/automations/triggers/#segment-triggers).

## Webhook

Ingressi e uscite inviano questi eventi [webhook](/it/docs/webhooks/):

- [`segment.contact_added`](/it/docs/webhooks/events/segment/contact-added/) quando un contatto entra, con `joined_at`.
- [`segment.contact_removed`](/it/docs/webhooks/events/segment/contact-removed/) quando un contatto esce, con `left_at`.

Entrambi contengono `id` e `name` del segmento, `id`, `email`, nomi e campi personalizzati del contatto, e il `reason` della tabella precedente. Anche l’**Activity log** del contatto mostra le voci «Joined segment» e «Left segment».

## Crescita e colonna Joined

La pagina di un segmento tracciato ha un grafico **Growth** degli ultimi 30 giorni, con i membri alla fine di ogni giorno (**Members**) e quanti contatti sono entrati (**Joined**) e usciti (**Left**). La cronologia inizia quando inizia il tracciamento, e il primo conteggio non viene mostrato come ingressi.

La tabella dei contatti aggiunge una colonna **Joined** con la data in cui è iniziata la permanenza attuale del contatto nel segmento. Un contatto che esce e poi rientra riceve una nuova data. La colonna è vuota finché il tracciamento non ha registrato il contatto.

Con l’API, usa [Recupera la crescita di un segmento](/it/docs/api-reference/segments/growth/) per un massimo di 365 giorni, e [Elenca i contatti di un segmento](/it/docs/api-reference/segments/contacts/) per `joined_at`.

## Quando il tracciamento va in pausa

Se il workspace passa a un piano senza segmenti tracciati, il tracciamento va in pausa. La pagina del segmento mostra **Tracking is paused** e `tracking.status` è `paused`:

- I membri smettono di aggiornarsi, non vengono inviati eventi e nessuna automazione parte dal segmento.
- Il segmento continua a contare, elencare e inviare in tempo reale, come qualsiasi segmento.

Quando passi di nuovo a un piano superiore, Emailit registra di nuovo i membri attuali al successivo aggiornamento, senza inviare eventi né avviare automazioni, poi il tracciamento riprende. Gli ingressi e le uscite avvenuti mentre il tracciamento era in pausa non vengono registrati.

## Usa l’API

| Operazione | Endpoint |
| --- | --- |
| Creare un segmento tracciato | [Crea un segmento](/it/docs/api-reference/segments/create/) con `"tracked": true` |
| Controllare lo stato del tracciamento | `tracked` e `tracking` in [Recupera un segmento](/it/docs/api-reference/segments/get/) |
| Membri, ingressi e uscite giornalieri | [Recupera la crescita di un segmento](/it/docs/api-reference/segments/growth/) |
| Quando è entrato ogni membro | `joined_at` in [Elenca i contatti di un segmento](/it/docs/api-reference/segments/contacts/) |

Con Pay as you go, `"tracked": true` restituisce `403` con `"error": "plan_required"` e `"required_plan": "pro"`. [Elenca i segmenti](/it/docs/api-reference/segments/list/) restituisce `usage.tracking_allowed`, che indica se il piano include i segmenti tracciati.

## Vedi anche

  - [Trigger delle automazioni](/it/docs/automations/triggers/): Ogni trigger e le sue opzioni.
  - [Tipi di evento](/it/docs/webhooks/event-types/): Tutti gli eventi webhook che Emailit invia.

---
Fonte: https://emailit.com/it/docs/segments/tracked/