文件Experience Platform即時客戶設定檔指南

使用即時客戶個人檔案與非結構化資料進行個人化客戶對話

最後更新： 2026年10月29日

建立對象：

  • 使用者
AVAILABILITY
此功能目前在​ beta ​中。 功能和檔案可能會有所變更。 若要參與此測試版，請聯絡Adobe客戶服務或您的客戶代表。

在Adobe Experience Platform中，您可以將來自多個管道的資料與即時客戶個人檔案合併，將客戶資料合併為統一的檢視。 Experience Platform支援非結構化資料，進一步擴充了這些功能，在語義上讓您能夠使用對話式和其他非結構化客戶資料，作為設定檔組成要素的一部分。

瞭解包含非結構化資料的設定檔 understanding

即時客戶個人檔案目前結合來自多個管道的結構化資料，包括線上、離線、CRM和協力廠商，將這些資料合併成統一的檢視，針對每個客戶互動提供可採取行動且附有時間戳記的帳戶。 不過，這並不涵蓋非結構化資料擷取，這表示來自交談、筆錄或其他多模式資料（例如PDF或影像）的資料無法用於設定檔。

包含非結構化資料的設定檔可讓您存取未處理的資料，這讓您更妥善地個人化交談，因為客戶內容將繼續在包括Brand Concierge在內的多個平台上共用。

包含非結構化資料的設定檔可為Experience Platform客戶提供下列功能：

  • 瞭解客戶意圖：擷取交談、傳訊、搜尋查詢、通話記錄、調查和其他文字式互動，以豐富現有的客戶設定檔。
  • 個人化交談：將設定檔屬性、對象成員資格和交談記錄結合在一起，讓Brand Concierge和其他客戶面對代理程式、工作階段、裝置和管道都能提供具有連續性的個人化體驗。
  • 即時啟用目的：從對話中擷取行銷人員定義的訊號，並透過對象、歷程和個人化來啟用它們。 這些下游啟用可在整個Experience Platform中使用，包括Adobe Journey Optimizer和Target。

使用案例 use-cases

包含非結構化資料的設定檔可讓您使用對話式資料作為進一步參與的啟用訊號，這可讓您更輕鬆地推動傳入個人化和傳出啟用。 因此，您可以在多種使用案例中使用這些設定檔：

  • 基於興趣的啟用：身為零售企業，已驗證的購物者會在交談中提及飲食偏好。 擷取的訊號可讓這些對象符合「無麩質」的興趣對象，其可用於傳入和傳出的啟用，例如量身打造的優惠和歷程。
  • 負面體驗抑制：作為大型零售公司，在客戶的交談中偵測到挫敗感。 然後會從促銷對象中抑制此客戶，以避免傳送失音的對外訊息。
  • 基於意圖的路由與下一個工作階段個人化：身為金融服務或金融技術公司，客戶在交談中會提及人生事件（例如「已婚」、「移動狀態」或「新工作」）。 系統會擷取這些關鍵字，並用於個人化其下一個工作階段，以將客戶與具有相關領域專業知識的顧問進行比對。

範例流程 sample-flow

以向客戶提供金融服務的公司為例。

在此案例中，您的其中一位客戶會向代理商詢問股票相關事宜。 由於此使用者端已登入，因此您的代理程式會透過讀取其即時客戶設定檔來瞭解此使用者。

然後，客戶繼續交談，表示「我也一直想要坐下來，仔細檢視我的退休儲蓄，只是還沒來得及安排時間。」 透過使用包含非結構化資料的個人檔案，Brand Concierge和Experience Platform可以從這些對話中擷取意圖，讓您透過代理程式傳送個人化回應。

因此，Experience Platform可讓此客戶進入「Financial Planning興趣」受眾，並立即個人化代理商以回覆「讓我們確定您的退休計畫如期進行 — 與Alex Agent預約免費簽到」。

此外，由於此內容在所有Experience Platform應用程式之間共用，因此您可以使用多個表單繼續處分對話。 例如，Adobe Journey Optimizer可以透過Alex Agent自動傳送一封電子郵件，內含淘汰簽到邀請。

Beta必要條件 prerequisites

若要搭配非結構化資料使用設定檔，您​ 必須 ​符合下列必要條件：

  • 已經是Adobe Experience Platform的現有使用者
  • 不​有Healthcare Shield附加元件

如果您符合所有這些必要條件，請聯絡Adobe客戶服務，以取得有關使用非結構化資料請求設定檔啟用的更多資訊。

需求 requirements

在使用非結構化資料設定繼續設定檔之前，您需要完成以下步驟：

