运行签名营销活动
活动是在指定时间窗口内呈现在已分配签名下方的横幅。它最初以草稿形式创建,在安排之前不会执行任何操作。
构建内容
get_content_schema在编写content之前调用——活动的内容与签名的draft_content使用相同的严格块树结构(一个stack根节点,其children为块)。适配返回的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 技能。