共用方式為


郵件黑猩猩

MailChimp 是一項 SaaS 服務,允許企業管理和自動化電子郵件行銷活動,包括發送行銷電子郵件、自動訊息和有針對性的活動。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://mailchimp.com/
隱私策略 https://mailchimp.com/legal/privacy/

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

傳送行銷活動 (預覽版)

傳送現有廣告活動

列出行銷活動

此作業會擷取帳戶中的行銷活動清單

取得所有清單

尋找目前使用者的所有清單

將成員新增至清單

新增或更新清單成員

從清單中移除成員

從清單中刪除成員。

新戰役 [已棄用]

此動作已被取代。 請改用新活動 (V2)。

根據行銷活動型別、收件者清單和行銷活動設定(主旨行、標題、from_name和reply_to)建立新的行銷活動

新戰役 (V2)

根據 行銷活動型別、收件者清單和行銷活動設定 (主旨行、標題、from_name和reply_to) (V2) 建立新的行銷活動。

新清單

在您的 MailChimp 帳戶中建立新清單

更新會員信息

更新特定清單成員的資訊。

訂閱或取消訂閱清單成員

批次訂閱或取消訂閱清單成員。

顯示清單成員

顯示清單的所有成員

傳送行銷活動 (預覽版)

傳送現有廣告活動

參數

名稱 機碼 必要 類型 Description
活動
campaign_id True string

清單的唯一識別碼

列出行銷活動

此作業會擷取帳戶中的行銷活動清單

傳回

名稱 路徑 類型 Description
Campaigns
campaigns array of CampaignResponseModel

物件陣列,每個物件代表一個行銷活動

取得所有清單

尋找目前使用者的所有清單

參數

名稱 機碼 必要 類型 Description
最大結果
count integer

要傳回的記錄數目。 預設值為 10。 最大值為 1000

Offset
offset integer

集合中要略過的記錄數。 預設值為 0。

傳回

取得清單時的回應

將成員新增至清單

新增或更新清單成員

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

電子郵件類型
email_type string

此成員要求接收的電子郵件類型('html' 或 'text')

地位
status True string

訂閱者的當前狀態。 可能的值:subscribed、unsubscribed、cleaned、pending

名字
FNAME string

訂閱者的名字

姓氏
LNAME string

訂閱者的姓氏

語言
language string

如果設定/偵測到,訂閱者的語言

VIP
vip boolean

訂閱者的 VIP 狀態

緯度
latitude float

位置緯度

經度
longitude float

位置經度

電子郵件地址
email_address True string

訂閱者的電子郵件地址

傳回

成員結果模型

從清單中移除成員

從清單中刪除成員。

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

會員電子郵件
member_email True string

要刪除的成員的電子郵件地址

新戰役 [已棄用]

此動作已被取代。 請改用新活動 (V2)。

根據行銷活動型別、收件者清單和行銷活動設定(主旨行、標題、from_name和reply_to)建立新的行銷活動

參數

名稱 機碼 必要 類型 Description
行銷活動類型
type True string

您可以在 MailChimp 中創建四種類型的活動。 A/B 分割行銷活動已被取代,應改用可變式行銷活動。 可能的值:regular、plaintext、absplit、rss、variate

清單識別碼
list_id True string

唯一清單識別碼

已儲存的區段ID
saved_segment_id integer

現有已儲存區段的ID

比賽類型
match string

區段比對型別:可能的值:any、all

活動主旨行
subject_line True string

廣告活動的主旨行

Title
title string

活動名稱

寄件者名稱
from_name True string

行銷活動上的「寄件者」名稱(不是電子郵件地址)

回覆地址
reply_to True string

行銷活動的回覆電子郵件地址

交談
use_conversation boolean

使用 MailChimp 對話功能管理外出回覆

命名
to_name string

廣告活動的自訂「收件者」名稱。 通常,名字合併欄位

資料夾 ID
folder_id integer

如果行銷活動列在資料夾中,則該資料夾的ID

Authentication
authenticate boolean

MailChimp 是否驗證了活動。 預設為 true

自動頁腳
auto_footer boolean

自動將 MailChimp 的預設頁尾附加到行銷活動

內嵌 CSS
inline_css boolean

自動內嵌行銷活動內容中包含的CSS

自動推文
auto_tweet boolean

在發送活動時自動發布指向活動存檔頁面的鏈接

自動發佈到 Facebook
auto_fb_post array of integer

要自動發佈到的 Facebook 頁面 ID 陣列

臉書評論
fb_comments boolean

允許Facebook對行銷活動發表評論(也強制啟用行銷活動封存工具列)。 預設為 true

獲勝標準
winner_criteria string

性能最好的組合。 這可能會根據點擊率、開啟率或總收益自動決定,也可以根據您認為最有價值的報表資料手動選擇。 對於多變數行銷活動測試send_time,會忽略winner_critera。 對於以「手動」為winner_citeria的多變量行銷活動,必須在 MailChimp Web 應用程式中選擇獲勝者

