콘텐츠로 건너뛰기

데이터 유형

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

정의

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

중요 고려 사항

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

커스텀 속성 데이터 유형

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

동작 메뉴에서 커스텀 속성을 개별적으로 차단 목록에 추가하거나, 최대 100개의 속성을 선택해 일괄로 차단 목록에 추가할 수 있습니다. 커스텀 속성을 차단하면 해당 속성에 대한 데이터가 수집되지 않습니다. 기존 데이터는 다시 활성화하기 전까지 사용할 수 없으며, 차단 목록에 추가된 속성은 필터나 그래프에 표시되지 않습니다. 또한 해당 속성을 현재 Braze 대시보드의 다른 영역에서 필터나 트리거가 참조하고 있다면 경고 Modal이 표시됩니다. 이 Modal은 해당 속성을 참조하는 모든 필터 또는 트리거 인스턴스가 제거되고 보관된다는 사실을 알려줍니다.

개인 식별 정보(PII)로 표시

관리자는 이 페이지에서 커스텀 속성을 생성하고 PII로 표시할 수도 있습니다. 이러한 속성은 관리자와 “PII로 표시된 커스텀 속성 보기” 권한이 있는 대시보드 사용자에게만 표시됩니다.

설명 추가

Manage Events, Attributes, Purchases 사용자 권한이 있으면 커스텀 속성을 생성한 후 설명을 추가할 수 있습니다. 커스텀 속성을 편집하고 팀을 위한 메모 등 원하는 내용을 입력하세요.

태그 추가

“Manage Events, Attributes, Purchases” 사용자 권한이 있으면 커스텀 속성을 생성한 후 태그를 추가할 수 있습니다. 그런 다음 태그를 사용해 속성 목록을 필터링할 수 있습니다.

커스텀 속성 제거

고객 프로필에서 커스텀 속성을 제거하는 방법은 두 가지입니다.

null 값 설정

  • null은 고객 프로필에서 속성을 완전히 제거합니다. 속성이 프로필에 표시되지 않으며 IS NOT BLANK 필터와도 일치하지 않습니다.
  • ""는 속성을 빈 문자열 값으로 설정합니다. 속성은 프로필에 빈 문자열 값으로 표시되지만 IS NOT BLANK 필터와 일치하지 않습니다(빈 값으로 처리됩니다).

또한 ""는 문자열 유형 속성에만 유효합니다. 대시보드에서 속성의 데이터 유형이 문자열이 아닌 유형(부울, 숫자, 시간 등)으로 설정되어 있다면 ""를 보내도 값이 지워지지 않으므로 대신 null을 사용하세요.

데이터 내보내기

커스텀 속성 목록을 CSV 파일로 내보내려면 페이지 상단에서 Export all을 선택합니다. 시스템이 CSV 파일을 생성하고 다운로드 링크를 이메일로 보내드립니다.

사용 보고서 보기

사용 보고서에는 특정 커스텀 속성을 사용하는 모든 Canvases, Campaigns, Segments가 나열됩니다. 이 목록에는 Liquid에서의 사용은 포함되지 않습니다.

해당 커스텀 속성 옆의 체크박스를 선택한 다음 View usage report를 선택하면 한 번에 최대 100개의 사용 보고서를 볼 수 있습니다.

값 탭

사용 보고서를 볼 때 Values 탭을 선택하면 약 250,000명의 사용자 샘플을 기준으로 선택한 커스텀 속성의 상위 값을 확인할 수 있습니다. 결과는 일부 사용자에게서 샘플링되므로 샘플에 기존의 모든 값이 포함되지는 않습니다. 따라서 Values 탭은 문제 해결이나 전체 사용자의 데이터를 반영해야 하는 사용 사례에는 사용하지 않는 것이 좋습니다.

선택한 커스텀 속성의 사용 보고서에서 "Values" 탭이 열려 있고, "US", "PR" 등 국가 속성 값을 보여주는 원형 차트가 표시된 화면

커스텀 속성 설정

다음은 여러 플랫폼에서 커스텀 속성을 설정하는 데 사용하는 방법 목록입니다.

