설명서Experience Platform데이터 수집

getIdentity

Last update: Fri Apr 03 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자

sendEvent 명령을 실행하면 웹 SDK에서 방문자의 ID가 없는 경우 자동으로 해당 방문자의 ID를 가져옵니다. getIdentity 명령을 사용하면 이벤트 데이터를 보내지 않고 방문자 ID를 가져올 수 있습니다. 방문자 ID를 생성하고 데이터를 보내기 위해 별도의 호출이 필요한 경우 이 명령을 사용할 수 있습니다.

IMPORTANT
클라이언트측의 ID 정보가 필요한 경우 getIdentity을(를) 사용합니다. ECID를 XDM에 매핑하기만 하면 되는 경우에는 대신 데이터 수집을 위한 데이터 준비 또는 태그 ECID 액세스 지침을 사용하십시오.

getIdentity 명령은 다음 흐름을 통해 ECID을(를) 검색합니다.

  1. 웹 SDK을 사용하여 getIdentity 또는 appendIdentityToUrl을(를) 호출합니다.
  2. 웹 SDK은 동의 정보가 제공될 때까지 기다립니다.
  3. 웹 SDK에서 호출에 ECID 네임스페이스가 요청되었는지 확인합니다. 기본적으로 ECID 네임스페이스는 항상 포함됩니다.
  4. Web SDK은 kndctr 쿠키를 읽고 해당 값이 있는 경우 ECID(으)로 반환합니다. ECID 값만 반환하고 regionId은(는) 반환하지 않습니다.
  5. kndctr ID 쿠키가 설정되지 않았거나 "CORE" 네임스페이스가 요청되면 Web SDK에서 Edge Network에 요청합니다.
  6. Edge Network은 ECID 및 regionId을(를) 모두 반환합니다(필요한 경우 CORE ID).

웹 SDK의 구성된 인스턴스를 호출할 때 getIdentity 명령을 실행합니다. 이 명령을 구성할 때 사용할 수 있는 옵션은 다음과 같습니다.

  • namespaces: 네임스페이스의 배열입니다. 기본값은 ["ECID"]입니다. 기타 지원되는 값은 다음과 같습니다.

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

    "ECID"과(와) "CORE ID"을(를) 동시에 요청할 수 있습니다. 예: "namespaces": ["ECID","CORE"].

  • edgeConfigOverrides: 데이터 스트림 구성 재정의 개체입니다.

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

응답 개체

이 명령을 사용하여 응답을 처리하기로 결정하는 경우 응답 개체에서 다음 속성을 사용할 수 있습니다.

  • identity.ECID: 방문자의 ECID가 포함된 문자열입니다.
  • identity.CORE: 방문자의 코어 ID가 포함된 문자열입니다.
  • edge.regionID: ID를 가져올 때 브라우저가 히트한 Edge Network 영역을 나타내는 정수입니다. 기존 Audience Manager 위치 힌트와 동일합니다.
// Get the visitor's ECID
alloy('getIdentity').then(result => {
  console.log(result.identity.ECID);
});

웹 SDK 태그 확장을 사용하여 ID 가져오기

웹 SDK 태그 확장은 태그 확장 UI를 통해 이 명령을 제공하지 않습니다. JavaScript 라이브러리 구문을 사용하여 사용자 지정 코드 편집기를 사용합니다.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1