Show Menu
主題×

Identity Service疑難排解指南

本檔案提供有關Adobe Experience Platform Identity Service常見問題的解答,以及常見錯誤的疑難排解指南。 如需有關Platform API的一般問題和疑難排解,請參閱 Adobe Experience Platform API疑難排解指南
識別單一客戶的資料通常會分散在他們用來與您的品牌互動的各種裝置和系統上。 Identity Service 可將這些零散的身分識別匯集在一起,以利全面瞭解客戶行為,讓您即時提供具影響力的數位體驗。 如需詳細資訊,請參閱 Identity Service總覽

常見問題集

以下是有關Identity Service常見問題的解答清單。

什麼是身分資料?

身分資料是可用於識別個人的任何資料。 視組織內使用資料的情況而定,識別資料可包含CRM系統的使用者名稱、電子郵件地址和ID。 身分資料不限於您網站或服務的註冊使用者,因為匿名使用者也可透過其裝置或Cookie ID來識別。

將資料欄位標示為身分的好處為何?

將某些資料欄位標示為記錄和時間系列資料中的身分識別,可讓您在資料的自然結構中對應身分關係,並協調跨通道的重複資料。 如需詳細 資訊,請參閱Identity Service 總覽。

什麼是已知和匿名身份?

知身份 ,是指可單獨使用或與其他資訊一起使用的識別值,以識別、聯絡或尋找個人。 已知身分的範例可能包括電子郵件地址、電話號碼和CRM ID。
名身分 ,是指無法單獨使用或與其他資訊一起使用的身分值,以識別、聯絡或尋找個別人員(例如Cookie ID)。

什麼是私人身分圖?

「私人身分圖」是銜接與連結身分之間關係的私人地圖,僅供您的組織使用。
當從串流端點擷取或傳送至啟用身分服務的資料集的資料中包含多個身分識別時,這些身分識別會連結在「私人身分圖」中。 Identity Service利用此圖表來收集特定消費者或實體的身分,允許身份拼接和描述檔合併。

如何在XDM架構中建立多個識別欄位?

體驗資料模型(XDM)結構 ,支援多個身分欄位。 實作XDM Individual Profile或XDM ExperienceEvent類型的架構內任何類型的 string 資料欄位都可標示為識別欄位。 標籤後,這些欄位中包含的任何資料都會新增至描述檔的識別地圖。
有關如何使用用戶介面將XDM欄位標籤為標識欄位的步驟,請參閱方案編輯器教程中的 Identity 部分。 如果您使用API,請參閱「方案註冊表API 」教程中的 「身份描述符」部分。

是否有些欄位不應標示為身分的上下文?

身分欄位應保留給每個個人專屬的值。 例如,請考慮客戶忠誠度方案的資料集。 「忠誠度等級」欄位(金、銀、銅)將不是有用的身分識別欄位,而忠誠度ID(唯一值)則是。
郵遞區號和IP位址等欄位不應標示為個人的身分,因為這些值可套用至多個個人。 這些類型的欄位只應標示為家庭層級行銷策略的身分。

為什麼我的身份欄位無法連結我的預期?

使用Identity /cluster/members ,您可以檢視一或多個身分欄位的相關身分識別。 如果回應未傳回您預期的連結身分,請確定您是在XDM資料中提供適當的身分資訊。 如需詳細資訊,請 參閱「身分服務」概觀中有關提供XDM資料給Identity Service 的章節。

什麼是身分命名空間?

身分名稱空間提供識別欄位與客戶身份相關的上下文。 例如,「電子郵件」名稱空間下的身分欄位應符合標準電子郵件格式(名稱 @emailprovider.com),而使用「Phone」名稱空間的欄位應符合標準電話號碼(例如北美地區的987-555-1234)。
名稱空間可區分不同CRM系統之間的相似身分值。 例如,假設描述檔包含與公司獎勵方案相關聯的數值「忠誠度ID」。 「忠誠度」的命名空間會將此值與電子商務系統的類似數值ID(也會顯示在相同的描述檔中)區隔。

如何將身份與身份名稱空間關聯?

身分欄位建立時,必須與現有的身分名稱空間相關聯。 在將任何新名稱空間與 身分欄位建立關聯之前 ,必須使用API來建立名稱空間。
有關使用API建立標識描述符時定義命名空間的逐步說明,請參閱「方案註冊」開發 人員指南中有關建立描述符的一節 。 要在UI中將架構欄位標籤為標識,請遵循「架構編輯器」教程中 的步驟

Experience Platform提供的標準身分名稱空間為何?

