contextData

上下文資料變數可讓您在每個頁面上定義處理規則可讀取的自訂變數。您可以在上下文資料變數中傳送資料，而不必在程式碼中明確指派 Analytics 變數的值。處理規則接著會取用上下文資料變數值，再傳遞至個別的 Analytics 變數。請參閱「管理員使用指南」中的處理規則。

上下文資料變數有助於開發團隊收集命名元素中的資料，而非編號變數。例如，與其要求開發團隊將頁面的作者指派給 eVar10，不如要求將頁面作者指派給 s.contextData["author"]。接下來，貴組織中的 Analytics 管理員就可以建立處理規則，將上下文資料變數與分析變數對應，以便進行報告。開發團隊最終只需擔心上下文資料變數，不必擔心Adobe提供的許多頁面變數。

使用 Web SDK 的內容資料變數

如果使用​ XDM物件，則所有未對應至Adobe Analytics變數的欄位都會自動納入為內容資料變數。 您也可以使用XDM物件明確設定內容資料。 然後您可以使用處理規則將內容資料變數指派給所需的Analytics變數。 如需詳細資訊，請參閱將其他XDM欄位對應到Analytics變數。

如果使用​ 資料物件，則所有內容資料變數都會以索引鍵值配對的形式存在於data.__adobe.analytics.contextData中：

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "contextData": {
          "example_variable": "Example value",
          "second_example": "Another value"
        }
      }
    }
  }
});

處理規則介面會在適用的下拉式功能表中顯示c.example_variable和c.second_example。

使用 Adobe Analytics 擴充功能的內容資料變數

Adobe Experience Platform 資料收集沒有專用位置可設定上下文資料變數。 請依照 AppMeasurement 語法使用自訂程式碼編輯器。

AppMeasurement 和 Analytics 擴充功能自訂程式碼編輯器中的 s.contextData

s.contextData 變數不會直接取用值。請改為將此變數的屬性設為字串。

// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";

使用處理規則填入分析變數

處理規則會在儲存後立即生效。它們不適用於歷史資料。

在連結追蹤呼叫中傳送上下文資料

請在 s.linkTrackVars 中將上下文資料變數納入為 contextData 的屬性：

s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");

使用內容資料變數的增加事件

建立處理規則時，您可以為事件指派內容資料變數。

// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";

// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";