---
title: 分群
description: 按筛选条件或手动维护的联系人分组，用作群发的受众，还可以绑定到某一个发信域名。
seo:
  title: 邮件分群
ai:
  exclude: true
---

分群是一组已保存的联系人，可以向它发送 [群发](/docs/zh-hans/concepts/broadcasts)。在控制台的 **联系人 → 分群** 中创建分群，也可以通过 API 创建。

分群有两种：

- **筛选分群。** 保存的是筛选条件，而不是一份人员名单。联系人一旦符合筛选条件，就立刻属于该分群，联系人数量在你读取时才计算。
- **手动分群。** 创建时不带筛选条件。联系人由你自己在控制台中添加和移除，也可以用 `POST /contacts/{id}/segments/{segmentId}` 和 `DELETE /contacts/{id}/segments/{segmentId}`。

筛选条件可以检查联系人的邮箱、姓名、订阅状态、创建日期，以及任何 [自定义属性](/docs/zh-hans/concepts/contacts)。支持的运算符包括等于、包含、已设置、未设置和日期比较，多个条件可以用「与」「或」组合。

## 使用分群

- **群发。** 选择一个分群作为受众。收到邮件的人在发送时计算，使用的筛选条件与你之前看到数量时相同。对整个团队退订的联系人，以及已从该群发的发信域名退订的联系人，始终会被排除。
- **联系人视图。** 可以按分群筛选列表。CSV 导出遵循同样的筛选。

```sh
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`）。

[订阅主题](/docs/zh-hans/concepts/topics) 也可以用同样的方式绑定。两者一起，让每个品牌的受众、订阅主题和退订彼此分开，参见 [退订](/docs/zh-hans/concepts/unsubscribes)。

## 限定域名的 API 密钥

限定在某一个域名的 API 密钥，只能创建绑定到该域名的分群，不能创建团队通用的分群。