Experience Platform內的所有組織都可使用下列標準名稱空間:
顯示名稱
ID
程式碼
說明
核心
0
核心
舊名稱:"Adobe AudienceManager"
ECID
4
ECID
別名:「Adobe Marketing Cloud ID」、「Adobe Experience Cloud ID」、「Adobe Experience Platform ID」
電子郵件
6
電子郵件
電子郵件(SHA256,小寫)
11
電子郵件
預先雜湊的電子郵件的標準命名空間。 在使用SHA-256進行雜湊處理之前,此命名空間中提供的值會轉換為小寫。
電話
7
電話
Windows AID
8
WAID
AdCloud
411
AdCloud
別名:Ad Cloud
Adobe Target
9
TNTID
目標ID
Google廣告ID
20914
GAID
GAID
Apple IDFA
20915
IDFA
廣告商的ID

我可以在哪裡找到組織可用的身份名稱空間清單?

使用 Identity Service API ,您可以向端點提出GET請求,以列出組織的所有可用身分名稱 /idnamespace/identities 空間。 如需詳細資訊,請 參閱Identity Service API總覽中 ,列出可用名稱空間一節。

如何為組織建立自訂命名空間?

使用 Identity Service API ,您可以透過向端點提出POST請求,為組織建立自訂身分命名空 /idnamespace/identities 間。 如需詳細資訊,請 參閱Identity Service API總覽中 ,建立自訂命名空間的章節。

什麼是複合身份和XID?

身分識別在API呼叫中會由其複合身分識別或XID參考。 復 合身份 ,是包含ID值和命名空間的身份的表示。 XID ​是單值識別碼,代表與複合身分識別(ID和命名空間)相同的構造,並在Identity Service保存時自動指派給新身分。 如需詳細 資訊,請參閱Identity Service API 總覽。

Identity Service如何處理個人識別資訊(PII)?

Identity Service會在持續值之前建立強大、單向的PII密碼雜湊。 使用SHA-256自動雜湊「電話」和「電子郵件」名稱空間中的身分資料,「電子郵件」值會在雜湊前自動轉換為小寫。

我是否應在傳送至平台之前加密所有PII?

在將PII資料收入平台之前,您不需要手動加密PII資料。 透過將資料 I1 使用標籤套用至所有適用的資料欄位,Platform會在擷取時自動將這些欄位轉換為雜湊的ID值。
如需如何套用及管理資料使用標籤的步驟,請參閱資 料使用標籤教學課程

在散列基於PII的身份時,是否有考慮事項?

如果您要將雜湊PII值傳送至Identity Service,則必須在資料集上使用相同的加密方法。 如此可確保資料集上的相同身分值會產生相同的雜湊值,並可在身分圖中正確比對及連結。

疑難排解

下節提供疑難排解建議,以瞭解使用Identity Service API時可能遇到的特定錯誤碼和非預期行為。

Identity Service錯誤訊息

以下是使用Identity Service API時可能遇到的錯誤訊息清單。

缺少必需的查詢參數

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

當請求路徑中未包含必要的查詢參數時,會顯示此錯誤。 錯 detail 誤消息的名稱提供了缺少的參數的名稱。 此錯誤訊息的變化包括:
  • 缺少必需的查詢參數- nsId
  • 缺少必需的查詢參數- id
  • 遺失必要的查詢參數- xid或(nsid,id)
  • 遺失必要的查詢參數- targetNs
  • 缺少必需的查詢參數- xids或compositeXids
在再次嘗試之前,請先檢查您是否已在請求路徑中正確加入指示的參數。

時間戳記應在最近180天內

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Timestamp should be within last 180 days"
}

Identity Service會清除180天以上的資料。 當您嘗試存取早於此日期的資料時,會顯示此錯誤訊息。

單一呼叫的XID上限為1000個

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit of 1000 XIDs in a single call"
}

當您嘗試擷取超過單一API呼叫所允許之XID數目上限的身分資訊時 #what-are-composite-identities-and-xids ,會顯示此錯誤訊息。 將請求中的XID數量減少至顯示的限制以解決此問題。

單一呼叫中限制1000個compositeXids

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There is a limit for 1000 compositeXids in a single call"
}

當您嘗試擷取超過單一API呼叫所允許之最大合成身分數的身分資訊 ,會顯示此錯誤訊息。 將請求中的複合身分識別數目減少至顯示的限制以解決此問題。

指定的圖形類型無效

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "The graph-type abc specified is invalid. Please provide a valid graph-type"
}

當請求路徑中的查詢參 graph-type 數被指定為無效值時,會顯示此錯誤訊息。 請參閱Identity Service概 述中的 「身分圖」一節,瞭解支援哪些圖形類型。