等待時間
wait_time integer

選擇獲勝行銷活動之前的等待分鐘數。 wait_time 的值必須大於 0,且以整小時為單位,以分鐘為單位指定

測試規模
test_size integer

要傳送測試組合的收件者百分比必須是介於10到100之間的值

主旨行
subject_lines array of string

可能要測試的主旨行。 如果未提供主旨行,則會使用settings.subject_line

發送時間
send_times array of string

可能的傳送測試時間。 提供的時間應採用 YYYY-MM-DD HH:MM:SS 格式。 如果提供send_times進行測試,則test_size將設定為 100%,並忽略winner_criteria

從名稱
from_names array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

回覆地址
reply_to_addresses array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

開啟次數
opens boolean

是否追蹤開局。 預設設置為 true。 無法針對變數行銷活動設定為false

HTML 點擊追蹤
html_clicks boolean

是否要追蹤行銷活動HTML版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

Plain-Text 點擊追蹤
text_clicks boolean

是否要追蹤行銷活動純文字版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

MailChimp 目標追蹤
goal_tracking boolean

是否啟用目標追蹤

eCommerce360 追蹤
ecomm360 boolean

是否啟用eCommerce360追蹤

Google Analytics 追蹤
google_analytics string

Google Analytics (分析) 追蹤的自訂 slug (最多 50 個位元組)

ClickTale 分析跟踪
clicktale string

ClickTale 追蹤的自訂 slug (最多 50 個位元組)

Salesforce 行銷活動
campaign boolean

在已連結的 Salesforce 帳戶中建立行銷活動

Salesforce 附註
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

高層運動
campaign boolean

在已連結的 Highrise 帳戶中建立行銷活動

高層筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

膠囊筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

供稿 URL
feed_url string

RSS 摘要的 URL

頻率
frequency string

RSS 活動的頻率

限制 RSS 影像
constrain_rss_img string

是否要將CSS新增至RSS摘要中的影像,以限制其在行銷活動中的寬度

發送時間
hour integer

以當地時間傳送行銷活動的小時。 可接受的時間為 0-23。 舉例來說,「4」會是您帳戶預設時區的凌晨 4 點

星期日
sunday boolean

在周日發送每日 RSS 活動

星期一
monday boolean

每週一發送每日 RSS 活動

星期二
tuesday boolean

每週二發送每日 RSS 活動

星期三
wednesday boolean

每週三發送每日 RSS 活動

星期四
thursday boolean

每週四發送每日 RSS 活動

星期五
friday boolean

每週五發送每日 RSS 活動

星期六
saturday boolean

週六發送每日 RSS 活動

每週寄件日
weekly_send_day string

每週發送 RSS 活動的星期幾

每月寄出日
monthly_send_date float

每月發送每月 RSS 活動的日期。 可接受的天數是 1-32,其中“0”始終是一個月的最後一天。 少於所選天數的月份,當天將不會傳送 RSS 行銷活動。 例如,設定在 30 日發送的 RSS 活動將在 2 月不會發出

圖像網址
image_url string

卡片標頭影像的網址

活動說明
description string

要顯示的行銷活動的簡短摘要

Title
title string

卡片的標題。 通常是行銷活動的主旨行

傳回

新的行銷活動結果模型

新戰役 (V2)

根據 行銷活動型別、收件者清單和行銷活動設定 (主旨行、標題、from_name和reply_to) (V2) 建立新的行銷活動。

參數

名稱 機碼 必要 類型 Description
行銷活動類型
type True string

您可以在 MailChimp 中創建四種類型的活動。 A/B 分割行銷活動已被取代,應改用可變式行銷活動。 可能的值:regular、plaintext、absplit、rss、variate

清單識別碼
list_id True string

唯一清單識別碼

已儲存的區段ID
saved_segment_id integer

現有已儲存區段的ID

比賽類型
match string

區段比對型別:可能的值:any、all

活動主旨行
subject_line True string

廣告活動的主旨行

Title
title string

活動名稱

寄件者名稱
from_name True string

行銷活動上的「寄件者」名稱(不是電子郵件地址)

回覆地址
reply_to True string

行銷活動的回覆電子郵件地址

交談
use_conversation boolean

使用 MailChimp 對話功能管理外出回覆

命名
to_name string

廣告活動的自訂「收件者」名稱。 通常,名字合併欄位

資料夾 ID
folder_id string

如果行銷活動列在資料夾中,則該資料夾的ID

Authentication
authenticate boolean

MailChimp 是否驗證了活動。 預設為 true

自動頁腳
auto_footer boolean

自動將 MailChimp 的預設頁尾附加到行銷活動

內嵌 CSS
inline_css boolean

自動內嵌行銷活動內容中包含的CSS

自動推文
auto_tweet boolean

在發送活動時自動發布指向活動存檔頁面的鏈接

自動發佈到 Facebook
auto_fb_post array of integer

