資料摘要中的子事件元件

AVAILABILITY
本文中描述的功能處於發佈的有限測試階段,可能尚未開放使用於您的環境中。 此功能普遍開放使用時,便會移除此注意事項。 有關 Customer Journey Analytics 發佈流程的資訊,請參閱 Customer Journey Analytics 功能發佈。

子事件元件是以XDM結構描述中的陣列或對應內的欄位為基礎的維度和量度。 它們可讓您在比事件層級更精細的層級分析資料,例如購買中的個別產品。 如需在區段中使用這項資料的相關資訊,請參閱子事件。

使用下列資訊來瞭解來自陣列和對應欄位的子事件元件如何在您的Customer Journey Analytics資料摘要中顯示。

瞭解子事件元件

XDM結構描述中的子事件元件

在XDM結構描述中,陣列的每個元素(字串陣列或物件陣列)都是子事件。 對應欄位中的每個專案也是子事件,如資料摘要🔗中的對應欄位中所述。 根據子事件內欄位的維度和量度是子事件元件。

若要在Adobe Experience Platform中檢視XDM結構描述內的子事件,請選取​結構描述,然後展開包含子事件的事件。

在下列範例中,Product list items是包含各種子事件元件的物件陣列。

包含物件陣列和子事件元件的 XDM結構描述

Analysis Workspace與資料摘要之間的子事件差異

Analysis Workspace和Customer Journey Analytics中的資料摘要之間,子事件元件的呈現方式不同。

位置
子事件元件如何呈現
Analysis Workspace (在Customer Journey Analytics中)
可選取為個別元件,與任何可見的階層分開。
資料摘要(在Customer Journey Analytics中)
以群組表示,其階層完整。

Adobe Analytics和Customer Journey Analytics之間的子事件差異

子事件資料(例如單一購買事件中的多個產品詳細資訊)在Customer Journey Analytics資料摘要中的顯示方式與Adobe Analytics資料摘要中的顯示方式不同。 下表比較每項產品代表子事件資料的方式。

產品
子事件資料在資料摘要中的顯示方式
範例:產品清單
Adobe Analytics
在單一欄中平面化為分隔字串。

產品清單包含在單一字串中分組的多個產品:

Power Tools;Cordless Drill;1;129.99,Power Tools;Drill Battery Pack;2;39.98

Customer Journey Analytics
子事件元件會保留XDM結構描述中定義的階層。 在同一欄中分組時,它們會向父事件和同層級子事件顯示其關聯階層。

產品清單會維護其在XDM結構描述中定義為陣列的階層:

[{"category":"Power Tools","product":"Cordless Drill","quantity":1,"revenue":129.99},{"category":"Power Tools","product":"Drill Battery Pack","quantity":2,"revenue":39.98}]

子事件範例:購買事件中的產品

客戶單一訂購購買兩種產品:一個無繩鑽床和兩個鑽床電池組。 您的實作會傳送單一購買事件,其中包含productListItems物件陣列中的兩個產品:

{
  "eventType": "commerce.purchases",
  "timestamp": "2026-09-16T14:32:07.512Z",
  "commerce": {
    "purchases": { "value": 1 }
  },
  "productListItems": [
    { "SKU": "CD-2000", "name": "Cordless Drill", "quantity": 1, "priceTotal": 129.99 },
    { "SKU": "BP-2000", "name": "Drill Battery Pack", "quantity": 2, "priceTotal": 39.98 }
  ]
}

此事件包含兩個子事件,productListItems陣列中的每個物件各一個。 下表顯示哪些欄位屬於事件以及哪些欄位屬於其子事件。

層級
欄位
欄位說明內容
事件
eventType, timestamp, commerce.purchases.value
整個購買。 每個欄位都有一個事件值。 訂單​量度會針對此事件計算1,無論它包含多少產品。
子事件
每個productListItems物件中的SKU、name、quantity、priceTotal
購買中的個別產品。 每個欄位針對每個產品具有一個值。 例如,quantity對於無繩鑽機是1,對於鑽機電池組是2。
NOTE
子事件僅包含隨事件傳送的資料。 Customer Journey Analytics不會從先前的事件重新建構購物車內容,例如購物車新增或結帳。 若要讓產品顯示為購買事件的子事件,您的實作必須包含在該購買事件的productListItems中。

將子事件元件新增至資料摘要

將子事件元件新增至資料摘要時,對話方塊會提示您從相同子事件新增其他元件。

提示您新增相關子事件元件的對話方塊

來自相同子事件的欄位在畫布上顯示為可收合的巢狀群組,而不是平面專案。

子事件群組

此群組反映基礎資料結構。

在資料摘要輸出中,所有這些元件都會以巢狀陣列的形式顯示在單一欄中。 Parquet檔案原生支援巢狀陣列。 如需詳細資訊,請參閱在資料摘要中使用Parquet檔案。

如需有關如何將元件(包括子事件元件)新增到資料摘要的資訊,請參閱建立資料摘要。

查詢資料摘要輸出中的子事件資料

由於子事件資料在Customer Journey Analytics資料摘要中的顯示方式不同,因此您用於它的查詢與您用於Adobe Analytics資料摘要的查詢不同。

下列範例說明如何尋找包含特定產品的事件。 這些範例使用Google BigQuery語法,其中UNNEST將陣列展開為列。 其他資料倉儲支援與其陣列功能相同的方法,例如Snowflake中的FLATTEN或Databricks中的explode。

