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

退訂與品牌

退訂依寄件網域各自記錄,因此每個品牌都有自己的名單、退訂頁面與連結主機。

退訂的意思是「不要再寄行銷郵件給我」。BillionSend 會把它記錄在帶有該連結的 Email 所屬的寄件網域上,所以擁有多個品牌的團隊,名單不會混在一起。離開某個品牌的人,仍會收到其他品牌的信。

交易郵件(沒有帶訂閱主題,也不屬於群發的郵件)永遠不受退訂影響。

三種範圍

範圍 由誰設定 停止什麼
網域 收件者,使用退訂連結或其郵件用戶端的一鍵按鈕 寄出該封 Email 的網域所寄的行銷郵件
整個團隊 你,把聯絡人的 unsubscribed 設為 true(API、控制台或 CSV 匯入) 團隊所有網域的行銷郵件
訂閱主題 收件者,在退訂頁面上 帶有該訂閱主題的郵件

收件者自己的退訂,永遠不會改動聯絡人的 unsubscribed 旗標。它會以該網域的一筆記錄儲存,並以 Email 位址作為索引,所以刪除再重新匯入聯絡人後,這筆記錄仍然有效。

群發與訂閱主題寄送,會略過已退出該寄件網域、整個團隊或該訂閱主題的收件者。以這種方式被攔下的單封 Email,最後狀態是 suppressed,原因為 domain_unsubscribed、contact_unsubscribed 或 topic_unsubscribed。

退訂不等於抑制。抑制清單收錄的是曾退信、投訴或由你封鎖的位址,會停止所有 Email,交易郵件也包含在內。退訂只會停止行銷郵件。

退訂頁面

每封群發與訂閱主題的 Email,都帶有一鍵退訂的 List-Unsubscribe 標頭(RFC 8058),以及一個連到託管退訂頁面的連結。在內文中放入 {{{UNSUBSCRIBE_URL}}},它就會變成每位收件者各自的同一個連結。頁面會以收件者的瀏覽器語言開啟(共 14 種語言,備用語言為英文)。除了退出該網域的所有行銷郵件,收件者也可以個別開關各個訂閱主題。

誤按的收件者,可以在確認頁面按重新訂閱。它只會復原該連結造成的退訂。開啟連結的郵件掃描器,永遠不會讓任何人重新訂閱。當你自己設定 unsubscribed: true 時,頁面上不會有重新訂閱按鈕。

每個網域有自己的外觀

頁面的外觀會與寄出該封 Email 的網域一致。每個網域可以設定:

  • 品牌名稱、標誌與標誌的圓角,
  • 背景、文字與強調色,
  • 按鈕上方的文字,以及儲存選擇後顯示的文字,
  • 退訂後要開啟的重新導向 URL,用來取代頁面上的訊息。

在控制台中,打開網域並使用品牌分頁,它會預覽結果。你留空的欄位會依序退回團隊的品牌預設值(設定),再退回 BillionSend 的簡潔外觀。頁面只會顯示屬於該網域的內容:它絕不會提到團隊的其他網域,而且只列出綁定到該網域的訂閱主題,以及沒有綁定網域的訂閱主題。

透過 API,則在 PATCH /domains/{id} 的 unsubscribe_page 中傳送這些欄位。null 會清除欄位。標誌在控制台上傳,在 API 中是唯讀。

curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "unsubscribe_page": {
      "brand_name": "Acme",
      "message": "Sorry to see you go. Unsubscribe from Acme emails?",
      "success_message": "You are unsubscribed from Acme.",
      "accent_color": "#0a7d5a",
      "logo_radius": "rounded"
    }
  }'

在 Email 之外產生的連結,例如 POST /contacts/{id}/preferences-link 傳回的連結,會開啟團隊的預設頁面,在那裡退訂會讓聯絡人退出所有網域。

你自己的退訂子網域