啟用包含非結構化資料的設定檔後，您可以透過設定以下步驟來開始使用此功能：

  • 在Experience Platform中擷取非結構化資料
  • 設定設定檔內容以個人化交談
  • 設定訊號，從非結構化資料中擷取資料以進行啟用

擷取非結構化資料 ingest

若要在個人化流程中使用非結構化資料，必須先將資料內嵌至Experience Platform。

擷取非結構化資料的方法因非結構化資料的來源而異。

標準原始文字

對於具有原始文字使用案例的標準簡單身分識別，您可以使用ExperienceEvent結構描述和資料集將資料擷取到Experience Platform。 這最適合用於大部分的使用案例，包括匯入成績單、交談、附註和評論。

建立結構描述

note important
IMPORTANT
當您建立結構描述和資料集時，請​ 不 ​為設定檔或身分識別啟用它。

您首先需要為資料集建立XDM ExperienceEvent結構描述。 此結構需要包含下列資訊：

  • unstructuredContent欄位群組。 如需非結構化內容欄位群組的詳細資訊，請參閱XDM GitHub。
  • 用於標籤已知個人的身分。 此身分可以是身分對應，或是標示為身分描述項的欄位。

若要瞭解如何建立結構描述，請閱讀建立結構描述指南。

建立資料集

建立結構描述後，您可以建立使用此結構描述的資料集。 若要瞭解如何根據現有結構描述建立資料集，請閱讀建立資料集指南。

建立資料集後，您可以對v2/dataSets端點發出PATCH請求，同時提供新建立資料集的ID。 這可讓您更新資料集，以便用於包含非結構化資料的設定檔。

accordion
範例修補程式請求和回應，以啟用包含非結構化資料之設定檔的資料集。
code language-shell 
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        },
        "adobe_dataContent": {
            "channel": "call_transcripts"
        }
    }
  }'

成功的回應會傳回HTTP狀態200和您新更新資料集的ID。

code language-json 
[
    "@/dataSets/67b3077efa10d92ab7a71858"
]

擷取資料

現在結構描述和資料集已設定完畢，您可以開始將資料擷取至Experience Platform。 您可以使用標準來源聯結器將資料載入Experience Platform，因為全都支援CSV、JSON和Parquet。 擷取資料時，請將非結構化文字放入rawText欄位中，並將身分識別放入identity欄中。

您現在可以使用組織ID、沙箱資訊、資料集資訊和擷取方法（包含原始文字XDM的簡單ID）等資訊聯絡Adobe客戶服務，以完成資料擷取的設定。

WhatsApp企業
note availability
AVAILABILITY
WhatsApp聯結器處於​ 已關閉的Beta ​中。

若要瞭解如何設定WhatsApp聯結器，請閱讀WhatsApp 聯結器指南。

當您設定WhatsApp聯結器時，會自動建立​ WhatsAppWebhook原始事件 ​資料集。 已針對包含非結構化資料的設定檔自動啟用此資料集，並套用管道資訊。

設定WhatsApp聯結器後，請聯絡Adobe客戶服務，提供包括組織ID、沙箱資訊、管道（WhatsApp企業）和模式（串流或批次）在內的資訊，以允許列出用於包含非結構化資料之設定檔的聯結器。

Brand Concierge交談

對於Brand Concierge交談，會自動建立三個資料集來追蹤使用者提示、代理程式回應和意見回饋。

若要為包含非結構化資料的設定檔啟用這些資料集，您需要向v2/dataSets端點發出PATCH請求，同時提供三個資料集中每個的識別碼。

accordion
範例修補程式請求和回應，以啟用包含非結構化資料之設定檔的資料集。
code language-shell 
curl -X PATCH https://platform.adobe.io/data/foundation/catalog/v2/dataSets/67b3077efa10d92ab7a71858
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "extensions": {
        "adobe_unifiedProfile": {
            "semanticProfile": {
                "enablement": {
                    "status": "READY"
                }
            }
        }
    }
  }'

成功的回應會傳回HTTP狀態200和您新更新資料集的ID。

code language-json 
[
    "@/dataSets/67b3077efa10d92ab7a71858"
]

設定設定檔內容

將非結構化資料擷取到Experience Platform後，您可以設定設定檔內容，以協助個人化您的交談。 您可以使用同事或Experience Platform API來設定此描述檔敘述。

CX Enterprise Coworker

您可以在Co-worker中詢問「我要建立語意設定檔設定」以開始設定。

