고객 ID 및 인증 상태

Experience Cloud 방문자 ID와 함께 추가 고객 ID 및 인증 상태와 각 방문자를 연결할 수 있습니다.

인증 상태

setCustomerIDs 메서드는 동일한 방문자의 여러 고객 ID를 수락합니다. 따라서 여러 다른 디바이스에서 개별 사용자를 식별하고 타기팅하는 데 도움이 됩니다. 예를 들어 이러한 ID를 고객 속성으로 Experience Cloud에 업로드하고 다른 솔루션에 있는 이 데이터에 액세스할 수 있습니다.

중요

setCustomerIDs (고객 ID 동기화)는 고객 특성 및 핵심 서비스 기능에 필요합니다. 고객 ID 동기화는 Analytics의 선택적 식별 방법입니다. Target의 경우 고객 특성이 작동하려면 Visitor.AuthState.AUTHENTICATED가 필요합니다. 예제에 대해서는 핵심 서비스 - 솔루션을 사용하도록 설정하는 방법을 참조하십시오.

Experience Cloud ID 서비스 v1.5 이상부터 setCustomerIDs에 선택적 AuthState 오브젝트가 있습니다. AuthState는 인증 상태(예: 로그인함 또는 로그아웃함)에 따라 방문자를 식별합니다. 표에 나열된 상태 값으로 인증 상태를 설정합니다. 인증 상태가 정수로 반환됩니다.

인증 상태 상태 정수 사용자 상태

Visitor.AuthState.UNKNOWN

0

알 수 없음 또는 인증되지 않음.

AuthState가 방문자 ID와 함께 사용되지 않거나 각 페이지 또는 앱 컨텍스트에서 명시적으로 설정되지 않으면 기본적으로 알 수 없음이 적용됩니다.

Visitor.AuthState.AUTHENTICATED

1

특정 인스턴스, 페이지 또는 앱에 대해 인증됨

주의: 제대로 작동하기 위해서는 Target의 고객 속성에 이 상태가 필요합니다.

Visitor.AuthState.LOGGED_OUT

2

로그아웃됨.

인증 상태에 대한 사용 사례

사용자가 웹 속성에서 수행하는 작업과 인증 여부에 따라 사용자에게 인증 상태를 할당할 수 있습니다. 아래 표에서 몇 가지 예를 참조하십시오.

인증 상태 사용 사례

Visitor.AuthState.UNKNOWN

이 상태는 다음과 같은 시나리오에 사용할 수 있습니다.

  • 이메일을 읽기(이 작업은 독자가 의도한 수신자이지만 이메일을 전송할 수도 있음을 의미함)
  • 이메일에서 랜딩 페이지로 클릭스루

Visitor.AuthState.AUTHENTICATED

사용자는 현재 웹 사이트 또는 앱에서 활성 세션으로 인증됩니다.

Visitor.AuthState.LOGGED_OUT

사용자가 인증되었지만 현재 로그아웃되었습니다. 사용자가 인증된 상태에서 연결을 끊고자 했습니다. 사용자가 더 이상 인증된 것으로 취급되고 싶어하지 않습니다.

고객 ID 및 인증 상태 설정

고객 ID는 다음 예제에 표시된 것처럼 ID 및 인증된 상태 조합이 포함될 수 있습니다.

중요
  • ID는 대소문자를 구분합니다.
  • ID에 대해 인코딩이 해제된 값만 사용하십시오.
  • 고객 ID 및 인증 상태는 방문자 ID 쿠키에 저장되지 않습니다. 모든 페이지 또는 애플리케이션 컨텍스트에 대해 설정되어야 합니다.
  • 고객 ID에는 PII(개인 식별 정보)를 포함시켜서는 안 됩니다. PII를 사용하여 방문자(예를 들어 이메일 주소)를 식별하는 경우 대신 이 정보의 해시 버전 또는 암호화 버전을 저장하는 것이 좋습니다. ECID 라이브러리는 사용자 ID 해시를 지원합니다. setCustomerIDs에 대한 SHA256 해시 지원을 참조하십시오.
// Single ID with a single authentication state
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    }
});

/*
Multiple IDs with only the first ID explicitly assigned an authentication state.
The second ID is not explicitly assigned an authentication state and is implicitly
assigned Visitor.AuthState.Unknown by default.
*/
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":"550e8400-e29b-41d4-a716-446655440000"
});

// Multiple IDs with identical authentication states
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":Visitor.AuthState.AUTHENTICATED
    }
});

// Multiple IDs with different authentication states
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":Visitor.AuthState.LOGGED_OUT
    }
});

고객 ID 및 인증 상태 반환

getCustomerIDs를 사용하여 고객 ID 및 관련 인증 상태를 반환합니다. 이 메서드는 방문자의 인증 상태를 정수로 반환합니다.

구문

getCustomerIDs는 다음 구문을 사용하여 데이터를 반환합니다.

{
    [customerIDType1]:{
        "id":[customerID1],
        "authState":[authState1]
    },
    [customerIDType2]:{
        "id":[customerID2],
        "authState":[authState2]
    }
    ...
}

반환된 고객 ID 및 인증 상태 데이터는 다음 예와 유사해야 합니다.

Object customerIDs = visitor.getCustomerIDs();

// No setCustomerIDs call on this instance
{}

// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456"}}
{
    "userid":{
        "id":"67312378756723456",
        "authState":0
    }
}

// setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456","authState":Visitor.AuthState.AUTHENTICATED}}
{
    "userid":{
        "id":"67312378756723456",
        "authState":1
    }
}

// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT}}
{
    "userid":{
        "authState":2
    }
}

// setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT},"dpuuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}}
{
    "userid":{
        "authState":2
    },
    "dpuuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":0
    }
 }

SDK 지원

Experience Cloud ID 서비스는 Android 및 iOS SDK 코드에서 고객 ID와 인증 상태를 지원합니다. 다음 코드 라이브러리를 참조하십시오.

Analytics 및 Audience Manager 고객을 위한 알림

선언된 ID를 Audience Manager에 전달하는 경우 userid 오브젝트가 데이터 소스와 연결된 통합 코드와 일치해야 합니다. 자세한 내용은 병합 규칙 코드 구성 설명서의 방문자 ID 서비스 섹션을 참조하십시오.

이 페이지에서는