계정 오브젝트
계정 오브젝트를 사용하여 계정 데이터로 메시징을 세분화하고 개인화하세요.
계정 오브젝트를 사용하면 다음을 수행할 수 있습니다.
- 계정 기준으로 Segments 구축
- Liquid를 통해 계정 속성으로 메시지 개인화
- 한 곳에서 계정 레코드 관리
계정 오브젝트는 사용자 프로필에 연결된 워크스페이스 수준의 데이터 모델입니다. 계정 레코드는 하나의 특정 계정과 관련 필드 데이터를 의미합니다. 회사 속성과 같은 계정 컨텍스트가 메시징 타겟팅 및 개인화에 도움이 될 때 계정 오브젝트를 사용하세요. 계정 계층 구조(예: 상위 및 하위 계정)를 모델링하고 하나의 사용자 프로필을 여러 계정에 연결할 수도 있습니다.
계정 객체를 사용하는 이유는 무엇인가요?
Campaigns와 Canvases가 개별 사용자에게 메시지를 보내더라도, 일부 사용 사례에는 계정 수준의 컨텍스트가 필요합니다.
계정 객체를 사용하면 계정 데이터를 한 번만 저장하고 Braze 전반에서 세분화와 개인화에 재사용할 수 있습니다.
이를 통해 다음을 수행할 수 있습니다.
- 계정 속성을 기준으로 세분화
- 공유 계정 컨텍스트(예: 회사 이름 또는 업종)로 메시지 개인화
- 계정 간 관계를 모델링하고 하나의 고객 프로필을 여러 계정에 연결
이 방식을 사용하면 동일한 계정 속성을 여러 고객 프로필에 중복해서 저장할 필요가 없습니다.
사전 요구 사항
시작하기 전에 다음을 확인하세요.
- 워크스페이스에 Accounts가 프로비저닝되어 있어야 합니다. Accounts는 정식 출시된 기능이지만, 대시보드나 Data Objects 엔드포인트에서 사용하려면 먼저 프로비저닝을 요청해야 합니다. 자세한 단계는 1단계: Accounts 활성화를 참조하세요.
- Braze에 이미 사용자가 있어야 합니다.
계정 데이터 모델
각 계정에는 식별자(id)와 이름(name)이 필요합니다.
이 섹션의 계정 필드는 계정 객체 스키마를 정의합니다. 이 필드는 Braze에 저장하는 모든 개별 계정 레코드에 적용됩니다.
Braze에는 기본적으로 표준 필드가 포함된 계정 객체가 제공됩니다. 사용 사례에 따라 커스텀 필드를 추가하거나 제거할 수 있습니다. 필드 이름 id, object_id, display_name은 예약되어 있으므로 커스텀 필드 이름으로 사용할 수 없습니다.
| 필드 이름 | 필드 유형 | 필수 | 설명 |
|---|---|---|---|
id |
문자열 | 예 | 계정에 대한 시스템 ID(예: CRM ID)입니다. 워크스페이스 내에서 고유해야 합니다. |
name |
문자열 | 예 | 계정 이름입니다. |
type |
문자열 | 아니요 | 고객, 파트너, 리셀러 등 계정 유형입니다. |
annual_revenue |
숫자 | 아니요 | 계정의 연간 매출입니다. |
industry |
문자열 | 아니요 | 계정의 업종입니다. |
number_of_employees |
숫자 | 아니요 | 직원 수입니다. |
address |
문자열 | 아니요 | 도로명 주소입니다. |
city |
문자열 | 아니요 | 구/군/시입니다. |
state |
문자열 | 아니요 | 주 또는 도입니다. |
postal_code |
문자열 | 아니요 | 우편번호입니다. |
country |
문자열 | 아니요 | 국가입니다. |
notes |
문자열 | 아니요 | 추가 메모입니다. |
website |
문자열 | 아니요 | 웹사이트 URL입니다. |
main_phone |
문자열 | 아니요 | 기본 전화번호입니다. |
created_date |
시간 | 아니요 | 계정 생성 타임스탬프입니다. |
sic_code |
문자열 | 아니요 | 표준 산업 분류(SIC) 코드입니다. |
| 커스텀 필드 | 커스텀 | 아니요 | 직접 정의하고 관리하는 필드입니다. |
데이터 통합 옵션
다음 방법으로 계정 레코드를 관리할 수 있습니다.
- 계정 레코드용 REST API 엔드포인트
- 개별 레코드의 경우 데이터 설정 > 계정에서 브라우저 내 편집
시작하기
1단계: 계정 활성화
계정은 회사 수준에서 활성화됩니다. 프로비저닝을 요청하려면 다음 단계를 따르세요.
- Braze 대시보드에서 데이터 설정 > 계정으로 이동합니다.
- 설문지를 작성합니다.
설문지를 제출하면 검토를 위해 Braze로 전달됩니다. 일주일 이내에 답변을 받을 수 있습니다. 대규모 사용 사례는 더 오래 걸릴 수 있습니다.
프로비저닝이 완료되면 데이터 설정 > 계정으로 이동하고, 메시지가 표시되면 일회성 초기화 절차를 완료합니다.
2단계: 계정 레코드 추가
REST API 또는 브라우저 내 편집을 통해 계정 레코드를 추가하거나 업데이트합니다.
3단계: 계정 기준에 대한 계산된 필터 만들기
계정 데이터로 세분화하기 전에 계정 기준을 정의하는 계산된 필터를 만듭니다.
- 오디언스 > 계산된 필터로 이동합니다.
- 필터 만들기를 선택한 다음 데이터 객체 필터를 선택합니다.
- 계정 기준을 정의합니다.
자세한 내용은 계산된 필터를 참조하세요.
4단계: Segment 빌더에서 계산된 필터 사용
Segment 빌더에서 생성한 계산된 필터를 선택한 다음, Campaign 또는 Canvas 타겟팅을 지원하는 추가 사용자 속성 필터를 추가합니다.
제한
계정에는 대부분의 사용 사례를 지원하기 위해 다음과 같은 기본 제한이 적용됩니다.
| 리소스 | 기본 제한 |
|---|---|
| 회사당 계정 레코드 수 | 50,000 |
| 계정 유형당 필드 수 | 500 |
| 관계 유형당 필드 수 | 25 |
| 사용자당 계정 객체 수 | 1,000 |
| 계정 객체당 사용자 수 | 10,000 |
| 계정 객체당 관련 객체 수 | 1,000 |
이 값은 시작 용량입니다. 더 많은 계정 레코드나 더 높은 제한이 필요하다면 Braze 계정 팀에 문의하여 증가를 요청하세요.
제한 관련 오류 코드와 API 요청이 제한을 초과할 경우 어떻게 되는지는 제품 제한을 참조하세요.
계정 기반 Segment 구축하기
계정 레코드와 계산된 필터가 준비되면 다음 단계를 따릅니다.
- Segment 빌더로 이동합니다.
- 계정 기준으로 미리 구성해 둔 계산된 필터를 추가합니다.
- 필요한 사용자 속성 필터를 추가합니다.
- Segment를 저장합니다.
예시:
- 계산된 필터: 계정
industry가 정확히healthcare임 - 사용자 속성 필터:
days_since_last_login이30미만임
Liquid로 개인화하기
{% data_object account %} Liquid 태그를 사용하여 사용자의 계정 데이터를 data_objects 배열에 로드합니다.
미리보기 및 테스트를 사용할 때는 개인화가 올바르게 처리될 수 있도록 계정 데이터가 포함된 Segment를 사용하세요.
{% data_object account %}
Hi {{${first_name}}},
We'd love to invite you and your peers at {{ data_objects[0].name }}.
일치하는 모든 계정을 반복하려면 다음을 사용합니다.
{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}
API 기본 사항
REST API를 사용하여 계정 레코드를 관리할 수 있습니다.
엔드포인트에 대한 자세한 내용은 데이터 객체 엔드포인트를 참조하세요.
인증 및 REST 엔드포인트 기본 사항은 Braze API 개요를 참조하세요.
자주 묻는 질문
계정에 커스텀 필드를 추가할 수 있나요?
예. 워크스페이스에서 커스텀 계정 필드를 정의하고 관리할 수 있습니다. 필드 요구 사항은 계정 데이터 모델을 참조하세요.
Accounts는 유료 애드온인가요?
아니요. Accounts는 유료 애드온이 아니며 모든 요금제에서 사용할 수 있습니다. 다만 사용하려면 먼저 워크스페이스가 프로비저닝되어 있어야 합니다. 단계별 안내는 1단계: Accounts 활성화를 참조하세요.