邊緣擴充功能的動作類型

注意

Adobe Experience Platform Launch在Adobe Experience Platform中已重新命名為一套資料收集技術。 因此,產品檔案中已推出數個術語變更。 有關術語更改的綜合參考,請參閱以下document

在標籤規則中,動作是在規則條件通過評估後執行的動作。 動作類型由擴充功能提供,其效果由擴充功能作者完全定義。

例如,擴充功能可提供「顯示支援聊天」動作類型,其中可顯示支援聊天對話方塊,協助可能在結帳時遇到問題的使用者。

本檔案說明如何在Adobe Experience Platform中定義邊緣擴充功能的動作類型。

重要

如果您正在開發 Web 擴充功能,請改為參閱 Web 擴充功能的動作類型指南。

本檔案也假設您熟悉程式庫模組,以及這些模組如何整合至邊緣擴充功能。 如果需要相關說明,請先參閱程式庫模組格式化的概述文章,再返回閱讀本指南。

動作類型通常包含下列項目:

  1. 資料收集UI中顯示的檢視,可讓使用者修改動作的設定。
  2. 在標籤執行階段程式庫內發出的程式庫模組,用於解譯設定並執行動作。

例如,將某些資料轉送至協力廠商端點的模組可能如下所示。

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  return fetch('http://someendpoint.com', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

如果要使用者可設定端點,並允許端點輸入和持續存在模組內的設定物件,則該物件看起來會類似於此。

{
  "endpoint": "http://someendpoint.com"
}

若要運用於使用者定義的端點,您的模組必須變更為下列範例。

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  const  { endpoint } = settings;
  return fetch(endpoint, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

動作結果

動作模組傳回的結果可能是任何項目。如果動作必須執行非同步工作,您可以傳回 Promise,這會在解析後傳回所需結果。

動作結果會儲存在 ruleStash 索引鍵中,可透過 context 參數 (context.arc.ruleStash) 供所有模組使用。如需深入了解 ruleStash,請參閱此處

本頁內容