要自動發佈到的 Facebook 頁面 ID 陣列

臉書評論
fb_comments boolean

允許Facebook對行銷活動發表評論(也強制啟用行銷活動封存工具列)。 預設為 true

獲勝標準
winner_criteria string

性能最好的組合。 這可能會根據點擊率、開啟率或總收益自動決定,也可以根據您認為最有價值的報表資料手動選擇。 對於多變數行銷活動測試send_time,會忽略winner_critera。 對於以「手動」為winner_citeria的多變量行銷活動,必須在 MailChimp Web 應用程式中選擇獲勝者

等待時間
wait_time integer

選擇獲勝行銷活動之前的等待分鐘數。 wait_time 的值必須大於 0,且以整小時為單位,以分鐘為單位指定

測試規模
test_size integer

要傳送測試組合的收件者百分比必須是介於10到100之間的值

主旨行
subject_lines array of string

可能要測試的主旨行。 如果未提供主旨行,則會使用settings.subject_line

發送時間
send_times array of string

可能的傳送測試時間。 提供的時間應採用 YYYY-MM-DD HH:MM:SS 格式。 如果提供send_times進行測試,則test_size將設定為 100%,並忽略winner_criteria

從名稱
from_names array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

回覆地址
reply_to_addresses array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

開啟次數
opens boolean

是否追蹤開局。 預設設置為 true。 無法針對變數行銷活動設定為false

HTML 點擊追蹤
html_clicks boolean

是否要追蹤行銷活動HTML版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

Plain-Text 點擊追蹤
text_clicks boolean

是否要追蹤行銷活動純文字版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

MailChimp 目標追蹤
goal_tracking boolean

是否啟用目標追蹤

eCommerce360 追蹤
ecomm360 boolean

是否啟用eCommerce360追蹤

Google Analytics 追蹤
google_analytics string

Google Analytics (分析) 追蹤的自訂 slug (最多 50 個位元組)

ClickTale 分析跟踪
clicktale string

ClickTale 追蹤的自訂 slug (最多 50 個位元組)

Salesforce 行銷活動
campaign boolean

在已連結的 Salesforce 帳戶中建立行銷活動

Salesforce 附註
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

高層運動
campaign boolean

在已連結的 Highrise 帳戶中建立行銷活動

高層筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

膠囊筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

供稿 URL
feed_url string

RSS 摘要的 URL

頻率
frequency string

RSS 活動的頻率

限制 RSS 影像
constrain_rss_img string

是否要將CSS新增至RSS摘要中的影像,以限制其在行銷活動中的寬度

發送時間
hour integer

以當地時間傳送行銷活動的小時。 可接受的時間為 0-23。 舉例來說,「4」會是您帳戶預設時區的凌晨 4 點

星期日
sunday boolean

在周日發送每日 RSS 活動

星期一
monday boolean

每週一發送每日 RSS 活動

星期二
tuesday boolean

每週二發送每日 RSS 活動

星期三
wednesday boolean

每週三發送每日 RSS 活動

星期四
thursday boolean

每週四發送每日 RSS 活動

星期五
friday boolean

每週五發送每日 RSS 活動

星期六
saturday boolean

週六發送每日 RSS 活動

每週寄件日
weekly_send_day string

每週發送 RSS 活動的星期幾

每月寄出日
monthly_send_date float

每月發送每月 RSS 活動的日期。 可接受的天數是 1-32,其中“0”始終是一個月的最後一天。 少於所選天數的月份,當天將不會傳送 RSS 行銷活動。 例如,設定在 30 日發送的 RSS 活動將在 2 月不會發出

圖像網址
image_url string

卡片標頭影像的網址

活動說明
description string

要顯示的行銷活動的簡短摘要

Title
title string

卡片的標題。 通常是行銷活動的主旨行

傳回

新的行銷活動結果模型

新清單

在您的 MailChimp 帳戶中建立新清單

參數

名稱 機碼 必要 類型 Description
清單名稱
name True string

清單的名稱

公司名稱
company True string

清單的公司名稱

地址行 1
address1 True string

清單連絡人的街道地址

地址行 2
address2 string

清單連絡人的街道地址

城市
city True string

名單聯絡城市

State
state True string

清單連絡人的狀態

郵遞區號
zip True string

清單聯絡人的郵遞區號或郵遞區號

國碼 (地區碼)
country True string

兩個字元的ISO3166國家/地區代碼。 如果無效,則預設為 US

電話號碼
phone True string

清單連絡人的電話號碼

權限提醒
permission_reminder True string

提醒人們如何註冊此列表的文本

使用存檔列
use_archive_bar boolean

此清單的行銷活動是否預設使用封存中的封存列

寄件人姓名
from_name True string

傳送至此清單之行銷活動的預設寄件者名稱

寄件人的電子郵件地址
from_email True string

傳送至此清單之行銷活動的預設寄件者電子郵件

主旨
subject True string

傳送至此清單之行銷活動的預設主旨行

