文件Experience PlatformWeb SDK 指南

getIdentity

Last update: Tue Mar 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員

當您執行sendEvent命令時，如果尚未取得訪客的身分，Web SDK會自動取得該身分。

getIdentity命令可讓您在不傳送事件資料的情況下取得訪客ID。

如果您需要個別呼叫來產生訪客ID並傳送資料，可以使用此命令。

getIdentity命令會進行下列流程來擷取ECID。

  1. 您使用Web SDK來呼叫getIdentity或appendIdentityToUrl。
  2. Web SDK會等待提供同意資訊。
  3. Web SDK會檢查是否已在呼叫中要求ECID名稱空間。 依預設，ECID名稱空間一律包含。
  4. Web SDK會讀取kndctr Cookie並傳回其值為ECID （如果存在的話）。 這只會傳回ECID值，不會傳回regionId。
  5. 如果未設定kndctr身分識別Cookie，或已要求"CORE"名稱空間，Web SDK會向Edge Network提出要求。
  6. Edge Network會同時傳回ECID和regionId （如果要求，還會傳回CORE ID）。

使用網頁SDK標籤擴充功能取得身分

Web SDK標籤擴充功能不會透過標籤擴充功能UI提供此命令。 使用JavaScript程式庫語法來使用自訂程式碼編輯器。

使用網頁SDK JavaScript資料庫取得身分

呼叫您設定的Web SDK執行個體時執行getIdentity命令。 設定此命令時，可以使用下列選項：

  • namespaces：名稱空間陣列。 預設值為 ["ECID"]。其他支援的值包括：

    • ["CORE"]
    • ["ECID","CORE"]
    • null
    • undefined

    您可以同時要求ECID和CORE ID。 範例："namespaces": ["ECID","CORE"]。

  • edgeConfigOverrides： 資料流設定覆寫物件。

alloy("getIdentity",{
  "namespaces": ["ECID","CORE"] //this command retrieves both ECID and CORE IDs.
});

回應物件

如果您決定使用此命令處理回應，則回應物件中有以下屬性：

  • identity.ECID：包含訪客ECID的字串。
  • identity.CORE：包含訪客核心ID的字串。
  • edge.regionID：整數，代表取得身分時瀏覽器點選的Edge Network區域。 它與舊版Audience Manager位置提示相同。
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636