scribemail/cursor-plugin

Exécuter une campagne marketing par signature

Une campagne est une bannière affichée sous les signatures assignées pendant une fenêtre de temps. Elle est créée en tant que brouillon et ne fait rien tant qu'elle n'est pas planifiée.

Construire la campagne

1. get_content_schema avant de rédiger le content — le contenu d'une campagne est le même arbre de blocs strict que le draft_content d'une signature (une racine stack dont les children sont des blocs). Adaptez l'example retourné ; ne devinez pas le format.
2. create_marketing_campaign nécessite name, start_time, end_time (ISO-8601) et time_zone (IANA, p. ex. Europe/Paris). S'il en manque un → 422. Options : content et les champs de ciblage smart_fields_conditions et signature_template_ids.
3. preview_marketing_campaign affiche la bannière en HTML avec des valeurs fictives, sans suivi. Lisez-la et confirmez la mise en page avant de planifier — un html vide signifie que la campagne n'a pas encore de contenu.
4. update_marketing_campaign est partiel (omettre = inchangé, content: null efface). status est en lecture seule : il ne change qu'avec les outils de cycle de vie ci-dessous.

Lancer la campagne

Action	Outil	Refus quand
Activer un brouillon ou une campagne en pause	schedule_marketing_campaign	409 si non planifiable (p. ex. la date de fin est passée) ; 403 si le plan n'a pas de campagnes
Mettre en pause une campagne active	pause_marketing_campaign	409 si non active
Reprendre une campagne en pause	resume_marketing_campaign	409 si non en pause ; 403 sur le plan
Supprimer	delete_marketing_campaign	Arrête d'abord une campagne active

Une campagne planifiée devient active immédiatement si start_time est déjà passé, sinon elle attend. Confirmez avec l'utilisateur avant de planifier — cela place la bannière sur les emails sortants de l'entreprise.

Cibler la campagne

• signature_template_ids limite la campagne à des signatures spécifiques.
• smart_fields_conditions la limite par attributs des coéquipiers (même forme OU-ET que les règles de destinataire de signature).
• Laissez les deux vides pour l'ensemble de l'espace de travail.
• Une variante de signature peut refuser les bannières via show_marketing_campaigns sur la variante.

Mesurer la campagne

Passez l'identifiant de la campagne en tant que marketing_campaign_id à get_analytics_views et get_analytics_clicks pour ses propres vues, clics et taux de clics ; group_by: "marketing_campaign" classe les campagnes les unes par rapport aux autres. get_analytics_events_summary attribue les événements de conversion en aval. Voir la compétence signature-analytics.