語言
language True string

此清單表單的預設語言

訂閱時通知
notify_on_subscribe string

要傳送訂閱通知的電子郵件地址

取消訂閱時通知
notify_on_unsubscribe string

要傳送取消訂閱通知的電子郵件地址

允許使用者在 HTML 和純文字 (true/false) 之間進行選擇?
email_type_option True boolean

當設定為 true 時,訂閱者可以選擇要接收 HTML 或純文字電子郵件。 當設定為 false 時,訂閱者將收到 HTML 電子郵件,並附有純文字替代備份

可見度
visibility string

此清單是公開或私人

傳回

建立新的清單結果模型

更新會員信息

更新特定清單成員的資訊。

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

會員電子郵件
member_email True string

要更新的成員的唯一電子郵件地址

電子郵件類型
email_type string

此成員要求接收的電子郵件類型('html' 或 'text')

地位
status True string

訂閱者的當前狀態。 可能的值:subscribed、unsubscribed、cleaned、pending

名字
FNAME string

訂閱者的名字

姓氏
LNAME string

訂閱者的姓氏

語言
language string

如果設定/偵測到,訂閱者的語言

VIP
vip boolean

訂閱者的 VIP 狀態

緯度
latitude float

位置緯度

經度
longitude float

位置經度

傳回

成員結果模型

訂閱或取消訂閱清單成員

批次訂閱或取消訂閱清單成員。

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

略過合併驗證
skip_merge_validation boolean

允許在沒有合併欄位值的情況下接受成員資料

略過重複檢查
skip_duplicate_check boolean

忽略請求中傳送的重複項

電子郵件類型
email_type string

此成員要求接收的電子郵件類型('html' 或 'text')

地位
status True string

訂閱者的當前狀態。 可能的值:subscribed、unsubscribed、cleaned、pending

名字
FNAME string

訂閱者的名字

姓氏
LNAME string

訂閱者的姓氏

語言
language string

如果設定/偵測到,訂閱者的語言

VIP
vip boolean

訂閱者的 VIP 狀態

緯度
latitude float

位置緯度

經度
longitude float

位置經度

電子郵件地址
email_address True string

訂閱者的電子郵件地址

更新現有成員
update_existing boolean

此批次操作是否會變更現有成員的訂閱狀態。

傳回

在批次中訂閱或取消訂閱清單成員時的回應

顯示清單成員

顯示清單的所有成員

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

最大結果
count integer

要傳回的記錄數目。 預設值為 10。 最大值為 1000

Offset
offset integer

集合中要略過的記錄數。 預設值為 0。

傳回

查詢清單中所有成員時的回應

觸發程序

建立新清單時

建立新清單時觸發工作流程

當成員已新增至清單時

當新成員新增至清單時觸發工作流程

建立新清單時

建立新清單時觸發工作流程

傳回

取得清單時的回應

當成員已新增至清單時

當新成員新增至清單時觸發工作流程

參數

名稱 機碼 必要 類型 Description
清單識別碼
list_id True string

清單的唯一識別碼

傳回

在清單中取得成員時的回應

定義

Recipient

行銷活動的設定

名稱 路徑 類型 Description
清單識別碼
list_id string

唯一清單識別碼

segment_opts
segment_opts Segment_Opts

代表所有分割選項的物件

Variate_Settings

行銷活動的設定

名稱 路徑 類型 Description
獲勝標準
winner_criteria string

性能最好的組合。 這可能會根據點擊率、開啟率或總收益自動決定,也可以根據您認為最有價值的報表資料手動選擇。 對於多變數行銷活動測試send_time,會忽略winner_critera。 對於以「手動」為winner_citeria的多變量行銷活動,必須在 MailChimp Web 應用程式中選擇獲勝者

等待時間
wait_time integer

選擇獲勝行銷活動之前的等待分鐘數。 wait_time 的值必須大於 0,且以整小時為單位,以分鐘為單位指定

測試規模
test_size integer

要傳送測試組合的收件者百分比必須是介於10到100之間的值

主旨行
subject_lines array of string

可能要測試的主旨行。 如果未提供主旨行,則會使用settings.subject_line

發送時間
send_times array of string

可能的傳送測試時間。 提供的時間應採用 YYYY-MM-DD HH:MM:SS 格式。 如果提供send_times進行測試,則test_size將設定為 100%,並忽略winner_criteria

從名稱
from_names array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

回覆地址
reply_to_addresses array of string

可能來自名稱。 提供的from_names數量必須與reply_to_addresses數量相符。 如果未提供from_names,則會使用settings.from_name

追蹤

行銷活動的設定

名稱 路徑 類型 Description
開啟次數
opens boolean

是否追蹤開局。 預設設置為 true。 無法針對變數行銷活動設定為false

HTML 點擊追蹤
html_clicks boolean

是否要追蹤行銷活動HTML版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

Plain-Text 點擊追蹤
text_clicks boolean

