Mailchimp事件轉送擴充功能概觀

NOTE
Adobe Experience Platform Launch已經過品牌重塑,現在是Adobe Experience Platform中的一套資料收集技術。 因此,所有產品檔案中出現了幾項術語變更。 請參閱下列檔案,以取得術語變更的彙總參考資料。

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

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

先決條件

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

需要Mailchimp帳戶才能使用此擴充功能。 您可以在這裡註冊帳戶。 在Mailchimp帳戶儀表板中,請記下以下值以用於本指南:

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

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

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

網域前置詞

登入Mailchimp並登入儀表板檢視後,瀏覽器的位址列應顯示https://us11.admin.mailchimp.com之類的URL或只有us11.admin.mailchimp.com。 在此範例中,前置詞us11只是預留位置,您的值將會不同。 請以您的前置詞來記錄您的URL,以供後續步驟使用。

API金鑰

若要尋找您帳戶的API金鑰,請在Mailchimp UI中選取您的設定檔圖示,然後選取​ 設定檔。 您應該會看到https://us11.admin.mailchimp.com/account/profile/之類的URL,但首碼為​ ,而非us11

選取​ 額外專案,然後選取​ API金鑰

額外功能表,API金鑰連結

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

對象ID和寄件者地址

在左側導覽中選取​ 對象,然後選取​ 對象儀表板。 接著,選取您要與此擴充功能搭配使用的對象。 若要深入瞭解,請參閱建立對象上的Mailchimp檔案。

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

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

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

Mailchimp自動化

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

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

安裝和設定

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

建立機密和資料元素

在事件轉送屬性中,建立名為Mailchimp API Key的Token密碼

接著,使用Core擴充功能和Secret資料元素型別,建立資料元素以參考您剛才建立的Mailchimp API Key密碼。 輸入Mailchimp Token作為資料元素名稱。

安裝並設定擴充功能

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

安裝Mailchimp延伸模組

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

IMPORTANT
請勿在此欄位中包含http://https://

擴充功能組態

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

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

資料收集

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

此擴充功能所需的資料可從Web SDK以XDM資料(使用xdm物件)或非XDM資料(使用data物件)傳送。

例如,如果客戶進行購買或在您的網站上註冊了事件,您可以使用此擴充功能透過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時間戳記
IMPORTANT
上述​ 範例路徑 ​值僅為範例。 這些資料元素中參照的欄位名稱和路徑在屬性中可能會不同,具體取決於您在上述步驟中命名和設定Web SDK的方式。

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

新增事件動作設定

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

資料驗證

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

Adobe Experience Platform Debugger

在Mailchimp儀表板中,您對象或對象成員的活動摘要檢視上,會提供該對象或對象成員的事件清單。 這應符合擴充功能傳送的事件,並顯示所傳送的任何選用資料,以及他們收到的電子郵件或促銷活動。 如需詳細資訊,請參閱Mailchimp自動化說明指南

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743