고객 프로필 속성

이 페이지는 Snowflake의 기본 속성 및 커스텀 속성 뷰에 대한 참조 문서입니다. 기본 속성에 대한 세 가지 뷰와 커스텀 속성에 대한 세 가지 뷰가 있으며, 각각 고유한 성능 고려 사항을 가진 특정 사용 사례를 위해 설계되었습니다.

대시보드와의 데이터 일치성

드문 경우이지만, 이 페이지의 Snowflake 뷰에 있는 기본 및 커스텀 속성 값이 Braze 대시보드의 고객 프로필에 표시되는 내용과 일치하지 않을 수 있습니다.

베타 기간 중에는 불일치가 발생할 수 있습니다. 예를 들어, Snowflake에서 속성이 NULL로 표시되지만 대시보드에서는 해당 사용자에 대한 값이 표시될 수 있습니다.

광범위한 불일치가 발견되면 고객 성공 매니저 또는 Braze 고객지원에 문의하세요.

사용 가능한 뷰

사용 가능한 뷰

유형	뷰	설명
기본 속성	USER_DEFAULT_ATTRIBUTES_VIEW_SHARED	고객 프로필 스냅샷
	USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED	실시간 고객 프로필
	USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED	이력 변경 로그
커스텀 속성	USER_CUSTOM_ATTRIBUTES_VIEW_SHARED	고객 프로필 스냅샷
	USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED	실시간 고객 프로필
	USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED	이력 변경 로그

고객 프로필 스냅샷

이 뷰는 고객 프로필 속성의 주기적인 스냅샷을 제공합니다. 데이터는 최대 12시간까지 지연되므로, 실시간 업데이트가 필요하지 않은 쿼리에 유용합니다.

• USER_DEFAULT_ATTRIBUTES_VIEW_SHARED
• USER_CUSTOM_ATTRIBUTES_VIEW_SHARED

사용법

• 최대 12시간 지연으로 사용자 속성의 스냅샷을 제공합니다.
• 실시간 정확성이 필요하지 않은 쿼리에 적합합니다.
• 특히 USER_ID 이외의 속성으로 필터링할 때 쿼리 실행 속도가 빠릅니다.
• 제한 사항: 데이터가 실시간으로 최신 상태가 아닙니다.

USER_DEFAULT_ATTRIBUTES_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
TIME_ZONE	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR

USER_CUSTOM_ATTRIBUTES_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES	VARIANT

실시간 고객 프로필 뷰

이 뷰는 고객 프로필 속성에 대한 거의 실시간 업데이트를 제공하며, Braze에서 업데이트가 발생한 후 최대 10분까지 데이터가 지연됩니다.

• USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED
• USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED

사용법

• 최소 지연(~10분)으로 최신 사용자 속성을 제공합니다.
• 실시간 분석 및 최근 데이터가 필요한 시나리오에 유용합니다.
• 성능 고려 사항:
  • 개별 사용자에 대한 쿼리는 더 빠릅니다(대형 웨어하우스 사용 시 1분 이내).
  • USER_ID 필터가 없는 쿼리는 모든 사용자에 대한 집계가 필요하므로 실행 시간이 크게 길어집니다.
  • 대규모 데이터셋(예: 1억 명 이상의 사용자)에 대한 쿼리는 수 분이 소요될 수 있습니다.

USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
APP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_LTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR
TIME_ZONE	VARCHAR

USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
APP_ID	VARCHAR
CUSTOM_ATTRIBUTES	OBJECT

이력 변경 로그

이 뷰는 사용자 속성의 이력 변경 로그를 저장하며, 12시간 단위로 변경 사항을 캡처합니다.

• USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED
• USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

사용법

• 롤링 6개월 기간 동안 사용자 속성의 이력 변경 기록을 제공합니다.
• 데이터는 12시간마다 스냅샷이 생성되므로, 이 기간 내의 여러 업데이트는 단일 레코드로 결합됩니다. 이 기간 내의 개별 변경 사항은 별도로 보존되지 않습니다.
• EFF_DT와 END_DT는 사용자 속성 상태의 시작과 끝을 나타냅니다.

USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
APP_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
EXTERNAL_ID	VARCHAR
FIRST_NAME	VARCHAR
LAST_NAME	VARCHAR
EMAIL	VARCHAR
GENDER	VARCHAR
PHONE	VARCHAR
DOB	VARCHAR
TIME_ZONE	VARCHAR
HOME_CITY	VARCHAR
COUNTRY	VARCHAR
LANGUAGE	VARCHAR
EFF_DT	TIMESTAMP_NTZ
END_DT	TIMESTAMP_NTZ

USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED 스키마

컬럼 이름	데이터 유형
APP_GROUP_ID	VARCHAR
USER_ID	VARCHAR
APP_ID	VARCHAR
TIME	NUMBER
UPDATE_SOURCE	VARCHAR
SF_UPDATED_AT	TIMESTAMP_NTZ
CUSTOM_ATTRIBUTES	VARIANT
EFF_DT	TIMESTAMP_NTZ
END_DT	TIMESTAMP_NTZ

모범 사례

권장 쿼리 사용법

사용 사례	권장 뷰	참고
최근 업데이트가 필요하지 않은 일반 쿼리	USER_DEFAULT_ATTRIBUTES_VIEW_SHARED 및 USER_CUSTOM_ATTRIBUTES_VIEW_SHARED	빠른 실행, 최대 12시간 전 데이터.
최신 사용자 속성이 필요한 쿼리	USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED 및 USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED	거의 실시간 업데이트를 제공하지만 대규모 데이터셋에서는 느릴 수 있습니다.
속성 변경의 이력 추적	USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED 및 USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED	12시간 단위로 속성 변경 사항을 저장합니다.

성능 고려 사항

• USER_DEFAULT_ATTRIBUTES_VIEW_SHARED 또는 USER_CUSTOM_ATTRIBUTES_VIEW_SHARED에 대한 쿼리는 대형 웨어하우스에서 대규모 데이터셋(~10억 명의 사용자)에 대해 10초 이내에 반환되어야 합니다.
• USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED 또는 USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED 에 대한 단일 사용자 쿼리는 1분 이내에 반환되지만, USER_ID 필터링 없이는 성능이 크게 저하됩니다.
• USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHARED 또는 USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED에서 1억 명 이상의 사용자에 대한 쿼리는 사용자별 집계로 인해 수 분이 소요될 수 있습니다.