플랫폼별 설명서를 보려면 펼치세요

커스텀 속성 저장

커스텀 속성 데이터를 포함해 고객 프로필에 저장된 모든 데이터는 각 프로필이 활성 상태인 한 무기한 보관됩니다.

커스텀 속성 데이터 유형

커스텀 속성은 매우 유연한 도구로, 정교한 타겟팅을 가능하게 합니다.

다음 데이터 유형을 커스텀 속성으로 저장할 수 있습니다.

부울(true/false)

부울 속성은 가입 상태와 같은 사용자에 대한 간단한 이진 데이터를 저장하는 데 유용합니다. 변수가 명시적으로 true 또는 false 값으로 설정된 사용자는 물론, 해당 속성이 아직 기록되지 않은 사용자도 찾을 수 있습니다.

부울 속성에는 다음과 같은 세분화 옵션을 사용할 수 있습니다.

세분화 옵션 드롭다운 필터 입력 옵션 예시
부울 값이 true, false, true 또는 설정되지 않음, false 또는 설정되지 않음 중 하나인지 확인 IS TRUE, FALSE, TRUE OR NOT SET 또는 FALSE OR NOT SET 이 필터가 coffee_drinker를 지정하는 경우, 다음과 같은 상황에서 사용자가 이 필터와 일치합니다.
  • 이 필터가 true이고 사용자에게 coffee_drinker 값이 있는 경우
  • 이 필터가 false이고 사용자에게 coffee_drinker 값이 없는 경우
  • 이 필터가 true or not set이고 사용자에게 coffee_drinker 값이 있거나 값이 없는 경우
  • 이 필터가 false or not set이고 사용자에게 coffee_drinker나 어떤 값도 없는 경우
부울 값이 사용자 프로필에 존재하며 null이 아닌지 확인 IS NOT BLANK N/A 이 필터가 coffee_drinker를 지정하고 사용자에게 coffee_drinker 속성 값이 있으면 사용자가 이 필터와 일치합니다.
부울 값이 사용자 프로필에 존재하지 않거나 null인지 확인 IS BLANK N/A 이 필터가 coffee_drinker를 지정하고 사용자에게 coffee_drinker 속성이 없거나 coffee_drinker 값이 null이면 사용자가 이 필터와 일치합니다.

숫자 속성에는 다음과 같은 세분화 옵션을 사용할 수 있습니다.

세분화 옵션 드롭다운 필터 입력 옵션 예시
숫자 속성이 숫자와 정확히 같은지 확인 EXACTLY NUMBER 이 필터가 10을 지정하고 고객 프로필에 10 값이 있으면 사용자가 이 필터와 일치합니다.
숫자 속성이 숫자와 같지 않은지 확인 DOES NOT EQUAL NUMBER 이 필터가 10을 지정하고 고객 프로필에 10 값이 없으면 사용자가 이 필터와 일치합니다.
숫자 속성이 숫자보다 큰지 확인 MORE THAN NUMBER 이 필터가 10을 지정하고 고객 프로필에 10보다 큰 값이 있으면 사용자가 이 필터와 일치합니다.
숫자 속성이 숫자보다 작은지 확인 LESS THAN NUMBER 이 필터가 10을 지정하고 고객 프로필에 10보다 작은 값이 있으면 사용자가 이 필터와 일치합니다.
숫자 속성이 사용자 프로필에 존재하며 null이 아닌지 확인 IS NOT BLANK N/A 고객 프로필에 지정된 숫자 속성이 포함되어 있으면 값과 관계없이 사용자가 이 필터와 일치합니다.
숫자 속성이 사용자 프로필에 존재하지 않거나 null인지 확인 IS BLANK N/A 고객 프로필에 지정된 숫자 속성이 없거나 속성 값이 null이면 사용자가 이 필터와 일치합니다.

숫자 속성 세부 정보

  • “Exactly 0” 및 “Less Than” 필터에는 NULL 필드가 있는 사용자가 포함됩니다.
    • 커스텀 속성 값이 없는 사용자를 제외하려면 is not blank 필터를 함께 포함해야 합니다.