在Customer Journey Analytics資料摘要中查詢產品資料

在Customer Journey Analytics資料摘要中,相同的兩個產品會顯示為product_list_items欄中的物件陣列。 不需要分隔符號剖析:

code language-json
{
  "row_id": "01K3F2M9-...-4821",
  "timestamp_utc": "2026-09-16T14:32:07.512000Z",
  "product_list_items": [
    { "category": "Power Tools", "product": "Cordless Drill", "quantity": 1, "revenue": 129.99,
      "events": {"event1": 1}, "merchandising": {"eVar10": "DrillBundle"} },
    { "category": "Power Tools", "product": "Drill Battery Pack", "quantity": 2, "revenue": 39.98,
      "events": {"event1": 1}, "merchandising": {"eVar10": "DrillBundle"} }
  ]
}

查詢的編寫方式取決於您是希望每個事件有一列,還是希望每個相符產品有一列。

每個事件傳回一列

若要篩選事件而不變更列數,請在EXISTS子查詢內使用陣列函式,例如UNNEST:

code language-sql
SELECT row_id, timestamp_utc, product_list_items
FROM `project.dataset.cja_data_feed` AS f
WHERE EXISTS (
  SELECT 1
  FROM UNNEST(f.product_list_items) AS item
  WHERE item.product = 'Cordless Drill'
);

此查詢會針對每個相符事件傳回一列,完整product_list_items陣列保持不變,無論陣列中有多少產品相符。

每個相符產品傳回一列

若要傳回每個相符產品的一列,請將陣列函式移至外部FROM子句:

code language-sql
SELECT f.row_id, f.timestamp_utc, item.product, item.quantity, item.revenue
FROM `project.dataset.cja_data_feed` AS f,
     UNNEST(f.product_list_items) AS item
WHERE item.product = 'Cordless Drill';

具有多個相符產品的事件會顯示為多列,而事件的欄(例如row_id)會重複顯示於每一列。 只有在您需要產品層級的詳細資料時,才使用此方法。 若要計算結果中的事件,請使用COUNT(DISTINCT row_id)而不計算資料列。

此方法適用於XDM結構描述中的任何陣列欄位,而不僅僅是產品。

在Adobe Analytics資料摘要中查詢產品資料

在Adobe Analytics資料摘要中,包含兩個產品一起購買的事件在product_list欄中顯示為單一分隔字串:

code language-text
Power Tools;Cordless Drill;1;129.99;event1=1;eVar10=DrillBundle,Power Tools;Drill Battery Pack;2;39.98;event1=1;eVar10=DrillBundle

若要尋找包含Cordless Drill的事件,請使用規則運算式剖析此字串:

code language-sql
SELECT hitid_high, hitid_low, post_evar10
FROM aa_hit_data
WHERE REGEXP_CONTAINS(product_list, r'(^|,)[^;]*;Cordless Drill;')

在資料摘要中使用對應欄位

對應XDM結構描述存放區索引鍵值配對中的欄位。 資料摘要會將每個地圖匯出為物件陣列,與其他子事件資料的方式相同。 每個物件都包含對應索引鍵及其值做為個別欄位。

輸出中的欄位名稱來自您為資料摘要設定的元件ID,而不是固定名稱,例如key或value。 本節中的範例使用範例元件ID。

簡單地圖

簡單對應是您可以在自己的結構描述中建立的對應型別。 每個鍵值都是一個字串,而每個值都是一個字串或整數。

例如,調查地圖會將每個問題儲存為索引鍵,並將回應儲存為值:

{
  "_yourtenant": {
    "surveyResponses": {
      "How did you hear about us?": "Search engine",
      "How likely are you to recommend us?": 9
    }
  }
}

在資料摘要輸出中,survey_question和survey_answer是索引鍵和值的元件ID:

{
  "survey_responses": [
    { "survey_question": "How did you hear about us?", "survey_answer": "Search engine" },
    { "survey_question": "How likely are you to recommend us?", "survey_answer": 9 }
  ]
}

身分對應

identityMap欄位中的每個身分都會匯出為一個物件。 物件包含身分名稱空間(金鑰),以及識別碼、驗證狀態和主要旗標。 該名稱空間會針對該名稱空間中的每個身分重複執行。

系統只會匯出資料檢視中作為維度存在的身分對應屬性,以及您新增至資料摘要的屬性。

{
  "identity_map": [
    { "identity_namespace": "ECID", "identity_id": "83290187457380573620940587193016478103", "authenticated_state": "ambiguous", "is_primary": true },
    { "identity_namespace": "CRMID", "identity_id": "C-1048576", "authenticated_state": "authenticated", "is_primary": false }
  ]
}

巢狀對應

某些Adobe定義的欄位(例如segmentMembership)為地圖地圖。 資料摘要會將其平面化為單一陣列,並使用第一層索引鍵和第二層索引鍵作為每個物件中的個別欄位。 在套用到的每個物件中會重複第一層索引鍵,因此不會遺失任何資料或關係。

例如,segment_namespace和segment_id是第一層索引鍵和第二層索引鍵的元件ID:

{
  "segment_membership": [
    { "segment_namespace": "ups", "segment_id": "04a81716-43d6-4e7a-a49c-f1d8b3129ba9", "status": "realized" },
    { "segment_namespace": "ups", "segment_id": "53cba6b2-a23b-454a-8069-fc41308f1c0f", "status": "exited" }
  ]
}
recommendation-more-help
analytics-platform-help-main