Show Menu
화제×

ID 서비스 문제 해결 가이드

이 문서에서는 Adobe Experience Platform ID 서비스에 대한 FAQ와 일반적인 오류에 대한 문제 해결 안내서를 제공합니다. 플랫폼 API에 대한 일반적인 질문 및 문제 해결에 대해서는 Adobe Experience Platform API 문제 해결 안내서를 참조하십시오.
단일 고객을 식별하는 데이터는 브랜드에 참여하는 데 사용하는 다양한 디바이스와 시스템에서 단편화되어 있습니다. ID 서비스는 이러한 단편화된 ID를 취합하여 고객 행동에 대한 완벽한 이해를 제공함으로써 효과적인 디지털 경험을 실시간으로 제공할 수 있습니다. 자세한 내용은 ID 서비스 개요를 참조하십시오.

FAQ

다음은 ID 서비스에 대해 자주 묻는 질문에 대한 답변 목록입니다.

ID 데이터란?

ID 데이터는 개별 개인을 식별하는 데 사용할 수 있는 모든 데이터입니다. 조직 내에서 데이터가 사용되는 방법에 따라 ID 데이터에는 CRM 시스템의 사용자 이름, 이메일 주소 및 ID가 포함될 수 있습니다. 익명 사용자는 자신의 디바이스 또는 쿠키 ID로 식별할 수 있으므로 ID 데이터는 웹 사이트 또는 서비스의 등록된 사용자에게만 제한되지 않습니다.

데이터 필드를 ID로 레이블을 지정하면 어떤 이점이 있습니까?

특정 데이터 필드에 레코드 및 시간 시리즈 데이터의 ID로 레이블을 지정하면 데이터의 자연 구조 내에서 ID 관계를 매핑하고 중복 데이터 크로스 채널을 조정할 수 있습니다. 자세한 내용은 ID 서비스 개요를 참조하십시오.

알려진 신원 및 익명의 신원은 무엇입니까?

알려진 ID는 개인 식별, 연락처 또는 찾기를 위해 단독으로 또는 기타 정보와 함께 사용할 수 있는 ID 값을 나타냅니다. 알려진 ID의 예로는 이메일 주소, 전화 번호 및 CRM ID가 있습니다.
익명의 ID는 ​자체 또는 개별 사용자를 식별, 연락처 또는 찾기 위해 다른 정보와 함께 사용할 수 없는 ID 값을 나타냅니다.

개인 ID 그래프란?

개인 ID 그래프는 연결된 ID 간 관계를 나타내는 개인 맵으로, 조직에서만 볼 수 있습니다.
스트리밍 끝점에서 인제스트된 데이터에 두 개 이상의 ID가 포함되거나 ID 서비스에 대해 활성화된 데이터 세트로 전송되면 이러한 ID는 개인 ID 그래프에 연결됩니다. Identity Service는 이 그래프를 활용하여 특정 소비자 또는 엔티티에 대한 ID를 수집하여 ID 연결 및 프로필 병합을 허용합니다.

XDM 스키마 내에서 여러 ID 필드를 만들려면 어떻게 합니까?

XDM(Experience Data Model) 스키마는 여러 ID 필드를 지원합니다. XDM 개인 프로필 또는 XDM ExperienceEvent 클래스를 구현하는 스키마 string 내의 모든 유형의 데이터 필드는 ID 필드로 레이블이 지정될 수 있습니다. 레이블이 지정되면 이 필드에 포함된 모든 데이터가 프로필의 ID 맵에 추가됩니다.
사용자 인터페이스를 사용하여 XDM 필드에 ID 필드로 레이블을 지정하는 방법에 대한 자세한 내용은 스키마 편집기 자습서의 ID 섹션을 참조하십시오. API를 사용하는 경우 스키마 레지스트리 API 자습서의 ID 설명자 섹션을 참조하십시오.

일부 필드에 ID로 레이블을 지정하지 않아야 하는 컨텍스트가 있습니까?

ID 필드는 각 개인에 고유한 값에 대해 예약해야 합니다. 예를 들어 고객 충성도 프로그램의 데이터 세트를 고려하십시오. "충성도 수준" 필드(금, 은, 브론즈)는 유용한 ID 필드가 아니지만 고유한 값인 충성도 ID가 됩니다.
ZIP 코드 및 IP 주소와 같은 필드는 여러 개인 사용자에게 적용할 수 있으므로 개인의 ID로 레이블을 지정할 수 없습니다. 이러한 유형의 필드는 가정 수준 마케팅 전략의 ID로만 레이블이 지정되어야 합니다.