문자열 속성은 최대 255자까지 입력할 수 있습니다. 단어 사이, 앞 또는 뒤에 공백이 있는 값을 입력하면 Braze는 동일한 공백까지 확인합니다.

문자열 속성에는 다음과 같은 세분화 옵션을 사용할 수 있습니다.

세분화 옵션 드롭다운 필터 입력 옵션 예시
문자열 속성이 입력된 문자열 또는 정규표현식과 부분적으로 일치하는지 확인 MATCHES REGEX STRING OR REGULAR EXPRESSION
대소문자를 구분하지 않음, 최대 32,764자		  
문자열 속성이 입력된 문자열 또는 정규표현식과 부분적으로 일치하지 않는지 확인 DOES NOT MATCH REGEX * STRING OR REGULAR EXPRESSION
대소문자를 구분하지 않음, 최대 32,764자		  
문자열 속성이 사용자 프로필에 존재하며 빈 문자열이 아닌지 확인 IS NOT BLANK N/A 이 필터가 favorite_genre를 지정하고 고객 프로필에 favorite_genre 속성이 있으면 속성 값과 관계없이 사용자가 이 필터와 일치합니다. 예를 들어 사용자의 값이 sci-fi, romance 또는 다른 값일 수 있습니다.
문자열 속성이 사용자 프로필에 존재하지 않는지 확인 BLANK N/A 이 필터가 favorite_genre를 지정하고 고객 프로필에 favorite_genre 속성이 없으면 사용자가 이 필터와 일치합니다.
문자열이 입력된 문자열 중 하나라도 정확히 일치하는지 확인 IS ANY OF STRING
대소문자 구분, 여러 문자열 허용(최대 256개)		 이 필터가 book, bookmark, reading light를 지정하고 고객 프로필에 이 문자열 중 하나 이상이 있으면 사용자가 이 필터와 일치합니다.
문자열 속성이 입력된 문자열 중 어느 것과도 정확히 일치하지 않는지 확인 IS NONE OF STRING
대소문자 구분, 여러 문자열 허용(최대 256개)		 이 필터가 book, bookmark, reading light를 지정하고 고객 프로필에 이 문자열이 하나도 없으면 사용자가 이 필터와 일치합니다.
문자열 속성이 입력된 문자열 중 하나라도 부분적으로 일치하는지 확인 CONTAINS ANY OF STRING
대소문자 구분, 여러 문자열 허용(최대 256개)		 이 필터가 gold를 지정하고 고객 프로필의 문자열에 gold_tier나 former_gold_tier처럼 gold가 포함되어 있으면 사용자가 이 필터와 일치합니다.
문자열 속성이 입력된 문자열 중 어느 것과도 부분적으로 일치하지 않는지 확인 DOESN’T CONTAIN ANY OF STRING
대소문자 구분, 여러 문자열 허용(최대 256개)		 이 필터가 gold를 지정하고 고객 프로필의 어떤 문자열에도 gold가 포함되어 있지 않으면 사용자가 이 필터와 일치합니다.

배열

배열의 최대 크기는 100 KB입니다. 속성의 기본 길이는 최대 500개 항목입니다. 예를 들어 “Movies Watched”와 같은 속성을 500으로 설정해 보내는 경우, 사용자가 501번째 영화를 시청하면 첫 번째 영화가 제거되고 가장 최근 영화가 추가됩니다. 단어 사이, 앞 또는 뒤에 공백이 있는 값을 입력하면 Braze는 동일한 공백까지 확인합니다.

배열 유형 커스텀 속성은 CSV 가져오기로 가져올 수 없습니다. 배열 값을 업로드하려면 /users/track 엔드포인트 또는 클라우드 데이터 수집을 사용하세요.

문제 해결: 배열 커스텀 속성이 고객 프로필에 값을 표시하지 않음

