Identity Graph Linking Rules에 대한 문제 해결 안내서

Identity Graph Linking Rules을(를) 테스트하고 유효성을 검사할 때 데이터 수집 및 그래프 동작과 관련된 문제가 발생할 수 있습니다. Identity Graph Linking Rules​(으)로 작업할 때 발생할 수 있는 몇 가지 일반적인 문제를 해결하는 방법에 대해 알아보려면 이 문서를 참조하십시오.

데이터 수집 흐름 개요 data-ingestion-flow-overview

다음 다이어그램은 데이터가 Adobe Experience Platform 및 애플리케이션으로 유입되는 방식을 단순하게 보여 줍니다. 이 페이지의 내용을 더 잘 이해하려면 이 다이어그램을 참조로 사용하십시오.

{modal="regular"}

다음 요인에 유의해야 합니다.

데이터 수집 문제 data-ingestion-issues

내 ID가 ID 서비스에 수집되지 않습니다. my-identities-are-not-getting-ingested-into-identity-service

이 문제가 발생할 수 있는 이유에는 다음과 같은 다양한 이유가 있습니다.

Identity Graph Linking Rules의 컨텍스트 내에서 들어오는 이벤트에 고유 네임스페이스는 같지만 ID 값이 다른 두 개 이상의 ID가 있으므로 ID 서비스에서 레코드가 거부될 수 있습니다. 이 시나리오는 일반적으로 구현 오류로 인해 발생합니다.

두 가지 가정을 사용하여 다음 이벤트를 고려하십시오.

다음 이벤트는 수집이 실패했음을 나타내는 오류 메시지를 반환합니다.

