데이터 유형

이 페이지에서는 커스텀 속성, 이벤트 속성정보, 카탈로그에 지원되는 데이터 유형을 통합하여 설명합니다. 각 커스텀 데이터 유형은 지원하는 데이터 유형과 제약 조건이 약간씩 다릅니다.

정의

이 표를 참고하여 고객 프로필 속성, 이벤트 데이터 또는 카탈로그 항목에 사용할 수 있는 데이터 유형을 확인하세요. 각 유형의 사용법과 제약 조건은 이어지는 섹션을 참조하세요.

데이터 유형	정의	커스텀 속성	이벤트 속성정보	카탈로그
부울	값 true 또는 false	✅ 지원됨	✅ 지원됨	✅ 지원됨
숫자	정수 또는 소수	✅ 지원됨	✅ 지원됨	✅ 지원됨
문자열	텍스트; 255자 이하	✅ 지원됨	✅ 지원됨	✅ 지원됨
시간	표준 형식의 날짜 및 시간(ISO 8601)	✅ 지원됨	✅ 지원됨	✅ 지원됨
배열	정렬된 값 목록	✅ 지원됨	✅ 지원됨	✅ 지원됨
오브젝트	명명된 필드가 있는 구조화된 데이터(중첩 키-값)	✅ 지원됨	✅ 지원됨	✅ 지원됨
오브젝트 배열	오브젝트 목록	✅ 지원됨	❌ 지원되지 않음	❌ 지원되지 않음

중요 고려 사항

• 배열: 커스텀 속성과 이벤트 속성정보에는 크기 제한이 있습니다. 이벤트 속성정보의 배열 내에서는 날짜/시간이 지원되지 않습니다. 카탈로그는 문자열 배열만 지원하며, 최대 100개의 요소를 포함할 수 있습니다.
• 오브젝트: Braze에서 이 유형은 커스텀 속성의 경우 “중첩 커스텀 속성”, 이벤트 속성정보의 경우 “중첩 오브젝트”, 카탈로그의 경우 “JSON 오브젝트”로 표시됩니다.
• 시간: 이벤트 속성정보에서 이 유형은 “Datetime”으로 표시됩니다.

커스텀 속성 데이터 유형

커스텀 속성은 정의 표에 나열된 데이터 유형을 지원합니다. 다음은 지원되는 각 데이터 유형의 사용법과 세분화에 대한 설명입니다.

• 부울
• 숫자
• 문자열
• 배열
• 시간
• 오브젝트
• 오브젝트 배열

커스텀 속성의 데이터 유형을 변경할 수 있지만, 그 영향에 대해 알고 있어야 합니다. 자세한 내용은 커스텀 속성 또는 이벤트 데이터 유형 변경을 참조하세요.

통합 연산자

속성 필터, 커스텀 속성 필터 및 중첩 커스텀 속성 필터에서 사용할 수 있는 연산자 목록을 통합했습니다. 이러한 연산자를 사용하는 기존 필터가 있는 경우 자동으로 새 연산자를 사용하도록 업데이트됩니다.

데이터 유형	이전 연산자	새 연산자	값
문자열	equals	is any of	1개 이상의 값
문자열	does not equal	is none of	1개 이상의 값
배열	includes value	includes any of	1개 이상의 값
배열	doesn’t include value	includes none of	1개 이상의 값

이벤트 속성정보 데이터 유형

이벤트를 기록할 때 추가 정보(예: 제품 이름 또는 가격)를 이벤트 속성정보로 첨부할 수 있습니다. 각 속성정보에는 이름과 값이 있습니다. 이벤트 속성정보 값은 정의 표의 데이터 유형을 지원합니다(이벤트 속성정보에서 시간은 “Datetime”으로 표시됩니다).

예상 형식

속성정보 값은 오브젝트로 전송됩니다: 키는 속성정보 이름이고, 값은 속성정보 값입니다. 속성정보 이름은 비어 있지 않은 문자열이어야 하며, 255자 이하이고, 앞에 달러 기호($)가 없어야 합니다.

이벤트 속성정보 관련 규칙:

• 시간(Datetime): ISO 8601 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식을 사용합니다. 배열 내에서는 지원되지 않습니다.
• 배열: 배열 내에서는 날짜/시간이 지원되지 않습니다.
• 중첩 오브젝트: 중첩 오브젝트를 참조하세요.
• 페이로드: 배열 또는 오브젝트 값을 포함하는 이벤트 속성정보 오브젝트는 최대 102,400바이트(100 KiB)까지 가능합니다.

커스텀 이벤트 속성정보의 데이터 유형을 변경할 수 있지만, 데이터가 수집된 후 데이터 유형을 변경하는 것의 영향을 인지해야 합니다.

이벤트 속성정보의 전체 동작, 예약 키, 트리거 및 개인화에서의 사용에 대해서는 커스텀 이벤트 속성정보를 참조하세요.

