Mailchimp事件轉送擴充功能概觀
Mailchimp 事件轉送擴充功能會將事件傳送至Mailchimp行銷API,可觸發Mailchimp行銷活動、歷程或交易的電子郵件。
本文介紹如何使用「新增事件」動作來設定擴充功能及設定規則。
先決條件
本檔案假設您熟悉擴充功能所使用的相關Mailchimp產品。 如需詳細資訊,請參閱行銷活動、歷程和交易的Mailchimp說明檔案。
需要Mailchimp帳戶才能使用此擴充功能。 您可以在這裡註冊帳戶。 在Mailchimp帳戶儀表板中,請記下以下值以用於本指南:
- 您的Mailchimp網域前置詞
- 您的API金鑰
- 對象ID
- 預設的「寄件者」電子郵件地址
根據您的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金鑰的Mailchimp檔案。
對象ID和寄件者地址
在左側導覽中選取 對象,然後選取 對象儀表板。 接著,選取您要與此擴充功能搭配使用的對象。 若要深入瞭解,請參閱建立對象上的Mailchimp檔案。
建立並選取您的對象後,選取 管理對象 下拉式清單,然後選擇 設定。 此畫面會顯示對象的各種設定。
在「設定」畫面底部,您應該會看到Unique id for audience [audience name]
,其中[audience name]
是您實際對象的名稱。 複製對象ID並儲存以供稍後步驟使用。
選取 對象名稱和預設值,並確認 預設來源電子郵件地址 為您的行銷活動具有正確的值。 請注意,此頁面頂端也會列出對象ID,與您在上一步驟中向下複製的值相同。
Mailchimp自動化
根據您的Mailchimp計畫以及您是否使用異動電子郵件、客戶歷程或其他Mailchimp自動化,您的特定歷程設定可能會有所不同。
安裝和設定
本節列出安裝和設定擴充功能的步驟。 若要安全地儲存Mailchimp API金鑰,您必須使用事件轉送密碼。
建立機密和資料元素
在事件轉送屬性中,建立名為Mailchimp API Key
的Token密碼。
接著,使用Core擴充功能和Secret資料元素型別,建立資料元素以參考您剛才建立的Mailchimp API Key
密碼。 輸入Mailchimp Token
作為資料元素名稱。
安裝並設定擴充功能
在相同事件轉送屬性中,選取 擴充功能、 然後 目錄 以顯示可供安裝的擴充功能。 從這裡,搜尋Mailchimp擴充功能並選取 安裝。
設定畫面隨即顯示。 在 Mailchimp伺服器首碼網域名稱 下,輸入您先前從Mailchimp帳戶複製的網域,包括唯一的網域首碼。
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
listId
arc.event.xdm._tenant.listId
或
arc.event.data._tenant.listid
name
arc.event.xdm._tenant.name
或
arc.event.data._tenant.name
properties
arc.event.xdm._tenant.properties
或
arc.event.data._tenant.properties
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
在事件轉送屬性中,您可以為上述每個欄位建立資料元素。 建立後,您可以參照此擴充功能之新增事件動作中的資料元素。
您現在可以使用此擴充功能和「新增事件」動作,為您的對象觸發Mailchimp電子郵件。
資料驗證
使用事件轉送擴充功能時,Adobe Experience Platform Debugger非常有用。 在「記錄」區段的Edge記錄底下,您可以檢視事件轉送規則觸發後提出的請求。 下列熒幕擷取畫面顯示擴充功能向Mailchimp API提出的請求。
在Mailchimp儀表板中,您對象或對象成員的活動摘要檢視上,會提供該對象或對象成員的事件清單。 這應符合擴充功能傳送的事件,並顯示所傳送的任何選用資料,以及他們收到的電子郵件或促銷活動。 如需詳細資訊,請參閱Mailchimp自動化說明指南。