# Gestisci i segmenti utente Advocate

La segmentazione è il processo di suddivisione dei partecipanti al tuo programma Advocate in segmenti di utenti, o gruppi, basati su caratteristiche comuni. 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 relativi alla relazione" %}
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 iscrizione
* 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 rimuovere partecipanti dai segmenti.

{% stepper %}
{% step %}

#### **Passo 1: Creare 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 **Aggiungi segmento**.
3. Nel **Nome** campo, inserisci un nome descrittivo per il segmento.
4. Seleziona **Aggiungi**.
   {% endstep %}

{% step %}

#### **Passo 2: Aggiungere 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 desideri aggiungere a un segmento di utenti.
3. Seleziona il suo nome per caricare il profilo del partecipante.
4. Nella *scheda Segmenti* seleziona **Aggiungi segmento**.
5. Scegli il segmento di utenti in cui desideri includere questo partecipante.
   {% endstep %}

{% step %}

#### **Passo 3: Aggiungere 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. Trova il nome del segmento al quale vuoi aggiungere utenti.
3. Posiziona il cursore sopra il nome del segmento al quale vuoi aggiungere 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 di utenti specifico.
6. Seleziona **Seleziona file** e scegli il tuo file CSV preparato.
7. Usa il menu a discesa per selezionare il segmento al quale vuoi aggiungere questi partecipanti.
8. Seleziona **Avvia importazione**.
   {% endstep %}

{% step %}

#### **Passo 4: Rimuovere un partecipante da 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. Trova il partecipante specifico che vuoi rimuovere da 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 ![](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 in cui il partecipante non dovrebbe più trovarsi.
   {% endstep %}
   {% endstepper %}

#### Segmentazione tramite Advocate API e UTT

La Advocate REST API e la libreria Javascript UTT possono anche essere utilizzate per gestire programmaticamente a quali segmenti i partecipanti appartengono.

Questa funzionalità può essere 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/impact-brand/reference/user).

{% tabs %}
{% tab title="Operatori" %}
I seguenti operatori costituiscono la base per le *Operazioni*, che vengono utilizzate 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à intrapresa alcuna azione.                                  | `miaChiaveSegmento`  |
| Elimina      | Includere la *chiave del segmento* con un `~` davanti informerà Advocate di rimuovere il partecipante dal segmento. Se il partecipante non fa già parte del segmento, non verrà intrapresa alcuna azione. | `~miaChiaveSegmento` |
| Cancella     | Includere una *chiave*, con un `~` davanti, informerà Advocate di rimuovere il partecipante da tutti i segmenti di cui è attualmente membro.                                                              | `~`                  |
| {% endtab %} |                                                                                                                                                                                                           |                      |

{% tab title="Operazioni" %}
Le seguenti operazioni, costruite usando le *Operatori*disponibili

| , ti consentono di gestire a quali segmenti un utente appartiene. | Descrizione                                                                                                                                                                                                                                              | Esempio                                                                                       |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Aggiungi                                                          | Operazione                                                                                                                                                                                                                                               | `Aggiunge un partecipante a un segmento. Qualsiasi altro segmento esistente verrà mantenuto.` |
| { "id" : "abc\_123", ... "segments" : \["A"] }                    | <p>Imposta</p><p><strong>Imposta il/ i segmento/i per un partecipante. Qualsiasi altro segmento esistente verrà rimosso.</strong> Importante: <em>Operatore</em> <em>(\~)</em> L'ordine è importante! Per eseguire un'operazione di impostazione, il</p> | `clear`                                                                                       |
| dovrebbe essere incluso per primo.                                | { "id" : "abc\_123", ... "segments" : \["\~","A" ] }                                                                                                                                                                                                     | `Rimuovi`                                                                                     |
| Cancella                                                          | Rimuove un partecipante da un segmento. Qualsiasi altro segmento esistente verrà mantenuto.                                                                                                                                                              | `{ "id" : "abc_123", ... "segments" : ["~A"] }`                                               |
| {% endtab %}                                                      |                                                                                                                                                                                                                                                          |                                                                                               |
| {% endtabs %}                                                     |                                                                                                                                                                                                                                                          |                                                                                               |
