> 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 su programa Advocate en segmentos de usuarios, o grupos, basados en características compartidas. Al segmentar a sus participantes, puede comprender mejor sus intereses, seguir su actividad y proporcionar 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 empleo
* Ingresos
  {% endtab %}

{% tab title="Factores de relación" %}
También puede segmentar a los usuarios en función de una serie de características relacionadas con su relación con su 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 su programa Advocate, puede crear nuevos segmentos de usuarios, agregar participantes individuales a segmentos de usuarios, agregar 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 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. Seleccione **Agregar segmento**.
3. En el **Nombre** campo, introduzca un nombre descriptivo para el segmento.
4. Seleccione **Agregar**.
   {% endstep %}

{% step %}
**Paso 2: Agregar un solo 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. Busque al participante específico que desea agregar a un segmento de usuarios.
3. Seleccione su nombre para cargar su perfil de participante.
4. En la *Segmentos* tarjeta, seleccione **Agregar segmento**.
5. Elija el segmento de usuarios en el que le gustaría incluir a este participante.
   {% endstep %}

{% step %}
**Paso 3: Agregar 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. Encuentre el nombre del segmento al que desea agregar usuarios.
3. Pase el cursor sobre el nombre del segmento al que desea agregar participantes y seleccione **Agregar usuarios**.
4. Elija el tipo de importación **Usuarios**.
5. Usando la [CSV de ejemplo](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), cree una lista de todos los participantes que le gustaría incluir en un segmento de usuarios específico.
6. Seleccione **Seleccionar archivo** y elija su archivo CSV preparado.
7. Use la lista desplegable para seleccionar el segmento al que desea agregar estos participantes.
8. Seleccione **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. Encuentre al participante específico que desea agregar a un segmento de usuarios.
3. Seleccione su nombre para cargar su perfil de participante.
4. En la parte inferior izquierda de la vista general del usuario, seleccione ![](/files/72e67acc3cf947f86781fa68f4c3b653b247c1ec) **\[Cancelar]** a la derecha del segmento en el que el participante ya no debería estar.
   {% endstep %}
   {% endstepper %}

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

La API REST de Advocate y la biblioteca JavaScript UTT también se pueden usar para gestionar programáticamente a qué segmentos pertenecen 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 API o el método UTT.

Puede encontrar más detalles 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 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á agregar 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 que elimine al participante del segmento. Si el participante ya no forma parte del segmento, no se realizará ninguna acción. | `~mySegmentKey` |
| Limpiar      | Incluir una *clave*, con un `~` delante de ella, informará a Advocate que elimine al participante de todos los segmentos de los que forma parte actualmente.                                                 | `~`             |
| {% endtab %} |                                                                                                                                                                                                              |                 |

{% tab title="Operaciones" %}
Las siguientes Operaciones, creadas usando las *Operadores*, le permiten gestionar de qué segmentos es miembro un usuario.

| Operación     | Descripción                                                                                                                                                                                                                                                                       | Ejemplo                                             |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Agregar       | Agrega a un participante a un segmento. Cualquier otro segmento existente se conservará.                                                                                                                                                                                          | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| Establecer    | <p>Establezca 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"] }`     |
| Limpiar       | 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.
