Mailchimp Interest Categories 連線

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
目標

建立對象：

管理員
使用者

Mailchimp是熱門的行銷自動化平台和電子郵件行銷服務，企業使用郵寄清單和電子郵件行銷活動，管理與連絡人 （客戶、客戶或其他感興趣的當事方） 的交談。可使用此連接器根據聯絡人的興趣和偏好將他們排序。

Mailchimp Interest Categories使用對象、群組和興趣類別（也稱為群組名稱或群組標題）。每個Mailchimp群組都是興趣類別的清單。聯絡人透過您網站上的登錄檔單訂閱一或多個興趣類別時，就會與興趣類別相關聯。在對象中，您還可以將聯絡人組織成群組，並將其與興趣類別建立關聯，然後可以使用這些群組來建立區段。您可以使用這些受眾將目標行銷活動電子郵件廣播給訂閱的聯絡人。

此Adobe Experience Platform 目的地使用Mailchimp batch subscribe or unsubscribe API API來建立興趣類別，然後將每個選定Experience Platform對象的連絡人新增至對應的興趣類別。您可以 新增連絡人 或更新現有Mailchimp連絡人的資訊，然後在新的區段中啟用這些連絡人後，在現有 對象中 新增或移除他們想要的群組Mailchimp。 Mailchimp Interest Groups使用從Experience Platform選取的對象名稱做為Mailchimp內的興趣類別。

使用案例 use-cases

為協助您更清楚瞭解您應如何及何時使用Mailchimp Interest Categories目的地，以下是Adobe Experience Platform客戶可藉由使用此目的地解決的範例使用案例。

傳送電子郵件給行銷活動的連絡人 use-case-send-emails

一家體育用品網站的銷售部門想要廣播電子郵件行銷活動，給已自我認定對足球感興趣的聯絡人清單。聯絡人清單在從網站開發團隊收到的資料匯出中被分離為批次，因此需要被追蹤。團隊會識別現有Mailchimp對象，並開始建立每個清單中的聯絡人加入的Experience Platform對象。將這些對象傳送至Mailchimp Interest Categories後，如果所選Mailchimp對象中不存在任何連絡人，則會將其新增至具有連絡人所屬對象名稱的群組。如果Mailchimp對象或群組中已有任何連絡人，則會更新其資訊。資料傳送至Mailchimp Interest Categories後，銷售團隊可以選取行銷活動電子郵件，並傳送給Mailchimp對象中的足球興趣群組。

先決條件 prerequisites

請參閱以下各節，瞭解您需要在Experience Platform和Mailchimp中設定的任何先決條件，以及使用Mailchimp Interest Categories目的地之前必須收集的資訊。

Experience Platform的必要條件 prerequisites-in-experience-platform

在啟用資料到Mailchimp Interest Categories目的地之前，您必須在中建立結構描述、資料集和區段Experience Platform。

Mailchimp Interest Categories目的地的先決條件 prerequisites-destination

若要將資料從Experience Platform匯出至您的Mailchimp帳戶，請注意下列必要條件：

您必須擁有Mailchimp帳戶 prerequisites-account

建立Mailchimp Interest Categories目的地之前，您必須先確定您有Mailchimp帳戶。如果您還沒有帳戶，請造訪Mailchimp 註冊頁面來註冊並建立您的帳戶。

收集Mailchimp API金鑰 gather-credentials

您需要您的Mailchimp API金鑰，以針對您的Mailchimp Interest Categories帳戶驗證Mailchimp目的地。當您 驗證目的地 時，API金鑰將用作密碼。

如果您沒有API金鑰，請登入您的帳戶並參閱Mailchimp 產生您的API金鑰檔案以建立金鑰。

API金鑰的範例為0123456789abcdef0123456789abcde-us14。

IMPORTANT

如果您產生API金鑰，請將其記下，因為您無法在產生後存取它。

識別Mailchimp資料中心 identify-data-center

接下來，您必須識別您的Mailchimp資料中心。若要這麼做，請登入您的Mailchimp帳戶，並導覽至您帳戶的API金鑰區段。

值是您在瀏覽器中看到的URL的第一部分。如果URL是https://us14.mailchimp.com/account/api/，則資料中心是us14。

它還以 key-dc 的格式附加至您的API金鑰；如果您的API金鑰是0123456789abcdef0123456789abcde-us14，則資料中心是us14。

寫下資料中心值（在此範例中為us14），當您填寫目的地詳細資料時，需要此值。

若您需要進一步的指引，請參閱Mailchimp 基礎檔案。

護欄 guardrails

