在此頁面上：瞭解如何將簡單和物件集合傳遞至自訂動作引數，以便在執行階段動態填入。
您可以在自訂動作引數中傳遞集合，這些引數會在執行階段以動態方式填入。
支援兩種型別的集合：
-
簡單集合
將簡單集合用於基本值清單，例如字串、數字或布林值。 當您只需要傳遞專案清單而沒有其他屬性時，這些會很有用。
例如，裝置型別清單：
code language-json { "deviceTypes": [ "android", "ios" ] } -
物件集合
當每個專案包含多個欄位或屬性時，使用物件集合。 這些通常用於傳遞結構化資料，例如產品詳細資訊、事件記錄或專案屬性。
例如:
code language-json { "products":[ { "id":"productA", "name":"A", "price":20.1 }, { "id":"productB", "name":"B", "price":10.0 }, { "id":"productC", "name":"C", "price":5.99 } ] }
一般程式 general-procedure
在本節中，我們會使用下列JSON裝載範例。 這是一個物件陣列，其中的欄位是一個簡單的集合。
{
"ctxt": {
"products": [
{
"id": "productA",
"name": "A",
"price": 20.1,
"color":"blue",
"locations": [
"Paris",
"London"
]
},
{
"id": "productB",
"name": "B",
"price": 10.99
}
]
}
}
您可以看到products是兩個物件的陣列。 您至少需要一個物件。
-
建立您的自訂動作。 請在此頁面了解更多。
-
在 動作引數 區段中，貼上JSON範例。 顯示的結構為靜態：貼上裝載時，所有欄位都會定義為常數。
-
如有需要，請調整欄位型別。 集合支援下列欄位型別：listString、listInteger、listDecimal、listBoolean、listDateTime、listDateTimeOnly、listDateOnly、listObject
note NOTE 根據裝載範例自動推斷欄位型別。 -
如果您想要以動態方式傳遞物件，則需要將物件設定為變數。 在此範例中，我們將
products設定為變數。 物件中包含的所有物件欄位都會自動設定為變數。note NOTE 裝載範例的第一個物件用於定義欄位。 -
針對每個欄位，定義將顯示在歷程畫布中的標籤。
-
建立您的歷程並新增您建立的自訂動作。 請在此頁面了解更多。
-
在 動作引數 區段中，使用進階運算式編輯器定義陣列引數（範例中為
products）。
-
對於以下每個物件欄位，輸入來源XDM結構描述中的對應欄位名稱。 如果名稱相同，則不需要這樣做。 在我們的範例中，我們只需要定義
product id和"color"。
針對陣列欄位，您也可以使用進階運算式編輯器來執行資料操作。 在下列範例中，我們使用篩選器和交集函式：
限制 limitations
雖然自訂動作中的集合可提供傳遞動態資料的靈活性，但需注意某些結構限制：
-
支援自訂動作中的巢狀陣列
Adobe Journey Optimizer支援自訂動作 回應承載 中的巢狀物件陣列，但此支援限於請求承載。
在請求裝載中，只有當巢狀陣列包含固定數量的專案時（如自訂動作設定中所定義），才支援巢狀陣列。 例如，如果巢狀陣列一律包含剛好三個專案，則可將其設定為常數。 當專案數量需要為動態時，只能將非巢狀陣列（位於底層的陣列）定義為變數。
範例：
-
下列範例說明不支援的使用案例。
在此範例中，產品陣列包含具有動態專案數的巢狀陣列(
locations)，這在要求裝載中不受支援。code language-json { "products": [ { "id": "productA", "name": "A", "price": 20, "locations": [ { "name": "Paris" }, { "name": "London" } ] } ] } -
支援的範例，包含定義為常數的固定專案。
在此情況下，巢狀位置會由固定欄位(
location1，location2)取代，讓裝載在支援的設定中保持有效。code language-json { "products": [ { "id": "productA", "name": "A", "price": 20, "location1": { "name": "Paris" }, "location2": { "name": "London" } } ] }
-
-
測試集合：若要使用測試模式測試集合，您必須使用程式碼檢視模式。 請注意，商業事件不支援程式碼檢視模式，因此在這種情況下，您只能傳送包含單一元素的集合。
特定案例 examples
針對異質型別和陣列陣列，陣列是以listAny型別定義。 您只能對應個別專案，但無法將陣列變更為變數。
異質型別範例：
{
"data_mixed-types": [
"test",
"test2",
null,
0
]
}
陣列陣列範例：
{
"data_multiple-arrays": [
[
"test",
"test1",
"test2"
]
]
}
其他資源
瀏覽以下章節，進一步瞭解設定、使用及疑難排解自訂動作的相關資訊：
本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。
如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。
- TL；DR：此頁面說明如何在Journey Optimizer中，將簡單集合和物件集合動態傳遞至自訂動作引數，包括支援的欄位型別、設定程式，以及有關巢狀陣列的已知限制。
意圖：
- 設定自訂動作以接受集合（簡單或物件）作為動態引數
- 建立歷程時，在進階運算式編輯器中將陣列引數定義為變數
- 套用篩選和交集函式，在運算式編輯器中操作陣列資料
- 瞭解並處理自訂動作要求裝載的巢狀陣列限制
- 在歷程測試模式下使用程式碼檢視模式測試集合引數
字彙表：
- 簡單集合：基本純量值（字串、數字、布林值）的清單，已傳遞為自訂動作引數（產品專用）
- 物件集合：結構化物件清單，每個物件都有多個欄位，以自訂動作引數 （產品特定） 傳遞
- listObject：在自訂動作組態中用來表示物件陣列 （產品特定） 的欄位型別
- listAny：用於異質陣列或陣列陣列(其中專案具有混合型別（產品特定）)的欄位型別
- 變數（與常數）：在動作引數設定中，設定為「變數」的欄位會在執行階段從歷程內容動態填入，而「常數」是在設定時間 （產品特定） 設定的固定值
護欄：
- 只有當要求裝載中的巢狀陣列包含固定數量的專案（定義為常數）時，才支援巢狀陣列；不支援動態巢狀陣列
- 在測試模式下測試集合需要程式碼檢視模式；商業事件不支援程式碼檢視，因此在這種情況下只能傳送單一元素集合
- 用來定義集合欄位的裝載範例中必須至少出現一個物件
- 裝載範例的第一個物件會定義整個集合的欄位
術語：
- 正式名稱：集合 — 縮寫：無 — 變體：陣列、清單、動態集合
- 同義字： “simple collection” = “scalar values清單” ； “object collection” = “objects array of objects”
- 請勿混淆：「listAny」≠「listObject」（listAny處理異質或巢狀陣列；listObject處理結構化物件的統一陣列）
常見問題集：
- 問：簡單集合和物件集合之間有何差異？ — 簡單集合包含基本純量值（字串、數字、布林值），而物件集合則包含結構化物件，每個物件都有多個具名欄位。
- 問：如何在執行階段讓集合引數成為動態的？ — 在自訂動作的「動作引數」區段中，將陣列欄位設定為「變數」；然後陣列欄位中的所有物件欄位會自動設定為變數。
- 問：自訂動作要求裝載是否支援巢狀陣列？ — 僅部分。 具有固定、已知專案數的巢狀陣列可以定義為常數。 請求承載中不支援具有動態專案數的巢狀陣列。
- 問：如何在歷程測試模式下測試集合？ — 在測試介面中使用程式碼檢視模式。 請注意，業務事件不支援程式碼檢視，因此在該內容中只能測試單一元素集合。
- 問：集合支援哪些欄位型別？ — listString、listInteger、listDecimal、listBoolean、listDateTime、listDateTimeOnly、listDateOnly和listObject全都受支援。