내 ID 필드가 예상한 대로 연결되지 않는 이유는 무엇입니까?

Identity Service API의 /cluster/members 사용하여 하나 이상의 ID 필드에 대해 연결된 ID를 볼 수 있습니다. 응답으로 예상한 연결된 ID가 반환되지 않는 경우 XDM 데이터에 적절한 ID 정보를 제공하는지 확인하십시오. 자세한 내용은 ID 서비스 개요에서 XDM 데이터를 ID 서비스에 제공하는 섹션을 참조하십시오.

ID 네임스페이스란 무엇입니까?

ID 네임스페이스는 ID 필드가 고객 ID와 어떻게 관련되는지 컨텍스트를 제공합니다. 예를 들어 "Email" 네임스페이스의 ID 필드는 표준 이메일 형식(name @emailprovider.com)을 준수해야 하지만 "Phone" 네임스페이스를 사용하는 필드는 표준 전화 번호(예: 북미)를 준수해야 합니다.
네임스페이스는 서로 다른 CRM 시스템 간에 유사한 ID 값을 구분합니다. 예를 들어, 회사의 보상 프로그램과 관련된 숫자 충성도 ID가 포함된 프로필을 고려해 보십시오. "충성도"의 네임스페이스는 이 값을 동일한 프로필에 표시되는 전자 상거래 시스템의 유사한 숫자 ID와 구분합니다.
자세한 내용은 ID 네임스페이스 개요를 참조하십시오.

ID를 ID 네임스페이스와 연결하려면 어떻게 해야 합니까?

ID 필드를 만들 때 기존 ID 네임스페이스와 연결해야 합니다. 새로운 네임스페이스는 API를 사용하여 만들어야 ID 필드에 연결할 수 있습니다.
API를 사용하여 ID 설명자를 만들 때 네임스페이스를 정의하는 단계별 지침을 보려면 스키마 레지스트리 개발자 안내서의 설명자 스키마 편집기를 사용하여 스키마 만들기 생성 섹션을 참조하십시오. UI에서 스키마 필드를 ID로 표시하려면 스키마 편집기 자습서의 단계를 따르십시오 .

Experience Platform에서 제공하는 표준 ID 네임스페이스는 무엇입니까?

Experience Platform 내의 모든 조직에서 사용할 수 있도록 다음과 같은 표준 네임스페이스가 제공됩니다.
표시 이름
ID
코드
설명
CORE
0
CORE
이전 이름:"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

조직에서 사용할 수 있는 ID 네임스페이스 목록은 어디에서 찾을 수 있습니까?

ID 서비스 API를 사용하여 /idnamespace/identities 종단점에 대한 GET 요청을 만들어 조직에 대해 사용 가능한 모든 ID 네임스페이스를 나열할 수 있습니다. 자세한 내용은 Identity Service API 개요에서 사용 가능한 네임스페이스 사용 가능한 네임스페이스 목록 나열을 참조하십시오.

조직의 사용자 정의 네임스페이스를 만들려면 어떻게 해야 합니까?

Identity Service API를 사용하여 /idnamespace/identities 종단점에 POST 요청을 작성하여 조직의 사용자 지정 ID 네임스페이스를 만들 수 있습니다. 자세한 내용은 ID 서비스 API 개요에서 사용자 정의 네임스페이스 사용자 정의 네임스페이스 만들기 만들기에 대한 섹션을 참조하십시오.

복합 ID와 XID란 무엇입니까?

ID 파섹 ID ID 값과 네임스페이스를 포함하는 ID를 나타냅니다. XID 복합 ID(ID 및 네임스페이스)와 동일한 구조를 나타내는 단일 값 식별자이며 Identity Service에서 지속되는 경우 새 ID에 자동으로 할당됩니다. 자세한 내용은 ID 서비스 API 개요를 참조하십시오.

ID 서비스는 PII(개인 식별 정보)를 어떻게 처리합니까?

ID 서비스는 값을 지속하기 전에 PII의 강력한 단방향 암호화 해시를 만듭니다. "Phone" 및 "Email" 네임스페이스의 ID 데이터는 SHA-256을 사용하여 자동으로 해시되고 "Email" 값은 해싱 전에 자동으로 소문자로 변환됩니다.

