scribemail/cursor-plugin

Executando uma campanha de marketing de assinatura

Uma campanha é um banner renderizado abaixo de assinaturas atribuídas durante um período de tempo. Ela é criada como um rascunho e não faz nada até ser agendada.

Construa-a

1. get_content_schema antes de criar o content — o conteúdo de uma campanha é a mesma árvore de blocos estrita que o draft_content de uma assinatura (uma raiz stack cujos children são blocos). Adapte o example retornado; não adivinhe o formato.
2. create_marketing_campaign requer name, start_time, end_time (ISO-8601) e time_zone (IANA, ex. Europe/Paris). Faltando um → 422. Opcional: content e os campos de segmentação smart_fields_conditions e signature_template_ids.
3. preview_marketing_campaign renderiza o banner em HTML com valores de espaço reservado, sem rastreamento. Leia e confirme o layout antes de agendar — um html vazio significa que a campanha ainda não tem conteúdo.
4. update_marketing_campaign é parcial (omitir = inalterado, content: null limpa). status é somente leitura: ele só se move através das ferramentas de ciclo de vida abaixo.

Publique-a

Ação	Ferramenta	Recusa quando
Ativar um rascunho ou campanha pausada	schedule_marketing_campaign	409 se não agendável (ex. o tempo de término já passou); 403 se o plano não tiver campanhas
Pausar uma campanha ativa	pause_marketing_campaign	409 se não estiver ativa
Retomar uma campanha pausada	resume_marketing_campaign	409 se não estiver pausada; 403 no plano
Excluir	delete_marketing_campaign	Primeiro para uma campanha ativa

Uma campanha agendada entra em vigor imediatamente se start_time já tiver passado, caso contrário, espera por ele. Confirme com o usuário antes de agendar — isso coloca o banner no email corporativo de saída.

Direcione-a

• signature_template_ids define o escopo da campanha para assinaturas específicas.
• smart_fields_conditions define o escopo por atributos dos colegas (mesma forma OU-de-ANDs das regras de destinatário da assinatura).
• Deixe ambos vazios para o workspace inteiro.
• Uma variante de assinatura pode recusar banners via show_marketing_campaigns na variante.

Meça-a

Passe o id da campanha como marketing_campaign_id para get_analytics_views e get_analytics_clicks para obter suas próprias visualizações, cliques e taxa de cliques; group_by: "marketing_campaign" classifica as campanhas entre si. get_analytics_events_summary atribui eventos de conversão downstream. Veja a skill signature-analytics.