> 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 utenti Advocate
La segmentazione è il processo di suddividere i partecipanti del tuo programma Advocate in segmenti di utenti, o gruppi, basati su caratteristiche condivise. Segmentando i tuoi partecipanti puoi comprendere meglio i loro interessi, seguire la loro attività e fornire in modo più accurato un valore che risponda alle 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 azienda, 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 partecipanti singoli 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. Nel **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 partecipanti in blocco 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 [esempio CSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crea un elenco di tutti i partecipanti che desideri includere in un segmento utente specifico.
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. In basso a sinistra nella panoramica utente, seleziona  **\[Annulla]** a destra del segmento in cui il partecipante non dovrebbe più essere.
{% endstep %}
{% endstepper %}
#### API di Advocate e segmentazione UTT
L'API REST di Advocate e la libreria JavaScript UTT possono essere utilizzate anche per gestire programmaticamente a quali segmenti appartengono i partecipanti.
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 sono alla base della segmentazione utente *Operazioni*, che vengono utilizzati per gestire a quali segmenti un partecipante appartiene.
| 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 | Includere la *chiave del segmento* con un `~` davanti ad essa informerà Advocate di rimuovere il partecipante dal segmento. Se il partecipante non fa già parte del segmento, non verrà eseguita alcuna azione. | `~mySegmentKey` |
| Cancella | Includere una *chiave*, con un `~` davanti ad essa, informerà Advocate di rimuovere il partecipante da tutti i segmenti di cui fa attualmente parte. | `~` |
| {% endtab %} | | |
{% tab title="Operazioni" %}
Le seguenti operazioni, create utilizzando i *Operatori*, consentono di gestire a quali segmenti un utente appartiene.
| Operazione | Descrizione | Esempio |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Aggiungi | Aggiunge un partecipante a un segmento. Eventuali altri segmenti esistenti verranno mantenuti. | `{ "id" : "abc_123", ... "segments" : ["A"] }` |
| Imposta | Imposta il/i segmento/i per un partecipante. Eventuali altri segmenti esistenti verranno rimossi.
Importante: L'ordine conta! Per eseguire un'operazione di impostazione, il comando di cancellazione Operatore (\~) dovrebbe essere incluso per primo.
| `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Rimuovi | Rimuove un partecipante da un segmento. Eventuali 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.