> 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 comprender mejor sus intereses, hacer un seguimiento de su actividad y ofrecerles valor que se ajuste a sus necesidades con mayor precisión.

{% tabs %}
{% tab title="Factores demográficos" %}
Entre los criterios habituales de segmentación se incluyen factores demográficos como:

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

{% tab title="Factores relacionados con la relación" %}
También puedes segmentar a los usuarios según varias 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 %}

#### Administrar segmentos de usuarios

En tu programa Advocate, puedes crear segmentos de usuarios, añadir participantes individuales a segmentos, añadir participantes a segmentos de forma masiva y eliminarlos de segmentos.

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

1. En el menú de navegación de la izquierda, 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. Selecciona **Añadir segmento**.
3. En el campo **Nombre** introduce un nombre descriptivo para el segmento.
4. Selecciona **Añadir**.
   {% endstep %}

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

1. En el menú de navegación de la izquierda, 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 quieres añadir a un segmento de usuarios.
3. Selecciona su nombre para abrir su perfil de participante.
4. En la tarjeta *Segmentos* selecciona **Añadir segmento**.
5. Elige el segmento de usuarios al que quieres añadir a este participante.
   {% endstep %}

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

1. En el menú de navegación de la izquierda, 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. Busca el nombre del segmento al que quieres añadir usuarios.
3. Coloca 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. Con el [CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crea una lista de todos los participantes que quieres incluir en un segmento de usuarios específico.
6. Selecciona **Seleccionar archivo** y elige el archivo CSV que preparaste.
7. Usa la lista desplegable para seleccionar el segmento al que quieres añadir a estos participantes.
8. Selecciona **Iniciar importación**.
   {% endstep %}

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

1. En el menú de navegación de la izquierda, 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 quieres añadir a un segmento de usuarios.
3. Selecciona su nombre para abrir su perfil de participante.
4. En la esquina 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 del que el participante ya no debe formar parte.
   {% endstep %}
   {% endstepper %}

#### Segmentación con la API de Advocate y UTT

La API REST de Advocate y la biblioteca JavaScript de UTT también se pueden usar para gestionar mediante programación los segmentos de los que forman parte los participantes.

Se puede acceder a esta funcionalidad 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.

Encontrarás más información sobre el uso de estas operaciones en nuestra biblioteca JavaScript de 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 las *operaciones*de segmentación de usuarios, que se usan para gestionar los segmentos de los que forma parte un participante.

| Operador     | Descripción                                                                                                                                                                                         | Ejemplo         |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Añadir       | Si se proporciona solo la clave del segmento, se intentará añadir al participante al segmento. Si el participante ya forma parte de él, no se realizará ninguna acción.                             | `mySegmentKey`  |
| Eliminar     | Incluir la *clave del segmento* con un `~` delante indicará a Advocate 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, indicará a Advocate que elimine al participante de todos los segmentos de los que forme parte en ese momento.                                              | `~`             |
| {% endtab %} |                                                                                                                                                                                                     |                 |

{% tab title="Operaciones" %}
Las siguientes operaciones, creadas con los *operadores*disponibles, te permiten gestionar los segmentos de los que forma parte un usuario.

| Operación     | Descripción                                                                                                                                                                                                                                                                           | Ejemplo                                             |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Añadir        | Añade un participante a un segmento. Se conservarán los demás segmentos existentes.                                                                                                                                                                                                   | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| Establecer    | <p>Establece los segmentos de un participante. Se eliminarán los demás segmentos existentes.</p><p><strong>Importante:</strong> ¡El orden importa! Para realizar una operación de establecimiento, el operador 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 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.