배열 커스텀 속성이 고객 프로필에 표시되지만 값이 보이지 않는다면, 대시보드에서 해당 속성의 Max Length가 0으로 설정되어 있는지 확인하세요.

  1. Data Settings > Custom Attributes로 이동합니다.
  2. Array로 목록을 필터링합니다.
  3. 해당 속성을 찾아 Max Length를 확인합니다.
  4. Max Length가 0이면 0보다 큰 값으로 업데이트합니다.

Max Length를 0으로 설정하면 고객 프로필에 값이 표시되지 않습니다.

SDK 중심의 배열 동작 예시는 분석 개요를 참조하세요.

배열 속성에는 다음과 같은 세분화 옵션을 사용할 수 있습니다.

세분화 옵션 드롭다운 필터 입력 옵션 예시
배열 속성에 입력된 값과 정확히 일치하는 값이 포함되어 있는지 확인 INCLUDES VALUE STRING 이 필터가 sci-fi를 지정하고 고객 프로필에 sci-fi 값이 있으면 사용자가 이 필터와 일치합니다.
배열 속성에 입력된 값과 정확히 일치하는 값이 포함되어 있지 않은지 확인 DOESN’T INCLUDE VALUE STRING 이 필터가 sci-fi를 지정하고 고객 프로필에 sci-fi 값이 없으면 사용자가 이 필터와 일치합니다.
배열 속성에 입력된 값 또는 정규표현식과 부분적으로 일치하는 값이 포함되어 있는지 확인 MATCHES REGEX STRING OR REGULAR EXPRESSION
최대 32,764자		  
배열 속성에 값이 있거나 비어 있지 않은지 확인 HAS A VALUE N/A 이 필터가 favorite_genres를 지정하고 고객 프로필에 값이 있는 favorite_genres가 포함되어 있으면 사용자가 이 필터와 일치합니다.
배열 속성이 비어 있거나 존재하지 않는지 확인 IS EMPTY N/A 이 필터가 favorite_genres를 지정하고 고객 프로필에 favorite_genres가 없거나, favorite_genres는 있지만 값이 없으면 사용자가 이 필터와 일치합니다.
배열 속성에 입력된 값 중 하나라도 정확히 일치하는 값이 포함되어 있는지 확인 INCLUDES ANY OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 sci-fi, fantasy, romance를 지정하고 고객 프로필에 sci-fi, fantasy, romance가 어떤 조합으로든 있으면(예: sci-fi만 있는 경우 포함) 사용자가 이 필터와 일치합니다. sci-fi, fantasy, romance 중 하나라도 있다면 사용자의 문자열에 horror나 다른 값이 있어도 됩니다.
배열 속성에 입력된 값 중 어느 것과도 정확히 일치하는 값이 포함되어 있지 않은지 확인 INCLUDES NONE OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 sci-fi, fantasy, romance를 지정하고 고객 프로필에 sci-fi, fantasy, romance가 어떤 조합으로도 없으면 사용자가 이 필터와 일치합니다. sci-fi, fantasy, romance 중 어느 것도 없다면 사용자에게 horror나 다른 값이 있어도 됩니다.
배열 속성에 입력된 값 중 하나라도 부분적으로 일치하는 값이 포함되어 있는지 확인 VALUES CONTAIN ANY OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 gold를 지정하고 고객 프로필 배열의 문자열 중 하나 이상에 gold가 포함되어 있으면 사용자가 이 필터와 일치합니다. 여기에는 gold_tier, former_gold_tier 등의 문자열 값이 포함됩니다.
배열 속성에 입력된 값 중 어느 것과도 부분적으로 일치하는 값이 포함되어 있지 않은지 확인 VALUES DON’T CONTAIN ANY OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 gold를 지정하고 고객 프로필 배열의 어떤 문자열에도 gold가 포함되어 있지 않으면 사용자가 이 필터와 일치합니다. 즉, gold_tier, former_gold_tier 같은 문자열 값이 있는 사용자는 이 필터와 일치하지 않습니다.
배열 속성에 입력된 값이 모두 포함되어 있는지 확인 IS ALL OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 sci-fi, fantasy, romance를 지정하고 고객 프로필에 이 값이 모두 있으면 사용자가 이 필터와 일치합니다. 사용자에게 horror나 다른 값이 있어도 이 필터와 일치합니다.
배열 속성에 입력된 값이 모두 포함되어 있지는 않은지 확인 ISN’T ALL OF STRING
대소문자 구분, 여러 값 허용(최대 256개)		 이 필터가 sci-fi, fantasy, romance를 지정하고 고객 프로필에 이 값이 모두 있지는 않으면 사용자가 이 필터와 일치합니다.

