分群
按筛选条件或手动维护的联系人分组,用作群发的受众,还可以绑定到某一个发信域名。
分群是一组已保存的联系人,可以向它发送 群发。在控制台的 联系人 → 分群 中创建分群,也可以通过 API 创建。
分群有两种:
- 筛选分群。 保存的是筛选条件,而不是一份人员名单。联系人一旦符合筛选条件,就立刻属于该分群,联系人数量在你读取时才计算。
- 手动分群。 创建时不带筛选条件。联系人由你自己在控制台中添加和移除,也可以用
POST /contacts/{id}/segments/{segmentId}和DELETE /contacts/{id}/segments/{segmentId}。
筛选条件可以检查联系人的邮箱、姓名、订阅状态、创建日期,以及任何 自定义属性。支持的运算符包括等于、包含、已设置、未设置和日期比较,多个条件可以用「与」「或」组合。
使用分群
- 群发。 选择一个分群作为受众。收到邮件的人在发送时计算,使用的筛选条件与你之前看到数量时相同。对整个团队退订的联系人,以及已从该群发的发信域名退订的联系人,始终会被排除。
- 联系人视图。 可以按分群筛选列表。CSV 导出遵循同样的筛选。
curl -X POST "https://api.billionsend.com/segments" \
-H "Authorization: Bearer bs_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Trial users",
"filter": { "match": "all", "conditions": [{ "field": "property:plan", "op": "equals", "value": "trial" }] }
}'
GET /segments/{id} 包含实时的 contact_count,GET /segments/{id}/contacts 列出成员。无效的筛选条件会返回 422,不会被保存。
每个品牌一个分群
如果你的每个域名都是一个独立品牌,可以通过设置 domain_id,把分群绑定到它所属的域名:创建时设置,之后用 PATCH /segments/{id} 设置,或在控制台中选择域名。
- 向已绑定的分群发送群发时,必须从该域名发出。从其他任何域名发送,群发相关的调用都会返回
422。 - 没有绑定域名的分群适用于所有域名。设置
"domain_id": null可让已绑定的分群重新成为团队通用。 - 只要还有分群绑定在某个域名上,该域名就不能删除(
409)。
订阅主题 也可以用同样的方式绑定。两者一起,让每个品牌的受众、订阅主题和退订彼此分开,参见 退订。
限定域名的 API 密钥
限定在某一个域名的 API 密钥,只能创建绑定到该域名的分群,不能创建团队通用的分群。