Mailchimp Interest Categories個連線
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。
識別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更新其對象狀態。
連線到目標 connect
若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。
在 目的地 > 目錄 內，搜尋Mailchimp Interest Categories。 或者，您可以在 電子郵件行銷 類別下找到它。
驗證目標 authenticate
若要驗證到目的地，請填寫下列必填欄位，然後選取 連線到目的地。
您的API金鑰採用
{KEY}-{DC}的形式，其中{KEY}部分參考在Mailchimp API金鑰部分中記下的值，而{DC}部分參考Mailchimp 資料中心。您可以提供
{KEY}部分或整個表單。例如，若您的API金鑰是
0123456789abcdef0123456789abcde-us14，，您可以提供*
0123456789abcdef0123456789abcde或0123456789abcdef0123456789abcde-us14*作為值。
如果提供的詳細資料有效，UI會顯示帶有綠色勾號的 已連線 狀態。 然後您可以繼續下一步驟。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
data center。 如需任何指引，請參閱識別 Mailchimp 資料中心區段。No options are available. Please verify the values selected for the following dependent fields: dataCenter，如下所示。 在此情況下，您無法從 對象名稱（請先選取資料中心） 欄位中選取值。 若要修正此錯誤，請提供正確的值。啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後，請選取 下一步。
啟動此目標的對象 activate
閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。
對應考量事項和範例 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之間可用的對應如下：
| Source欄位 | 目標欄位 | 附註 |
| — | — | — |
|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.street1Attribute: ADDRESS.addr1xdm: workAddress.street2Attribute: ADDRESS.addr2xdm: workAddress.cityAttribute: ADDRESS.cityxdm: workAddress.stateAttribute: ADDRESS.statexdm: workAddress.postalCodeAttribute: ADDRESS.zipxdm: workAddress.countryAttribute: 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覆寫。具有已完成對應的範例如下所示：
當您完成提供目的地連線的對應時，請選取 下一步。
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地，請遵循下列步驟：
- 登入您的Mailchimp帳戶。 然後，導覽至 Audience 頁面。 接下來，展開 Manage Contacts 功能表並選取 Groups。
- 選取群組，並檢查選取的對象是否以來自平台的對象名稱建立為類別，且後面可能會接著自動產生的尾碼。
- 此目的地會使用Mailchimp 新增興趣類別API，以選取的區段名稱來建立興趣類別。 如果您建立新目的地並再次啟用相同的對象，Mailchimp會新增尾碼以區分現有區段和新區段。
- 群組中不存在其電子郵件的連絡人會新增至新建立的類別。
- 對於群組中已存在的連絡人，會更新屬性欄位資料，並將連絡人新增至新建立的類別。
資料使用與控管 data-usage-governance
處理您的資料時，所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊，請參閱資料控管概觀。
錯誤與疑難排解 errors-and-troubleshooting
如果Mailchimp API金鑰或資料中心值不正確，便發生錯誤 incorrect-credentials-error
如果您在 密碼 欄位中提供的API金鑰或 資料中心 值不正確，UI會顯示Mailchimp API錯誤回應： No options are available. Please verify the values selected for the following dependent fields: dataCenter，如下所示。 在此情況下，您無法從 對象名稱（請先選取資料中心） 欄位中選取值。
若要修正此錯誤並繼續進行下一個步驟，您必須提供正確的值。 請參閱識別 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檔案中的其他實用資訊如下：