同事會透過下列步驟，引導您使用非結構化資料設定設定設定檔：

  • 同事會問「您的使用案例為何？」

  • 在說明您的使用案例後， Co-worker會根據使用案例提供相關屬性的清單

  • 一旦您確認屬性看起來正常， Co-worker將會確認下列動作。 根據預設，同事將有​ no ​個對象說明、精確​個人資料敘述、no​個資料治理標籤，以及​ 預設 ​個人名稱空間。

    • 如果您想要將對象說明新增至設定檔敘述
    • 設定檔敘述的精確度
    • 新增資料控管標籤並設定人員名稱空間

完成這些步驟後，您的個人資料與非結構化資料上下文一起建立。

API呼叫

您可以使用Experience Platform API，以非結構化資料內容設定設定檔。

在繼續之前，請先閱讀快速入門手冊，以取得相關檔案的連結、閱讀本節範例API呼叫的指南，以及有關成功呼叫任何Experience Platform API所需必要標題的重要資訊。

取得類別 get-categories

您必須先取得設定檔內容的類別。 類別是沙箱中可用的設定檔屬性群組。

API格式

code language-http 
GET /semanticprofile/config/category

要求

以下請求會擷取沙箱中所有可用類別及其屬性的清單。

accordion
擷取可用類別的範例請求。
code language-shell 
curl -X GET https://platform.adobe.io.data/core/semanticprofile/config/category \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回HTTP狀態200，其中包含可用於您的組織和沙箱的類別清單。

accordion
包含屬於您的組織和沙箱的類別和屬性清單的範例回應
code language-json 
{
  "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "result": [
    {
      "categories": [
        {
          "name": "Customer Demographics",
          "attributes": [
            "person.name.firstName",
            "person.name.lastName",
            "person.gender",
            "person.maritalStatus"
          ]
        },
        {
          "name": "Contact Information",
          "attributes": [
            "personalEmail.address",
            "mobilePhone.number"
          ]
        }
      ]
    }
  ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
欄位 類型 說明
requestId 字串 請求的唯一ID。
result 陣列 包含沙箱可用類別的陣列。
categories.name 字串 類別的名稱。
categories.attributes 陣列 包含類別中可用屬性清單的陣列。

建立設定

取得沙箱的可用類別後，您可以建立設定。 此設定包含設定檔資料的類別和屬性、您要反白顯示的對象、行銷動作、敘述精確度以及名稱空間。

API格式

code language-http 
POST /semanticprofile/config/configuration

要求

以下請求會使用「客戶人口統計」類別，利用非結構化資料設定來建立設定檔，包括指定的對象、無行銷動作、模糊敘述精確度和電子郵件名稱空間。

accordion
建立設定檔組態的範例要求。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/semanticprofile/config/configuration \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "data": {
        "name": "CustomerSummary":,
        "configurationDetails": {
            "category": [
                {
                    "name": "Customer Demographics",
                    "attributes": [
                        "person.name.firstName",
                        "person.name.lastName"
                    ]
                }
            ],
            "segments": {
                "limit": 1,
                "selection_mode": "inclusion",
                "inclusion": [
                    {
                        "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                        "priority": "1"
                    }
                ],
                "exclusion": []
            },
            "marketingActions": [],
            "narrative_precision": "fuzzy",
            "personNamespace": {
                "isPersonNamespaceEnabled": true,
                "code": ["Email"]
            }
        }
    }
 }'
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4
欄位 必要 類型 說明
name 是 字串 設定的名稱。 這是Narrative API中的金鑰。
configurationDetails 是 物件 包含設定詳細資訊的物件，包括類別、對象詳細資訊、行銷動作、敘述精確度和名稱空間。
category 是 陣列 陣列，包含您要組態使用的類別相關資訊。
category.name 是 字串 您要使用的類別名稱。 此​ 必須 ​符合GET類別API呼叫中的值。
category.attributes 是 陣列 您要使用的屬性陣列。 這些屬性​ 必須 ​屬於您使用的類別。
segments 無 物件 包含您要新增至設定的對象的物件。
segments.limit 無 數字 您要新增到設定的對象數量上限。
segments.selection_mode 無 字串 選擇對象的方法。 目前僅支援inclusion。
segments.inclusion 無 陣列 包含您要納入之對象的陣列。 對象會寫入為同時包含區段定義ID和優先順序的物件，其中較低的數字表示較高的優先順序（因此「1」是最高優先順序）。
marketingActions 無 陣列 包含您要套用至設定的行銷動作的陣列。 如需行銷動作的詳細資訊，請參閱行銷動作端點指南。
narrativePrecision 無 字串 組態敘述的精確度等級。 支援的值包括precise、fuzzy和value_only。
personNamespace 無 物件 包含設定之身分名稱空間詳細資訊的物件。 如果此欄位留空，將會使用沙箱的預設名稱空間。
personNamespace.isPersonNamespaceEnabled 無 布林值 如果設為true，則會使用personNamespace.code中列出的名稱空間。 否則，將會使用沙箱的預設名稱空間。
personNamespace.code 無 陣列 陣列，列出您想讓敘述使用的身分名稱空間程式碼。

