執行簽名檔行銷活動
行銷活動是指在指定時間窗口內,顯示於已指派簽名檔下方的橫幅。活動會先建立為草稿,在排程之前不會有任何作用。
建立活動
- 在撰寫
content之前,先使用get_content_schema— 活動的內容與簽名檔的draft_content使用相同的嚴格區塊樹結構(一個children為區塊的stack根節點)。請參考回傳的example,不要自行推測格式。 create_marketing_campaign需要提供name、start_time、end_time(ISO-8601 格式)以及time_zone(IANA 時區,例如Europe/Paris)。缺少任一項會得到 422 錯誤。可選欄位包含:content以及定位用的smart_fields_conditions和signature_template_ids。preview_marketing_campaign會將橫幅渲染為 HTML,並使用佔位符值,不啟用追蹤。在排程前請先閱讀並確認版面配置 — 空白的html表示活動尚未有內容。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 技能。