플랫폼으로 보내기 전에 모든 PII를 암호화해야 합니까?

PII 데이터를 플랫폼에 인제스트하기 전에 수동으로 암호화하지 않아도 됩니다. Platform은 데이터 I1 사용 레이블을 모든 해당 데이터 필드에 적용하여 이러한 필드를 통합 시 해시된 ID 값으로 자동으로 변환합니다.
데이터 사용 레이블을 적용하고 관리하는 방법에 대한 단계는 데이터 사용 레이블 자습서를 참조하십시오.

PII 기반 ID를 해싱할 때 고려해야 할 사항이 있습니까?

해시된 PII 값을 ID 서비스로 전송하는 경우 데이터 세트에서 동일한 암호화 방법을 사용해야 합니다. 이렇게 하면 데이터 세트에서 동일한 ID 값이 해시된 동일한 값을 생성하고 ID 그래프에서 제대로 일치시키고 연결할 수 있습니다.

문제 해결

다음 섹션에서는 Identity Service API를 사용하여 작업할 때 발생할 수 있는 특정 오류 코드 및 예기치 않은 동작에 대한 문제 해결 제안을 제공합니다.

ID 서비스 오류 메시지

다음은 Identity Service API를 사용할 때 발생할 수 있는 오류 메시지 목록입니다.

필수 쿼리 매개 변수가 없습니다.

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

이 오류는 필수 쿼리 매개 변수가 요청 경로에 포함되지 않았을 때 표시됩니다. 오류 detail 메시지의 경우 누락된 매개 변수의 이름을 제공합니다. 이 오류 메시지의 변형은 다음과 같습니다.
  • 필수 쿼리 매개 변수 누락 - nsId
  • 필수 쿼리 매개 변수 - id가 없습니다.
  • 필요한 쿼리 매개 변수 - xid 또는 (nsid,id)가 없습니다.
  • 필수 쿼리 매개 변수 누락 - targetNs
  • 필요한 쿼리 매개 변수 - xid 또는 compositeXids가 없습니다.
다시 시도하기 전에 요청 경로에 표시된 매개 변수를 올바르게 포함하는지 확인합니다.

타임스탬프는 마지막 180일 이내여야 합니다.

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

ID 서비스는 180일 이전의 데이터를 삭제합니다. 이 오류 메시지는 이보다 오래된 데이터에 액세스하려고 할 때 표시됩니다.

단일 호출에는 1000개의 XID로 제한됩니다.

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

이 오류 메시지는 단일 API 호출에서 허용되는 최대 XID 수 이상의 ID 정보를 검색하려고 할 때 표시됩니다. 이 문제를 해결하기 위해 요청의 XID 수를 표시된 제한 아래로 줄입니다.

단일 호출에서 1000개의 compositeXids에 대한 제한이 있습니다.

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

이 오류 메시지는 단일 API 호출에서 허용되는 최대 복합 ID 수 이상의 ID를 검색하려고 할 때 표시됩니다. 이 문제를 해결하려면 요청의 복합 ID 수를 표시된 제한 아래로 줄입니다.

지정된 그래프 유형이 잘못되었습니다.

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

이 오류 메시지는 graph-type 쿼리 매개 변수에 요청 경로에 잘못된 값이 주어지면 표시됩니다. 지원되는 그래프 유형을 알아보려면 ID 서비스 개요의 ID 그래프에 대한 섹션을 참조하십시오.

서비스 토큰의 범위가 잘못되었습니다.

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

이 오류 메시지는 IMS 조직이 ID 서비스에 대한 적절한 권한을 제공받지 않은 경우 표시됩니다. 이 문제를 해결하려면 시스템 관리자에게 문의하십시오.

게이트웨이 서비스 토큰이 잘못되었습니다.

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

이 오류의 경우 액세스 토큰이 잘못되었습니다. 액세스 토큰은 24시간마다 만료되며 플랫폼 API를 계속 사용하려면 다시 생성해야 합니다. 새 액세스 토큰을 생성하는 방법에 대한 지침은 인증 자습서를 참조하십시오.

인증 서비스 토큰이 잘못되었습니다.

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