回應

成功的回應會傳回HTTP狀態200，其中包含唯一的請求ID和新建立之設定的詳細資料。

accordion
包含新建立組態的範例回應。
code language-json 
{
    "requestId": "aaaa479b53a61598",
    "result": {
        [
            "CustomerSummary"
        ],
        "configurations": [
            {
                "name": "",
                "configurationDetails": {
                    "category": [
                        {
                            "name": "Customer Demographics",
                            "llm_desc": "",
                            "attributes": [
                                {
                                    "field": "person.name.firstName",
                                    "xdm_desc": "First Name",
                                    "llm_desc": ""
                                },
                                {
                                    "field": "person.name.lastName",
                                    "xdm_desc": "Last Name",
                                    "llm_desc": ""
                                }
                            ]
                        }
                    ]
                },
                "segments": {
                    "limit": 1,
                    "selection_mode": "inclusion",
                    "inclusion": [
                        {
                            "id": "b2cf20ca-5d07-4ef2-b50a-994eb2c11349",
                            "priority": "1",
                            "name": "High Value Customers",
                            "description": "Customers with LTV > $500",
                            "totalProfiles": 125000
                        }
                    ],
                    "exclusion": []
                },
                "marketingActions": [],
                "narrative_precision": "fuzzy",
                "personNamespace": {
                    "isPersonNamespaceEnabled": true,
                    "code": [
                        {
                            "code": "Email",
                            "name": "Email"
                        }
                    ]
                }
            }
        ]
    }
}

現在已建立設定檔內容，您可以針對Brand Concierge或任何其他面向客戶的代理程式儲存設定。

Brand Concierge中的設定檔內容 profile-context-brand-concierge

在Brand Concierge中，選取您要套用設定檔設定的服務人員。

顯示 Brand Concierge，顯示服務人員清單。

選取禮賓之後，請移至​ Personalization ​標籤，並選取先前建立的設定。

個人化標籤會顯示在Brand Concierge中。

其他面向客戶的代理程式的設定檔內容 profile-context-other

若要搭配其他面向客戶的代理程式使用設定檔內容，您需要使用Experience Platform API來查詢客戶的設定檔內容並擷取交談記錄。 透過擷取這兩個值，您的代理可以在開始交談之前正確擷取完整和相關內容。

若要查閱客戶的設定檔內容，您必須在提供entityIdNS、entityId和configurationName作為查詢引數時，對/semanticprofile/lookup/narrative端點發出GET要求。

取得設定檔敘述的範例要求與回應
code language-shell 
curl -X GET "https://platform.adobe.io/data/core/semanticprofile/lookup/narrative?entityIdNS=Email&entityId=jane.doe%2B1@example.com&configurationName=CustomerSummary" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key: {API_KEY}" \
  -H "x-gw-ims-org-id: {ORG_ID}" \
  -H "x-sandbox-name: {SANDBOX_NAME}"
table 0-row-2 1-row-2 2-row-2 3-row-2
查詢參數 說明
entityIdNS 身分名稱空間。 這必須是沙箱中定義的名稱空間。 可能的值包括Email、ECID和CRMID。
entityId 名稱空間中的身分值。 您​必須 URL編碼保留字元。
configurationName 先前建立組態的名稱。

成功的回應會傳回HTTP狀態200，其中包含設定檔內容的資訊。

code language-json 
{
    "requestId": "7f3a9c8e-4d7b-4a6e-9f2c-1b6e8d4a2c91",
    "narrative": "Jane Doe is a member of the 'High Value Loyalty' audience. Her primary email address is jane.doe+1@example.com."
}
table 0-row-2 1-row-2 2-row-2
欄位 說明
requestId 為請求產生的唯一ID。
narrative 產生的自然語言設定檔摘要。

若要查詢客戶的先前交談記錄，您必須對/semanticprofile/query/v1/profile端點提出POST要求，同時提供entityIdNS和entityId作為查詢引數。