服務Token沒有有效範圍

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Service token does not have valid scope. Either acp.core.identity or acp.foundation is required"
}

當您的IMS組織尚未布建適當的Identity Service權限時,會顯示此錯誤訊息。 請連絡您的系統管理員以解決此問題。

閘道服務Token無效

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Gateway service token is not valid"
}

如果發生此錯誤,您的存取Token無效。 存取Token每24小時過期一次,且必須重新產生才能繼續使用平台API。 請參閱驗 證教學課程 ,以取得有關產生新存取Token的指示。

授權服務Token無效

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Authorization service token is not valid"
}

如果發生此錯誤,您的存取Token無效。 存取Token每24小時過期一次,且必須重新產生才能繼續使用平台API。 請參閱驗 證教學課程 ,以取得有關產生新存取Token的指示。

使用者Token沒有有效的產品內容

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "User token does not have valid product context"
}

當您的存取Token尚未從Experience Platform整合產生時,會顯示此錯誤訊息。 請參閱驗 證教學課程 ,以取得有關為Experience Platform整合產生新存取Token的指示。

從識別碼和命名空間程式碼取得原生XID時發生內部錯誤

{
    "title": "UnauthorizedAccess",
    "status": 401,
    "detail": "Invalid IMS Token/IMS Org | Internal error - when tried to get native XID from identity and namespace code"
}

當Identity Service保留身分時,會為身分的ID和關聯的命名空間ID指派一個稱為XID的唯一識別碼。 當在尋找指定ID值和命名空間的XID過程中發生錯誤時,會顯示此訊息。

IMS組織未針對Identity Service用途布建

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "The IMS Org. {IMS_ORG_NAME} is not provisioned for Identity Service usage"
}

當您的IMS組織尚未布建適當的Identity Service權限時,會顯示此錯誤訊息。 請連絡您的系統管理員以解決此問題。

內部伺服器錯誤

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Server Error. There was a problem processing your request"
}

當平台服務調用執行中發生意外異常時,將顯示此錯誤。 最佳實務是,在收到此錯誤時,設定您的自動呼叫程式,以計時間隔重試其要求幾次。 如果問題仍然存在,請與系統管理員聯繫。

批次擷取錯誤碼

Identity Service會從使用批次擷取功能上傳至平台的記錄和時間序列資料擷取身分資料。 由於批處理提取是非同步流程,因此您必須查看批處理的詳細資訊才能查看錯誤。 錯誤會隨著批處理進行而累積,直到批處理完成為止。
以下是使用「資料擷取API」時可能遇到的與Identity Service相關的錯 誤訊息清單

未知的XDM模式

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Unknown XDM schema"
}

Identity Service僅會針對分別符合Profile或ExperienceEvent類的記錄或時間系列資料使用身分。 嘗試為未遵守任一類別的Identity Service收錄資料會觸發此錯誤。

處理批的前100行中有0個有效身份

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "There were 0 valid identities in the first 100 rows of the processed batch"
}

當批次的前100列未顯示任何身分時,就會顯示此錯誤。 但是,此錯誤沒有明確表示在後續記錄中找不到任何身份。

跳過記錄,因為每個XDM記錄只有1個身份

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Skipped {NUMBER_OF_RECORDS} records as they had only 1 identity per XDM record"
}

Identity Service僅在單一記錄顯示兩個或更多身分值時連結身分。 每個收錄的批次都會發生此錯誤訊息一次,並顯示只能找到一個身分的記錄數,且不會造成身分圖表變更。

未為此IMS組織註冊命名空間代碼

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Namespace Code {ERRONEOUS_CODE} is not registered for this IMS Org"
}

當收錄的記錄呈現您的IMS組織不存在或無法存取其相關名稱空間的身分時,會顯示此錯誤。

由於未為「私用身分圖」布建IMS組織,因此正在跳過批次擷取

{
    "title": "AccountNotProvisioned",
    "status": 403,
    "detail": "Skipping batch ingestion as IMS Org is not provisioned for Private Identity Graph"
}

在擷取批次資料時,當您的IMS組織尚未布建適當的Identity Service權限時,會顯示此錯誤訊息。 請連絡您的系統管理員以解決此問題。

內部錯誤

{
    "title": "InternalError",
    "status": 500,
    "detail": "Internal Error. There was a problem during the ingestion"
}

當批次擷取期間發生意外例外時,會顯示此錯誤。 最佳實務是,在收到此錯誤時,設定您的自動呼叫程式,以計時間隔重試其要求幾次。 如果問題仍然存在,請與系統管理員聯繫。