> 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 di 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 valore in linea con le loro esigenze.
{% tabs %}
{% tab title="Fattori demografici" %}
I criteri di segmentazione comuni includono fattori demografici come:
* Età
* Genere
* Località
* 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 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] → Sorgenti dati → Segmenti**.
2. Seleziona **Aggiungi segmento**.
3. Nella **Nome** nel 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] → Sorgenti 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. Usando 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 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  **\[Cancel]** a destra del segmento in cui il partecipante non dovrebbe più trovarsi.
{% endstep %}
{% endstepper %}
#### API Advocate e segmentazione 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 sono membri.
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 degli utenti *Operazioni*, che vengono utilizzate per gestire i segmenti di cui un partecipante è membro.
| Operatore | Descrizione | Esempio |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------- |
| Aggiungi | Fornendo solo la chiave del segmento, si 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, si informerà 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, si informerà Advocate di rimuovere il partecipante da tutti i segmenti di cui attualmente fa parte. | `~` |
| {% endtab %} | | |
{% tab title="Operazioni" %}
Le seguenti operazioni, create utilizzando i *Operatori*disponibili, ti consentono di gestire i segmenti di cui un utente è membro.
| 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 conta! Per eseguire un'operazione di impostazione, il valore di cancellazione Operatore (\~) deve essere incluso per primo.
| `{ "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.