{
  "_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'

쿼리를 실행한 후 그래프를 생성해야 하는 이벤트 레코드를 찾은 다음 동일한 행에서 ID 값이 다른지 확인합니다. 예를 보려면 다음 이미지를 확인하십시오.

사후 인증 ExperienceEvents는 잘못된 인증된 프로필로 인한 것입니다.

네임스페이스 우선 순위는 이벤트 조각이 기본 ID를 결정하는 방법에 중요한 역할을 합니다.

인증된 사용자 이벤트를 사용자 네임스페이스에 연결하려면 인증된 모든 이벤트에는 사용자 네임스페이스(CRMID)가 포함되어야 합니다. 즉, 사용자가 로그인한 후에도 인증된 모든 이벤트에 개인 네임스페이스가 계속 존재해야 합니다.

프로필 뷰어에서 프로필을 조회할 때 primary=true개의 '이벤트' 플래그가 계속 표시될 수 있습니다. 그러나 이 작업은 무시되며 프로필에서 사용되지 않습니다.

AAID는 기본적으로 차단됩니다. 따라서 Adobe Analytics 소스 커넥터를 사용하는 경우 인증되지 않은 이벤트가 ECID의 기본 ID를 갖도록 ECID가 ECID보다 높은 우선 순위를 갖도록 해야 합니다.

문제 해결 단계

내 경험 이벤트 조각이 프로필에 수집되지 않습니다. my-experience-event-fragments-are-not-getting-ingested-into-profile

다음을 포함하되 이에 국한되지 않는 다양한 이유로 경험 이벤트 조각이 프로필에 수집되지 않는 이유가 있습니다.

네임스페이스 우선 순위의 컨텍스트에서 프로필은 가장 높은 네임스페이스 우선 순위를 가진 두 개 이상의 ID가 포함된 모든 이벤트를 거부합니다. 예를 들어 GAID가 고유 네임스페이스로 표시되지 않고 GAID 네임스페이스와 다른 ID 값이 있는 두 개의 ID가 모두 들어 있는 경우 프로필은 이벤트를 저장하지 않습니다.

문제 해결 단계

데이터가 데이터 레이크로 전송되지만 프로필로 전송되지 않고 단일 이벤트에서 네임스페이스 우선 순위가 가장 높은 두 개 이상의 ID를 전송하기 때문이라고 생각되는 경우 다음 쿼리를 실행하여 동일한 네임스페이스에 대해 전송된 두 개의 다른 ID 값이 있는지 확인할 수 있습니다.

  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'

이 쿼리는 다음을 가정합니다.

그래프 동작 관련 문제 graph-behavior-related-issues

이 섹션에서는 ID 그래프의 작동 방식과 관련하여 발생할 수 있는 일반적인 문제에 대해 간략히 설명합니다.

인증되지 않은 ExperienceEvents가 잘못된 인증된 프로필에 첨부되고 있습니다.

ID 최적화 알고리즘에서 가장 최근에 설정된 링크를 적용하고 가장 오래된 링크를 제거합니다. 따라서 이 기능을 활성화하면 ECID가 한 개인에서 다른 개인으로 다시 할당(다시 연결)될 수 있습니다. 시간이 지남에 따라 ID가 연결되는 방식을 이해하려면 아래 단계를 따르십시오.

문제 해결 단계

먼저 다음 정보를 수집해야 합니다.

ID 기호(namespaceCode)는 대/소문자를 구분합니다. identityMap에서 주어진 데이터 세트에 대한 모든 ID 기호를 검색하려면 다음 쿼리를 실행합니다.

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

쿠키 식별자의 ID 값을 모를 때 여러 개인 식별자에 연결되었을 쿠키 ID를 검색하려는 경우 다음 쿼리를 실행해야 합니다. 이 쿼리는 ECID를 쿠키 네임스페이스로 가정하고 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에 연결된 쿠키 값을 식별했으므로 결과에서 쿠키 값을 가져와 다음 쿼리에서 사용하여 해당 쿠키 값이 다른 개인 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

ID 최적화 알고리즘이 예상대로 "작동" 중이 아닙니다.

문제 해결 단계

ID 최적화 알고리즘에 대한 설명서와 지원되는 그래프 구조 유형을 참조하십시오.

UI의 그래프 시뮬레이션 도구를 사용하여 이벤트를 시뮬레이션하고 고유한 네임스페이스와 네임스페이스 우선 순위 설정을 구성할 수도 있습니다. 이렇게 하면 ID 최적화 알고리즘이 어떻게 동작해야 하는지에 대한 기준선 이해를 돕는 데 도움이 될 수 있습니다.

시뮬레이션 결과가 그래프 동작 예상과 일치하면 ID 설정이 시뮬레이션에서 구성한 설정과 일치하는지 확인할 수 있습니다.

ID 설정을 구성한 후에도 샌드박스에 축소된 그래프가 표시됩니다

ID 그래프는 구성된 고유 네임스페이스와 네임스페이스 우선 순위 after ​를 준수합니다. 설정이 저장되었습니다. 새 설정을 저장하는 이전 ​에 존재하는 "축소된" 그래프는 축소된 그래프가 업데이트되도록 새 데이터가 수집될 때까지 영향을 받지 않습니다. 네임스페이스 우선 순위가 변경된 후에도 실시간 고객 프로필에 있는 이벤트 조각의 기본 ID는 업데이트되지 않습니다.

문제 해결 단계

ID 그래프 뷰어를 사용하여 그래프가 설정 전후에 수집되었는지 여부를 확인할 수 있습니다. ID 서비스에서 그래프를 수집한 시기를 확인하려면 링크 속성에서 마지막으로 업데이트된 타임스탬프를 검사하십시오. 타임스탬프가 구성 전이면 기능을 활성화하기 전에 "축소된" 그래프가 생성되었음을 나타냅니다.

내 샌드박스에 "축소된" 그래프가 몇 개 있는지 알고 싶습니다

ID 및 그래프 수 등 ID 그래프의 상태에 대한 통찰력에 ID 대시보드를 사용합니다. 축소된 그래프 수는 지표 "여러 네임스페이스가 있는 그래프 수"를 참조하십시오. 그래프는 동일한 네임스페이스를 가진 두 개 이상의 ID를 포함합니다. 샌드박스에 데이터가 없고 고유한 네임스페이스(예: CRMID)가 있다고 가정할 경우 두 개 이상의 CRMID가 있는 그래프가 0이어야 합니다. 아래 예에는 두 개 이상의 이메일 주소를 포함하는 두 개의 그래프가 있습니다.

아래 쿼리를 실행하여 데이터 레이크의 프로필 스냅숏 내보내기 데이터 세트에서 자세한 분류를 찾을 수 있습니다.

  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

프로필 스냅샷 내보내기 데이터 세트에서 다음 쿼리를 사용하여 "축소된" 그래프에서 샘플 ID를 얻을 수 있습니다.

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

자주 묻는 질문 faq

이 섹션에서는 Identity Graph Linking Rules에 대한 FAQ 응답 목록을 간략하게 설명합니다.

ID 최적화 알고리즘 identity-optimization-algorithm

ID 최적화 알고리즘에 대한 FAQ에 대한 답변을 보려면 이 섹션을 참조하십시오.

각 비즈니스 유니트에 대한 CRMID(B2C CRMID, B2B CRMID)가 있지만, 모든 프로필에 고유한 네임스페이스가 없습니다. B2C CRMID 및 B2B CRMID를 고유으로 표시하고 ID 설정을 활성화하면 어떻게 됩니까?

이 시나리오는 지원되지 않습니다. 따라서 사용자가 B2C CRMID를 사용하여 로그인하고 다른 사용자가 B2B CRMID를 사용하여 로그인하는 경우 그래프가 축소되는 것을 볼 수 있습니다. 자세한 내용은 구현 페이지의 단일 사용자 네임스페이스 요구 사항에 대한 섹션을 참조하십시오.

ID 최적화 알고리즘이 축소된 기존 그래프를 '수정'합니까?

축소된 기존 그래프는 새 설정을 저장한 후 이러한 그래프가 업데이트되는 경우에만 그래프 알고리즘의 영향을 받습니다('fixed').

동일한 디바이스를 사용하여 두 사람이 로그아웃하면 이벤트는 어떻게 됩니까? 모든 이벤트가 마지막으로 인증된 사용자에게 전송됩니까?

자세한 내용은 경험 이벤트에 대한 기본 ID 확인에 대한 안내서를 참조하십시오.

ECID가 한 개인에서 다른 개인으로 전송되는 경우 Adobe Journey Optimizer의 여정은 어떻게 영향을 받습니까?

마지막으로 인증된 사용자의 CRMID는 ECID(공유 장치)에 연결됩니다. ECID는 사용자 행동을 기반으로 한 개인에서 다른 개인으로 재할당할 수 있습니다. 영향은 여정이 구성되는 방식에 따라 다르므로, 고객은 개발 샌드박스 환경에서 여정을 테스트하여 동작을 확인하는 것이 중요합니다.

강조할 주요 사항은 다음과 같습니다.

네임스페이스 우선순위

네임스페이스 우선 순위에 대한 FAQ에 대한 답변은 이 섹션을 참조하십시오.

내 ID 설정을 활성화했습니다. 설정을 활성화한 후 사용자 지정 네임스페이스를 추가하려면 내 설정은 어떻게 됩니까?

네임스페이스에는 사람 네임스페이스와 장치/쿠키 네임스페이스의 두 가지 '버킷'이 있습니다. 새로 만든 사용자 지정 네임스페이스는 각 '버킷'에서 우선 순위가 가장 낮으므로 이 새 사용자 지정 네임스페이스가 기존 데이터 수집에 영향을 주지 않습니다.

실시간 고객 프로필이 identityMap에서 더 이상 '기본' 플래그를 사용하지 않는 경우 이 값을 계속 보내야 합니까?

예. identityMap의 '기본' 플래그를 다른 서비스에서 사용합니다. 자세한 내용은 다른 Experience Platform 서비스에 대한 네임스페이스 우선 순위의 의미에 대한 안내서를 참조하십시오.

실시간 고객 프로필의 프로필 레코드 데이터 세트에 네임스페이스 우선 순위가 적용됩니까?

아니요. 네임스페이스 우선 순위는 XDM ExperienceEvent 클래스를 사용하는 경험 이벤트 데이터 세트에만 적용됩니다.

이 기능은 그래프당 50개의 ID라는 ID 그래프 가드레일과 어떻게 연동됩니까? 네임스페이스 우선 순위가 이 시스템 정의 가드레일에 영향을 줍니까?

ID 최적화 알고리즘이 먼저 적용되어 개인 엔티티 표현을 보장합니다. 그런 다음 그래프가 ID 그래프 보호(그래프당 50ID)을(를) 초과하려고 하면 이 논리가 적용됩니다. 네임스페이스 우선 순위는 50 ID/그래프 가드레일의 삭제 논리에 영향을 주지 않습니다.

테스트

Identity Graph Linking Rules의 테스트 및 디버깅 기능에 대한 FAQ에 대한 답변을 보려면 이 섹션을 참조하십시오.

개발 샌드박스 환경에서 테스트해야 하는 시나리오 중 일부는 무엇입니까?

일반적으로 개발 샌드박스에서 테스트하는 것은 프로덕션 샌드박스에서 실행하려는 사용 사례를 모방해야 합니다. 포괄적인 테스트를 수행할 때 확인할 몇 가지 주요 영역에 대해서는 다음 표를 참조하십시오.

이 기능이 예상대로 작동하는지 확인하려면 어떻게 해야 합니까?

그래프 시뮬레이션 도구를 사용하여 기능이 개별 그래프 수준에서 작동하는지 확인하십시오.

샌드박스 수준에서 기능의 유효성을 검사하려면 ID 대시보드의 여러 네임스페이스에 대한 그래프 개수 섹션을 참조하십시오.