上下文資料變數可讓您在每個頁面上定義處理規則可讀取的自訂變數。您可以在上下文資料變數中傳送資料,而不必在程式碼中明確指派 Analytics 變數的值。處理規則接著會取用上下文資料變數值,再傳遞至個別的 Analytics 變數。請參閱「管理員使用指南」中的處理規則。
上下文資料變數有助於開發團隊收集命名元素中的資料,而非編號變數。例如,與其要求開發團隊將頁面的作者指派給 eVar10
,不如要求將頁面作者指派給 s.contextData["author"]
。接下來,貴組織中的 Analytics 管理員就可以建立處理規則,將上下文資料變數與分析變數對應,以便進行報告。開發團隊最終只需擔心上下文資料變數,不必擔心 Adobe 提供的許多頁面變數。
如果 XDM 欄位未和 Adobe Analytics 進行對應,此欄位會以內容資料變數自動包含在內。然後,您可以使用處理規則將此內容資料變數指派到所需的 Analytics 變數。
雖然將資料對應到資料流中正確的 XDM 欄位是最佳實務,但此方法可獲得類似的結果。
Adobe Experience Platform 資料收集沒有專用位置可設定上下文資料變數。 請依照 AppMeasurement 語法使用自訂程式碼編輯器。
s.contextData
變數不會直接取用值。請改為將此變數的屬性設為字串。
// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";
"a."
來啟動上下文資料變數。此首碼由 Adobe 保留使用。例如,請勿使用 s.contextData["a.InstallEvent"]
。s.contextData["example"]
等於 s.contextData["EXAMPLE"]
。處理規則執行後,上下文資料變數便會遭到捨棄。如果您沒有將值放入變數的作用中處理規則,該資料將會永久遺失!
處理規則會在儲存後立即生效。它們不適用於歷史資料。
請在 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";