scribemail/cursor-plugin

Cómo ejecutar una campaña de marketing de firma

Una campaña es un banner que se muestra debajo de las firmas asignadas durante un período de tiempo. Se crea como un borrador y no hace nada hasta que se programa.

Cómo crearla

1. get_content_schema antes de redactar el content: el contenido de una campaña es el mismo árbol de bloques estricto que el draft_content de una firma (una raíz stack cuyos children son bloques). Adapta el example devuelto; no adivines el formato.
2. create_marketing_campaign requiere name, start_time, end_time (ISO-8601) y time_zone (IANA, p. ej. Europe/Paris). Si falta uno → 422. Opcional: content y los campos de segmentación smart_fields_conditions y signature_template_ids.
3. preview_marketing_campaign renderiza el banner a HTML con valores de ejemplo, sin seguimiento. Léelo y confirma el diseño antes de programar: un html vacío significa que la campaña aún no tiene contenido.
4. update_marketing_campaign es parcial (omitir = no cambia, content: null lo borra). status es de solo lectura: solo cambia mediante las herramientas de ciclo de vida que aparecen a continuación.

Cómo publicarla

Acción	Herramienta	Se niega cuando
Activar una campaña en borrador o pausada	schedule_marketing_campaign	409 si no se puede programar (p. ej., la hora de fin ya pasó); 403 si el plan no incluye campañas
Pausar una campaña activa	pause_marketing_campaign	409 si no está activa
Reanudar una campaña pausada	resume_marketing_campaign	409 si no está pausada; 403 por el plan
Eliminar	delete_marketing_campaign	Primero detiene una campaña activa

Una campaña programada se activa de inmediato si start_time ya ha pasado; de lo contrario, espera hasta ese momento. Confirma con el usuario antes de programar: esto pone el banner en el correo saliente de la empresa.

Cómo segmentarla

• signature_template_ids limita la campaña a firmas específicas.
• smart_fields_conditions la limita por atributos de los compañeros (misma forma OR-de-ANDs que las reglas de destinatarios de firmas).
• Deja ambos vacíos para toda el área de trabajo.
• Una variante de firma puede optar por no mostrar banners mediante show_marketing_campaigns en la variante.

Cómo medirla

Pasa el id de la campaña como marketing_campaign_id a get_analytics_views y get_analytics_clicks para obtener sus vistas, clics y tasa de clics; group_by: "marketing_campaign" ordena las campañas entre sí. get_analytics_events_summary atribuye eventos de conversión posteriores. Consulta el skill signature-analytics.