分群
以篩選條件或手動建立的聯絡人群組,用作群發的受眾,並可各自綁定到單一寄件網域。
分群是一組已儲存的聯絡人,你可以對它傳送群發。在控制台的聯絡人 → 分群建立分群,也可以透過 API 建立。
分群有兩種:
- 篩選分群。 它儲存的是篩選條件,而不是一份人員名單。聯絡人一旦符合條件,就立刻屬於這個分群,聯絡人數則在你讀取時才計算。
- 手動分群。 建立時不帶篩選條件。你自己在控制台,或用
POST /contacts/{id}/segments/{segmentId}與DELETE /contacts/{id}/segments/{segmentId}新增與移除聯絡人。
篩選條件可以針對聯絡人的 Email、姓名、訂閱狀態、建立日期,以及任何自訂屬性。運算子包括等於、包含、已設定、未設定與日期比較,條件之間可用 and / or 組合。
使用分群
- 群發。 選擇一個分群作為受眾。實際收信的人會在寄出時計算,使用的篩選條件與你寄出前看到的人數相同。已在團隊層級退訂,或已退訂該群發寄件網域的聯絡人,一律會被排除。
- 聯絡人檢視。 依分群篩選清單。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 金鑰,只能建立綁定到該網域的分群,不能建立團隊層級的分群。