고객 ID 및 인증 상태

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

인증 상태

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

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

인증 상태에 대한 사용 사례

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

고객 ID 및 인증 상태 설정

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

// 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와 인증 상태를 지원합니다. 다음 코드 라이브러리를 참조하십시오.

• Android SDK 메서드
• iOS SDK 메서드

Analytics 및 Audience Manager 고객을 위한 알림

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