> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Etiquetas

> Use las etiquetas de datos de OneSignal para almacenar propiedades de usuario y rastrear eventos para segmentación avanzada y mensajería personalizada.

Las etiquetas de datos son pares clave-valor que le permiten almacenar propiedades personalizadas y rastrear el comportamiento del usuario en OneSignal. Permiten una segmentación y personalización poderosas.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/t82DSCUXShk?si=KH_u3zB2N5ci8GLT" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

Use las etiquetas para:

* Almacenar características del usuario como `subscription_tier` o `name`
* Rastrear comportamientos como `purchases`, `clicks` o `levels`
* Segmentar usuarios para mensajes y Journeys
* Personalizar el contenido del mensaje

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Z-rYqwEUU0M?si=Qjx2dMdFXwXSuZJR" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

## Reglas de formato de valores de etiquetas de datos

Todos los valores de etiquetas deben ser **cadenas de texto**. ¡Aún puede almacenar números, marcas de tiempo y valores booleanos, solo conviértalos en cadenas!

| Tipo de valor     | Ejemplo de formato                  | Notas                                                                                |
| ----------------- | ----------------------------------- | ------------------------------------------------------------------------------------ |
| Etiqueta de texto | `"free"`, `"VIP"`                   | Para tipos de usuario, privilegios, estados                                          |
| Número            | `"42"`, `"3.14"`                    | Habilita filtros numéricos (`mayor que`, `menor que`)                                |
| Marca de tiempo   | `"1685400000"`                      | Marca de tiempo Unix (en segundos). Use con [Operadores de tiempo](./time-operators) |
| Booleano          | `"true"` / `"false"`, `"1"` / `"0"` | Use `"1"`/`"0"` para reducir el tamaño de la carga útil                              |

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/YTp-jLcajJ0?si=uSRn2cQ7Yur5MAp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Warning>
  **No compatible:** Matrices, objetos, valores anidados o blobs JSON. Si necesita almacenar datos complejos, use [Eventos personalizados](./custom-events).
</Warning>

### Palabras clave restringidas

Las siguientes palabras clave están restringidas y no deben usarse como claves de etiquetas porque se usan internamente para la personalización de mensajes:
`message`, `notification`, `subscription`, `user`, `template`, `app`, `org`, `dynamic_content`, `data_feed`, `journey`, `custom_data`

Consulte [Personalización de mensajes](./message-personalization) para obtener más detalles.

### Etiquetas vs Eventos personalizados

[Tags](/docs/en/add-user-data-tags) and [Custom Events](/docs/en/custom-events) are both ways to add data to your users. However, there are some key differences:

