使用Adobe Experience Platform資料進行個人化(Beta) aep-data
Journey Optimizer可讓您在個人化編輯器中運用Adobe Experience Platform中的資料，以個人化您的內容。 若要這麼做，必須首先透過API呼叫啟用查詢個人化所需的資料集，如下所述。 完成後，您可以使用他們的資料將您的內容個人化為Journey Optimizer。
Beta限制和指引 guidelines
開始之前，請檢閱下列限制和准則：
資料集啟用 enablement
- 資料集大小 在生產資料集中限製為5GB，在開發沙箱資料集中限製為1GB
- 在任何時候，每個組織最多可以啟用50個資料集 以供查閱。
- 記錄數 在生產資料集中限製為5M，在開發沙箱資料集中限製為1M。
- 資料使用標籤和強制執行 目前未針對啟用查閱的資料集強制執行。
- 啟用查閱及用於個人化的資料集不會受到刪除保護。 您可以自行追蹤用於個人化的資料集，以確保不會刪除或移除這些資料集。
使用Adobe Experience Platform資料的Personalization perso
- 支援的頻道：目前，此功能僅適用於電子郵件、簡訊、推播和直接郵件頻道。
- 資料使用標籤和強制執行 目前未針對啟用查閱的資料集強制執行。
- 運算式片段：目前無法將資料集查詢個人化放在運算式片段中。
啟用資料集以進行資料查詢 enable
為了將資料集中的資料用於個人化，您需要使用API呼叫來擷取其狀態並啟用查詢服務。
先決條件 prerequisites-enable
-
依照本檔案中詳述的指示，設定您的環境以傳送API命令。
-
開發人員專案必須將Adobe Journey Optimizer和Adobe Experience Platform API新增至其專案。
-
您角色中必須有管理資料集許可權。
-
資料集所依據的結構描述必須包含可作為查詢金鑰的 主要身分。
API呼叫結構 call
curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"
其中：
- URL 是
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION} - 資料集識別碼 是您要啟用的資料集。
- 動作 為啟用或停用。
- 存取權杖 可從開發人員主控台擷取。
- 可從開發人員主控台擷取 API金鑰。
- IMS組織ID 是您的Adobe IMS組織。
- 沙箱名稱 是資料集所在的沙箱名稱（例如prod、dev等）。
運用資料集進行個人化 leverage
使用API呼叫啟用資料集查閱個人化後，您就可以使用其資料將您的內容個人化至Journey Optimizer。
-
開啟個人化編輯器，您可在每個內容中定義個人化（例如訊息），此編輯器可供使用。 瞭解如何使用個人化編輯器
-
導覽至協助程式函式清單，並將 datasetLookup 協助程式函式新增至程式碼窗格。
-
此函式提供預先定義的語法，可讓您從Adobe Experience Platform資料集呼叫欄位。 語法如下：
code language-none {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}-
datasetId 為您正在處理的資料集識別碼。
-
id 是來源資料行的識別碼，應該以查詢資料集的主要身分聯結。
note 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 NOTE 參考資料集欄位時，請確定您符合結構描述中定義的完整欄位路徑。 -
result 是您已指派給 MultiEntity 協助程式函式中 result 引數的值。 在此範例中，「飛行」。
-
fieldID 是您要擷取的欄位識別碼。 瀏覽與您的資料集相關的記錄結構描述時，Adobe Experience Platform使用者介面中會顯示此ID：
accordion 從何處擷取欄位ID？ 在Adobe Experience Platform使用者介面中預覽資料集時，可以擷取欄位ID。 在Adobe Experience Platform檔案中瞭解如何預覽資料集。
在此範例中，我們想使用與乘客登機時間和登機口相關的資訊。 因此，我們新增這兩行：
{{flight._myorg.booking.boardingTime}}{{flight._myorg.booking.gate}}
-
-
現在您的程式碼已準備就緒，您可以照常完成您的內容，並使用 模擬內容 按鈕來測試內容，以檢查個人化。 瞭解如何預覽和測試內容
