在此頁面上：瞭解如何在個人化編輯器中使用datasetLookup協助程式函式，以擷取Adobe Experience Platform記錄資料集中的欄位，並個人化您的內容。
Journey Optimizer可讓您利用個人化編輯器中Adobe Experience Platform記錄資料集的資料，來個人化您的內容。 開始之前，必須先啟用查詢個人化所需的資料集以進行查詢。 本節提供詳細資訊： 使用Adobe Experience Platform資料。
在資料集啟用查詢個人化後，您就可以使用其資料將您的內容個人化為Journey Optimizer。
-
開啟個人化編輯器，您可在每個內容中定義個人化（例如訊息），此編輯器可供使用。 瞭解如何使用個人化編輯器
-
導覽至協助程式函式清單，並將 datasetLookup 協助程式函式新增至程式碼窗格。
-
此函式提供預先定義的語法，可讓您從Adobe Experience Platform資料集呼叫欄位。 語法如下：
code language-none {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}-
datasetId為您正在處理的資料集識別碼。
-
id是來源資料行的識別碼，應該以查詢資料集的主要身分聯結。
note NOTE 為此欄位輸入的值可以是欄位識別碼( profile.packages.packageSKU)、在歷程事件中傳遞的欄位(context.journey.events.event_ID.productSKU)或靜態值(sku007653)。 無論如何，系統都會使用值，並在資料集中查詢，以檢查它是否符合索引鍵。如果索引鍵使用常值字串值，請將文字放在引號中。 例如： {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}。 如果使用屬性值做為動態索引鍵，請移除引號。 例如：{{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}} -
result為任意名稱，您必須提供該名稱，以參考您要從資料集擷取的所有欄位值。 此值將在您的程式碼中用於呼叫每個欄位。
-
required=false：如果required設為TRUE，則只有在找到相符的索引鍵時，才會傳遞訊息。 如果設為false，則不需要比對索引鍵，仍可傳送訊息。 請注意，如果設為false，建議您說明訊息內容的遞補或預設值。
accordion 在哪裡擷取資料集ID？ 可在Adobe Experience Platform使用者介面中擷取資料集ID。 在Adobe Experience Platform檔案中瞭解如何使用資料集。
-
-
調整語法以符合您的需求。 在此範例中，我們要擷取和乘客航班相關的資料。 語法如下：
code language-none {{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}- 我們正在處理其ID為「1234567890abcdtId」的資料集，
- 我們想要用來與查詢資料集建立聯結的欄位是profile.upformingFlightId，
- 我們想要在「飛行」參考下包含所有欄位值。
-
一旦設定好要在Adobe Experience Platform資料集中呼叫的語法，您就可以指定要擷取的欄位。 語法如下：
code language-none {{result.fieldId}}note NOTE 參考資料集欄位時，請確定您符合結構描述中定義的完整欄位路徑。 可使用協助程式函式提取的欄位數沒有硬性限制。 但是，為獲得最佳效能，建議將欄位數保持在50以下，以避免影響輸送量。 -
result是您已指派給 datasetLookup 協助程式函式中 result 引數的值。 在此範例中，為「flight」。
-
fieldID是您要擷取的欄位識別碼。 瀏覽與您的資料集相關的記錄結構描述時，Adobe Experience Platform使用者介面中會顯示此ID：
accordion 在何處擷取欄位ID？ 在Adobe Experience Platform使用者介面中預覽資料集時，可以擷取欄位ID。 在Adobe Experience Platform檔案中瞭解如何預覽資料集。
在此範例中，我們想使用與乘客登機時間和登機口相關的資訊。 因此，我們新增這兩行：
{{flight._myorg.booking.boardingTime}}{{flight._myorg.booking.gate}}
-
-
現在您的程式碼已準備就緒，您可以照常完成您的內容，並使用模擬方法進行測試：按一下「模擬內容」以使用範例輸入資料或AI自動產生來測試內容變異，或按一下「模擬內容」，然後從下拉式清單中選取「模擬內容（AEP設定檔）」，以使用測試設定檔預覽。 瞭解如何預覽和測試內容
快速參考 quick-reference
本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。
如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。
TL；DR
此頁面會教導如何在Journey Optimizer個人化編輯器中使用datasetLookup協助程式功能，以從Adobe Experience Platform記錄資料集中擷取欄位，並將這些欄位整合到訊息個人化中。
個意圖
- 啟用AEP記錄資料集，以進行查詢個人化
- 將
datasetLookup協助程式功能新增至個人化運算式 - 使用資料集ID、加入金鑰、結果別名和必要的旗標來設定函式
- 使用結果別名參考個人化運算式中擷取的資料集欄位
- 使用模擬內容流程測試個人化內容
- datasetLookup：個人化編輯器中的協助程式函式，透過加入指定索引鍵從AEP記錄資料集中擷取欄位值。 （產品特定）
- 記錄資料集： Adobe Experience Platform資料集型別包含可啟用查詢個人化的記錄層級資料。 （產品特定）
- 查詢個人化：在傳送時從AEP記錄資料集擷取欄位，以個人化訊息內容的程式。 （產品特定）
- 結果引數：在
datasetLookup呼叫中指派的任意別名；用來參照後續運算式中所有擷取的欄位值（例如{{result.fieldId}}）。 - 必要的引數：
datasetLookup中的布林值旗標，可控制訊息傳遞是否需要要在資料集中找到相符的索引鍵。
- 正式名稱： datasetLookup — 變體：資料集查詢、資料集查詢協助程式、資料集查詢協助程式函式
- 同義字： “datasetLookup” = “dataset lookup helper function”
- 請勿混淆： 「datasetId」（AEP資料集的識別碼）≠「id」（用來聯結資料集主要身分的來源資料行）≠「result」（參考擷取欄位值的別名）
- 功能目前處於「有限可用性」 — 尚未普遍提供給所有客戶。
- 運算式片段中的
datasetLookup協助程式函式僅供有限的客戶集使用；請聯絡您的Adobe代表以取得存取權。 - 資料集必須明確啟用查詢個人化功能，才能與
datasetLookup搭配使用。 - 將每
datasetLookup次呼叫擷取的欄位數保持在50以下，以避免影響輸送量（建議限制 — 頁面上未說明硬性限制）。
問： datasetLookup協助程式函式是什麼？
這是個人化編輯器中的協助程式功能，可擷取Adobe Experience Platform記錄資料集中的欄位值，讓您將該資料併入訊息個人化。
問：如果在資料集中找不到required=false和相符的索引鍵，會發生什麼情況？
訊息仍可傳送。 在使用required=false時，建議考慮訊息內容中的遞補或預設值。
問：如果找不到required=true和相符的金鑰，會發生什麼情況？
只有在資料集中找到相符的索引鍵時，才會傳遞訊息。
問：在哪裡可以找到語法所需的資料集ID和欄位ID？
可在Adobe Experience Platform UI中的「資料集」下擷取資料集ID。 在AEP UI中預覽資料集和瀏覽記錄結構描述時，會顯示欄位ID。
問：如何測試使用datasetLookup的內容？
使用 模擬內容 按鈕以使用範例輸入資料或AI自動產生進行測試，或從下拉式清單中選取模擬內容（AEP設定檔），以使用測試設定檔預覽。