在此頁面上：瞭解如何使用資料集查詢活動，在執行階段動態擷取Adobe Experience Platform記錄資料集的資料，並使用外部資料豐富您的歷程，以進行個人化和決策。
透過「資料集查詢」活動，您可以在執行階段期間從 Adobe Experience Platform 記錄資料集動態檢索資料。 善用此功能，您便能夠存取可能不是存放在輪廓或事件承載中的資料，確保及時與您的客戶進行相關的互動。
主要優點：
- 即時個人化：使用擴充資料量身打造客戶體驗。
- 動態決策：使用外部資料來驅動歷程邏輯和動作。
- 增強型資料存取：擷取產品中繼資料、訂價表格或與特定金鑰繫結的關聯式資料。
必讀 must-read
在設定資料集查詢之前，請先檢閱這些需求。
資料集啟用
必須在Adobe Experience Platform中啟用資料集以進行查詢。 本節中有詳細資訊： 使用 Adobe Experience Platform 資料。
限制和限制
- 每個歷程最多10個資料集查詢活動。
- 最多20個選取的欄位。
- 查詢鍵陣列中最多可有50個鍵。
- 擴充的資料大小上限為10KB。
其他效能考量事項
以下建議是避免傳遞延遲的指引：
設定資料集查詢活動 configure
若要設定 資料集查詢 活動，請遵循下列步驟：
-
展開 協調流程 類別，並將 資料集查詢 活動拖放到畫布中。
歷程
-
新增標籤和說明。
-
在 資料集 欄位中，選取具有所需屬性的資料集。
note NOTE 如果您要尋找的資料集未顯示在清單中，請確定您已啟用它以進行查詢。 如需詳細資訊，請參閱必須讀取區段。 -
選取您要從資料集擷取的特定欄位。
-
您只能選取葉節點（位於結構描述最低層級的欄位）。 欄位必須是基本值（字串、數字、布林值、日期等）。
-
無法選取清單（陣列）和地圖（機碼值物件）。
accordion 範例 
-
-
在 查閱索引鍵 欄位中，選擇同時存在於決定專案屬性和資料集中的加入索引鍵。 系統使用此索引鍵來搜尋所選資料集。
-
金鑰可以是衍生自歷程內容的運算式，例如SKU、電子郵件ID或其他識別碼。 範例：
@profile.email或list(@event{purchase_event.products.sku})。 -
只支援 字串 或字串清單。
note important IMPORTANT 您必須使用 進階模式 來定義查詢索引鍵。 如果您使用簡單模式設定索引鍵，資料集查詢活動輸出將無法作為下游活動中的內容屬性，且 @datasetLookup{}語法會失敗，並在條件活動中出現「找不到資料集查詢」錯誤。accordion 範例 
-
在歷程中使用擴充的資料
資料集查詢活動擷取的資料會以物件陣列的形式儲存在Journey內容中。 它可在歷程運算式編輯器和個人化編輯器中使用，以根據擴充的資料啟用條件式邏輯和個人化傳訊。
-
歷程運算式編輯器：
存取 進階模式 編輯器並使用語法：
@datasetLookup{MyDatasetLookUpActivity1.entities}。 瞭解如何使用進階運算式編輯器 -
Personalization編輯器：
使用語法：
{{context.journey.datasetLookup.1482319411.entities}}。
使用案例範例
案例:Send給家庭產品花費超過$40的使用者優惠券。
歷程流程：
-
購買事件：從使用者的購物車擷取SKU。
-
資料集查詢活動：
- 資料集：
products-dataset（SKU作為主索引鍵）。 - 查閱金鑰：
list(@event{purchase_event.products.sku})。 - 要傳回的欄位：
["SKU", "category", "price"]。
- 資料集：
-
條件活動：
-
篩選類別為「家庭」的SKU。
code language-none @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}
或
-
彙總家庭產品的總支出，並將其與$40的臨界值進行比較。
code language-none sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40
-
-
Personalization編輯器：
使用擴充資料來個人化電子郵件內容：
code language-none {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"
案例：識別設定檔的哪個電子郵件帳戶具有「白金」忠誠度狀態。 在這種情況下，忠誠度帳戶會與電子郵件ID相關聯，而標準設定檔查詢存放區中不會提供忠誠度資料。
歷程流程：
-
設定檔事件觸發器：從設定檔或事件內容擷取電子郵件ID。
-
資料集查詢活動：
- 資料集：
loyalty-member-dataset（以電子郵件作為主索引鍵）。 - 查閱金鑰：
@profile.email。 - 要傳回的欄位：
["email", "loyaltyTier"]。
- 資料集：
-
條件活動：
根據忠誠度等級來分支歷程：
code language-none @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum' -
Personalization編輯器：
使用擴充的熟客層級資料來個人化傳出通訊：
code language-none {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}
疑難排解 troubleshooting
條件活動中的「找不到資料集查詢」錯誤 troubleshooting-not-found
症狀：條件活動的進階運算式編輯器中的@datasetLookup{}語法傳回「找不到資料集查詢」錯誤，即使已在歷程中正確設定資料集查詢活動。
原因：資料集查詢活動中的查詢索引鍵是使用簡單模式設定的。 如果未在進階模式中定義索引鍵，則下游活動中不會將活動輸出公開為內容屬性。
修正：開啟資料集查閱活動，找到 查閱索引鍵 欄位，然後切換至 進階模式 以重新定義索引鍵運算式。 儲存活動並重新發佈歷程。
本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。
如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。
- TL；DR：此頁面說明如何設定資料集查詢活動，以便在歷程執行階段動態擷取AEP記錄資料集資料，以進行即時個人化和條件式邏輯。
意圖：
- 將資料集查詢活動新增至歷程，以在執行階段擷取外部AEP記錄資料
- 選取要在查詢期間擷取的特定資料集欄位（葉節點/基本值）
- 在進階模式中定義查詢索引鍵，以結合歷程內容與資料集記錄
- 在歷程運算式編輯器或個人化編輯器中使用擴充的資料集資料
- 疑難排解使用簡單模式查詢索引鍵所導致的「找不到資料集查詢」錯誤
字彙表：
- 資料集查詢活動：使用聯結索引鍵 （產品特定） 在執行階段從AEP記錄資料集擷取資料的歷程協調活動
- 分葉節點：結構描述階層最低層級的欄位，包含基本值（字串、數字、布林值、日期） （產品特定）
- 查詢索引鍵：用來比對歷程內容資料與所選資料集 （產品特定） 中記錄的聯結運算式（字串或字串清單）
- 擴充的資料：資料集查詢活動所擷取的資料，暫時儲存在歷程內容中，以用於下游活動（產品特定）
護欄：
- 每個歷程最多10個資料集查詢活動。
- 每個查閱活動最多可選取20個欄位。
- 查詢鍵陣列中最多可有50個鍵。
- 擴充的資料大小上限為10KB。
- 資料集必須先在Adobe Experience Platform中啟用以供查詢，才會出現在活動設定中。
- 只能選取分葉節點（基本值）；無法選取陣列和對應。
- 僅支援字串或字串清單做為查詢索引鍵。
- 查閱索引鍵必須在進階模式中定義；使用簡單模式會導致活動輸出無法作為下游的內容屬性。
- 擴充的資料是暫時性的，僅在歷程執行階段和輸出活動個人化中可用。
- 為獲得最佳效能，每個歷程限製為5個查詢活動（建議）；系統強制的硬性限製為每個歷程10個活動。 也建議每個查詢最多20個屬性。
術語：
- 正式名稱：資料集查詢活動 — 縮寫： n/a — 變體：AEP資料查詢、資料擴充活動
- 同義字： “lookup key” = “joining key”
- 請勿混淆：「資料集查詢活動」≠「體驗事件查詢」 — 資料集查詢會擷取記錄資料集資料，而非時間序列體驗事件
常見問題集：
- 問：為什麼我的資料集沒有出現在資料集欄位下拉式清單中？ — 必須在Adobe Experience Platform中啟用資料集以進行查詢。 請依照必讀一節中的指示加以啟用。
- 問：為什麼
@datasetLookup{}在條件中傳回「找不到資料集查詢」錯誤？ — 查詢鍵是使用簡單模式（而非進階模式）定義的。 在進階模式下重新定義它，並重新發佈歷程。 - 問：我可以從資料集擷取陣列或對應欄位嗎？ — 否，只能選取基本葉節點欄位（字串、數字、布林值、日期）。
- 問：如何在電子郵件中存取擴充的資料？ — 使用語法為
{{context.journey.datasetLookup.<activityId>.entities}}的個人化編輯器。 - 問：歷程結束後，是否有豐富的資料持續存在？ — 否，擴充的資料是暫時性的，只能在歷程執行階段工作階段中使用。