> 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 consiste nel suddividere i partecipanti al tuo programma Advocate in segmenti di utenti, ovvero gruppi basati su caratteristiche condivise. Segmentando i partecipanti, puoi comprenderne meglio gli interessi, seguirne l'attività e offrire con maggiore precisione un valore in linea con le loro esigenze.

{% tabs %}
{% tab title="Fattori demografici" %}
Tra i criteri di segmentazione più comuni figurano fattori demografici come:

* Età
* Genere
* Posizione
* Settore lavorativo
* Luogo di lavoro
* Reddito
  {% endtab %}

{% tab title="Fattori legati alla relazione" %}
Puoi anche segmentare gli utenti in base a diverse caratteristiche relative 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 %}

#### Gestire i segmenti di utenti

Nel tuo programma Advocate puoi creare nuovi segmenti di utenti, aggiungere singoli partecipanti ai segmenti, aggiungere partecipanti ai segmenti in blocco e rimuoverli dai segmenti.

{% stepper %}
{% step %}
**Passaggio 1: crea un segmento di utenti**

1. Nel menu di navigazione a sinistra, seleziona ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Data Sources → Segments**.
2. Seleziona **Add Segment**.
3. Nel campo **Name** , 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 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participants**.
2. Cerca il partecipante specifico che vuoi aggiungere a un segmento di utenti.
3. Seleziona il suo nome per aprire il profilo del partecipante.
4. Nella scheda *Segments* , seleziona **Add Segment**.
5. Scegli il segmento di utenti a cui vuoi aggiungere il partecipante.
   {% endstep %}

{% step %}
**Passaggio 3: aggiungi partecipanti in blocco a un segmento di utenti**

1. Nel menu di navigazione a sinistra, seleziona ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Data Sources→ Segments**.
2. Individua 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 **Add Users**.
4. Scegli il tipo di importazione **Users**.
5. Utilizzando il [example CSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crea un elenco di tutti i partecipanti che vuoi includere in uno specifico segmento di utenti.
6. Seleziona **Select 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 **Start Import**.
   {% endstep %}

{% step %}
**Passaggio 4: rimuovere un partecipante da un segmento utenti**

1. Nel menu di navigazione a sinistra, seleziona ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participants**.
2. Individua il partecipante specifico che vuoi aggiungere a un segmento utenti.
3. Seleziona il suo nome per aprire il profilo del partecipante.
4. Nell’angolo in basso a sinistra della panoramica dell’utente, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[Annulla]** a destra del segmento da cui vuoi rimuovere il partecipante.
   {% endstep %}
   {% endstepper %}

#### API Advocate e segmentazione UTT

È possibile utilizzare anche l’API REST Advocate e la libreria JavaScript UTT per gestire a livello di codice i segmenti di cui fanno parte 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.

Per ulteriori dettagli sull’uso di queste operazioni nella libreria JavaScript UTT e nei metodi API, consulta la nostra [documentazione dell’API utente](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).

{% tabs %}
{% tab title="Operatori" %}
Gli operatori seguenti sono alla base delle *operazioni*, che consentono di gestire i segmenti di cui fa parte un partecipante.

| Operatore    | Descrizione                                                                                                                                                                                        | Esempio         |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Aggiungi     | Se si specifica solo la chiave del segmento, si tenterà di aggiungere il partecipante al segmento. Se il partecipante ne fa già parte, non verrà eseguita alcuna azione.                           | `mySegmentKey`  |
| Elimina      | Includendo la *chiave del segmento* preceduta da `~` si indicherà ad Advocate di rimuovere il partecipante dal segmento. Se il partecipante non ne fa già parte, non verrà eseguita alcuna azione. | `~mySegmentKey` |
| Cancella     | Includendo una *chiave*, preceduta da `~` si indicherà ad Advocate di rimuovere il partecipante da tutti i segmenti di cui fa attualmente parte.                                                   | `~`             |
| {% endtab %} |                                                                                                                                                                                                    |                 |

{% tab title="Operazioni" %}
Le operazioni seguenti, create utilizzando gli *operatori*, consentono di gestire i segmenti di cui fa parte un utente.

| Operazione    | Descrizione                                                                                                                                                                                                                                                                            | Esempio                                             |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Aggiungi      | Aggiunge un partecipante a un segmento. Gli altri segmenti esistenti vengono mantenuti.                                                                                                                                                                                                | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| Imposta       | <p>Imposta i segmenti di un partecipante. Gli altri segmenti esistenti vengono rimossi.</p><p><strong>Importante:</strong> L’ordine è importante! Per eseguire un’operazione di impostazione, l’operatore Cancella <em>operatore</em> <em>(\~)</em> deve essere incluso per primo.</p> | `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Rimuovi       | Rimuove un partecipante da un segmento. Gli altri segmenti esistenti vengono 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=<question>&goal=<user_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.
