跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

分群

按筛选条件或手动维护的联系人分组,用作群发的受众,还可以绑定到某一个发信域名。

分群是一组已保存的联系人,可以向它发送 群发。在控制台的 联系人 → 分群 中创建分群,也可以通过 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 密钥,只能创建绑定到该域名的分群,不能创建团队通用的分群。

这个页面有帮助吗?