Mailchimp事件轉送擴充功能概觀

注意

Adobe Experience Platform Launch已經過品牌重塑，現在是Adobe Experience Platform中的一套資料收集技術。因此，所有產品文件中出現了幾項術語變更。如需術語變更的彙整參考資料，請參閱以下文件。

Mailchimp 事件轉送擴充功能會將事件傳送至Mailchimp Marketing API，而該API可觸發Mailchimp行銷活動、歷程或交易的電子郵件。

本文介紹如何使用「新增事件」動作來設定擴充功能及設定規則。

先決條件

本檔案假設您熟悉擴充功能所使用的相關Mailchimp產品。如需詳細資訊，請參閱Mailchimp說明檔案行銷活動，歷程、和交易.

使用此擴充功能需要Mailchimp帳戶。您可以註冊帳戶此處. 在Mailchimp帳戶儀表板中，記下以下值以用於本指南：

您的Mailchimp網域前置詞
您的API金鑰
對象ID
預設的「寄件者」電子郵件地址

根據您的Mailchimp帳戶計畫，您對Mailchimp客戶歷程工具的存取權可能會受到限制。

秘訣

如果您使用Mailchimp自動化，例如交易電子郵件或客戶歷程，步驟和畫面可能會稍有不同，此處列出。不過，使用此擴充功能仍需上述相同資訊。請參閱 Mailchimp說明中心以取得您特定帳戶與計畫的每個值的詳細資訊。

網域前置詞

登入Mailchimp並登入控制面板檢視後，瀏覽器的位址列應會顯示URL，例如 https://us11.admin.mailchimp.com 或只是 us11.admin.mailchimp.com. 在此範例中，前置詞 us11 只是預留位置，您的值將會不同。將您的URL和前置詞記錄下來，以供稍後步驟使用。

API金鑰

若要尋找您帳戶的API金鑰，請在Mailchimp UI中選取您的設定檔圖示，然後選取 設定檔. 您應會看到URL，例如 https://us11.admin.mailchimp.com/account/profile/ 但使用您的首碼而非 us11.

選取 額外專案，則 API金鑰：

下 您的API金鑰，您可以選擇現有金鑰，或選取 建立金鑰 以建立新檔案。您可以建立新金鑰以專門用於此擴充功能。複製API金鑰並儲存以供稍後步驟使用。如需詳細資訊，請參閱Mailchimp檔案以瞭解如何產生您的API金鑰.

對象ID和寄件者地址

選取對象在左側導覽中，然後 受眾控制面板. 接著，選取您要搭配此擴充功能使用的對象。若要深入瞭解，請參閱Mailchimp檔案，網址為建立對象.

建立並選取您的對象後，選取 管理對象 下拉式清單並選擇設定. 此畫面會顯示您對象的各種設定。

在「設定」畫面底部，您應該會看到 Unique id for audience [audience name] 位置 [audience name] 是您實際對象的名稱。複製對象ID並儲存以供稍後步驟使用。

選取 對象名稱和預設值 並確認 預設寄件者電子郵件地址 具有行銷活動的正確值。請注意，此頁面頂端也會列出Audience ID，與您在上一步中向下複製的值相同。

Mailchimp自動化

根據您的Mailchimp計畫以及您使用交易式電子郵件、客戶歷程或其他Mailchimp自動化，您的特定歷程設定可能會有所不同。

重要

您選擇用來在Mailchimp中觸發自動化或歷程的事件名稱，與您必須使用此擴充功能傳送的事件名稱相同。記下Mailchimp自動化中的事件名稱，並將其儲存以供稍後步驟使用。

安裝和設定

本節列出安裝及設定擴充功能的步驟。若要安全地儲存Mailchimp API金鑰，您必須使用事件轉送秘密.

建立密碼和資料元素

在事件轉送屬性中，建立 Token 密碼已呼叫 Mailchimp API Key.

下一個，建立資料元素使用核心擴充功能和密碼資料元素型別以參照 Mailchimp API Key 您剛才建立的密碼。輸入 Mailchimp Token 做為資料元素名稱。

安裝並設定擴充功能

