고객 ID 및 인증 상태 customer-ids-and-authentication-states
Experience Cloud 방문자 ID와 함께 추가 고객 ID 및 인증 상태와 각 방문자를 연결할 수 있습니다.
인증 상태 section-68ad4065dfaa437d9070832d6e2bf85c
setCustomerIDs 메서드는 동일한 방문자의 여러 고객 ID를 수락합니다. 따라서 여러 다른 디바이스에서 개별 사용자를 식별하고 타기팅하는 데 도움이 됩니다. 예를 들어 이러한 ID를 고객 속성으로 Experience Cloud에 업로드하고 다른 솔루션에 있는 이 데이터에 액세스할 수 있습니다.
setCustomerIDs (고객 ID 동기화)는 고객 특성 및 핵심 서비스 기능에 필요합니다. 고객 ID 동기화는 Analytics의 선택적 식별 방법입니다. Target의 경우 고객 특성이 작동하려면 Visitor.AuthState.AUTHENTICATED가 필요합니다. 예제에 대해서는 핵심 서비스 - 솔루션을 사용하도록 설정하는 방법을 참조하십시오.Experience Cloud ID 서비스 v1.5 이상부터 setCustomerIDs에 선택적 AuthState 오브젝트가 있습니다. AuthState는 인증 상태(예: 로그인함 또는 로그아웃함)에 따라 방문자를 식별합니다. 표에 나열된 상태 값으로 인증 상태를 설정합니다. 인증 상태가 정수로 반환됩니다.
알 수 없음 또는 인증되지 않음.
AuthState가 방문자 ID와 함께 사용되지 않거나 각 페이지 또는 앱 컨텍스트에서 명시적으로 설정되지 않으면 기본적으로 알 수 없음이 적용됩니다.
특정 인스턴스, 페이지 또는 앱에 대해 인증됨
주의: 제대로 작동하기 위해서는 Target의 고객 속성에 이 상태가 필요합니다.
인증 상태에 대한 사용 사례 section-fe9560cc490943b29dac2c4fb6efd72c
사용자가 웹 속성에서 수행하는 작업과 인증 여부에 따라 사용자에게 인증 상태를 할당할 수 있습니다. 아래 표에서 몇 가지 예를 참조하십시오.
이 상태는 다음과 같은 시나리오에 사용할 수 있습니다.
- 이메일을 읽기(이 작업은 독자가 의도한 수신자이지만 이메일을 전송할 수도 있음을 의미함)
- 이메일에서 랜딩 페이지로 클릭스루
고객 ID 및 인증 상태 설정 section-ec4b367d16ad4ac1a1baca9b01f4ee98
고객 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 및 인증 상태 반환 section-71a610546188478fa9a3185a01d6e83b
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 지원 section-861c6b3b1ba645dda133dccb22ec7bb0
Experience Cloud ID 서비스는 Android 및 iOS SDK 코드에서 고객 ID와 인증 상태를 지원합니다. 다음 코드 라이브러리를 참조하십시오.
Analytics 및 Audience Manager 고객을 위한 알림 section-3a8e9d51e71c4c6e865184b81ed9d99b
선언된 ID를 Audience Manager에 전달하는 경우 userid 오브젝트가 데이터 소스와 연결된 통합 코드와 일치해야 합니다. 자세한 내용은 병합 규칙 코드 구성 설명서의 방문자 ID 서비스 섹션을 참조하십시오.