預設情況下,連結會在 BillionSend 的主機上開啟。想在你自己的網域上開啟,請在網域的連結分頁為它設定退訂子網域,或對 POST /domains 或 PATCH /domains/{id} 使用 unsubscribe_subdomain(標籤,例如用 unsubscribe 代表 unsubscribe.yourdomain.com;null 會清除)。它的運作方式與追蹤子網域相同,請見網域。

  1. 新增網域的 DNS 分頁顯示的 CNAME,指向 cname.billiondns.com,並設為僅限 DNS(Cloudflare 上的灰雲)。
  2. CNAME 解析後會自動核發憑證,通常在幾分鐘內完成。unsubscribe_status 會從 pending 變成 active,沒有成功時,unsubscribe_error 會說明原因。
  3. 之後新寄出的信件會在連結與 List-Unsubscribe 標頭中使用你的主機。在啟用之前,以及出現 failed 結果(72 小時內未啟用)之後,會使用共用主機。

已經寄出的連結會保留寄出時的主機,所以你之後移除 CNAME,它就會失效。你的子網域只會開啟它自己網域的連結,其他任何連結都會回應 404。

追蹤與退訂可以共用同一個標籤,但分開命名更安全:廣告封鎖器會封鎖追蹤主機,共用同一個名稱會讓退訂連結一起被封鎖。

讀取與變更退訂

GET /contacts/{id} 會回傳 unsubscribed(團隊層級的旗標)與 unsubscribed_domains。在控制台中,聯絡人的頁面會列出兩者,也能讓你移除某個網域的退訂。聯絡人下的退訂分頁會列出所有記錄。

# 列出,最新的在前。domain_id 可縮小到單一網域。
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..."

# 記錄對單一網域的退訂(省略 domain_id 代表所有網域)
curl -X POST "https://api.billionsend.com/unsubscribes" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'

# 移除一筆記錄
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
  -H "Authorization: Bearer bs_..."

domain_id 與 domain 都是 null 的記錄,代表該位址退出所有網域。POST 具有冪等性:已存在的記錄會原樣回傳。相同的呼叫也有對應的 MCP 工具:list_unsubscribes、add_unsubscribe 與 delete_unsubscribe。

各項操作解除的範圍:

  • 帶有 unsubscribed: false 的 PATCH /contacts/{id} 只會解除團隊層級的退訂。特定網域的退訂會保留。
  • DELETE /unsubscribes/{id} 只移除那一筆記錄。

如果你刪除網域後,又用同一個名稱重新新增,該網域收件者的退訂會再次生效。

誰可以變更

擁有者、管理員與行銷成員,以及具備完整權限的 API 金鑰,可以記錄退訂。只有擁有者與管理員可以撤回退訂。請見團隊角色。

限制在單一網域的 API 金鑰,只能管理該網域的退訂:其他網域會回傳 403 restricted_api_key。

從 CSV 匯入名單

要把另一家服務商的退訂名單帶過來,請在控制台打開聯絡人 → 退訂,選擇匯入 CSV。

email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
  • email 為必填。domain 為選填。標題列也是選填。
  • domain 是你的其中一個網域,會把退訂限制在它所寄的信件上。* 代表所有網域。空白的儲存格會使用你在對話框中選擇的預設網域。
  • 網域不明或位址無效的資料列會被略過。

對話框會顯示新增了多少筆退訂、有多少筆已經存在,以及資料列被略過的原因。同一個檔案匯入兩次也很安全。

事件

收件者退訂時會觸發 contact.unsubscribed,其中 source 為 hosted_page 或 one_click,並附上 domain_id 與 domain_name(團隊層級的退訂兩者都是 null)。撤回退訂會觸發 contact.resubscribed。請見 Webhook。

限制

Free Starter、Pro、Scale
退訂頁面外觀(標誌、顏色、字型、標誌圓角) 預設外觀 每個網域各自的外觀
自有退訂子網域 否(共用主機) 是
頁面上的「Powered by BillionSend」 顯示 隱藏

在 Free 上設定子網域會回傳 403 plan_limit_reached。你可以儲存頁面外觀,但在升級之前,收件者看到的仍是預設外觀。降級後,已儲存的外觀會保留,升級後再次生效,已設定的子網域也會繼續運作。

这个页面有帮助吗?