> 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).

# Gestionar 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, seguir su actividad y ofrecer con mayor precisión valor que se ajuste a sus necesidades.

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

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

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

* Estado de la 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 los segmentos de usuarios, añadir participantes a los segmentos de usuarios de forma masiva y eliminar participantes de los 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] → Orígenes de datos → Segmentos**.
2. Seleccione **Agregar segmento**.
3. En el **Nombre** campo, introduce un nombre descriptivo para el segmento.
4. Seleccione **Agregar**.
   {% 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 quieres añadir a un segmento de usuarios.
3. Selecciona su nombre para cargar su perfil de participante.
4. En la *Segmentos* tarjeta, selecciona **Agregar segmento**.
5. Elige el segmento de usuarios en el que deseas 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] → Orígenes de datos→ Segmentos**.
2. Encuentra 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. 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 ![](/files/72e67acc3cf947f86781fa68f4c3b653b247c1ec) **\[Cancelar]** a la derecha del segmento del que el participante ya no debe formar parte.
   {% 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 de forma programática 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 usuario](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         |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Agregar      | 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 una `~` delante de ella informará a Advocate de que debe eliminar 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 una `~` delante de ella, informará a Advocate de que debe eliminar al participante de todos los segmentos de los que forma parte actualmente.                                                 | `~`             |
| {% endtab %} |                                                                                                                                                                                                                        |                 |

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

| Operación     | Descripción                                                                                                                                                                                                                                                                      | Ejemplo                                             |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Agregar       | Añade un participante a un segmento. Cualquier otro segmento existente se conservará.                                                                                                                                                                                            | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| Establece     | <p>Establece el/los segmento(s) para un participante. Cualquier otro segmento existente se eliminará.</p><p><strong>Importante:</strong> ¡El orden importa! Para realizar una operación de establecimiento, el clear <em>Operador</em> <em>(\~)</em> debe incluirse primero.</p> | `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Eliminar      | Elimina a un participante de un segmento. Cualquier otro segmento existente se conservará.                                                                                                                                                                                       | `{ "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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