是否要追蹤行銷活動純文字版本中的點按次數。 預設設置為 true。 無法針對變數行銷活動設定為false

MailChimp 目標追蹤
goal_tracking boolean

是否啟用目標追蹤

eCommerce360 追蹤
ecomm360 boolean

是否啟用eCommerce360追蹤

Google Analytics 追蹤
google_analytics string

Google Analytics (分析) 追蹤的自訂 slug (最多 50 個位元組)

ClickTale 分析跟踪
clicktale string

ClickTale 追蹤的自訂 slug (最多 50 個位元組)

銷售人員
salesforce Salesforce

行銷活動的 Salesforce 追蹤選項。 必須使用 MailChimp 的內建 Salesforce 整合

高層建築
highrise Highrise

活動的高樓追蹤選項。 必須使用 MailChimp 的內置 Highrise 集成

膠囊
capsule Capsule

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

RSS_Opts

行銷活動的 RSS 選項

名稱 路徑 類型 Description
供稿 URL
feed_url string

RSS 摘要的 URL

頻率
frequency string

RSS 活動的頻率

限制 RSS 影像
constrain_rss_img string

是否要將CSS新增至RSS摘要中的影像,以限制其在行銷活動中的寬度

時間表
schedule Schedule

傳送 RSS 行銷活動的排程

Social_Card

行銷活動的設定

名稱 路徑 類型 Description
圖像網址
image_url string

卡片標頭影像的網址

活動說明
description string

要顯示的行銷活動的簡短摘要

Title
title string

卡片的標題。 通常是行銷活動的主旨行

Segment_Opts

代表所有分割選項的物件

名稱 路徑 類型 Description
已儲存的區段ID
saved_segment_id integer

現有已儲存區段的ID

比賽類型
match string

區段比對型別:可能的值:any、all

Salesforce

行銷活動的 Salesforce 追蹤選項。 必須使用 MailChimp 的內建 Salesforce 整合

名稱 路徑 類型 Description
Salesforce 行銷活動
campaign boolean

在已連結的 Salesforce 帳戶中建立行銷活動

Salesforce 附註
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

Highrise

活動的高樓追蹤選項。 必須使用 MailChimp 的內置 Highrise 集成

名稱 路徑 類型 Description
高層運動
campaign boolean

在已連結的 Highrise 帳戶中建立行銷活動

高層筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

膠囊

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

名稱 路徑 類型 Description
膠囊筆記
notes boolean

根據訂閱者電子郵件地址更新行銷活動的聯絡人備註

排程

傳送 RSS 行銷活動的排程

名稱 路徑 類型 Description
發送時間
hour integer

以當地時間傳送行銷活動的小時。 可接受的時間為 0-23。 舉例來說,「4」會是您帳戶預設時區的凌晨 4 點

daily_send
daily_send Daily_Send

一週中要傳送每日 RSS 行銷活動的日期。

每週寄件日
weekly_send_day string

每週發送 RSS 活動的星期幾

每月寄出日
monthly_send_date float

每月發送每月 RSS 活動的日期。 可接受的天數是 1-32,其中“0”始終是一個月的最後一天。 少於所選天數的月份,當天將不會傳送 RSS 行銷活動。 例如,設定在 30 日發送的 RSS 活動將在 2 月不會發出

Daily_Send

一週中要傳送每日 RSS 行銷活動的日期。

名稱 路徑 類型 Description
星期日
sunday boolean

在周日發送每日 RSS 活動

星期一
monday boolean

每週一發送每日 RSS 活動

星期二
tuesday boolean

每週二發送每日 RSS 活動

星期三
wednesday boolean

每週三發送每日 RSS 活動

星期四
thursday boolean

每週四發送每日 RSS 活動

星期五
friday boolean

每週五發送每日 RSS 活動

星期六
saturday boolean

週六發送每日 RSS 活動

CampaignResponse模型

新的行銷活動結果模型

名稱 路徑 類型 Description
行銷活動ID
id string

唯一識別此行銷活動的字串

行銷活動類型
type string

您可以在 MailChimp 中創建四種類型的活動。 A/B 分割行銷活動已被取代,應改用變數行銷活動

創建時間
create_time string

廣告活動的建立日期和時間

存檔網址
archive_url string

活動封存版本的連結

地位
status string

活動封存版本的連結

發送的電子郵件
emails_sent integer

針對此行銷活動傳送的電子郵件總數

發送時間
send_time string

行銷活動的傳送時間和日期

內容類型
content_type string

行銷活動內容的組合方式 ('template', 'drag_and_drop', 'html', 'url')

清單
recipient array of Recipient

行銷活動的清單設定

設定
settings SettingsV2

行銷活動的設定

variate_settings
variate_settings Variate_Settings

行銷活動的設定

追蹤
tracking Tracking

行銷活動的設定

rss_opts
rss_opts RSS_Opts

行銷活動的 RSS 選項

ab_split_opts
ab_split_opts AB_Split_Opts

