# Atributos y eventos

Los atributos son los campos que describen a un contacto; los eventos son las acciones con fecha y hora que construyen su actividad. En esta página se explican los tipos de atributo y de dato, los atributos de sistema frente a los personalizados, los atributos únicos y la fusión automática, los límites y acciones de atributos, y el catálogo completo de eventos con su origen.

**Language:** es
**Audience:** platform
**Translation key:** platform.audience.attributes-events
**Search keywords:** atributo, atributos, atributo personalizado, atributo de sistema, atributo primario, atributo ad-hoc, atributo de evento, atributo único, atributo de solo lectura, tipo de dato, texto, número, fecha, sí/no, divisa, crear atributo, editar atributo, eliminar atributo, marcar como único, fusión, unificación, deduplicación, evento, eventos, actividad, categorías de eventos, esquema de evento, parámetros de evento, esquema, esquema de datos, atributos de suscripción
**Related pages:** /platform/en/audience/attributes-events, /platform/es/audience, /platform/es/audience/segments, /platform/es/data-sources, /platform/es/consent
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This zone's index:** https://docs.instasent.com/platform/es/llms.txt
**This page:** https://docs.instasent.com/platform/es/audience/attributes-events/ (HTML) · https://docs.instasent.com/platform/es/audience/attributes-events.md (Markdown)
**Other language (en):** https://docs.instasent.com/platform/en/audience/attributes-events.md

Todo lo que sabes de un contacto se guarda de dos maneras. Los **atributos** son lo que un
contacto *es*: sus campos fijos —nombre, teléfono, país, total gastado—, que se sobrescriben
cuando llega un valor nuevo. Los **eventos** son lo que un contacto *hizo*: acciones con fecha y
hora —un pedido, un clic, un carrito abandonado— que se van acumulando y forman su historial.
Juntos, atributos y eventos son la materia con la que segmentas tu audiencia y personalizas los
mensajes.

Los atributos se gestionan en la pantalla de **Atributos**, a la que llegas desde **Ajustes ›
Proyecto › Atributos**, desde la ficha de un contacto o con la URL `/customer-data/attributes`.

![El gestor de atributos listando los atributos del proyecto con su descripción, su formato (tipo de dato) y su tipo (personalizado o primario), además del botón Crear atributo y los filtros Tipo / Formato](/platform/es/audience/images/attributes-events--1-attributes-manager.png)
*El gestor de atributos: todos los campos del esquema del proyecto, con su tipo de dato y si son personalizados o de sistema.*

## Atributos

Un atributo es un campo de cada contacto: un nombre, un teléfono, un país, el total gastado. El
gestor de atributos lista cada uno con su descripción, su **Formato** (tipo de dato) y su
**Tipo** (**personalizado** o **primario**), y un recuento de cuántos tienes (por ejemplo, *Tienes 81
atributos*). Las filas se pueden reordenar arrastrándolas, salvo la fijada **Nombre completo**.

### Tipo: personalizados, de sistema y de solo lectura

La columna **Tipo** lleva una de dos etiquetas, **personalizado** o **primario**, pero en realidad hay
cuatro clases de atributo, y lo que puedes hacer con cada una es distinto:

- **Personalizado**: los que añades para tus propios datos. Son totalmente editables
  (nombre, descripción, tipo) y se pueden eliminar.
- **Primario / de sistema**: los campos integrados que mantiene Instasent (nombre completo,
  teléfono móvil, email, país, los totales de e-commerce, etc.). Sus nombres empiezan por un
  guion bajo (`_full_name`, `_phone_mobile`, `_email`). Puedes **Ver detalles**, pero no
  renombrarlos, cambiarles el tipo ni eliminarlos.
- **Ad-hoc**: campos que aportan las integraciones (por ejemplo, el client ID de Klaviyo). Son
  de solo lectura y no se pueden eliminar, y **no cuentan para tu límite de atributos
  personalizados**.
- **De evento / e-commerce**: campos de solo lectura que se crean en masa la primera vez que
  llegan eventos de pedido de e-commerce (totales, medias, fecha del último pedido,
  predicciones). No se pueden editar ni eliminar.

En la columna **Tipo** solo verás dos etiquetas: los ad-hoc y los de evento/e-commerce se
muestran también como **personalizado** (lo que los distingue de un personalizado editable son sus
restricciones de solo lectura, no la etiqueta). Una columna de **restricciones** señala los
atributos **Únicos** o de **Solo lectura**, y una línea bajo cada uno indica qué fuentes de datos
lo configuraron.

### Tipos de dato

Cada atributo tiene un tipo de dato —su **Formato**— que determina cómo se comporta en los
filtros y la personalización:

| Formato    | Ejemplos                                                                                                       |
| ---------- | -------------------------------------------------------------------------------------------------------------- |
| **Texto**  | Texto plano, con variantes de longitud (keyword hasta 40, string hasta 128, texto largo hasta 512 caracteres). |
| **Número** | Entero, decimal (1–3 posiciones) y unidades como días u horas.                                                 |
| **Fecha**  | Fecha, fecha y hora, hora y zona horaria.                                                                      |
| **Sí/No**  | Un campo booleano.                                                                                             |
| **Divisa** | Un importe monetario (EUR), que usan los totales de e-commerce.                                                |

