> 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/es/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md).

# Administrar segmentos de usuarios de Advocate

La segmentación es el proceso de dividir a los participantes de tu programa Advocate en segmentos de usuarios, o grupos, basados en características compartidas. Al segmentar a tus participantes, puedes entender mejor sus intereses, seguir su actividad y ofrecer con mayor precisión un valor que se ajuste a sus necesidades.

{% tabs %}
{% tab title="Factores demográficos" %}
Los criterios de segmentación comunes incluyen factores demográficos como:

* Edad
* Género
* Ubicación
* Sector laboral
* Lugar de trabajo
* Ingresos
  {% endtab %}

{% tab title="Factores relacionales" %}
También puedes segmentar a los usuarios según una serie de características relacionadas con su relación con tu empresa, como:

* Estado de membresía
* Nivel del plan de suscripción
* Fecha de la última compra
* Fecha de registro
* Dispositivo
  {% endtab %}
  {% endtabs %}

#### Gestionar segmentos de usuarios

En tu programa Advocate, puedes crear nuevos segmentos de usuarios, añadir participantes individuales a segmentos de usuarios, añadir participantes a segmentos de usuarios en bloque y eliminar participantes de segmentos de usuarios.

{% stepper %}
{% step %}
**Paso 1: Crear un segmento de usuarios**

1. En el menú de navegación izquierdo, selecciona ![](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] → Fuentes de datos → Segmentos**.
2. Seleccione **Añadir segmento**.
3. En el **Nombre** campo, introduce un nombre descriptivo para el segmento.
4. Seleccione **Añadir**.
   {% endstep %}

{% step %}
**Paso 2: Añadir un participante individual a un segmento de usuarios**

1. En el menú de navegación izquierdo, selecciona ![](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] → Participantes**.
2. Busca al participante específico que deseas añadir a un segmento de usuarios.
3. Selecciona su nombre para cargar su perfil de participante.
4. En la *Segmentos* tarjeta, selecciona **Añadir segmento**.
5. Elige el segmento de usuarios en el que te gustaría incluir a este participante.
   {% endstep %}

{% step %}
**Paso 3: Añadir participantes en bloque a un segmento de usuarios**

1. En el menú de navegación izquierdo, selecciona ![](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] → Fuentes de datos → Segmentos**.
2. Encuentra el nombre del segmento al que quieres añadir usuarios.
3. Pasa el cursor sobre el nombre del segmento al que quieres añadir participantes y selecciona **Añadir usuarios**.
4. Elige el tipo de importación **Usuarios**.
5. Usando el [CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crea una lista de todos los participantes que te gustaría incluir en un segmento de usuarios específico.
6. Seleccione **Seleccionar archivo** y elige tu archivo CSV preparado.
7. Usa la lista desplegable para seleccionar el segmento al que quieres añadir estos participantes.
8. Seleccione **Iniciar importación**.
   {% endstep %}

{% step %}
**Paso 4: Eliminar un participante de un segmento de usuarios**

1. En el menú de navegación izquierdo, selecciona ![](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] → Participantes**.
2. Encuentra al participante específico que quieres añadir a un segmento de usuarios.
3. Selecciona su nombre para cargar su perfil de participante.
4. En la parte inferior izquierda de la vista general del usuario, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[Cancelar]** a la derecha del segmento en el que el participante ya no debería estar.
   {% endstep %}
   {% endstepper %}

#### API de Advocate y segmentación UTT

La API REST de Advocate y la biblioteca JavaScript UTT también pueden utilizarse para gestionar programáticamente de qué segmentos son miembros los participantes.

Esta funcionalidad se puede acceder incluyendo una o más de las siguientes "operaciones" (una combinación del nombre del segmento y un operador) en el objeto de usuario de la llamada a la API o del método UTT.

Puedes encontrar más detalles sobre el uso de estas operaciones en nuestra biblioteca JavaScript UTT y en los métodos de la API en nuestra [Documentación de la API de usuarios](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).

{% tabs %}
{% tab title="Operadores" %}
Los siguientes operadores son la base de la segmentación de usuarios *Operaciones*, que se utilizan para gestionar de qué segmentos es miembro un participante.

| Operador     | Descripción                                                                                                                                                                                                       | Ejemplo         |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Añadir       | Proporcionar solo la clave del segmento intentará añadir al participante al segmento. Si el participante ya forma parte del segmento, no se realizará ninguna acción.                                             | `mySegmentKey`  |
| Eliminar     | Incluir la *clave del segmento* con un `~` delante de ella informará a Advocate para que elimine al participante del segmento. Si el participante ya no forma parte del segmento, no se realizará ninguna acción. | `~mySegmentKey` |
| Borrar       | Incluir una *clave*, con un `~` delante, informará a Advocate para que elimine al participante de todos los segmentos de los que forma parte actualmente.                                                         | `~`             |
| {% endtab %} |                                                                                                                                                                                                                   |                 |

{% tab title="Operaciones" %}
Las siguientes operaciones, construidas usando los *Operadores*disponibles, te permiten gestionar de qué segmentos es miembro un usuario.

| Operación     | Descripción                                                                                                                                                                                                                                                                               | Ejemplo                                             |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Añadir        | Añade un participante a un segmento. Se conservarán todos los demás segmentos existentes.                                                                                                                                                                                                 | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| Establece     | <p>Establece el/los segmento(s) para un participante. Se eliminarán todos los demás segmentos existentes.</p><p><strong>Importante:</strong> ¡El orden importa! Para realizar una operación de establecimiento, el de borrado <em>Operador</em> <em>(\~)</em> debe incluirse primero.</p> | `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Eliminar      | Elimina a un participante de un segmento. Se conservarán todos los demás segmentos existentes.                                                                                                                                                                                            | `{ "id" : "abc_123", ... "segments" : ["~A"] }`     |
| Borrar        | Borra todos los segmentos configurados para un participante.                                                                                                                                                                                                                              | `{ "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/es/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.
