即時查詢邊緣上的設定檔屬性
Adobe Experience Platform使用即時客戶設定檔作為所有設定檔資料的單一信任來源。 為了快速即時擷取資料，它使用邊緣設定檔，這些設定檔是分散在整個Edge Network的輕量型設定檔。 這可提供快速、即時的個人化使用案例。
使用案例 use-cases
以下是邊緣設定檔查詢可協助使用的兩個使用案例。
- 即時Personalization：從邊緣設定檔快速擷取設定檔資訊，以個人化使用者在您網站上的體驗。
- 客戶支援：當客戶致電支援中心代理時，即時擷取設定檔資訊。
此頁面說明您必須遵循的步驟，以便即時查詢邊緣設定檔資料、提供個人化體驗，或透過下游應用程式通知決策規則。
術語和先決條件 prerequisites
設定本頁面所述的使用案例時，您將使用下列Experience Platform元件：
- 資料串流：資料串流會接收來自Web SDK的傳入事件資料，並以邊緣設定檔資料回應。
- 合併原則：您將建立Active-On-Edge合併原則，以確保Edge設定檔使用正確的設定檔資料。
- 自訂Personalization連線：您將設定新的自訂個人化連線，以將設定檔屬性傳送至Edge Network。
- Edge Network API：您將使用Edge Network API 互動式資料集合功能，從邊緣設定檔快速擷取設定檔屬性。
效能護欄 guardrails
Edge設定檔查詢使用案例須受下表所述的特定效能護欄約束。 如需Edge Network API護欄的詳細資訊，請參閱護欄檔案頁面。
步驟1：建立和設定資料流 create-datastream
請依照資料流設定檔案中的步驟，使用下列 Service 設定來建立新的資料流：
- Service：Adobe Experience Platform
- Personalization Destinations：已啟用
- Edge Segmentation：如果您需要邊緣分段，請啟用此選項。 如果您只想在邊緣上查詢設定檔屬性，但不想根據邊緣設定檔執行任何分段，則請停用此選項。
步驟2：設定您的對象以進行邊緣評估 audience-edge-evaluation
在Edge上查詢設定檔屬性時，需要針對邊緣評估設定您的對象。
確定您計畫啟用的對象已將Edge上作用中合併原則設定為預設值。 Active-On-Edge合併原則可確保持續評估邊緣上的對象，並可用於即時個人化使用案例。
依照建立合併原則上的指示進行，並確定啟用 Active-On-Edge Merge Policy 切換按鈕。
步驟3：將設定檔屬性資料傳送至Edge Network configure-custom-personalization-connection
若要即時查詢邊緣設定檔，包括屬性和對象成員資格資料，資料必須可在Edge Network上取得。 為此，您必須建立與 Custom Personalization With Attributes 目的地的連線並啟用對象，包括您想在邊緣設定檔上查閱的屬性。
請依照目的地連線建立教學課程中的指示進行，以取得有關如何建立新目的地連線的詳細說明。
設定新目的地時，請在欄位中選取您在步驟1 Datastream ID中建立的資料流。 對於Integration alias，您可以使用任何有助於您日後識別此目的地連線的值，例如目的地名稱。
建立 Custom Personalization With Attributes 連線後，您就可以將設定檔資料傳送至Edge Network了。
| note important |
|---|
| IMPORTANT |
| 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。 |
-
移至Connections > Destinations，然後選取 Catalog 標籤。
在Experience Platform UI中反白顯示
-
尋找 Custom Personalization With Attributes 目的地卡片，然後選取Activate audiences，如下圖所示。
-
選取您先前設定的目的地連線，然後選取Next。
-
選取您的對象。 使用對象名稱左邊的核取方塊來選取您要啟用至目的地的對象，然後選取Next。
您可以根據對象的來源，從多種對象型別中進行選取：
-
選取您要讓邊緣輪廓可用的輪廓屬性。
-
選取來源屬性。 若要新增來源屬性，請在 Add new field 欄上選取 Source field 控制項，然後搜尋或導覽至您想要的XDM屬性欄位，如下所示。
-
選取目標屬性。 若要新增目標屬性，請在 Add new field 欄上選取 Target field 控制項，然後輸入您要對應來源屬性的自訂屬性名稱。
-
當您完成對應設定檔屬性時，請選取Next。
在 Review 頁面上，您可以看到選取範圍的摘要。 選取 Cancel 以中斷流程，Back以修改您的設定，或 Finish 以確認您的選擇並開始將設定檔資料傳送至Edge Network。
在 Review 步驟中，您可以使用頁面上的可用篩選器來僅顯示其排程或對應已隨著此工作流程而更新的對象。 您也可以切換要檢視的表格欄。
如果您對您的選擇感到滿意，並且未偵測到任何原則違規，請選取 Finish 以確認您的選擇。
步驟4：在邊緣上查詢設定檔屬性 configure-edge-profile-lookup
現在您應該已完成設定資料串流，您已建立新的具有屬性的自訂Personalization目的地連線，而且您已使用此連線來傳送設定檔屬性，以便查閱Edge Network。
下一步是設定個人化解決方案，以從邊緣設定檔擷取設定檔屬性。
您在步驟1中設定的資料流現在已準備好接受傳入的事件資料並以邊緣設定檔資訊回應。
設定您的整合以擷取邊緣設定檔資訊，如下列範例所示。
請求 request
若要擷取邊緣設定檔資料，請傳送空的POST呼叫至/interact端點，其中包含您要查詢包含在事件中的設定檔屬性的主要身分，如下所示。
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event":
{
"xdm": {
"identityMap": {
"Email": [
{
"id":"test123@adobetest.com",
"primary":true
}
]
}
}
}
}'
回應 response
成功的回應會傳回HTTP狀態200 OK，其中的Handle物件包含與下列標籤中範例類似的資訊，端視設定檔是否位於邊緣而定。
handle物件可包含多種型別的payload物件。 與Edge設定檔查詢相關的資訊會分組到payload具有"type": "activation:pull"的物件下，如果設定檔存在於邊緣，根據啟動至邊緣的設定檔屬性和對象，您可以預期會有與以下內容類似的屬性和對象會籍回應。
| code language-json |
|---|
|
handle物件提供下表所述的資訊。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto | |
|---|---|
| 參數 | 說明 |
payload |
包含邊緣查詢資訊的payload物件。 回應可能包含多個其他payload物件，與邊緣查詢無關。 |
type |
負載會依其型別分組在回應中。 邊緣設定檔查詢的裝載型別一律設為profileLookup。 |
destinationId |
您在 Custom Personalization 步驟3中建立的連線執行個體的識別碼。 |
alias |
目的地連線的別名，由使用者在建立自訂Personalization目的地連線時設定。 |
attributes |
此陣列包含您在步驟3中啟動之對象的邊緣設定檔屬性。 |
segments |
此陣列包含您在步驟3中啟用的對象。 |
type |
handle物件依型別分組。 若是邊緣設定檔查詢使用案例，handle物件的型別一律為activation:pull。 |
eventIndex |
Edge Network會以陣列的形式從使用者端接收事件。 陣列中事件的順序會在處理期間保留，並會反映在此索引中。 事件索引從0開始。 |
如果邊緣上沒有設定檔，您可以預期類似以下的回應。
| code language-json |
|---|
|
handle物件提供下表所述的資訊。
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto | |
|---|---|
| 參數 | 說明 |
payload |
當設定檔不存在於邊緣時，payload物件為空白。 |
type |
payload物件依型別分組。 若是邊緣設定檔查詢使用案例，payload物件的型別一律為activation:pull。 |
eventIndex |
Edge Network會以陣列的形式接收來自使用者端的事件。 陣列中事件的順序會在處理期間保留，並會反映在此索引中。 事件索引從0開始。 |
結論 conclusion
依照上述步驟，您可以有效率地即時查詢邊緣設定檔屬性，透過下游應用程式實現個人化體驗和明智的決策。