Mailchimp Interest Categories個連線

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
目標

建立對象：

管理員
使用者

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

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

此Adobe Experience Platform 目的地使用Mailchimp batch subscribe or unsubscribe API API來建立興趣類別，然後將每個所選平台對象的連絡人新增至對應的興趣類別。您可以 新增連絡人 或 更新現有Mailchimp連絡人的資訊，然後在新的區段中啟用這些連絡人後，在現有Mailchimp對象中 新增或移除他們想要的群組。 Mailchimp Interest Groups使用從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

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

您必須擁有Mailchimp帳戶 prerequisites-account

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

收集Mailchimp API金鑰 gather-credentials

您需要您的Mailchimp API金鑰，以針對您的Mailchimp帳戶驗證Mailchimp Interest Categories目的地。當您驗證目的地時，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 群組。當您達到此限制時，您會從Mailchimp API收到錯誤回應形式的400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)訊息。

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

支援的身分 supported-identities

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

目標身分

說明

考量事項

電子郵件

連絡人電子郵件地址

強制

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

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

項目

類型

附註

匯出類型

以設定檔為基礎

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

匯出頻率

串流

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

連線到目標 connect

IMPORTANT

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

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

在 目的地 > 目錄內，搜尋Mailchimp Interest Categories。或者，您可以在 電子郵件行銷 類別下找到它。

驗證目標 authenticate

若要驗證到目的地，請填寫下列必填欄位，然後選取 連線到目的地。

欄位

說明

使用者名稱

您的Mailchimp Interest Categories使用者名稱。

密碼

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

平台UI熒幕擷圖顯示如何驗證。

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

填寫目標詳細資訊 destination-details

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

顯示目的地詳細資訊的平台UI熒幕擷取畫面。

欄位

說明

名稱

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

說明

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

資料中心

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

對象名稱（請先選取資料中心）

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

興趣類別（請先選取資料中心和對象名稱）

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

TIP

如果您在密碼欄位中提供的API金鑰或 資料中心 值不正確，UI會顯示Mailchimp API錯誤回應： No options are available. Please verify the values selected for the following dependent fields: dataCenter，如下所示。在此情況下，您無法從 對象名稱（請先選取資料中心） 欄位中選取值。若要修正此錯誤，請提供正確的值。

啟用警示 enable-alerts

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

當您完成提供目的地連線的詳細資訊後，請選取 下一步。

啟動此目標的對象 activate

IMPORTANT

若要啟用資料，您需要 檢視目的地、啟用目的地、檢視設定檔 和 檢視區段 存取控制許可權。閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
若要匯出身分，您需要 檢視身分圖表 存取控制許可權。

{width="100" modal="regular"}

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

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

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

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

在對應步驟中，選取 新增對應。您現在可以在畫面上看到新的對應列。
在 選取來源欄位 視窗中，選擇 選取屬性 類別並選取XDM屬性，或選擇 選取身分名稱空間 並選取身分。

在 選取目標欄位 視窗中，選擇 選取身分名稱空間 並選取身分，或選擇 選取屬性 類別，並從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是特殊目標欄位，在您的Mailchimp對象中稱為merge field。 Mailchimp 檔案將必要的金鑰定義為addr1、city、state和zip，以及選用金鑰addr2和country。這些欄位的值必須是字串。如果存在任何ADDRESS欄位對應，目的地會將ADDRESS物件傳遞至Mailchimp API以進行更新。除了預設為US的國家/地區外，任何未對應的ADDRESS欄位的值預設為NULL。

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`

例如，您想要以連絡人的現有位址列位addr1、city、state和zip的值更新country的值，例如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覆寫。

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

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

驗證資料匯出 exported-data

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

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

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

選取群組，並檢查選取的對象是否以來自平台的對象名稱建立為類別，且後面可能會接著自動產生的尾碼。
- 此目的地會使用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金鑰或資料中心值不正確，則平台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