> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 유저 속성 관리

> 유저 속성을 미리 등록하고 속성별 암호화를 설정하는 방법을 안내합니다.

속성 관리에서 커스텀 유저 속성을 등록하고, 속성별로 암호화 여부를 설정할 수 있습니다. 이름이나 주소처럼 보호가 필요한 정보는 **데이터를 보내기 전에 속성을 등록하고 암호화를 설정**해 주세요. 암호화를 설정한 속성에 대해서는, DB 암호화와 더불어 값 자체가 암호화된 채로 저장되며, 메시지 내용에서는 복호화된 값을 개인화 변수로 사용합니다.

이 문서에서 안내하는 암호화 설정은 커스텀 유저 속성을 대상으로 합니다. 기본 필드인 이메일·전화번호는 암호화된 상태로 저장되며, 이 화면에서 암호화를 해제할 수 없습니다.

## 속성 등록하기

1. 노티플라이 콘솔에서 설정할 프로덕트와 환경을 선택합니다.
2. **유저 리스트**에서 **속성 관리**를 클릭합니다.
3. **속성 추가**를 클릭합니다.

![유저 속성 목록과 속성 추가 버튼](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/01-property-management.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=4c7e7430dc5b87c76175b04cbad0a66d)

4. 전송할 데이터와 동일한 **속성명**을 입력합니다. 예를 들어 배송지 주소를 `delivery_address`로 전달한다면 같은 이름으로 등록합니다.
5. 보호가 필요한 속성이면 **암호화**를 활성화한 뒤 **추가**를 클릭합니다.

![속성명 입력과 암호화 설정](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/02-property-registration.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=b11dfb92768d8caa9c824bfec57939e7)

속성을 등록해도 유저나 속성값이 생성되지는 않습니다. 실제 유저 데이터가 없어도 속성과 암호화 설정을 먼저 준비할 수 있습니다.

## 암호화 설정하기

### 활성화하기

1. 속성 관리에서 암호화할 속성의 스위치를 클릭합니다.
2. 유의사항과 수정이 필요한 캠페인·유저 여정을 확인합니다.
3. **암호화 켜기**를 클릭합니다.

> [!NOTE]
>
> 암호화 설정이 반영되기까지 최대 15분이 걸릴 수 있습니다.

### 캠페인·유저 여정 영향 확인하기

암호화를 활성화할 때 해당 속성을 사용하는 **활성 캠페인과 유저 여정의 조건**을 확인합니다. 암호화 속성에서 [지원하지 않는 조건](#발송-대상-조건)이 있으면 활성화할 수 없습니다.

확인 창에는 수정이 필요한 캠페인·유저 여정과 사용 중인 조건이 표시됩니다. 예를 들어 `address`에 **문자열 포함** 조건을 사용하고 있다면 해당 조건을 수정해야 합니다.

![암호화 활성화를 막는 캠페인과 유저 여정 조건](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/03-encryption-impact.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=b195f90163ea452273dbc69f7d0df717)

목록의 캠페인·유저 여정을 열어 조건을 수정한 뒤, 속성 관리로 돌아와 암호화를 다시 활성화해 주세요.

### 비활성화하기

1. 암호화된 속성의 스위치를 클릭합니다.
2. **암호화 비활성화 시 유의사항**을 확인합니다.
3. **암호화 끄기**를 클릭합니다.

![암호화 비활성화 유의사항과 확인 버튼](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/04-encryption-disable.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=08e5b6ca3e3ebb2d90cae9560f41cf6e)

> [!WARNING]
>
> 설정이 반영되면 기존 값도 콘솔에서 원문으로 조회되고 SDK에 전달될 수 있습니다. 이미 저장된 암호문을 일괄
> 복호화하지는 않습니다.

비활성화할 때는 캠페인·유저 여정의 조건을 검사하지 않습니다.

## 암호화 속성 사용하기

### 유저 정보 조회

암호화된 속성은 유저 정보 화면에서 값이 **마스킹**되고, 잠금 아이콘으로 표시됩니다. 암호화를 설정하지 않은 속성은 기존처럼 조회할 수 있습니다.

![유저 상세 화면에서 마스킹된 이름 속성](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/05-user-property-masking.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=74478a84ed43f362d27422e0a5eb645d)

### 발송 대상 조건

암호화된 속성은 다음 조건으로만 발송 대상을 설정할 수 있습니다.

* **일치**: 입력한 값과 같은 유저
* **불일치**: 입력한 값과 다른 유저
* **존재함**: 해당 속성에 값이 있는 유저
* **존재하지 않음**: 해당 속성에 값이 없는 유저

문자열 포함, 시작·끝 문자열, 크기 비교 등 이외의 조건은 미지원합니다.

![캠페인 발송 대상 설정에서 암호화 속성에 지원하는 조건
연산자](https://mintcdn.com/notifly/R1OpXpwGiNP1uJDu/images/user-guide/users/properties/06-encrypted-condition-operators.jpg?fit=max\&auto=format\&n=R1OpXpwGiNP1uJDu\&q=85\&s=4edcf1762e48e09a9405faa0371ae0f6)

### 메시지 개인화

암호화된 속성도 **메시지 개인화**에 계속 사용할 수 있습니다. 예를 들어 이름 속성을 암호화해도 이름을 포함한 메시지를 발송할 수 있습니다.

콘솔에서 값이 마스킹되는 것과 별개로, 개인화에 사용한 값은 실제 메시지에 포함됩니다. 수신자에게 표시해도 되는 정보인지 확인해 주세요.

설정 방법은 [메시지 개인화](https://docs.notifly.tech/ko/user-guide/campaigns/personalization/basic.md)를 참고해 주세요.

## 주요 제한

* **세그먼트 조건**: 암호화된 속성은 일치·불일치·존재함·존재하지 않음 조건만 지원합니다. 문자열 포함, 시작·끝 문자열, 크기 비교 등 이외의 조건은 미지원합니다. 메시지 개인화는 계속 사용할 수 있습니다.
* **설정 반영 시간**: 암호화 활성화·비활성화 설정이 반영되기까지 최대 15분이 걸릴 수 있습니다. 반영 전에는 기존 설정이 적용될 수 있습니다.
* **같은 세션에서 변경된 속성**: 암호화된 유저 속성이 변경되더라도 같은 세션에서 팝업 대상 여부가 즉시 갱신되지는 않습니다. 다음 유저 상태 조회 시 다시 판단합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.