구매 이벤트 및 매출

구매 및 매출 데이터는 구매 이벤트 또는 권장 이커머스 이벤트를 통해 기록됩니다.

구매 이벤트를 기록하면 각 고객 프로필에 대한 생애주기 가치(LTV)가 설정되며, 이 데이터는 매출 페이지에서 시계열로 확인할 수 있습니다. 지출 금액, 마지막 구매 날짜, 기간 내 구매 횟수 등으로 세분화할 수 있습니다.

구매 이벤트 속성정보 데이터 유형

구매 이벤트 속성정보 값(구매의 properties 오브젝트)은 정의 표의 데이터 유형을 지원하며, 이벤트 속성정보와 동일한 구조 및 명명 규칙을 따릅니다.

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

Data type	Description
Number	Integer or float
Boolean	Value true or false
Datetime	String in ISO 8601 or yyyy-MM-dd'T'HH:mm:ss:SSSZ format. Not supported within arrays.
String	255 characters or fewer
Array	Supported; datetimes are not supported within arrays.
Object	Ingested as strings (not nested objects). For nested data, use a string value (for example, JSON serialized).

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

전체 구매 오브젝트 스키마 및 예시는 구매 오브젝트를 참조하세요. 구매 이벤트 기록, 세분화 필터 및 전체 세부 정보는 구매 이벤트를 참조하세요.

커스텀 속성 또는 이벤트 데이터 유형 변경

커스텀 속성 또는 이벤트의 데이터 유형을 변경하려면:

1. Data Settings로 이동하여 Custom Attributes 또는 Custom Events를 선택합니다.
2. 목록에서 속성 또는 이벤트를 찾고 More actions를 선택합니다.
3. 드롭다운에서 새 Data type을 선택합니다.
4. Save를 선택합니다.

커스텀 속성 또는 이벤트의 데이터 유형을 변경하는 경우(예: time을 string으로 변경), 다음 사항을 고려하세요:

• 필터가 자동으로 업데이트되지 않습니다. 변경된 속성 또는 이벤트를 사용하는 Segments, Campaigns, Canvases 또는 기타 위치는 업데이트되지 않습니다. 데이터 유형을 변경하기 전에 Segments 또는 필터에서 해당 속성을 사용하는 Campaigns이나 Canvases를 중지하고, 해당 속성을 참조하는 필터에서 속성을 제거하세요.
• 기존 사용자 데이터는 소급 업데이트되지 않습니다. 변경 전에 고객 프로필에 변경된 속성이 있었다면, 해당 값은 이전 데이터 유형으로 유지됩니다. 필터가 새 데이터 유형을 찾기 때문에 사용자가 변경된 속성을 포함하는 Segment에서 빠질 수 있습니다. 해당 고객 프로필을 업데이트하여(예: /users/track 엔드포인트 사용) 새 유형과 일치하도록 하고 필요한 경우 Segment에 다시 포함되도록 하세요.
• 새 데이터는 새 유형과 일치해야 합니다. 변경된 속성에 대해 이전 데이터 유형을 전송하는 API 호출은 수락되지 않습니다. 새 데이터 유형을 전송하세요.

카탈로그 데이터 유형

카탈로그는 정의 표에 나열된 유형을 지원합니다. 다음 표에는 각 유형, 생성 또는 업데이트 방법, 형식 및 예시가 나와 있습니다.

데이터 유형	설명	CSV 업로드로 사용 가능	API 및 CDI로 사용 가능
문자열	문자 시퀀스(예: 이름, 설명, ID).	✅ 예	✅ 예
숫자	정수 또는 플로트 숫자 값(예: 가격, 수량, 평점).	✅ 예	✅ 예
부울	true 또는 false 값.	✅ 예	✅ 예
시간	ISO 8601 형식 또는 초 단위 Unix 타임스탬프의 날짜 및 시간.	✅ 예	✅ 예
JSON 오브젝트(오브젝트)	키-값 페어가 있는 중첩 오브젝트. 플랫폼에 표시되지만 API 또는 CDI를 통해서만 생성하거나 업데이트할 수 있습니다.	❌ 아니요	✅ 예
문자열 배열(배열)	문자열 목록. 플랫폼에 표시되지만 API 또는 CDI를 통해서만 생성하거나 업데이트할 수 있습니다. 최대 100개 요소.	❌ 아니요	✅ 예

형식 및 예시

데이터 유형	형식	예시
문자열	텍스트	"Hello World"
시간	ISO 8601 또는 Unix 타임스탬프(초)	"2024-03-15T14:30:00Z"
부울	true 또는 false	true
숫자	정수 또는 소수	42 또는 19.99
오브젝트	JSON 오브젝트	{"key": "value", "price": 10}
배열	문자열 배열	["red", "blue", "green"]

카탈로그 생성 및 업데이트에 대해서는 카탈로그 생성을 참조하세요.