Concepto
Segmentos con seguimiento
Los segmentos con seguimiento registran quién entra y quién sale, y cuándo. Inicia automatizaciones y envía webhooks con las entradas y salidas, y sigue el crecimiento de un segmento. Alfa: solo para el equipo de Emailit.
Un segmento con seguimiento es un segmento que además guarda sus miembros. Cuando un contacto empieza a cumplir sus reglas o deja de cumplirlas, Emailit registra el cambio, así que puedes:
- iniciar automatizaciones cuando alguien entra o sale,
- recibir webhooks con las entradas y salidas,
- ver el crecimiento del segmento a lo largo del tiempo y cuándo entró cada contacto.
Los recuentos, la lista de contactos y las campañas funcionan igual que en cualquier segmento: evalúan las reglas en directo y nunca usan los miembros guardados.
Los segmentos con seguimiento están incluidos en los planes Pro, Business y Custom, y cuentan para el mismo límite de segmentos que los demás segmentos.
Crear un segmento con seguimiento
Al crear un segmento, elige Tracked segment en Type. En Pay as you go, la opción está desactivada y muestra Upgrade. Con la API, pasa "tracked": true a Crear un segmento.
El tipo no se puede cambiar después, en ninguna de las dos direcciones. Para hacer el seguimiento de un segmento existente, crea un segmento con seguimiento nuevo con las mismas reglas. Duplicate mantiene el tipo del original.
Justo después de crearlo, un segmento con seguimiento muestra Recording current members mientras Emailit guarda a todos los que ya coinciden (tracking.status es syncing en la API). Este primer recuento no envía eventos ni inicia automatizaciones: solo cuentan como cambios los contactos que entran o salen después.
Cómo se actualizan los miembros
| Qué ocurre | Cuándo se actualizan los miembros | reason |
|---|---|---|
| Se crea, se edita o se elimina un contacto, se suscribe o se da de baja, o un paso de una automatización lo modifica | Normalmente en menos de un minuto | contact |
| Termina una importación de contactos o se elimina una lista de contactos | Cuando termina, para todo el segmento | contact |
| Reglas que avanzan con el tiempo, como Created en los últimos 30 días, y cambios que no generan eventos de contacto | Cada día a las 00:30 UTC, para todo el segmento | schedule |
| Editas el origen o los filtros del segmento | Justo después de guardar | segment_updated |
Cada entrada o salida se registra con su reason. Los cambios causados por editar el segmento se envían a los webhooks, pero no inician automatizaciones, así que un cambio de reglas no ejecuta una automatización para todos los contactos a los que afecta. Los contactos que salen porque se han eliminado no envían ningún evento.
Iniciar automatizaciones
Dos disparadores de contacto parten de un segmento con seguimiento:
| Disparador | Clave en la API | Inicia una ejecución cuando |
|---|---|---|
| Added to segment | contact.added_to_segment |
Un contacto entra en el segmento. |
| Removed from segment | contact.removed_from_segment |
Un contacto sale del segmento. |
Elige el segmento en Tracked segment, en el disparador. Solo aparecen los segmentos con seguimiento, y solo ellos se pueden usar. Las ejecuciones suelen empezar en menos de un minuto tras la entrada o la salida.
Para Added to segment, selecciona Also start for contacts already in the segment when the automation is first started para ejecutar también la automatización para los miembros actuales. Esto ocurre una sola vez, en el primer inicio de la automatización, para los miembros registrados en ese momento. Se siguen aplicando los ajustes de ejecución de la automatización, como allow_reentry y cooldown_seconds. Consulta Usar la API.
Las entradas y salidas también pueden terminar ejecuciones (Removed from segment como condición de salida), cumplir objetivos y reanudar pasos Wait until. Consulta Condiciones de salida y objetivos.
Un segmento que se usa en una automatización no se puede eliminar hasta que cambies esa automatización. Consulta Disparadores de las automatizaciones.
Webhooks
Las entradas y salidas envían estos eventos de webhook:
segment.contact_addedcuando un contacto entra, conjoined_at.segment.contact_removedcuando un contacto sale, conleft_at.
Ambos incluyen el id y el name del segmento, el id, el email, los nombres y los campos personalizados del contacto, y el reason de la tabla anterior. El Activity log del contacto también muestra «Joined segment» y «Left segment».
El crecimiento y la columna Joined
La página de un segmento con seguimiento tiene un gráfico Growth de los últimos 30 días: los miembros al final de cada día (Members) y cuántos contactos han entrado (Joined) y salido (Left). El historial empieza cuando empieza el seguimiento, y el primer recuento no se muestra como entradas.
La tabla de contactos añade una columna Joined con la fecha en que empezó la permanencia actual del contacto en el segmento. Un contacto que sale y vuelve recibe una fecha nueva. La columna está vacía hasta que el seguimiento registra al contacto.
Con la API, usa Obtener el crecimiento de un segmento para consultar hasta 365 días, y Listar los contactos de un segmento para obtener joined_at.
Cuando el seguimiento se pausa
Si el espacio de trabajo cambia a un plan sin segmentos con seguimiento, el seguimiento se pausa. La página del segmento muestra Tracking is paused y tracking.status es paused:
- Los miembros dejan de actualizarse, no se envían eventos y no se inicia ninguna automatización desde el segmento.
- El segmento sigue funcionando en directo para los recuentos, las listas y los envíos, como cualquier segmento.
Cuando vuelves a subir de plan, Emailit vuelve a registrar los miembros actuales en la siguiente actualización, sin enviar eventos ni iniciar automatizaciones, y después el seguimiento continúa. Las entradas y salidas que se produjeron mientras el seguimiento estaba pausado no se registran.
Usar la API
| Tarea | Endpoint |
|---|---|
| Crear un segmento con seguimiento | Crear un segmento con "tracked": true |
| Comprobar el estado del seguimiento | tracked y tracking en Obtener un segmento |
| Miembros, entradas y salidas de cada día | Obtener el crecimiento de un segmento |
| Cuándo entró cada miembro | joined_at en Listar los contactos de un segmento |
En Pay as you go, "tracked": true devuelve 403 con "error": "plan_required" y "required_plan": "pro". Listar segmentos devuelve usage.tracking_allowed, que indica si el plan incluye segmentos con seguimiento.