이 오류의 경우 액세스 토큰이 잘못되었습니다. 액세스 토큰은 24시간마다 만료되며 플랫폼 API를 계속 사용하려면 다시 생성해야 합니다. 새 액세스 토큰을 생성하는 방법에 대한 지침은 인증 자습서를 참조하십시오.

사용자 토큰에 올바른 제품 컨텍스트가 없습니다.

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

이 오류 메시지는 액세스 토큰이 Experience Platform 통합에서 생성되지 않았을 때 표시됩니다. Experience Platform 통합을 위한 새로운 액세스 토큰을 생성하는 방법에 대한 지침은 인증 자습서를 참조하십시오.

ID 및 네임스페이스 코드에서 기본 XID를 가져오는 동안 내부 오류가 발생했습니다.

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

ID 서비스가 ID를 유지하면 ID의 ID 및 관련 네임스페이스 ID에 XID라는 고유 식별자가 할당됩니다. 이 메시지는 지정된 ID 값과 네임스페이스에 대한 XID를 찾는 동안 오류가 발생하면 표시됩니다.

IMS 조직이 ID 서비스 사용을 위해 제공되지 않습니다.

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

이 오류 메시지는 IMS 조직이 ID 서비스에 대한 적절한 권한을 제공받지 않은 경우 표시됩니다. 이 문제를 해결하려면 시스템 관리자에게 문의하십시오.

내부 서버 오류

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

이 오류는 플랫폼 서비스 호출 실행에서 예기치 않은 예외가 발생하는 경우에 표시됩니다. 이 오류를 수신할 때 자동 호출을 프로그래밍하여 요청을 시간 간격에 몇 번 다시 시도하는 것이 좋습니다. 문제가 계속되면 시스템 관리자에게 문의하십시오.

일괄 처리 통합 오류 코드

ID 서비스는 일괄 처리를 사용하여 플랫폼에 업로드된 레코드 및 시간 시리즈 데이터의 ID 데이터를 인제스트합니다. 일괄 인제스트는 비동기 프로세스이므로, 오류를 보려면 일괄 처리에 대한 세부 사항을 확인해야 합니다. 배치가 완료될 때까지 배치가 진행되면 오류가 누적됩니다.
다음은 데이터 통합 API를 사용할 때 발생할 수 있는 ID 서비스와 관련된 오류 메시지 목록입니다 .

알 수 없는 XDM 스키마

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

ID 서비스는 각각 Profile 또는 ExperienceEvent 클래스를 준수하는 레코드 또는 시간 시리즈 데이터에 대해 ID만 사용합니다. 두 클래스를 따르지 않는 ID 서비스에 대한 데이터를 인제스트하려고 하면 이 오류가 발생합니다.

처리된 일괄 처리의 처음 100개 행에 0개의 유효한 ID가 있습니다.

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

이 오류는 일괄 처리의 처음 100개 행에 ID가 표시되지 않을 때 표시됩니다. 하지만 이 오류는 후속 레코드에 ID가 없다는 것을 확실히 나타내지 않습니다.

XDM 레코드당 ID가 1개인 레코드를 건너뛰었습니다.

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

ID 서비스는 단일 레코드가 두 개 이상의 ID 값을 제공할 때 ID만 연결합니다. 이 오류 메시지는 인제스트된 각 일괄 처리에 대해 한 번 발생하고 ID가 하나만 찾을 수 있고 ID 그래프가 변경되지 않는 레코드 수를 표시합니다.

네임스페이스 코드가 이 IMS 조직에 등록되어 있지 않습니다.

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

이 오류는 인제스트된 레코드가 연결된 네임스페이스가 없거나 IMS 조직에서 액세스할 수 없는 ID를 표시할 때 표시됩니다.

IMS로 일괄 처리를 건너뜁니다. 조직이 개인 ID 그래프에 대해 제공되지 않습니다.

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

일괄 처리 데이터를 인제스트할 때 IMS가 ID 서비스에 대한 적절한 권한을 조직에 제공하지 않은 경우 이 오류 메시지가 표시됩니다. 이 문제를 해결하려면 시스템 관리자에게 문의하십시오.

내부 오류

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

이 오류는 일괄 처리 중 예기치 않은 예외가 발생할 때 표시됩니다. 이 오류를 수신할 때 자동 호출을 프로그래밍하여 요청을 시간 간격에 몇 번 다시 시도하는 것이 좋습니다. 문제가 계속되면 시스템 관리자에게 문의하십시오.