Atributos y eventos

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.

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

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 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. 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 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: 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, 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. Consulta esa sección para verlo en detalle.

Una vez tengas tu esquema listo, úsalo en Segmentos.