데이터 수집에서 identityMap 사용

identityMap 페이로드 개체는 장치 수준 ECID을(를) 벗어난 방문자를 Edge Network에 알리는 방법입니다. 방문자가 로그인하거나, 구매를 완료하거나, 다른 방법으로 알려지면 ECID와 함께 개인 수준 식별자(CRM ID, 해시된 이메일, 로열티 ID 등)를 보낼 수 있습니다. 이러한 개인 수준 식별자는 다운스트림 서비스에 중요한 정보를 제공하여 다음과 같은 작업을 수행할 수 있도록 합니다.

이 페이지에서는 identityMap 페이로드를 만들고, 각 ID에 적합한 설정을 선택하고, 일반적인 구현 시나리오를 처리하는 방법을 다룹니다.

페이로드 구조 structure

identityMap은(는) 각 최상위 키가 네임스페이스이고 값이 ID 설명자의 배열인 JSON 개체입니다. 단일 페이로드에 하나 이상의 네임스페이스를 포함할 수 있으며 각 설명자에는 세 개의 필드(id, authenticatedState 및 primary)가 포함되어 있습니다.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

아래 섹션에서는 페이로드의 각 부분을 자세히 다룹니다.

네임스페이스 키 namespace-keys

identityMap의 각 최상위 키는 식별자 유형(예: , ​, CRMID 또는 Email)을 분류하는 문자열인 PhoneID 네임스페이스LoyaltyId입니다. 네임스페이스는 페이로드에서 참조하기 전에 ID 서비스에 있어야 합니다. 방문자에 대한 식별자가 두 개 이상 있는 경우 동일한 이벤트에 여러 네임스페이스 키를 포함할 수 있습니다.

ECID를 네임스페이스 키로 포함할 필요는 없습니다. Edge Network은 ID 페이로드에 ECID를 자동으로 추가합니다. ECID를 명시적으로 포함시키는 경우 개인 수준 ID도 있는 경우 primary(으)로 표시하지 마십시오.

id id

id 필드는 식별자 문자열 자체(이 ID가 나타내는 특정 개인 또는 장치를 Experience Platform에 알려 주는 값)입니다. 각 ID 네임스페이스에는 특정 값 형식이 필요한데 잘못된 형식의 값을 보내면 올바른 형식의 버전과 병합할 수 없는 고유한 ID가 만들어져 프로필이 조각화됩니다.

identityMap에 값을 포함하기 전에 대상 네임스페이스에서 예상하는 형식에 따라 값을 준비합니다.

표준 네임스페이스 및 해당 정의에 대한 전체 목록은 ID 네임스페이스 개요를 참조하십시오.

런타임에 id을(를) 수집하는 중 collect-id

필요한 식별자는 페이지에서 직접 사용할 수 있는 경우가 거의 없습니다. 일반적인 수집 전략은 다음과 같습니다.

authenticatedState authenticated-state

authenticatedState 필드는 다운스트림 서비스에 지정된 ID에 신뢰할 수 있는 정도를 알려줍니다. 이 필드에 유효한 값은 다음과 같습니다.

primary primary-identity

모든 identityMap 페이로드에는 primary: true(으)로 표시된 ID가 하나만 있어야 합니다. 기본 ID는 Experience Platform에서 이벤트의 앵커로 사용되는 ID를 결정합니다.

기본 ID를 설정할 때 다음 지침을 따르십시오.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

구현에서 identityMap 보내기 send-identity

alloy("sendEvent", {
  xdm: {
    identityMap: {
      CRMID: [
        {
          id: "abc-123-xyz",
          authenticatedState: "authenticated",
          primary: true
        }
      ]
    },
    eventType: "web.webpagedetails.pageViews"
  }
});

일반적인 시나리오 common-scenarios

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "loggedOut",
        "primary": false
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email_LC_SHA256": [
      {
        "id": "a1b2c3d4e5f6...",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ],
    "LoyaltyId": [
      {
        "id": "LOY-98765",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

identityMap이 ID 그래프에 미치는 영향 identity-graph

Experience Platform에 도달하는 모든 identityMap 페이로드는 ID 그래프에 보내는 ID를 연결하는 ID 서비스에 의해 처리됩니다. 포함하는 네임스페이스, authenticatedState을(를) 설정하는 방법 및 primary(으)로 표시하는 ID는 ID 서비스에서 해당 그래프를 작성하고 병합하는 방법을 직접 구성합니다.

알아야 할 주요 행동:

구현에서 ID 그래프 연결 규칙(예: 네임스페이스 우선 순위 또는 ID 최적화 알고리즘)을 사용하는 경우 구현 안내서를 검토하여 identityMap을(를) 통해 보내는 ID와 해당 규칙이 상호 작용하는 방법에 대해 알아보십시오.