行銷活動的A/B測試選項

social_card
social_card Social_Card

行銷活動的設定

report_summary
report_summary Report_Summary

對於已傳送的行銷活動,開啟、點按和取消訂閱的摘要

delivery_status
delivery_status Delivery_Status

傳送過程中的行銷活動更新

_links
_links array of Link

API 綱目文件的鏈結類型及說明清單

設定V2

行銷活動的設定

名稱 路徑 類型 Description
活動主旨行
subject_line string

廣告活動的主旨行

Title
title string

活動名稱

寄件者名稱
from_name string

行銷活動上的「寄件者」名稱(不是電子郵件地址)

回覆地址
reply_to string

行銷活動的回覆電子郵件地址

交談
use_conversation boolean

使用 MailChimp 對話功能管理外出回覆

命名
to_name string

廣告活動的自訂「收件者」名稱。 通常,名字合併欄位

資料夾 ID
folder_id string

如果行銷活動列在資料夾中,則該資料夾的ID

Authentication
authenticate boolean

MailChimp 是否驗證了活動。 預設為 true

自動頁腳
auto_footer boolean

自動將 MailChimp 的預設頁尾附加到行銷活動

內嵌 CSS
inline_css boolean

自動內嵌行銷活動內容中包含的CSS

自動推文
auto_tweet boolean

在發送活動時自動發布指向活動存檔頁面的鏈接

自動發佈到 Facebook
auto_fb_post array of integer

要自動發佈到的 Facebook 頁面 ID 陣列

臉書評論
fb_comments boolean

允許Facebook對行銷活動發表評論(也強制啟用行銷活動封存工具列)。 預設為 true

AB_Split_Opts

行銷活動的A/B測試選項

名稱 路徑 類型 Description
分割測試
split_test string

要執行的 AB 分割類型

選擇獲勝者
pick_winner string

我們應該如何評價獲勝者。 根據「開啟」、「點擊」或「手動」

等待時間
wait_units string

衡量獲勝者的時間單位(“小時”或“天”)。 傳送行銷活動後無法變更

等待時間
wait_time integer

選擇獲勝者之前的等待時間。 傳送行銷活動後無法變更

分割尺寸
split_size integer

分割群組的大小。 根據「排程」分割的行銷活動會強制進行 50/50 分割。 有效的分割整數介於 1-50 之間

從名稱組 A
from_name_a string

如果廣告活動以「寄件者名稱」分割,則 A 群組的名稱

來自名稱組 B
from_name_b string

如果廣告活動以「寄件者名稱」分割,則為 B 群組的名稱

回覆電子郵件群組 A
reply_email_a string

如果廣告活動以「寄件者名稱」分割,則群組 A 的回覆地址

回覆電子郵件群組 B
reply_email_b string

針對「寄件者名稱」分割的行銷活動,群組 B 的回覆地址

主旨行組 A
subject_a string

針對「主旨行」分割的行銷活動,則為 A 組的主旨行

主旨行 B 組
subject_b string

如果廣告活動按「主旨行」分割,則為 B 組的主旨行

傳送時間群組 A
send_time_a string

A組的傳送時間

傳送時間群組 B
send_time_b string

B組的傳送時間

發送時間獲勝者
send_time_winner string

獲勝版本的傳送時間

Report_Summary

對於已傳送的行銷活動,開啟、點按和取消訂閱的摘要

名稱 路徑 類型 Description
自動化開啟
opens integer

行銷活動的開啟總數

獨特開啟次數
unique_opens integer

唯一開啟次數

開啟率
open_rate float

不重複開啟次數除以成功傳遞的總數

點擊總數
clicks integer

行銷活動的點擊總數

不重複訂閱者點擊次數
subscriber_clicks float

不重複點擊次數

點擊「費率」
click_rate float

不重複點按次數除以成功傳遞總數

Delivery_Status

傳送過程中的行銷活動更新

名稱 路徑 類型 Description
已啟用 Delivery Staut
enabled boolean

是否已為此帳戶和行銷活動啟用行銷活動傳遞狀態

活動可取消
can_cancel boolean

是否可以取消行銷活動傳送

行銷活動傳遞狀態
status string

行銷活動傳遞的目前狀態

發送的電子郵件
emails_sent integer

到目前為止,已針對此行銷活動已確認傳送的電子郵件總數

已取消的電子郵件
emails_canceled integer

此行銷活動已取消的電子郵件總數

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

名稱 路徑 類型 Description
雷爾
rel string

與 HTML 'rel' 屬性一樣,這描述了連結的類型

赫雷夫
href string

此屬性包含完整 URL,可呼叫該 URL 來擷取連結的資源或執行連結的動作

方法
method string

存取 'href' 中定義的 URL 時應使用的 HTTP 方法。 (獲取、發布、放置、補丁、刪除、選項、頭)

目標結構描述
targetSchema string

對於 GET,這是代表回應應符合的結構描述的 URL

