識別圖連結規則疑難排解指南

測試和驗證身分圖表連結規則時，您可能會遇到一些與資料擷取和圖表行為相關的問題。 請閱讀本檔案，瞭解如何疑難排解使用身分圖表連結規則時可能會遇到的一些常見問題。

資料擷取流程概觀 data-ingestion-flow-overview

下圖是資料如何流入Adobe Experience Platform和應用程式的簡化表示。 使用此圖表作為參考，協助您更清楚瞭解此頁面的內容。

請務必注意下列因素：

資料擷取問題 data-ingestion-issues

我的身分未內嵌到Identity Service中 my-identities-are-not-getting-ingested-into-identity-service

發生此情形有多種原因，包括但不限於下列各項：

在身分圖表連結規則的內容中，可能會拒絕身分服務的記錄，因為傳入事件有兩個或多個具有相同唯一名稱空間但不同身分值的身分。 發生此情形通常是因為實作錯誤。

考量下列事件有兩個假設：

下列事件將傳回錯誤訊息，指出擷取失敗。

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

疑難排解步驟

若要解決此錯誤，您必須先收集下列資訊：

接下來，使用Adobe Experience Platform查詢服務並執行下列查詢：

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

執行查詢後，尋找您預期產生圖形的事件記錄，然後驗證同一列中的身分值是否不同。 檢視下列影像以取得範例：

驗證後ExperienceEvents被歸因到錯誤的已驗證設定檔

名稱空間優先順序在事件片段判斷主要身分的方式中會扮演重要角色。

為了將已驗證的使用者事件繫結至人員名稱空間，所有已驗證的事件都必須包含人員名稱空間(CRMID)。 這表示即使使用者登入後，每個已驗證的事件上仍必須存在人員名稱空間。

在設定檔檢視器中查詢設定檔時，您可能會繼續看到primary=true個「事件」標幟。 不過，此專案會被忽略，且不會由設定檔使用。

預設會封鎖AAID。 因此，如果您使用Adobe Analytics來源聯結器，您必須確定ECID的優先順序高於ECID，讓未驗證的事件具有ECID的主要身分識別。

疑難排解步驟

我的體驗事件片段未內嵌到設定檔中 my-experience-event-fragments-are-not-getting-ingested-into-profile

您的體驗事件片段未擷取至設定檔中的原因有很多，包含但不限於：

在名稱空間優先順序的情境下，設定檔將拒絕：

疑難排解步驟

如果您的資料已傳送至Data Lake但未傳送設定檔，而您認為這是因為在單一事件中傳送了兩個以上具有最高名稱空間優先順序的身分，則可執行下列查詢以驗證針對相同名稱空間傳送了兩個不同的身分值：

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

您也可以執行以下查詢來檢查對設定檔的擷取是否由於最高的名稱空間具有空白字串而並未發生：

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE (col.id = '' or _testimsorg.identification.core.email = '') and key = 'Email'

這兩個查詢假設如下：

圖表行為相關問題 graph-behavior-related-issues

本節概述您可能會遇到的有關身分圖表行為方式的常見問題。

未驗證的ExperienceEvents被附加到錯誤的已驗證設定檔

身分最佳化演演算法會接受最近建立的連結，並移除最舊的連結。 因此，啟用此功能後，ECID可能會從一個人重新指派（重新連結）至另一個人。 若要瞭解身分在一段時間內如何連結的歷史記錄，請遵循下列步驟：

疑難排解步驟

首先，您必須收集下列資訊：

身分符號(namespaceCode)區分大小寫。 若要擷取identityMap中指定資料集的所有身分符號，請執行以下查詢：

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

如果您不知道Cookie識別碼的身分值，而想要搜尋已連結至多個人員識別碼的Cookie ID，則必須執行下列查詢。 此查詢假設ECID為Cookie名稱空間，CRMID為人員名稱空間。

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

現在您已識別連結至多個人員ID的Cookie值，請從結果中取一個，並在以下查詢中使用它來取得該Cookie值連結至不同人員ID時的時間順序檢視：

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

身分最佳化演演算法未如預期「運作」

疑難排解步驟

請參閱有關身分最佳化演演算法的檔案，以及支援的圖表結構型別。

您也可以在UI🔗中使用圖形模擬工具來模擬事件，並設定您自己的唯一名稱空間和名稱空間優先順序設定。 這麼做有助於您基本瞭解身分最佳化演演算法應該如何運作。

如果您的模擬結果與圖形行為預期相符，則可以檢查您的身分設定是否與您在模擬中設定的設定相符。

即使在設定身分設定後，我仍會在沙箱中看到摺疊的圖表

