文件Analytics實作指南

contextData

最後更新： 2025年4月29日
  • 主題：

建立對象：

  • 管理員
  • 開發人員

上下文資料變數可讓您在每個頁面上定義處理規則可讀取的自訂變數。您可以在上下文資料變數中傳送資料，而不必在程式碼中明確指派 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"
        }
      }
    }
  }
});

處理規則介面會在適用的下拉式功能表中顯示example_variable和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";
  • 有效的上下文資料變數只包含英數字元、底線和句點。如果您包含其他字元 (如連字號)，Adobe不保證處理規則能收集資料。
  • 請勿使用 "a." 來啟動上下文資料變數。此首碼由 Adobe 保留使用。例如，請勿使用 s.contextData["a.InstallEvent"]。
  • 上下文資料變數不區分大小寫。變數 s.contextData["example"] 等於 s.contextData["EXAMPLE"]。
  • 單一索引鍵不能包含多個值。 如果您想要針對多值變數使用內容資料變數，請使用分隔字元（通常是逗號）串連所有值，並使用處理規則將其傳遞至清單prop或清單變數。

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

WARNING
處理規則執行後，上下文資料變數便會遭到捨棄。如果您沒有將值放入變數的作用中處理規則，該資料將會永久遺失！
  1. 請更新您的實施以設定上下文資料變數名稱和值。
  2. 登入Adobe Analytics並移至​ 管理員 > 報表 ​套裝。
  3. 選取所需的報表套裝，然後前往​ 編輯設定 > 一般 > 處理規則。
  4. 建立處理規則，將 Analytics 變數設定為上下文資料變數值。
  5. 儲存變更。

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

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

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

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

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

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

  • 如果內容資料變數包含任何類型的文字，事件會增加 1。
  • 如果內容資料變數包含整數，事件會增加該整數的數量。
// 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";
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690