Mailchimp事件轉送擴充功能概觀

注意

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

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

本檔案說明如何使用「新增事件」動作來設定擴充功能和設定規則。

先決條件

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

使用此擴充功能需要Mailchimp帳戶。您可以註冊帳戶此處. 在Mailchimp帳戶控制面板中，記下下列值以供本指南使用：

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

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

秘訣

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

網域前置詞

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

API金鑰

若要尋找您的帳戶的API金鑰，請在Mailchimp UI中選取您的設定檔圖示，然後選取 設定檔. 您應該會看到 https://us11.admin.mailchimp.com/account/profile/ 但您的前置詞而非前置詞 us11.

選擇額外，然後 API金鑰:

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

對象ID和寄件者位址

選擇對象在左側導覽中，然後 對象儀表板. 接下來，選取您要與此擴充功能搭配使用的對象。若要進一步了解，請參閱建立對象.

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

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

選擇 對象名稱和預設值 並確認 預設寄件者電子郵件地址 對您的促銷活動有正確的值。請注意，「對象ID」也會列在此頁面頂端，與您在最後一個步驟中下復的值相同。

Mailchimp自動化

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

重要

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

安裝和設定

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

建立機密和資料元素

在事件轉送屬性中，建立代號秘密呼叫 Mailchimp API Key.

下一個，建立資料元素使用核心擴充功能與機密要參考的資料元素類型 Mailchimp API Key 你剛建立的秘密。輸入 Mailchimp Token 作為資料元素名稱。

安裝並設定擴充功能

在相同的事件轉送屬性中，選取 擴充功能, then 目錄顯示可安裝的擴充功能。在此搜尋Mailchimp擴充功能，然後選取安裝.

安裝Mailchimp擴充功能

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

重要

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

擴充功能組態

在 Mailchimp代號，請選取資料元素圖示，然後選取 Mailchimp Token 您先前建立的資料元素。選擇儲存以儲存變更。

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

資料收集

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

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

例如，如果客戶購買或註冊您網站上的事件，您可以透過此擴充功能的Mailchimp傳送確認電子郵件。一旦您將必要資訊從Web SDK傳送至邊緣網路，擴充功能就會使用Mailchimp觸發電子郵件。

新增事件動作設定

資料元素

上一節的螢幕擷圖顯示資料，您可以隨著每個事件從此擴充功能傳送至Mailchimp。在您設定Web SDK將此資料傳送至邊緣網路後，您可以在事件轉送屬性中建立資料元素，讓擴充功能可以存取這些值。

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

名稱	範例路徑	類型	說明	必填	限制
`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 非常有用。在「記錄檔」區段的「Edge記錄檔」下方，可以查看觸發後，事件轉送規則提出的請求。下列螢幕擷取畫面顯示擴充功能對Mailchimp API提出的要求。

Adobe Experience Platform Debugger

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

全新的改善搜尋

Mailchimp事件轉送擴充功能概觀