在相同的事件轉送屬性中，選取 擴充功能， 則目錄以顯示可供安裝的擴充功能。從這裡，搜尋Mailchimp擴充功能並選取安裝.

安裝Mailchimp擴充功能

設定畫面隨即顯示。下 Mailchimp伺服器首碼網域名稱，請輸入您先前從Mailchimp帳戶複製的網域，包括唯一的網域首碼。

重要

不包括 http:// 或 https:// 在此欄位中。

擴充功能組態

下 Mailchimp權杖，選取資料元素圖示，然後選擇 Mailchimp Token 您先前建立的資料元素。選取儲存以儲存變更。

擴充功能現已安裝並設定為可在您的屬性中使用。

資料收藏集

在中使用此擴充功能時規則，擴充功能會隨著每個事件傳送數個資料值至Mailchimp。對於一般實作，您可以設定 Adobe Experience Platform Web SDK擴充功能以傳送該資料至 Platform Edge Network 供擴充功能在事件轉送屬性中使用。

此擴充功能所需的資料可以作為XDM資料或非XDM資料從Web SDK傳送。請參閱檔案以深入瞭解傳送XDM資料.

例如，如果客戶購買產品，或在您的網站上註冊了事件，您可以使用此擴充功能透過Mailchimp傳送確認電子郵件。從Web SDK傳送所需資訊至Edge Network後，擴充功能會透過Mailchimp觸發電子郵件。

新增事件動作設定

資料元素

上一節中的熒幕擷圖顯示您可以與此擴充功能中每個事件一起傳送至Mailchimp的資料。設定Web SDK以將此資料傳送至Edge Network後，您可以在事件轉送屬性中建立資料元素，讓擴充功能可存取這些值。

下表提供每個可能值的詳細資訊。

名稱	範例路徑	類型	說明	必填	限制
`email`	`arc.event.xdm._tenant.emailId` 或 `arc.event.data._tenant.emailId`	字串	接收電子郵件的地址	是	必須存在於Mailchimp對象中
`listId`	`arc.event.xdm._tenant.listId` 或 `arc.event.data._tenant.listid`	字串	對象ID	是	必須符合現有的對象ID
`name`	`arc.event.xdm._tenant.name` 或 `arc.event.data._tenant.name`	字串	事件名稱	是	2-30個字元長
`properties`	`arc.event.xdm._tenant.properties` 或 `arc.event.data._tenant.properties`	物件	JSON格式的可選屬性清單，包含有關事件的詳細資訊	無
`isSyncing`	`arc.event.xdm._tenant.isSyncing` 或 `arc.event.data._tenant.isSyncing`	布林值	建立事件 `is_syncing` 設定為 `true` 不會觸發自動化	無
`occurredAt`	`arc.event.xdm._tenant.occuredAt` 或 `arc.event.data._tenant.occuredAt`	字串	事件發生時的ISO 8601時間戳記	無

重要

此 範例路徑 上述值僅為範例。欄位名稱和路徑這些資料元素中參照的元素在屬性中可能會有所不同，具體取決於您在上述步驟中命名和設定Web SDK的方式。

在事件轉送屬性中，您可以為上述每個欄位建立資料元素。建立後，您可以參照新增事件此擴充功能的動作。

新增事件動作設定

您現在可以使用此擴充功能和「新增事件」動作，為您的對象觸發Mailchimp電子郵件。

資料驗證

使用事件轉送擴充功能時， Adobe Experience Platform Debugger 非常有用。在「記錄」區段的「邊緣記錄」下方，您可以檢視事件轉送規則觸發後所提出的請求。下列熒幕擷取畫面顯示擴充功能向Mailchimp API提出的請求。

Adobe Experience Platform Debugger

在Mailchimp控制面板中，您的「對象」或「對象成員」的「活動摘要」檢視上，會提供該「對象」或「對象成員」的事件清單。這應該會比對擴充功能傳送的事件，並顯示任何傳送的可選資料，以及他們收到的電子郵件或促銷活動。請參閱 Mailchimp自動化說明指南以取得更多詳細資料。

Mailchimp事件轉送擴充功能概觀