시간 속성은 특정 동작이 마지막으로 수행된 시간을 저장하는 데 유용하므로, 사용자에게 콘텐츠별 재참여 메시징을 제공할 수 있습니다.

상대 날짜를 사용하는 시간 필터(예: 1일 이상 전, 2일 미만 전)는 1일을 24시간으로 측정합니다. 이러한 필터를 사용해 실행하는 모든 Campaign은 24시간 단위로 모든 사용자를 포함합니다. 예를 들어 last used app more than 1 day ago는 Campaign이 실행되는 정확한 시간을 기준으로 “앱을 마지막으로 사용한 지 24시간이 넘은” 모든 사용자를 포함합니다. 더 긴 날짜 범위로 설정된 Campaign도 마찬가지이므로, 활성화로부터 5일은 이전 120시간을 의미합니다.

시간 범위 안에 해당하는 시간 속성을 가진 사용자를 타겟팅하려면 두 개의 오디언스 필터를 사용하세요. 하한에는 in more than을, 상한에는 in less than을 사용합니다. 하나의 필터로는 범위의 양쪽을 모두 표현할 수 없습니다. 예를 들어 다음 24시간 이내(지금부터 하루 후까지)의 시간 속성을 가진 사용자를 타겟팅하려면 in more than 0 days와 in less than 1 day를 적용하세요.

시간 속성에는 다음과 같은 세분화 옵션을 사용할 수 있습니다.

세분화 옵션 드롭다운 필터 입력 옵션 예시
시간 속성이 선택한 날짜 이전인지 확인 BEFORE CALENDAR DATE SELECTOR 이 필터가 2024-01-31을 지정하고 고객 프로필의 날짜가 2024-1-31 이전이면 사용자가 이 필터와 일치합니다.
시간 속성이 선택한 날짜 이후인지 확인 AFTER CALENDAR DATE SELECTOR 이 필터가 2024-01-31을 지정하고 고객 프로필의 날짜가 2024-1-31 이후이면 사용자가 이 필터와 일치합니다.
시간 속성이 X일보다 더 이전인지 확인 MORE THAN NUMBER OF DAYS AGO 이 필터가 7을 지정하고 고객 프로필의 날짜가 7일보다 더 이전이면 사용자가 이 필터와 일치합니다.
시간 속성이 X일 이내의 과거인지 확인 LESS THAN NUMBER OF DAYS AGO 이 필터가 7을 지정하고 고객 프로필의 날짜가 7일 이내의 과거이면 사용자가 이 필터와 일치합니다.
시간 속성이 X일보다 더 먼 미래인지 확인 IN MORE THAN NUMBER OF DAYS IN FUTURE 이 필터가 7을 지정하고 고객 프로필의 날짜가 7일보다 더 먼 미래이면 사용자가 이 필터와 일치합니다.
시간 속성이 X일 이내의 미래인지 확인 IN LESS THAN NUMBER OF DAYS IN FUTURE 이 필터가 7을 지정하고 고객 프로필의 날짜가 7일 이내의 미래이면 사용자가 이 필터와 일치합니다.
시간 속성이 사용자 프로필에 존재하며 null이 아닌지 확인 IS NOT BLANK N/A 이 필터가 고객 프로필에 있는 시간 속성을 지정하면 사용자가 이 필터와 일치합니다.
시간 속성이 사용자 프로필에 존재하지 않거나 null인지 확인 IS BLANK N/A 이 필터가 고객 프로필에 없는 시간 속성을 지정하면 사용자가 이 필터와 일치합니다.

시간 속성 세부 정보

반복 이벤트 날짜 및 타임스탬프 오프셋

