list

清單變數是自訂變數，您可以視需要使用。它們的作用與 eVar 類似，但是它們可以在同一次點擊中包含多個值。清單變數沒有字元限制。

請務必將每個清單變數的使用方式與其邏輯記錄在解決方案設計文件內。

在報表套裝設定中設定清單變數

在實施中使用清單變數之前，請務必先在報表套裝設定中設定每個變數。請參閱「管理員指南」中的轉換變數。此步驟適用於所有實作方法。

使用 Web SDK 的清單變數

如果使用​ XDM物件，清單變數會使用XDM欄位xdm._experience.analytics.customDimensions.lists.list1.list[]至xdm._experience.analytics.customDimensions.lists.list3.list[]。 每個陣列元素包含一個 "value" 物件，其中包含每個字串。不需要提供分隔符號；Adobe資料收集伺服器會自動偵測並包含報表套裝設定中設定的正確分隔符號。

"xdm": {
  "_experience": {
    "analytics": {
      "customDimensions": {
        "lists": {
          "list1": {
            "list": [
              {
                "value": "Example value 1"
              },
              {
                "value": "Example value 2"
              },
              {
                "value": "Example value 3"
              }
            ]
          }
        }
      }
    }
  }
}

如果使用​ 資料物件，清單變數會使用data.__adobe.analytics.list1 - data.adobe.analytics.list3下列AppMeasurement語法。 請確定您在報表套裝設定中使用正確的分隔符號集。

"data": {
  "__adobe": {
    "analytics": {
      "list1": "Example value 1,Example value 2,Example value 3"
    }
  }
}

使用 Adobe Analytics 擴充功能的清單變數

Adobe Analytics 擴充功能中沒有專用欄位可使用這個變數。請依照 AppMeasurement 語法使用自訂程式碼編輯器。

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

每個清單變數都是字串，其中包含貴組織專屬的自訂值。此變數沒有位元組數上限，不過每個個別值都有最多255個位元組的限制。 您使用的分隔字元，可以在 報表套裝設定中設定變數時決定。在分隔多個項目時，請勿使用空格。

// A list variable configured with a comma as a delimiter
s.list1 = "Example value 1,Example value 2,Example value 3";

比較清單屬性和清單變數

清單屬性和清單變數都可以在同一次點擊中包含多個值。不過，這兩種變數類型之間有幾項主要差異。