範例要求與回應
code language-shell 
curl -X POST "https://platform.adobe.io.data/core/semanticprofile/query/v1/profile?entityIdNS=Email&entityId=jane.doe%2B1@example.com" \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "conversations": {}
 }'
table 0-row-2 1-row-2 2-row-2
查詢參數 說明
entityIdNS 身分名稱空間。 這必須是沙箱中定義的名稱空間。 可能的值包括Email、ECID和CRMID。
entityId 名稱空間中的身分值。 您​必須 URL編碼保留字元。

| 要求欄位 | 類型 | 說明 |
| ------------- | -------- | ---- | ----------- |
| conversations | 物件 | 決定您要傳回對話相關資訊的物件。 若將其保留為空白物件，您將會自動接收互動、中繼資料和訊號的相關資訊。 |

範例回應會傳回HTTP狀態200，其中包含所要求實體之交談的相關資訊。

code language-json 
{
    "conversations": {
        "items": [{
            "conversation_id": "conv-001",
            "channel": "web-chat",
            "created_at": "2026-05-02T14:03:11Z",
            "last_active_at": "2026-05-02T14:21:55Z",
            "participants": [{
                "identity_map": {
                    "Email": [{
                        "id": "jane.doe+1@example.com",
                        "primary": true
                    }]
                },
                "role": "customer",
                "is_author": true
            }],
            "interactions": [{
                "interaction_id": "int-001",
                "timestamp": "2026-05-02T14:03:11Z",
                "contents": [{
                    "content_value": "Hi, I'd like to upgrade my plan.",
                    "content_type": "TEXT"
                }]
            }]
        }],
    "has_more": true,
    "page_token": "eyJjdXJzb3IiOi…"
  }
}

取得敘述和對話後，您可以將此資訊提供給協力廠商AI代理。 因此，AI代理程式將擁有客戶身分的相關資訊，以及客戶討論內容的相關資訊。

設定訊號以擷取資料 configure-signals

設定設定檔內容後，您現在可以設定訊號，從非結構化資料中擷取資料。

您可以前往「同事」並詢問「讓我從交談中擷取訊號」，開始此程式。 然後同事會詢問您要從對話中偵測哪種訊號型別。

同事中會顯示要偵測的專案。

接下來，同事詢問這些對話屬於哪種品牌或企業。

同事詢問使用者訊號的品牌或內容。

最後，Co-worker會詢問您是要建立新的訊號群組，還是要加入現有的訊號群組。

同事詢問您是否要建立新訊號或更新現有的訊號。

然後，您可以確認上述步驟是否正確以及您是否要繼續建立訊號。

同事詢問您是否要確認步驟是否準確。

訊號建立作業隨即開始。 然後同事會建立訊號，自動將其新增至Experience Platform。

Co-worker列出要插入訊號需要複製和貼上的內容。

常見問題 faq

下節列出與非結構化資料設定檔相關的常見問題。

包含非結構化資料的設定檔是否與一般客戶設定檔分開？

回答
不可以。 設定檔非結構化資料​ 延伸 ​即時客戶設定檔。 因此，除了非結構化資料外，您還可以使用現有的設定檔基礎資料。 這​ 不 ​會取代現有的即時客戶設定檔。

什麼是設定檔內容/設定檔敘述？

回答

設定檔內容（設定檔敘述）是提供給AI代理程式的整合資訊，可改善互動。 上下文可以結合以下資料：

  • 輪廓屬性
  • 客群會籍
  • 行為記錄
  • 瀏覽活動
  • 先前的交談

什麼是訊號？

回答

訊號是一種結構化、可啟動的意義表示，可在非結構化互動中偵測。 訊號範例包括：

  • 產品興趣
  • 取消目的
  • 規定的偏好設定
  • 終生重大事件
  • 負面體驗
  • 產業
  • 購買者角色

訊號可由行銷人員定義，或由系統透過分析資料中發現的個別訊號來建立。

訊號與原始交談有何不同？

回答
訊號代表定義的業務概念，可與設定檔相關的事件資料一起儲存，而原始對話則是非結構化來源資料。

含有非結構化資料的設定檔是否只支援Brand Concierge？

回答
不可以。 包含非結構化資料的設定檔可支援Adobe、客戶自建和面向客戶的第三方代理程式。

我可以使用哪些資料來源？

回答

支援下列來源：

  • Brand Concierge和非Brand Concierge交談
  • WhatsApp交談
  • 搜尋查詢
  • 客服中心記錄
  • 聊天記錄
  • 調查
  • 網路研討會與銷售電話成績單
  • 其他文字互動
recommendation-more-help
experience-platform-help-profile