Schema
schema string

對於可以接收本文(POST 和 PUT)的 HTTP 方法,這是代表本文應符合的結構描述的 URL

連絡人​​

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

名稱 路徑 類型 Description
公司名稱
company string

清單的公司名稱

地址行 1
address1 string

清單連絡人的街道地址

地址行 2
address2 string

清單連絡人的街道地址

城市
city string

名單聯絡城市

State
state string

清單連絡人的狀態

郵遞區號
zip string

清單聯絡人的郵遞區號或郵遞區號

國碼 (地區碼)
country string

兩個字元的ISO3166國家/地區代碼。 如果無效,則預設為 US

電話號碼
phone string

清單連絡人的電話號碼

Campaign_Defaults

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

名稱 路徑 類型 Description
寄件人姓名
from_name string

傳送至此清單之行銷活動的預設寄件者名稱

寄件人的電子郵件地址
from_email string

傳送至此清單之行銷活動的預設寄件者電子郵件

主旨
subject string

傳送至此清單之行銷活動的預設主旨行

語言
language string

此清單表單的預設語言

CreateNewListResponseModel

建立新的清單結果模型

名稱 路徑 類型 Description
清單識別碼
id string

唯一識別此清單的字串

清單名稱
name string

清單的名稱

聯繫
contact Contact

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

權限提醒
permission_reminder string

清單的權限提醒

使用存檔列
use_archive_bar boolean

此清單的行銷活動是否預設使用封存中的封存列

campaign_defaults
campaign_defaults Campaign_Defaults

行銷活動的膠囊追蹤選項。 必須使用 MailChimp 的內建 Capsule 整合

訂閱時通知
notify_on_subscribe string

要傳送訂閱通知的電子郵件地址

取消訂閱時通知
notify_on_unsubscribe string

要傳送取消訂閱通知的電子郵件地址

建立日期
date_created string

建立此清單的日期和時間

列表評級
list_rating integer

清單的自動產生活動分數 (0-5)

電子郵件類型選項
email_type_option boolean

清單是否支援多種格式的電子郵件。當設定為 true 時,訂閱者可以選擇要接收 HTML 或純文字電子郵件。當設定為 false 時,訂閱者將收到 HTML 電子郵件,並附有純文字替代備份

訂閱網址短
subscribe_url_short string

我們的 EepURL 此列表訂閱表單的縮短版本

訂閱網址長
subscribe_url_long string

此列表訂閱表的完整版本(主持人會有所不同)

Beamer 地址
beamer_address string

清單的電子郵件 Beamer 位址

可見度
visibility string

此清單是公開或私人

模組
modules array of string

為此清單安裝的任何清單特定模組

統計數據
stats Stats

列表的統計數據。 其中許多會快取至少五分鐘

Links
_links array of Link

API 綱目文件的鏈結類型及說明清單

Stats

列表的統計數據。 其中許多會快取至少五分鐘

名稱 路徑 類型 Description
會員人數
member_count integer

清單中的作用中成員數目

取消訂閱計數
unsubscribe_count integer

已取消訂閱清單的成員人數

已清潔計數
cleaned_count integer

從清單中清除的成員數目

自發送以來的成員計數
member_count_since_send integer

自上次行銷活動傳送以來,清單中的作用中成員數目

自傳送以來的取消訂閱計數
unsubscribe_count_since_send integer

自上次活動發送以來取消訂閱的成員人數

自傳送以來已清除的計數
cleaned_count_since_send integer

自上次行銷活動傳送以來,從清單中清除的成員人數

活動計數
campaign_count integer

使用此清單的任何狀態的行銷活動數量

行銷活動上次傳送
campaign_last_sent date-time

最後一個行銷活動傳送至此清單的日期和時間

合併變量計數
merge_field_count integer

此清單的合併變數數目 (不是 EMAIL,這是必要的)

平均訂閱率
avg_sub_rate float

清單每月的平均訂閱數(如果尚未計算,則不會傳回)

平均退訂率
avg_unsub_rate float

清單每月平均取消訂閱次數(如果尚未計算,則不傳回)

目標訂閱費率
target_sub_rate float

清單每月的目標訂閱數量,以使其保持成長(如果我們尚未計算,則不會傳回)

開啟率
open_rate float

清單中每個行銷活動的平均開啟率(以 0 到 100 之間的數字表示的百分比)(如果我們尚未計算,則不會傳回)

點擊「費率」
click_rate float

清單中每個行銷活動的平均點擊率(以 0 到 100 之間的數字表示的百分比)(如果我們尚未計算,則不會傳回)

最後訂閱清單日期
last_sub_date string

上次有人訂閱此清單的日期和時間

最後取消訂閱列表的日期
last_unsub_date string

上次有人取消訂閱此清單的日期和時間

GetListsResponseModel

取得清單時的回應

名稱 路徑 類型 Description
Lists
lists array of CreateNewListResponseModel

物件陣列,每個物件代表一個清單

