---
title: 分群
description: 以篩選條件或手動建立的聯絡人群組，用作群發的受眾，並可各自綁定到單一寄件網域。
seo:
  title: Email 分群
ai:
  exclude: true
---

分群是一組已儲存的聯絡人，你可以對它傳送[群發](/docs/zh-hant/concepts/broadcasts)。在控制台的**聯絡人 → 分群**建立分群，也可以透過 API 建立。

分群有兩種：

- **篩選分群。** 它儲存的是篩選條件，而不是一份人員名單。聯絡人一旦符合條件，就立刻屬於這個分群，聯絡人數則在你讀取時才計算。
- **手動分群。** 建立時不帶篩選條件。你自己在控制台，或用 `POST /contacts/{id}/segments/{segmentId}` 與 `DELETE /contacts/{id}/segments/{segmentId}` 新增與移除聯絡人。

篩選條件可以針對聯絡人的 Email、姓名、訂閱狀態、建立日期，以及任何[自訂屬性](/docs/zh-hant/concepts/contacts)。運算子包括等於、包含、已設定、未設定與日期比較，條件之間可用 and / or 組合。

## 使用分群

- **群發。** 選擇一個分群作為受眾。實際收信的人會在寄出時計算，使用的篩選條件與你寄出前看到的人數相同。已在團隊層級退訂，或已退訂該群發寄件網域的聯絡人，一律會被排除。
- **聯絡人檢視。** 依分群篩選清單。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-hant/concepts/topics)也可以用同樣的方式綁定。兩者搭配，就能讓每個品牌的受眾、訂閱主題與退訂彼此獨立；請見[退訂](/docs/zh-hant/concepts/unsubscribes)。

## 限制在單一網域的 API 金鑰

限制在單一網域的 API 金鑰，只能建立綁定到該網域的分群，不能建立團隊層級的分群。
