Skip to content

고객 프로필 속성

이 페이지는 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 Braze 워크스페이스 식별자
APP_ID VARCHAR 워크스페이스 내의 특정 앱
USER_ID VARCHAR 고유 Braze 사용자 식별자
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
SF_UPDATED_AT TIMESTAMP_NTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
FIRST_NAME VARCHAR 사용자의 이름
LAST_NAME VARCHAR 사용자의 성
EMAIL_ADDRESS VARCHAR 사용자의 이메일 주소
GENDER VARCHAR 사용자의 성별
PHONE_NUMBER VARCHAR 사용자의 전화번호
DOB VARCHAR 사용자의 생년월일
TIME_ZONE VARCHAR 사용자의 시간대
HOME_CITY VARCHAR 사용자의 거주 도시
COUNTRY VARCHAR 사용자의 국가
LANGUAGE VARCHAR 사용자의 언어 설정
ARCHIVED BOOLEAN 고객 프로필이 보관 처리되었는지 여부

USER_CUSTOM_ATTRIBUTES_VIEW_SHARED 스키마

컬럼 이름 데이터 유형 설명
APP_GROUP_ID VARCHAR Braze 워크스페이스 식별자
APP_ID VARCHAR 워크스페이스 내의 특정 앱
USER_ID VARCHAR 고유 Braze 사용자 식별자
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
SF_UPDATED_AT TIMESTAMP_NTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
CUSTOM_ATTRIBUTES VARIANT 모든 커스텀 속성을 포함하는 JSON 객체(키-값 페어)
ARCHIVED BOOLEAN 고객 프로필이 보관 처리되었는지 여부

CUSTOM_ATTRIBUTES 활용하기

CUSTOM_ATTRIBUTES 컬럼은 모든 커스텀 속성을 JSON 객체로 저장합니다. Snowflake의 JSON 함수를 사용하여 개별 속성에 접근할 수 있습니다.

예시: 특정 커스텀 속성 쿼리하기

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
-- Get users with a specific loyalty tier
SELECT
  USER_ID,
  EXTERNAL_USER_ID,
  CUSTOM_ATTRIBUTES:loyalty_tier::STRING as loyalty_tier,
  CUSTOM_ATTRIBUTES:points::NUMBER as points
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:loyalty_tier::STRING = 'gold';

-- Get users who made a purchase above a certain amount
SELECT
  USER_ID,
  CUSTOM_ATTRIBUTES:last_purchase_amount::NUMBER as last_purchase_amount
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:last_purchase_amount::NUMBER > 100;

예시: 커스텀 속성 데이터 분석하기

1
2
3
4
5
6
7
8
9
10
11
12
13
14
-- Count users by subscription status
SELECT
  CUSTOM_ATTRIBUTES:subscription_status::STRING as subscription_status,
  COUNT(*) as user_count
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
GROUP BY CUSTOM_ATTRIBUTES:subscription_status::STRING;

-- Find average order value by customer segment
SELECT
  CUSTOM_ATTRIBUTES:customer_segment::STRING as segment,
  AVG(CUSTOM_ATTRIBUTES:lifetime_value::NUMBER) as avg_lifetime_value
FROM USER_CUSTOM_ATTRIBUTES_VIEW_SHARED
WHERE CUSTOM_ATTRIBUTES:customer_segment IS NOT NULL
GROUP BY CUSTOM_ATTRIBUTES:customer_segment::STRING;

실시간 고객 프로필 뷰

이 뷰는 고객 프로필 속성에 대한 거의 실시간 업데이트를 제공하며, 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 Braze 워크스페이스 식별자
APP_ID VARCHAR 워크스페이스 내의 특정 앱
USER_ID VARCHAR 고유 Braze 사용자 식별자
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
ARCHIVED BOOLEAN 고객 프로필이 보관 처리되었는지 여부
SF_UPDATED_AT TIMESTAMP_LTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
FIRST_NAME VARCHAR 사용자의 이름
LAST_NAME VARCHAR 사용자의 성
EMAIL_ADDRESS VARCHAR 사용자의 이메일 주소
GENDER VARCHAR 사용자의 성별
PHONE_NUMBER VARCHAR 사용자의 전화번호
DOB VARCHAR 사용자의 생년월일
HOME_CITY VARCHAR 사용자의 거주 도시
COUNTRY VARCHAR 사용자의 국가
LANGUAGE VARCHAR 사용자의 언어 설정
TIME_ZONE VARCHAR 사용자의 시간대

USER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED 스키마

컬럼 이름 데이터 유형 설명
APP_GROUP_ID VARCHAR Braze 워크스페이스 식별자
USER_ID VARCHAR 고유 Braze 사용자 식별자
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
ARCHIVED BOOLEAN 고객 프로필이 보관 처리되었는지 여부
SF_UPDATED_AT TIMESTAMP_NTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
APP_ID VARCHAR 워크스페이스 내의 특정 앱
CUSTOM_ATTRIBUTES OBJECT 모든 커스텀 속성을 포함하는 JSON 객체(키-값 페어)

이력 변경 로그

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

  • USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED
  • USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED

사용법

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

USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHARED 스키마

컬럼 이름 데이터 유형 설명
APP_GROUP_ID VARCHAR Braze 워크스페이스 식별자
USER_ID VARCHAR 고유 Braze 사용자 식별자
APP_ID VARCHAR 워크스페이스 내의 특정 앱
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
SF_UPDATED_AT TIMESTAMP_NTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
FIRST_NAME VARCHAR 사용자의 이름
LAST_NAME VARCHAR 사용자의 성
EMAIL_ADDRESS VARCHAR 사용자의 이메일 주소
GENDER VARCHAR 사용자의 성별
PHONE_NUMBER VARCHAR 사용자의 전화번호
DOB VARCHAR 사용자의 생년월일
TIME_ZONE VARCHAR 사용자의 시간대
HOME_CITY VARCHAR 사용자의 거주 도시
COUNTRY VARCHAR 사용자의 국가
LANGUAGE VARCHAR 사용자의 언어 설정
EFF_DT TIMESTAMP_NTZ 유효 시작일: 이 속성 상태가 시작된 시점
END_DT TIMESTAMP_NTZ 유효 종료일: 이 속성 상태가 종료된 시점(현재 상태인 경우 NULL)

USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED 스키마

컬럼 이름 데이터 유형 설명
APP_GROUP_ID VARCHAR Braze 워크스페이스 식별자
USER_ID VARCHAR 고유 Braze 사용자 식별자
APP_ID VARCHAR 워크스페이스 내의 특정 앱
EXTERNAL_USER_ID VARCHAR 사용자 지정 사용자 식별자(설정된 경우)
TIME NUMBER 프로필 업데이트의 Unix 타임스탬프(초)
TIME_MS NUMBER 프로필 업데이트의 Unix 타임스탬프(밀리초)
UPDATE_SOURCE VARCHAR 속성 업데이트 소스(API, SDK, 대시보드 등)
SF_UPDATED_AT TIMESTAMP_NTZ Snowflake에서 데이터가 마지막으로 업데이트된 시점
CUSTOM_ATTRIBUTES VARIANT 모든 커스텀 속성을 포함하는 JSON 객체(키-값 페어)
ARCHIVED BOOLEAN 고객 프로필이 보관 처리되었는지 여부
EFF_DT TIMESTAMP_NTZ 유효 시작일: 이 속성 상태가 시작된 시점
END_DT TIMESTAMP_NTZ 유효 종료일: 이 속성 상태가 종료된 시점(현재 상태인 경우 NULL)

일반적인 사용 사례

사용자 세그먼트 구축

1
2
3
4
5
6
7
8
9
10
11
12
13
-- Find active users in a specific city who haven't received an email recently
SELECT
  d.EXTERNAL_USER_ID,
  d.EMAIL_ADDRESS,
  d.HOME_CITY,
  c.CUSTOM_ATTRIBUTES:last_email_sent::TIMESTAMP as last_email_sent
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE d.HOME_CITY = 'New York'
  AND d.EMAIL_ADDRESS IS NOT NULL
  AND (c.CUSTOM_ATTRIBUTES:last_email_sent::TIMESTAMP < DATEADD(day, -30, CURRENT_TIMESTAMP())
       OR c.CUSTOM_ATTRIBUTES:last_email_sent IS NULL);

시간에 따른 사용자 행동 분석

1
2
3
4
5
6
7
8
9
10
-- Track how a user's loyalty tier changed over the past 6 months
SELECT
  USER_ID,
  CUSTOM_ATTRIBUTES:loyalty_tier::STRING as loyalty_tier,
  EFF_DT,
  END_DT
FROM USER_CUSTOM_ATTRIBUTES_HISTORY_VIEW_SHARED
WHERE USER_ID = 'user_123'
  AND EFF_DT >= DATEADD(month, -6, CURRENT_TIMESTAMP())
ORDER BY EFF_DT DESC;

기본 속성과 커스텀 속성 결합

1
2
3
4
5
6
7
8
9
10
11
12
13
14
-- Get a complete user profile with both default and custom attributes
SELECT
  d.EXTERNAL_USER_ID,
  d.FIRST_NAME,
  d.LAST_NAME,
  d.EMAIL_ADDRESS,
  d.COUNTRY,
  c.CUSTOM_ATTRIBUTES:subscription_status::STRING as subscription_status,
  c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER as lifetime_value,
  c.CUSTOM_ATTRIBUTES:last_purchase_date::DATE as last_purchase_date
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
LEFT JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE d.EXTERNAL_USER_ID = 'customer_456';

고가치 고객 찾기

1
2
3
4
5
6
7
8
9
10
11
12
-- Identify users with high lifetime value who are at risk of churning
SELECT
  d.EXTERNAL_USER_ID,
  d.EMAIL_ADDRESS,
  c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER as lifetime_value,
  c.CUSTOM_ATTRIBUTES:days_since_last_purchase::NUMBER as days_since_last_purchase
FROM USER_DEFAULT_ATTRIBUTES_VIEW_SHARED d
JOIN USER_CUSTOM_ATTRIBUTES_VIEW_SHARED c
  ON d.USER_ID = c.USER_ID
WHERE c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER > 1000
  AND c.CUSTOM_ATTRIBUTES:days_since_last_purchase::NUMBER > 90
ORDER BY c.CUSTOM_ATTRIBUTES:lifetime_value::NUMBER DESC;

모범 사례

사용 사례 권장 뷰 참고
최근 업데이트가 필요하지 않은 일반 쿼리 USER_DEFAULT_ATTRIBUTES_VIEW_SHAREDUSER_CUSTOM_ATTRIBUTES_VIEW_SHARED 빠른 실행, 최대 12시간 전 데이터.
최신 사용자 속성이 필요한 쿼리 USER_LATEST_STATE_DEFAULT_ATTRIBUTES_VIEW_SHAREDUSER_LATEST_STATE_CUSTOM_ATTRIBUTE_VIEW_SHARED 거의 실시간 업데이트를 제공하지만 대규모 데이터셋에서는 느릴 수 있습니다.
속성 변경의 이력 추적 USER_DEFAULT_ATTRIBUTES_HISTORY_VIEW_SHAREDUSER_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억 명 이상의 사용자에 대한 쿼리는 사용자별 집계로 인해 수 분이 소요될 수 있습니다.
New Stuff!