您的Mailchimp個對象中，每個對象都可以在單一群組或相同對象內數個群組間包含最多60個群組名稱（或興趣類別）。如需任何必要的說明，請參考Mailchimp 群組。當您達到此限制時，您會從400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories) API收到錯誤回應形式的Mailchimp訊息。

此外，請參閱Mailchimp 速率限制，以取得有關Mailchimp API所設限制的詳細資訊。

支援的身分 supported-identities

Mailchimp支援下表所述的身分啟用。深入瞭解身分。

目標身分

說明

考量事項

電子郵件

連絡人電子郵件地址

強制

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目

類型

附註

匯出類型

Profile-based

您正在匯出區段的所有成員，以及所需的結構描述欄位（例如：電子郵件地址、電話號碼、姓氏） （根據您的欄位對應）。
針對Experience Platform中每個選取的對象，相對應的Mailchimp Interest Categories區段狀態會從Experience Platform更新其對象狀態。

匯出頻率

Streaming

串流目的地是「一律開啟」的API型連線。當根據對象評估在Experience Platform中更新設定檔時，聯結器會將更新傳送至下游的目標平台。深入瞭解串流目的地。

連線到目標 connect

IMPORTANT

若要連線到目的地，您需要 View Destinations 和Manage Destinations 存取控制許可權。閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。在設定目標工作流程中，填寫以下兩個區段中列出的欄位。

在Destinations > Catalog內，搜尋Mailchimp Interest Categories。或者，您可以在 Email marketing 類別下找到它。

驗證目標 authenticate

若要驗證到目的地，請填寫以下必填欄位並選取Connect to destination。

欄位

說明

Username

您的Mailchimp Interest Categories使用者名稱。

Password

您的Mailchimp API金鑰已在收集 Mailchimp 認證區段中記下。
您的API金鑰採用{KEY}-{DC}的形式，其中{KEY}部分參考在Mailchimp API金鑰部分中記下的值，而{DC}部分參考Mailchimp 資料中心。
您可以提供{KEY}部分或整個表單。
例如，若您的API金鑰是
0123456789abcdef0123456789abcde-us14，
，您可以提供*0123456789abcdef0123456789abcde或0123456789abcdef0123456789abcde-us14*作為值。

Experience Platform UI熒幕擷圖顯示如何驗證。

如果提供的詳細資料有效，UI會顯示帶有綠色勾號的 Connected 狀態。然後您可以繼續下一步驟。

填寫目標詳細資料 destination-details

若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。

Experience Platform UI熒幕擷圖顯示目的地詳細資料。

欄位

說明

Name

您日後可辨識此目的地的名稱。

Description

可協助您日後識別此目的地的說明。

Data center

您的Mailchimp帳戶data center。如需任何指引，請參閱識別 Mailchimp 資料中心區段。

Audience Name (Please select Data center first)

選取您的 Data center 後，此下拉式清單會自動填入您Mailchimp帳戶中的對象名稱。選取您要以Experience Platform資料更新的對象。

Interest Category (Please select Data center and Audience Name first)

選取您的 Audience Name 後，此下拉式清單會自動填入您Mailchimp帳戶中的興趣群組類別名稱。選取您要以Experience Platform資料更新的類別名稱。

TIP

如果您在 Password 欄位中提供的API金鑰或 Data center 值不正確，UI會顯示Mailchimp API錯誤回應： No options are available. Please verify the values selected for the following dependent fields: dataCenter，如下所示。在此情況下，您無法從 Audience Name (Please select Data center first) 欄位中選取值。若要修正此錯誤，請提供正確的值。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。從清單中選取警報以訂閱接收有關資料流狀態的通知。如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊時，請選取Next。

啟動此目標的對象 activate

IMPORTANT

若要啟用資料，您需要View Destinations、Activate Destinations、View Profiles和View Segments 存取控制許可權。閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
若要匯出身分，您需要View Identity Graph 存取控制許可權。
{width="100" modal="regular"}

閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。

對應考量事項和範例 mapping-considerations-example

若要將對象資料從Adobe Experience Platform正確傳送至Mailchimp Interest Categories目的地，您必須完成欄位對應步驟。對應包括在Experience Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。

若要將您的XDM欄位正確對應到Mailchimp Interest Categories目的地欄位，請遵循下列步驟：

在 Mapping 步驟中，選取Add new mapping。您現在可以在畫面上看到新的對應列。
在 Select source field 視窗中，選擇 Select attributes 類別並選取XDM屬性，或選擇 Select identity namespace 並選取身分。