項目數量
total_items integer

不論分頁為何,符合查詢的項目總數

名字和姓氏

包含使用者名字和姓氏的合併欄位

名稱 路徑 類型 Description
名字
FNAME string

訂閱者的名字

姓氏
LNAME string

訂閱者的姓氏

地點

訂閱者位置資訊

名稱 路徑 類型 Description
緯度
latitude float

位置緯度

經度
longitude float

位置經度

成員回應模型

成員結果模型

名稱 路徑 類型 Description
電子郵件識別碼
id string

清單成員電子郵件地址小寫版本的 MD5 雜湊

電子郵件地址
email_address string

訂閱者的電子郵件地址

唯一電子郵件 ID
unique_email_id string

所有 MailChimp 地址的標識符

電子郵件類型
email_type string

該成員要求接收的電子郵件類型(“html”或“文本”)。

地位
status string

訂閱者的當前狀態。 可能的值:subscribed、unsubscribed、cleaned、pending

merge_fields
merge_fields FirstAndLastName

包含使用者名字和姓氏的合併欄位

統計數據
stats Stats

列表的統計數據。 其中許多會快取至少五分鐘

註冊 IP
ip_signup string

訂閱者註冊的 IP 位址

註冊時間戳記
timestamp_signup string

訂閱者註冊清單的日期和時間

選擇加入 IP
ip_opt string

訂閱者用來確認其選擇加入狀態的 IP 位址

選擇加入時間戳記
timestamp_opt string

訂閱者確認其選擇加入狀態的日期和時間

會員評分
member_rating integer

該會員的星級在 1 到 5 之間

最後更改日期
last_changed string

成員資訊上次變更的日期和時間

語言
language string

如果設定/偵測到,訂閱者的語言

VIP
vip boolean

訂閱者的 VIP 狀態

電子郵件用戶端
email_client string

清單成員的電子郵件用戶端

位置
location Location

訂閱者位置資訊

last_note
last_note Last_Note

最近添加的關於該成員的註釋

清單識別碼
list_id string

清單識別碼

Links
_links array of Link

API 綱目文件的鏈結類型及說明清單

Last_Note

最近添加的關於該成員的註釋

名稱 路徑 類型 Description
附註 ID
note_id integer

附註 ID

創建時間
created_at string

備註的建立日期

作者
created_by string

筆記的作者

備註
note string

筆記內容

GetAddMembersBatchResponseModel

在批次中訂閱或取消訂閱清單成員時的回應

名稱 路徑 類型 Description
創建總計
total_created integer

新增至清單的成員總數

更新總數
total_updated integer

訂閱狀態已更新的現有清單成員總數

錯誤計數
error_count integer

無法新增至清單或更新的電子郵件地址號碼

GetAllMembersResponseModel

查詢清單中所有成員時的回應

名稱 路徑 類型 Description
Members
members array of MemberResponseModel

物件陣列,每個物件代表特定的清單成員

清單識別碼
list_id string

清單識別碼

項目總數
total_items integer

不論分頁為何,符合查詢的項目總數

GetMembersResponseModel

在清單中取得成員時的回應

名稱 路徑 類型 Description
Members
members array of AddUserResponseModel

物件陣列,每個物件代表特定的清單成員

新增使用者回應模型

新的行銷活動結果模型

名稱 路徑 類型 Description
電子郵件識別碼
id string

清單成員電子郵件地址小寫版本的 MD5 雜湊

電子郵件地址
email_address string

訂閱者的電子郵件地址

唯一電子郵件 ID
unique_email_id string

所有 MailChimp 地址的標識符

電子郵件類型
email_type string

該成員要求接收的電子郵件類型(“html”或“文本”)。

地位
status string

訂閱者的當前狀態。 可能的值:subscribed、unsubscribed、cleaned、pending

merge_fields
merge_fields FirstAndLastName

包含使用者名字和姓氏的合併欄位

統計數據
stats Stats

列表的統計數據。 其中許多會快取至少五分鐘

註冊 IP
ip_signup string

訂閱者註冊的 IP 位址

註冊時間戳記
timestamp_signup string

訂閱者註冊清單的日期和時間

選擇加入 IP
ip_opt string

訂閱者用來確認其選擇加入狀態的 IP 位址

選擇加入時間戳記
timestamp_opt string

訂閱者確認其選擇加入狀態的日期和時間

會員評分
member_rating integer

該會員的星級在 1 到 5 之間

最後更改日期
last_changed string

成員資訊上次變更的日期和時間

語言
language string

如果設定/偵測到,訂閱者的語言

VIP
vip boolean

訂閱者的 VIP 狀態

電子郵件用戶端
email_client string

清單成員的電子郵件用戶端

位置
location Location

訂閱者位置資訊

last_note
last_note Last_Note

最近添加的關於該成員的註釋

清單識別碼
list_id string

清單識別碼

Links
_links array of Link

API 綱目文件的鏈結類型及說明清單