시간 커스텀 속성의 경우 Braze는 절대 타임스탬프를 저장하고, 이를 바탕으로 반복 이벤트 날짜(월과 일)를 도출합니다. 이 날짜는 “Day of Recurring Event” 필터와 중첩 커스텀 속성의 “day of year” 비교에 사용됩니다. 반복 이벤트 날짜는 속성이 설정될 때 타임스탬프의 UTC 오프셋 기준 달력 날짜로 계산됩니다.

오프셋이 반복 날짜 비교에 미치는 영향:

시간 속성을 설정하면 타임스탬프의 UTC 오프셋에 따라 저장되는 반복 이벤트 날짜가 결정됩니다. 같은 시점이라도 오프셋이 다르면 반복 날짜가 달라집니다.

  • 2026-10-13T00:09:49+09:00 → 10월 13일
  • 2026-10-12T15:09:49Z → 10월 12일

이 두 타임스탬프는 같은 시점을 나타내지만, 첫 번째는 +09:00 오프셋(JST)을 사용해 10월 13일로 저장되고, 두 번째는 UTC(Z)를 사용해 10월 12일로 저장됩니다. 회사 및 사용자 시간대 설정은 이렇게 저장된 반복 이벤트 날짜를 다시 계산하지 않습니다.

SDK 직렬화:

일부 SDK는 Date 객체를 Braze로 보내기 전에 UTC로 직렬화합니다. 예를 들어 Swift, 웹 또는 Android SDK에서 Date 객체를 사용해 시간 속성을 설정하면, SDK가 전송 전에 이를 UTC 타임스탬프로 변환합니다. 현지 시간이 JST 기준 00:00~08:59 사이라면 UTC 날짜는 하루 이전이 되며, 저장된 반복 이벤트 날짜는 사용자 현지 시간대의 전날과 일치합니다. 마찬가지로 현지 시간대가 UTC보다 늦은 경우(예: 미국 시간대) UTC 날짜가 현지 달력 날짜보다 하루 늦을 수 있으며, 저장된 반복 이벤트 날짜도 사용자의 현지 날짜보다 하루 늦어집니다.

의도한 현지 달력 날짜 유지하기:

반복 이벤트 날짜가 사용자의 현지 달력 날짜와 일치하도록 하려면 시간 속성을 Date 객체 대신 현지 오프셋이 포함된 문자열로 보내세요.




{
  "anniversary_date": "2026-10-13T00:00:00+09:00"
}

이렇게 하면 “Day of Recurring Event” 및 중첩 day-of-year 필터링에서 10월 13일이 반복 이벤트 날짜로 유지됩니다.

  • 반복 이벤트의 날짜
    • “반복 이벤트의 날짜” 필터를 사용할 때 “반복 이벤트의 캘린더 날짜”를 선택하라는 메시지가 표시되면, IS LESS THAN 또는 IS MORE THAN을 선택한 경우 현재 날짜가 해당 세분화 필터에 포함됩니다.
    • 예를 들어, 2020년 3월 10일에 속성 날짜를 LESS THAN ... March 10, 2020으로 선택한 경우, 2020년 3월 10일을 포함하여 그 이전 날짜의 속성이 고려됩니다.
  • X일 이내 과거: “X일 이내 과거” 필터는 X일 전부터 현재 날짜/시간 사이의 날짜를 포함합니다.
  • X일 이내 미래: 현재 날짜/시간부터 미래 X일 사이의 날짜를 포함합니다.

중첩 커스텀 속성을 사용해 객체를 커스텀 속성의 데이터 유형으로 보낼 수 있습니다. 자세한 내용은 중첩 커스텀 속성을 참조하세요.

객체 배열을 사용해 관련 속성을 그룹화할 수 있습니다. 자세한 내용은 객체 배열을 참조하세요.

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

통합 연산자

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

데이터 유형 이전 연산자 새 연산자 값
문자열 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(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 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"]

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

Braze 고객 참여 플랫폼 문서.

리소스
법적 고지
회사
© 2026 Braze, Inc. All rights reserved.
브레이즈 상태 확인
New Stuff!