在 Select target field 視窗中，選擇 Select identity namespace 並選取身分，或選擇 Select attributes 類別並從Mailchimp API填入的屬性清單中選取。 您新增至所選Mailchimp對象的自訂屬性也可供選擇為目標欄位。

您的XDM設定檔結構描述與Mailchimp Interest Categories之間可用的對應如下：

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
來源欄位	目標欄位	附註
`IdentityMap: Email`	`Identity: email`	必要：是
`xdm: person.name.firstName`	`Attribute: FNAME`
`xdm: person.name.lastName`	`Attribute: LNAME`
`xdm: person.birthDayAndMonth`	`Attribute: BIRTHDAY`

此外，ADDRESS是特殊目標欄位，在您的merge field對象中稱為Mailchimp。 Mailchimp 檔案將必要的金鑰定義為addr1、city、state和zip，以及選用金鑰addr2和country。這些欄位的值必須是字串。如果存在任何ADDRESS欄位對應，目的地會將ADDRESS物件傳遞至Mailchimp API以進行更新。除了預設為ADDRESS的國家/地區外，任何未對應的NULL欄位的值預設為US。

ADDRESS欄位可用的對應如下：

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
來源欄位	目標欄位
`xdm: workAddress.street1`	`Attribute: ADDRESS.addr1`
`xdm: workAddress.street2`	`Attribute: ADDRESS.addr2`
`xdm: workAddress.city`	`Attribute: ADDRESS.city`
`xdm: workAddress.state`	`Attribute: ADDRESS.state`
`xdm: workAddress.postalCode`	`Attribute: ADDRESS.zip`
`xdm: workAddress.country`	`Attribute: ADDRESS.country`

例如，您想要以連絡人的現有位址列位country、addr1、city和state的值更新zip的值，例如132, My Street, Kingston、New York、New York和12401。若要更新country，您必須傳遞變更 （若有的話） 的現有值，以及國家/地區的新值。所以資料集中的值應該是132, My Street, Kingston、New York、New York、12401和US。若要重申，如果您只傳遞country而未提供addr1、city、state和zip的值，則會被NULL覆寫。

具有已完成對應的範例如下所示：
Experience Platform UI熒幕擷圖範例，顯示欄位對應。

當您完成提供目的地連線的對應時，請選取Next。

驗證資料匯出 exported-data

若要驗證您是否已正確設定目的地，請遵循下列步驟：

登入您的Mailchimp帳戶。然後，導覽至 Audience 頁面。接下來，展開 Manage Contacts 功能表並選取Groups。

顯示「對象」群組頁面的Mailchimp UI熒幕擷圖。

選取群組，並檢查選取的對象是否建立為類別，其對象名稱來自Experience Platform，且後面可能會跟著自動產生的尾碼。
- 此目的地會使用Mailchimp 新增興趣類別API，以選取的區段名稱來建立興趣類別。如果您建立新目的地並再次啟用相同的對象，Mailchimp會新增尾碼以區分現有區段和新區段。
群組中不存在其電子郵件的連絡人會新增至新建立的類別。
對於群組中已存在的連絡人，會更新屬性欄位資料，並將連絡人新增至新建立的類別。

顯示Audience群組類別的Mailchimp UI熒幕擷圖。

資料使用與控管 data-usage-governance

處理您的資料時，所有Adobe Experience Platform目的地都符合資料使用原則。如需Adobe Experience Platform如何強制資料控管的詳細資訊，請參閱資料控管概觀。

錯誤與疑難排解 errors-and-troubleshooting

如果Mailchimp API金鑰或資料中心值不正確，便發生錯誤 incorrect-credentials-error

如果您的Mailchimp API金鑰或資料中心值不正確，Experience Platform UI熒幕擷圖會顯示錯誤。

若要修正此錯誤並繼續進行下一個步驟，您必須提供正確的值。請參閱識別 Mailchimp 資料中心和
如果您需要指引，請收集 Mailchimp API金鑰區段。

如果超過Mailchimp群組名稱限制，就會發生錯誤 group-name-limits-error

建立目的地時，您可能會收到下列錯誤訊息： Cannot have more than 60 interests per list (Across all categories)或400 BAD_REQUEST。如護欄區段所述，當您在單一群組或跨相同對象限制內的數個群組超過60個群組名稱（或興趣類別）時，就會發生這種情況。若要修正此錯誤，請確定您在Mailchimp中未超過群組名稱限制。

Mailchimp狀態與錯誤碼

請參閱Mailchimp 錯誤頁面，以取得包含說明的狀態和錯誤碼完整清單。

其他資源 additional-resources

Mailchimp檔案中的其他實用資訊如下：

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6