El tipo de dato es lo que determina qué
[operadores](/platform/es/audience/segments#operadores-por-tipo-de-campo) tienes al filtrar por
el atributo.

### Crear y editar atributos

Puedes crear un atributo personalizado con **Crear atributo** en la pantalla de Atributos, o al
vuelo mientras mapeas las columnas de una importación (ver
[Fuentes de datos](/platform/es/data-sources)). Al crear o editar:

- La **etiqueta visible es obligatoria, de 2 a 50 caracteres**, y la descripción admite hasta
  **128 caracteres**.
- Se requiere un tipo de dato. Al editar, solo los atributos personalizados cambian, y el tipo
  solo puede cambiarse a uno compatible.
- El identificador (uid) es de solo lectura; puedes copiarlo.

El menú de acciones de cada atributo ofrece **Editar** / **Ver detalles**, **Duplicar**,
**Copiar ID**, **Marcar como único** (cuando procede) y **Eliminar** (solo para atributos
personalizados cuyo id no empieza por `_`).

> **Note**: Puedes editar el *valor* de cualquier atributo de un contacto desde su
> [ficha](/platform/es/audience/contacts-profiles). Lo que no puedes cambiar en un atributo de
> sistema es su *definición*: su nombre y su tipo.

### Atributos únicos y fusión automática

Un atributo puede marcarse como **único** (la acción **Marcar como único**). Cuando lo es,
Instasent lo usa como clave de identidad: si llegan datos con el mismo valor en un atributo
único, **todos los contactos con ese valor se fusionan automáticamente** en una sola ficha en
lugar de crear duplicados.

Marcar un atributo como único es una acción única e irreversible: el panel la confirma con *Todos
los contactos con el mismo valor en {atributo} se fusionarán automáticamente. Esta acción no se
puede deshacer.* Los valores vacíos nunca se fusionan. Por defecto, el teléfono móvil y el correo actúan
como claves únicas, y así una persona que aparece en varias fuentes sigue siendo un único
contacto.

### Límites

El número de **atributos personalizados** que puedes crear depende de tu plan; los atributos
ad-hoc y de evento no cuentan para ese límite.
{/* VERIFY: límite exacto de atributos personalizados por plan */} Algunos atributos son
multivalor, con sus propios topes (por ejemplo, suscripciones hasta 50, y deals o
automatizaciones hasta 100). Los límites de longitud dependen del tipo de texto: keyword 40,
string 128, texto largo 512 caracteres.

## Eventos

Un **evento** es una acción con fecha y hora que realizó un contacto: un pedido, un clic en una
campaña, un carrito abandonado, la asistencia a una reunión. Los eventos son los que llenan la
[línea de actividad](/platform/es/audience/contacts-profiles#actividad) del contacto y permiten
segmentar por comportamiento.

- **Esquema**: cada evento tiene un nombre y un conjunto de **parámetros** tipados (un evento de
  pedido lleva su id de pedido, importe, divisa, nombre de producto y código de descuento; uno
  de cupón su código, valor y porcentaje; uno de checkout su importe y número de productos; y
  así). Esos parámetros son por los que filtras en una condición de segmento *Filtrar por
  actividad*, y los que puedes usar como variables en un mensaje.
- **De dónde vienen**: los eventos los alimentan tus
  [fuentes de datos](/platform/es/data-sources): un conector como Shopify o Klaviyo, o la API y
  los webhooks. Cada evento lleva la fuente de datos de la que procede. No se escriben a mano,
  por eso son de solo lectura en la ficha.

### Categorías de eventos

Los eventos se agrupan en familias. El catálogo es amplio —en torno a setenta tipos— e incluye:

- **Ciclo de vida**: creado, fusionado, eliminado, actualizado, suscrito, dado de baja.
- **General / web**: genérico, personalizado, acción, vista, activo, clic, métrica.
- **Formularios**: formulario visto, formulario enviado.
- **Facturación**: pago, reembolso, contracargo, factura.
- **Marketing / inbound**: lead, inbound.
- **Campaña**: campaña enviada, clic de campaña (CTA), campaña abierta.
- **Automatización**: disparada, enviada, despachada, CTA, abierta, flujo.
- **Transaccional**: enviado, CTA, abierto.
- **E-commerce — productos**: producto visto, añadido, comprado.
- **E-commerce — checkout**: checkout iniciado, abandonado, cancelado, actualizado.
- **E-commerce — pedidos**: pedido creado, actualizado, pagado, enviado, entregado, cancelado,
  reembolsado, con contracargo.
- **E-commerce — cupones**: cupón creado, usado, eliminado.
- **Suscripciones**: cambio de plan, cancelación, renovación.
- **Reuniones**: registrada, cancelada, unido, abandonada.
- **Deals / CRM**: deal añadido, actualizado, ganado, perdido.

Los eventos de e-commerce solo aparecen en proyectos de e-commerce.

### Explorar la actividad

Los eventos se exploran de dos formas: por contacto, en la tarjeta de **Actividad** de la
[ficha](/platform/es/audience/contacts-profiles#actividad), y en todo el proyecto, en **Audiencia
› Actividad**. Ambas muestran una línea de actividad que puedes filtrar por tipo de evento, periodo
(últimos 30 / 90 días, últimos 12 meses) y base de la fecha (fecha del evento frente a fecha de
recepción), con **Eventos recomendados** como selección por defecto. Cada evento abre un panel con
sus parámetros, su atribución (UTM) y su información general, y los eventos de pedido/checkout se
despliegan en línea para más detalle. Cuando no coincide nada, el feed ofrece restablecer los
filtros.

## Atributos de suscripción

Entre los atributos de sistema hay un conjunto que registra el **consentimiento por canal**: si
un contacto acepta marketing y si está suscrito en SMS, WhatsApp, etc. Se muestran en la ficha,
en **Preferencias de canal**, pero el modelo que hay detrás —qué significa cada valor y cómo se
aplica— es propiedad de [Consentimiento](/platform/es/consent). Consulta esa sección para verlo
en detalle.

Una vez tengas tu esquema listo, úsalo en
[Segmentos](/platform/es/audience/segments).

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.