Communitygithub.com

scribemail/cursor-plugin

執行 Scribe 簽名檔行銷活動:建立橫幅內容、設定目標對象、排程/暫停/繼續活動,並衡量成效。當使用者想透過所有人電子郵件簽名檔下方的橫幅推廣活動、產品發布或優惠時使用。

cursor-plugin 是什麼?

此技能可讓 AI Agent 透過 Scribe 平台,在組織內所有成員的電子郵件簽名檔底下建立並執行行銷橫幅活動。使用者可以建立、預覽和更新活動內容(使用嚴格的區塊樹結構),並透過排程、暫停、繼續或刪除活動來管理其生命週期。定位功能支援按特定簽名範本或團隊成員屬性(智慧欄位條件)設定目標對象,若留空則作用於整個工作區。成效衡量的部分,則可透過分析端點(例如 `get_analytics_views` 和 `get_analytics_clicks`)取得個別活動的曝光數、點擊數及點擊率,並能與其他活動進行比較。此技能適用於 Cursor 等支援工具,並仰賴嚴格的生命週期狀態機(草稿→排程→啟用/暫停)與特定的 API 結構。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scribemail/cursor-plugin/tree/HEAD/skills/marketing-campaigns

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

執行簽名檔行銷活動

行銷活動是指在指定時間窗口內,顯示於已指派簽名檔下方的橫幅。活動會先建立為草稿,在排程之前不會有任何作用。

建立活動

  1. 在撰寫 content 之前,先使用 get_content_schema — 活動的內容與簽名檔的 draft_content 使用相同的嚴格區塊樹結構(一個 children 為區塊的 stack 根節點)。請參考回傳的 example,不要自行推測格式。
  2. create_marketing_campaign 需要提供 name、start_time、end_time(ISO-8601 格式)以及 time_zone(IANA 時區,例如 Europe/Paris)。缺少任一項會得到 422 錯誤。可選欄位包含:content 以及定位用的 smart_fields_conditions 和 signature_template_ids。
  3. preview_marketing_campaign 會將橫幅渲染為 HTML,並使用佔位符值,不啟用追蹤。在排程前請先閱讀並確認版面配置 — 空白的 html 表示活動尚未有內容。
  4. update_marketing_campaign 是部分更新(省略的欄位不變,content: null 則清除內容)。status 為唯讀:只能透過下列生命週期工具來改變。

啟用活動

動作工具拒絕條件
啟用草稿或已暫停的活動schedule_marketing_campaign若無法排程則回傳 409(例如結束時間已過);若方案不包含活動功能則回傳 403
暫停正在執行的活動pause_marketing_campaign若活動不在執行中則回傳 409
繼續已暫停的活動resume_marketing_campaign若活動未暫停則回傳 409;方案問題則回傳 403
刪除活動delete_marketing_campaign若活動正在執行,會先將其停止

已排程的活動若 start_time 已過期則會立即上線,否則會等待時間到來。在排程前請先與使用者確認 — 這會將橫幅顯示在公司的外寄郵件上。

設定目標對象

  • signature_template_ids 可將活動限定於特定的簽名範本。
  • smart_fields_conditions 可根據團隊成員屬性來限定範圍(與簽名檔收件者規則相同的 OR-of-ANDs 結構)。
  • 若兩者皆留空,則作用於整個工作區。
  • 簽名範本變體可透過該變體上的 show_marketing_campaigns 選擇退出橫幅顯示。

衡量成效

將活動的 ID 作為 marketing_campaign_id 傳遞給 get_analytics_views 和 get_analytics_clicks,以取得該活動的曝光數、點擊數及點擊率;使用 group_by: "marketing_campaign" 則可讓活動之間互相排名。get_analytics_events_summary 會歸因後續的轉換事件。詳細說明請參閱 signature-analytics 技能。

相關技能