創建偏好中心
帖子
/ preference_center / v1
使用這個端點創建允許用戶偏好中心管理通知偏好電子郵件活動。
看看創建一個中心通過API的偏好有關如何在你的電子郵件包含這個活動。
速率限製
這個端點的速率限製每分鍾10請求,每個工作區。
請求體
1 2
內容類型:application / json授權:無記名YOUR-REST-API-KEY
1 2 3 4 5 6 7 8 9 10
{“名稱”:“字符串”,“preference_center_title”:“字符串”,“preference_center_page_html”:“字符串”,“confirmation_page_html”:“字符串”,“狀態”:(可選)選擇“活躍”或“草案”。違約來“活躍”如果不指定的,“選項”:{“meta-viewport-content”:“字符串”,(可選)隻有的“內容”價值的的元標簽}}
請求參數
| 參數 | 要求 | 數據類型 | 描述 |
|---|---|---|---|
的名字 |
要求 | 字符串 | 偏好中心的名稱符合下列要求: ——隻包含字母、數字、連字符和下劃線 ——沒有空間 |
preference_center_title |
可選 | 字符串 | 偏好中心和確認頁麵的標題。如果沒有指定一個標題,標題的頁麵將默認為“中心”的偏好。 |
preference_center_page_html |
要求 | 字符串 | 偏好中心的HTML頁麵。 |
confirmation_page_html |
要求 | 字符串 | 確認頁麵的HTML。 |
狀態 |
可選 | 字符串 | 選擇活躍的或草案。默認為活躍的如果沒有指定。 |
選項 |
可選 | 對象 | 屬性:meta-viewport-content。當禮物,視窗meta標簽將被添加到頁麵內容= <屬性值>。 |
注意:
偏好中心名稱不能被編輯。
液體的標簽
參考下麵的液體標簽可以包含在HTML生成用戶的訂閱狀態偏好中心頁麵。
用戶訂閱狀態
| 液體 | 描述 |
|---|---|
{{subscribed_state。$ {email_global}}} |
得到全球電子郵件訂閱用戶(即狀態。“opted_in”、“訂閱”或“沒訂閱”。 |
{{subscribed_state。$ {< subscription_group_id >}}} |
得到的訂閱狀態指定訂閱用戶(即組。、“訂閱”或“unsubscribed”)。 |
表單輸入和行動
| 液體 | 描述 |
|---|---|
{% form_field_name: email_global_state %} |
表明一個特定的表單輸入元素對應於用戶的全球電子郵件訂閱狀態。用戶的選擇狀態應該“opted_in”、“訂閱”,或“unsubscribed”提交表單時選擇數據為全球電子郵件訂閱狀態。如果它是一個複選框,用戶要麼是“opted_in”或“沒訂閱”。隱藏輸入,“訂閱”狀態也會有效。 |
{% form_field_name: subscription_group < subscription_group_id > %} |
表明一個特定的表單輸入元素對應於給定訂閱組。用戶的選擇狀態應該是“訂閱”或“unsubscribed”提交表單時選擇數據為一個特定的訂閱組。 |
{{preference_center_submit_url}} |
為表單提交生成URL。 |
示例響應
1 2 3 4 5 6
{“preference_center_api_id”:“preference_center_api_id_example”、“liquid_tag”:“{{preference_center。$ {MyPreferenceCenter2022-09-22}}}”、“created_at”:“2022 - 09 - 22 - t18:28:07 + 00:00”、“消息”:“成功”}
編輯這個頁麵在GitHub上