資料元素

資料元素是資料字典 (或資料地圖) 的建置組塊。使用資料元素，在行銷和廣告技術之間收集、組織和傳遞資料。

單一資料元素是變數，其值可對應至查詢字串、URL、Cookie 值、JavaScript 變數等資料。您可以在整個Adobe Experience Platform中利用變數名稱參考此值。 此資料元素集合會成為定義資料的字典，您可用來建立規則 (事件、條件和動作)。此資料字典會跨標籤共用，以搭配您新增至屬性的擴充功能使用。

在建立規則的過程中，請盡量廣泛使用資料元素，以便確立動態資料的定義，並提高標記時的效率。您只須定義資料規則一次，之後便可在多處使用。

可重複使用資料元素的概念非常強大，您應該使用它們作為最佳做法。

例如，如果您有參考頁面名稱或產品ID的特定方式，或透過附屬機構行銷連結的查詢字串引數或從AdWords等等抓取資訊，可以透過資料字典（資料元素）的來源取得資訊，然後在各種標籤規則中使用此資料，藉此建立資料字典（資料元素）。

以頁面名稱為例，假設您透過參照資料層、document.title 元素或網站內的標題標籤來使用特定頁面名稱結構描述。Adobe Experience Platform中的標籤可讓您將資料元素建立為該特定資料點的單一參考點。 之後，您就可以在需要參照頁面名稱的任何規則中使用此資料元素。如果以後基於某些原因，您決定變更參照頁面名稱的方式 (例如您原本是參照 document.title，但現在您想參照特定資料層)，您不必編輯許多不同的規則即可變更該參照。只需在資料元素中變更參照一次，參照該資料元素的所有規則即會自動更新。

在規則中使用資料元素，或在指令碼中手動呼叫資料元素時，資料元素中便會填入資料。基本上，您可以：

資料元素用途

規則

您可以使用搜尋方塊來尋找資料元素的名稱，以在規則編輯介面中使用資料元素。

自訂指令碼

您可以使用 _satellite 物件語法，以在自訂指令碼中使用資料元素：

_satellite.getVar('data element name');

建立資料元素 create-a-data-element

資料元素是規則的基礎要素。資料元素可讓您為網站上包含的任何物件在頁面上經常使用的項目建立資料字典 (或資料地圖)，而不論其來源為何 (查詢字串、URL 或 Cookie 值)。

建立或編輯元素時，您可以儲存並建置您使用中的程式庫。這樣會立即將變更儲存至您的程式庫並執行組建。組件狀態會隨即顯示。您也可以從使用中程式庫下拉式清單中建立新程式庫。

資料元素型別 types-of-data-elements

下列章節說明​ 核心擴充功能 ​中可用的資料元素型別。 其他擴充功能則使用其他類型的資料元素。

Cookie

可在「Cookie名稱」欄位中參考任何可用的網域Cookie。

範例：

cookieName

自訂程式碼

選取開啟編輯器並將程式碼插入編輯器視窗，即可在UI中輸入自訂JavaScript。

您必須在編輯器視窗中輸入傳回陳述式，以指明應設為資料元素值的值。如果未包含傳回陳述式，資料元素會解析為 undefined。這會觸發遞補機制開始尋找所儲存的值；如果未儲存任何值，則系統會尋找預設值。

範例：

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

自訂程式碼可接受呼叫規則的 event 物件做為引數。如此一來，程式碼就能讀取該處的值。

範例：

// `event` is the default object provided by the rule
var eventType = event.$type;
return eventType; // if this data element is called from a "DOM Ready" event, then `core.dom-ready` is returned

您可以使用 _satellite 物件語法，在自訂指令碼中使用此方法：

// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);

使用百分比(%)語法時，您只需要指定資料元素名稱。 不需指定 event。

%data element name%

DOM 屬性

任何可擷取的元素值，例如 div 或 H1 標籤。

範例：

CSS 選擇器鏈結：

id#dc logo img

取得下列項目的值：

src

JavaScript 變數

任何可用的 JavaScript 物件或變數可使用下列路徑欄位參照。

如果您想要在標籤中收集JavaScript變數或物件屬性，並搭配任何擴充功能或規則使用，則資料元素可用來擷取這些值。 這樣的話，您可以在全部規則中參照資料元素，而如果資料來源有所變更，您只需在一個位置變更來源的參照（資料元素）即可。

例如，假設您的標記包含稱為 Page_Name 的 JavaScript 變數，如下所示：

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

建立資料元素時，您必須提供該變數的路徑。

如果您使用資料收集器物件作為資料層的一部分，只需在路徑中使用點記號來參照您要擷取到資料元素中的物件和屬性，如_myData.pageName或digitalData.pageName等。

範例：

window.document.title

本機儲存

在本機儲存專案名稱欄位中提供本機儲存專案的名稱。

本機儲存讓瀏覽器能在頁面之間儲存資訊 (https://www.w3schools.com/html/html5_webstorage.asp)。本機儲存的運作方式與Cookie類似，但更大也更有彈性。

使用提供的欄位來指定您為本機儲存項目建立的值，例如 lastProductViewed.

頁面資訊

使用這些資料點來擷取頁面資訊，以便用於規則邏輯或者傳送資訊至 Analytics 或外部追蹤系統。

您可以選取下列其中一個頁面屬性以用於資料元素：

查詢字串參數

在URL引數欄位中指定單一URL引數。

只需指定名稱部分，且任何特殊指示項都應省略 (例如「?」或「=」)

範例：

contentType

隨機數字

使用此資料元素產生隨機數字。它通常用於取樣資料或建立ID，例如點選ID。 隨機數字也可用來模糊化敏感資料，或對其執行 Salt 處理。某些範例可能包括：

指定隨機數字的最小值和最大值。

預設值：

最小：0

最大：1000000000

工作階段儲存

在工作階段儲存專案名稱欄位中提供工作階段儲存專案的名稱。

工作階段儲存與本機儲存類似，除了在工作階段結束後會捨棄資料，但本機儲存或 Cookie 可能會保留資料。

訪客行為

與「頁面資訊」類似，此資料元素使用常見行為型別，在規則或其他Platform解決方案中擴充邏輯。

選取下列其中一個訪客行為屬性：

常見的使用案例包括：

內建資料元素

如果您先前曾使用下列任何資料元素，則必須建立其他自訂資料元素：