> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md).
# Gestisci i segmenti utente di Advocate
La segmentazione è il processo di suddivisione dei partecipanti del tuo programma Advocate in segmenti utente, o gruppi, basati su caratteristiche condivise. Segmentando i partecipanti puoi comprendere meglio i loro interessi, seguire la loro attività e fornire con maggiore precisione un valore che rispecchi le loro esigenze.
{% tabs %}
{% tab title="Fattori demografici" %}
I criteri di segmentazione comuni includono fattori demografici come:
* Età
* Genere
* Posizione
* Settore lavorativo
* Luogo di lavoro
* Reddito
{% endtab %}
{% tab title="Fattori relazionali" %}
Potresti anche segmentare gli utenti in base a una serie di caratteristiche legate al loro rapporto con la tua attività, come:
* Stato di iscrizione
* Livello del piano di abbonamento
* Data dell'ultimo acquisto
* Data di registrazione
* Dispositivo
{% endtab %}
{% endtabs %}
#### Gestisci i segmenti utente
Nel tuo programma Advocate, puoi creare nuovi segmenti utente, aggiungere singoli partecipanti ai segmenti utente, aggiungere partecipanti ai segmenti utente in blocco e rimuovere partecipanti dai segmenti utente.
{% stepper %}
{% step %}
**Passaggio 1: crea un segmento utente**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Origini dati → Segmenti**.
2. Seleziona **Aggiungi segmento**.
3. Nella **Nome** campo, inserisci un nome descrittivo per il segmento.
4. Seleziona **Aggiungi**.
{% endstep %}
{% step %}
**Passaggio 2: aggiungi un singolo partecipante a un segmento utente**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Partecipanti**.
2. Cerca il partecipante specifico che vuoi aggiungere a un segmento utente.
3. Seleziona il suo nome per caricare il profilo del partecipante.
4. Nella *Segmenti* scheda, seleziona **Aggiungi segmento**.
5. Scegli il segmento utente in cui desideri includere questo partecipante.
{% endstep %}
{% step %}
**Passaggio 3: aggiungi in blocco i partecipanti a un segmento utente**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Origini dati → Segmenti**.
2. Trova il nome del segmento a cui vuoi aggiungere gli utenti.
3. Passa il cursore sul nome del segmento a cui vuoi aggiungere i partecipanti e seleziona **Aggiungi utenti**.
4. Scegli il tipo di importazione **Utenti**.
5. Utilizzando il [CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crea un elenco di tutti i partecipanti che desideri includere in uno specifico segmento utente.
6. Seleziona **Seleziona file** e scegli il file CSV preparato.
7. Usa l'elenco a discesa per selezionare il segmento a cui vuoi aggiungere questi partecipanti.
8. Seleziona **Avvia importazione**.
{% endstep %}
{% step %}
**Passaggio 4: rimuovi un partecipante da un segmento utente**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Partecipanti**.
2. Trova il partecipante specifico che vuoi aggiungere a un segmento utente.
3. Seleziona il suo nome per caricare il profilo del partecipante.
4. Nell'angolo in basso a sinistra della panoramica utente, seleziona  **\[Annulla]** a destra del segmento di cui il partecipante non dovrebbe più far parte.
{% endstep %}
{% endstepper %}
#### Segmentazione tramite API Advocate e UTT
L'API REST di Advocate e la libreria JavaScript UTT possono essere utilizzate anche per gestire in modo programmatico i segmenti di cui i partecipanti fanno parte.
Questa funzionalità è accessibile includendo una o più delle seguenti "operazioni" (una combinazione del nome del segmento e di un operatore) nell'oggetto utente della chiamata API o del metodo UTT.
Puoi trovare ulteriori dettagli sull'uso di queste operazioni nella nostra libreria JavaScript UTT e nei metodi API nella nostra [Documentazione API utente](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).
{% tabs %}
{% tab title="Operatori" %}
I seguenti operatori costituiscono la base della segmentazione degli utenti *Operazioni*, e vengono utilizzati per gestire i segmenti di cui un partecipante fa parte.
| Operatore | Descrizione | Esempio |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Aggiungi | Fornire solo la chiave del segmento tenterà di aggiungere il partecipante al segmento. Se il partecipante fa già parte del segmento, non verrà eseguita alcuna azione. | `mySegmentKey` |
| Elimina | Includendo la *chiave del segmento* con un `~` davanti, informerai Advocate di rimuovere il partecipante dal segmento. Se il partecipante non fa già parte del segmento, non verrà eseguita alcuna azione. | `~mySegmentKey` |
| Cancella | Includendo una *chiave*, con un `~` davanti, informerai Advocate di rimuovere il partecipante da tutti i segmenti di cui fa attualmente parte. | `~` |
| {% endtab %} | | |
{% tab title="Operazioni" %}
Le seguenti operazioni, create utilizzando gli *Operatori*, ti consentono di gestire i segmenti di cui un utente fa parte.
| Operazione | Descrizione | Esempio |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Aggiungi | Aggiunge un partecipante a un segmento. Tutti gli altri segmenti esistenti verranno mantenuti. | `{ "id" : "abc_123", ... "segments" : ["A"] }` |
| Imposta | Imposta il/i segmento/i per un partecipante. Tutti gli altri segmenti esistenti verranno rimossi.
Importante: L'ordine è importante! Per eseguire un'operazione di impostazione, la cancellazione Operatore (\~) deve essere inclusa per prima.
| `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Rimuovi | Rimuove un partecipante da un segmento. Tutti gli altri segmenti esistenti verranno mantenuti. | `{ "id" : "abc_123", ... "segments" : ["~A"] }` |
| Cancella | Cancella tutti i segmenti configurati per un partecipante. | `{ "id" : "abc_123", ... "segments" : ["~*"] }` |
| {% endtab %} | | |
| {% endtabs %} | | |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.