在儲存設定後​ 身分圖表將遵循您設定的唯一名稱空間和名稱空間優先順序。 在​ 之前您儲存新設定的任何「摺疊」圖形，在擷取新資料以更新摺疊的圖形之前，都不會受到影響。 ​即使名稱空間優先順序有所變更，即時客戶設定檔上的事件片段的主要身分也不會更新。

疑難排解步驟

您可以使用身分圖表檢視器來檢查您的圖表是在設定之前或之後擷取。 檢查連結屬性下上次更新的時間戳記，以檢視Identity Service何時擷取圖形。 如果時間戳記在設定之前，則表示在啟用功能之前已建立「摺疊」圖形。

我想知道我的沙箱中有多少「摺疊」的圖表

使用身分儀表板來深入分析身分圖表的狀態，例如身分計數和圖表。 請參閱量度「具有多個名稱空間的圖表計數」，以取得已收合的圖表計數 — 這些圖表包含兩個或多個具有相同名稱空間的身分。 假設沙箱沒有資料，並且您已將名稱空間（例如CRMID）設定為唯一，則預期應該有零個具有兩個或更多CRMID的圖表。 在下列範例中，有兩個圖表包含兩個或多個電子郵件地址。

您可以執行下列查詢，在Data Lake的設定檔快照匯出資料集中找到詳細的劃分：

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

您可以在設定檔快照匯出資料集中使用以下查詢，以從「摺疊」的圖形取得範例身分。

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

常見問題 faq

本節概述有關身分圖表連結規則常見問題的解答清單。

身分最佳化演演算法 identity-optimization-algorithm

請閱讀本節，瞭解有關身分最佳化演演算法的常見問題解答。

我的每個企業單位(B2C CRMID、B2B CRMID)都有一個CRMID，但我所有的設定檔中沒有唯一的名稱空間。 如果我將B2C CRMID和B2B CRMID標示為唯一，並啟用我的身分設定，會發生什麼事？

此情境不受支援。 因此，當使用者使用其B2C CRMID登入，而另一個使用者使用其B2B CRMID登入時，您可能會看到圖形摺疊。 如需詳細資訊，請參閱實作頁面中單一人員名稱空間需求一節。

身分最佳化演演算法是否會「修正」現有的收合圖形？

現有收合的圖形只有在您儲存新設定後更新時，才會受到圖形演演算法的影響（「固定」）。

如果兩個人使用同一部裝置登入和登出，事件會發生什麼事？ 所有事件是否會轉移給最後驗證的使用者？

如需詳細資訊，請閱讀判斷體驗事件的主要身分的指南。

當ECID從一個人傳輸至另一個人時，Adobe Journey Optimizer中的歷程會受到哪些影響？

上次驗證使用者的CRMID將會連結至ECID （共用裝置）。 ECID可根據使用者行為從一個人重新指派給另一個人。 影響將取決於如何建構歷程，因此客戶在開發沙箱環境中測試歷程以驗證行為非常重要。

重點如下：

命名空間優先等級

請閱讀本節，瞭解有關名稱空間優先順序的常見問題解答。

我已啟用我的身分設定。 如果在啟用設定後新增自訂名稱空間，我的設定會發生什麼事？

名稱空間有兩個「貯體」：人員名稱空間和裝置/Cookie名稱空間。 新建立的自訂名稱空間在每個「貯體」中的優先順序最低，因此這個新的自訂名稱空間不會影響現有的資料擷取。

如果即時客戶設定檔不再使用identityMap上的「主要」標幟，是否仍需傳送此值？

是，identityMap上的「主要」旗標已由其他服務使用。 如需詳細資訊，請閱讀名稱空間優先順序對其他Experience Platform服務的影響的指南。

名稱空間優先順序是否會套用至即時客戶個人檔案中的個人檔案記錄資料集？

不可以。 名稱空間優先順序僅適用於使用XDM ExperienceEvent類別的體驗事件資料集。

此功能如何與每個圖表50個身分的身分圖表護欄搭配運作？ 名稱空間優先順序是否會影響此系統定義的護欄？

身分最佳化演演算法將先套用，以確保個人實體表示。 之後，如果圖表嘗試超過身分圖表護欄 （每個圖表50個身分），則會套用此邏輯。 名稱空間優先順序不會影響50身分/圖表護欄的刪除邏輯。

測試

請參閱本節，以取得有關測試和偵錯身分圖表連結規則中功能的常見問題解答。

我應該在開發沙箱環境中測試哪些情境？

一般而言，在開發沙箱上測試應模擬您打算在生產沙箱上執行的使用案例。 請參考下表以瞭解進行全面測試時需驗證的一些關鍵區域：

如何驗證此功能是否如預期運作？

使用圖表模擬工具來驗證功能是否可在個別的圖表層級運作。

若要在沙箱層級驗證功能，請參閱身分儀表板中具有多個名稱空間的圖表計數區段。