| Feature        |                   Tags                   |                                          Custom Events                                         |
| -------------- | :--------------------------------------: | :--------------------------------------------------------------------------------------------: |
| Data usage     |     Segmentation and personalization     | Trigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys |
| Data retention |                 Lifetime                 |        30+ days ([lifetime storage is available](/docs/en/billing-faq#streaming-events))       |
| Data format    |       Key-value strings or numbers       |                                              JSON                                              |
| Data source    |     OneSignal SDK, API, or CSV import    |                               OneSignal SDK, API, or integrations                              |
| Data access    | Segmentation and message personalization |        Journeys and Journey-message-template personalization, Segmentation (Coming soon)       |

The key distinction between Tags and Custom Events is in their depth and use cases. Tags are properties of a user, such as Name, Account Status, or Location. Events are thing that the user has done, such as Purchasing an Item, Completing a Level, or Inviting a Friend. Both tags and events can be used for segmentation and personalization.

In practice, you will likely use both:

* Tags for user properties that are static and don't change often
* Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows

***

## Estrategias de etiquetas recomendadas

Las etiquetas de datos deben representar información que desee **usar en mensajes o segmentación de audiencia**. No están destinadas a almacenar perfiles de usuario completos o registros; use su base de datos de backend para eso.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/DeCnQYA21TY?si=YnAv50tpiiVdNEX7" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

### Etiquetas de comportamiento basadas en eventos

Rastree las acciones del usuario con etiquetas. Ideal para activar Journeys, seguimientos o recordatorios.

| Clave             | Ejemplo de valor          | Descripción                                                                                     |
| ----------------- | ------------------------- | ----------------------------------------------------------------------------------------------- |
| `cart_update`     | `"1685400000"`            | Última vez que el usuario agregó algo al carrito. Use [Operadores de tiempo](./time-operators). |
| `last_order`      | `"1684100000"`            | Marca de tiempo de la última compra completada                                                  |
| `amount_spent`    | `"100"`                   | Total gastado: número en cadena, sin símbolo de moneda                                          |
| `social_share`    | `"2"`                     | Conteo de compartidos sociales o referencias                                                    |
| `tutorial_status` | `"step2"` o `"completed"` | Progreso del tutorial: use valores de cadena legibles o numerados                               |

### Etiquetas de actividad de juegos

Utilizadas por juegos para personalizar según el rendimiento del usuario.

| Clave        | Ejemplo de valor | Descripción                      |
| ------------ | ---------------- | -------------------------------- |
| `points`     | `"1250"`         | Puntos de experiencia o de juego |
| `level`      | `"8"`            | Nivel de juego actual            |
| `high_score` | `"3000"`         | Puntuación más alta alcanzada    |

### Etiquetas de estado de cuenta

Use estas para dirigirse a usuarios por nivel de cuenta o cambio de estado.

| Clave             | Ejemplo de valor       | Descripción                               |
| ----------------- | ---------------------- | ----------------------------------------- |
| `user_type`       | `"free"`, `"premium"`  | Nivel de suscripción o acceso             |
| `has_downgraded`  | `"1"` o `"1685400000"` | Booleano o marca de tiempo de degradación |
| `user_privileges` | `"admin"`, `"guest"`   | Segmentación basada en roles              |

<Note>
  Use **External ID** para identificar usuarios individuales. **No** use etiquetas para este propósito. Consulte [External ID](./users#external-id) y [Aliases](./aliases).
</Note>

### Etiquetas de personalización

Ideal para personalización de mensajes basada en nombres usando [Sustitución de variables](./message-personalization).

| Clave        | Ejemplo de valor  | Descripción                           |
| ------------ | ----------------- | ------------------------------------- |
| `first_name` | `"Jon"`           | Nombre                                |
| `last_name`  | `"Smith"`         | Apellido                              |
| `user_name`  | `"PokeCatcher22"` | Nombre de visualización o de pantalla |

### Etiquetas de ubicación y demográficas

Segmente usuarios por región o edad.

| Clave        | Ejemplo de valor | Descripción                                                                                  |
| ------------ | ---------------- | -------------------------------------------------------------------------------------------- |
| `region`     | `"New York"`     | Área metropolitana, opcionalmente use [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) |
| `postcode`   | `"94105"`        | Código postal                                                                                |
| `location`   | `"Downtown LA"`  | Ubicación de cadena personalizada                                                            |
| `birthdate`  | `"915148800"`    | Marca de tiempo Unix en segundos (fecha de nacimiento)                                       |
| `birth_year` | `"1998"`         | Año de nacimiento de cuatro dígitos                                                          |
| `age_range`  | `"18-35"`        | Útil para segmentación general de audiencia                                                  |

## Cómo agregar, actualizar y eliminar etiquetas

Puede administrar las etiquetas usando cualquiera de los métodos a continuación, según su caso de uso y configuración técnica.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/e5B3nJyr_ao?si=PfVu4bHMkQJydc41" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<br />

<Columns cols={2}>
  <Card title="Métodos del SDK (Recomendado)">
    Configure etiquetas en tiempo real desde su aplicación o sitio web a medida que los usuarios realizan acciones.

    * → [Referencia del SDK móvil](./mobile-sdk-reference#data-tags)
    * → [Referencia del SDK web](./web-sdk-reference#data-tags)
  </Card>

  <Card title="API REST" href="/reference/update-user">
    Agregue, actualice o elimine etiquetas del lado del servidor usando nuestra API REST.
  </Card>

  <Card title="Journeys" href="./journeys-overview">
    Aplique etiquetas automáticamente a medida que los usuarios avanzan por los pasos de Journey.
  </Card>

  <Card title="Importación CSV" href="./import">
    Actualice etiquetas de usuario de forma masiva cargando un CSV con `external_id` o `subscription_id`.
  </Card>

  <Card title="Solicitudes de categoría web" href="./permission-requests">
    Solicite a los usuarios que seleccionen intereses, que se almacenan como etiquetas.
  </Card>

  <Card title="Mensajes en la aplicación" href="./in-app-messages-setup">
    Recopile o actualice etiquetas según las acciones de clic en mensajes en la aplicación.
  </Card>

  <Card title="Entrada manual">
    Edite etiquetas directamente desde el panel de OneSignal.

    * Vaya a **Audience > Users > User Profile > Tags**
  </Card>

  <Card title="Integraciones de terceros" href="./integrations">
    Algunas integraciones admiten la sincronización automática de etiquetas.

    * Segment, HubSpot, Mixpanel y otros
  </Card>
</Columns>

***

## Preguntas frecuentes

### ¿Cuántas etiquetas puedo establecer por usuario?

Depende de su plan. Consulte los [límites de su plan](https://onesignal.com/pricing) o [contacte a ventas](https://onesignal.com/contact) para aumentar su cuota.

### ¿Qué sucede con mis etiquetas si excedo los límites del plan?

No hay límite en la cantidad de etiquetas disponibles dentro de una aplicación de OneSignal. El límite se aplica a cuántas etiquetas se pueden establecer en cada usuario individual a la vez.

**No puede agregar o actualizar** etiquetas para usuarios que están en o por encima de su límite. Debe eliminar etiquetas primero, luego enviar una segunda solicitud para agregar nuevas.

Las etiquetas ya establecidas persistirán.

Ejemplo:

El límite de su plan = 20 etiquetas/usuario.

* El usuario tiene 19 etiquetas:
  * ✅ Agregar 1 etiqueta nueva = éxito
  * ❌ Agregar 2+ etiquetas nuevas = fallo
* El usuario tiene 20 etiquetas:
  * ❌ Agregar cualquier etiqueta nueva = fallo
  * ✅ Actualizar 1+ etiqueta existente = éxito

### ¿Dónde puedo verificar el uso de etiquetas?

* Panel: **Audience > Users > columna Tags**
* [Exportar usuarios](./exporting-data) para una vista completa

### ¿Cómo reduzco el uso de etiquetas?

* Elimine etiquetas usando el SDK o la API
* Use [Importación CSV](./import) para eliminar de forma masiva
* Use menos etiquetas más reutilizables (por ejemplo, `status:active`)

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>

***