# Gestisci i segmenti di utenti Advocate
La segmentazione è il processo di divisione dei 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 che corrisponda 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 relative al loro rapporto con la tua azienda, come:
* Stato dell'iscrizione
* Livello del piano di abbonamento
* Data dell'ultimo acquisto
* Data di registrazione
* Dispositivo
{% endtab %}
{% endtabs %}
#### Gestisci i segmenti di utenti
Nel tuo programma Advocate, puoi creare nuovi segmenti di utenti, aggiungere singoli partecipanti ai segmenti di utenti, aggiungere partecipanti ai segmenti di utenti in blocco e rimuovere partecipanti dai segmenti di utenti.
{% stepper %}
{% step %}
**Passaggio 1: crea un segmento di utenti**
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 di utenti**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Partecipanti**.
2. Cerca il partecipante specifico che vuoi aggiungere a un segmento di utenti.
3. Seleziona il suo nome per caricare il profilo del partecipante.
4. Nella *Segmenti* Widget, seleziona **Aggiungi segmento**.
5. Scegli il segmento di utenti in cui desideri includere questo partecipante.
{% endstep %}
{% step %}
**Passaggio 3: aggiungi partecipanti in blocco a un segmento di utenti**
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 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 uno specifico segmento di utenti.
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 di utenti**
1. Nel menu di navigazione a sinistra, seleziona  **\[Engage] → Partecipanti**.
2. Trova il partecipante specifico che vuoi aggiungere a un segmento di utenti.
3. Seleziona il suo nome per caricare il profilo del partecipante.
4. In basso a sinistra nella panoramica dell'utente, seleziona  **\[Annulla]** a destra del segmento in cui il partecipante non dovrebbe più trovarsi.
{% 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 i segmenti di cui un partecipante è membro.
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 dell'API utente](https://integrations.impact.com/impact-brand/reference/user).
{% tabs %}
{% tab title="Operatori" %}
I seguenti operatori sono la base per la segmentazione degli utenti *Operazioni*, e vengono utilizzati per gestire i segmenti di cui un partecipante è membro.
| 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 a essa indicherà ad 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 a essa, indicherà ad Advocate di rimuovere il partecipante da tutti i segmenti di cui fa attualmente parte. | `~` |
| {% endtab %} | | |
{% tab title="Operazioni" %}
Le seguenti operazioni, costruite 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. 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 (\~) deve 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: 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:
```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.