커스텀 이벤트
이 문서에서는 커스텀 이벤트 및 속성정보, 고객 프로필 이벤트 기록, 관련 세분화 필터, Canvas 진입 속성정보, 관련 분석 등에 대해 설명합니다. Braze 이벤트에 대해 전반적으로 알아보려면 이벤트를 참조하세요.
커스텀 이벤트는 사용자가 수행한 동작 또는 사용자에 대한 업데이트입니다. 커스텀 이벤트가 기록되면 원하는 수와 유형의 후속 Campaign을 트리거할 수 있습니다. 그런 다음 세분화 필터를 사용하여 해당 커스텀 이벤트가 발생한 최근성 및 빈도에 따라 사용자를 세분화할 수 있습니다. 따라서 커스텀 이벤트는 애플리케이션 내에서 가치가 높은 사용자 상호작용을 추적하는 데 가장 적합합니다.
사용 사례
일반적인 커스텀 이벤트 사용 사례는 다음과 같습니다:
- 실행 기반 전달을 사용하여 커스텀 이벤트를 기반으로 Campaign 또는 Canvas 트리거
- 커스텀 이벤트를 수행한 횟수, 마지막으로 이벤트가 발생한 시점 등을 기준으로 사용자를 세그먼트화
- 대시보드 커스텀 이벤트 분석을 사용하여 각 이벤트가 발생한 빈도의 집계 확인
- 퍼널 및 유지 보고서를 사용하여 추가 분석 수행
- 영구 항목 속성을 활용하여 고객 이벤트의 메타데이터를 캔버스 단계에서 개인화에 사용
- Currents를 사용하여 더 정교한 분석 생성
- 종료 기준을 설정하여 사용자가 Canvas를 종료해야 하는 시점 정의
커스텀 이벤트 관리하기
대시보드에서 데이터 설정 > 커스텀 이벤트로 이동하여 커스텀 이벤트를 관리, 생성 또는 차단 목록에 추가할 수 있습니다.
중복 커스텀 속성 또는 이벤트 문제 해결
동일한 이름으로 보이는 커스텀 데이터 항목이 두 개 표시되는 경우, 하나의 항목에 보이지 않는 선행 또는 후행 공백이 포함되어 있을 수 있습니다.
이 문제를 해결하려면 다음을 수행합니다.
- 데이터 설정 > 커스텀 속성 또는 커스텀 이벤트로 이동한 다음, 동일한 이름으로 보이는 두 항목을 찾습니다.
- 이름 중 하나에 숨겨진 공백이 포함되어 있는지 확인합니다.
- 각 이름을 마우스 오른쪽 버튼으로 클릭하고 검사를 선택합니다.
- 브라우저 개발자 도구에서 HTML 텍스트 값을 확인합니다.
- 값을 비교합니다(예:
email과 ` email`). - 필요한 경우 Chrome DevTools로 페이지 및 스타일 검사 및 편집을 참조합니다.
- 표준 키로 유지할 이름을 결정하고, 해당 철자와 대소문자를 정확히 통일합니다.
- 하나의 항목에 선행 또는 후행 공백이 포함되어 있고 대시보드에서 직접 생성된 경우, 해당 항목 사용을 중단하고 표준 키로 전환합니다.
- 대시보드 워크플로, CSV 가져오기 및 내부 런북을 표준 키를 사용하도록 업데이트합니다.
- 해당 항목을 폐기할 준비가 되면 잘못된 항목에 대해 커스텀 데이터 차단 목록을 설정합니다.
- 수집 경로를 확인합니다.
- API 및 SDK 페이로드는 선행 및 후행 공백을 자동으로 제거합니다.
- 대시보드에서 생성된 이름은 자동으로 공백을 제거하지 않으므로, 수동 입력 시 주의와 관리가 필요합니다.
커스텀 이벤트 옆의 메뉴를 선택하면 다음 작업을 수행할 수 있습니다:
차단 목록에 추가하기
작업 메뉴를 통해 개별 커스텀 이벤트를 차단 목록에 추가하거나, 최대 100개의 이벤트를 선택하여 일괄적으로 차단 목록에 추가할 수 있습니다.
커스텀 이벤트를 차단하면:
- 해당 이벤트에 대한 향후 데이터는 수집되지 않습니다.
- 해당 이벤트의 차단이 해제되지 않는 한 기존 데이터를 사용할 수 없습니다.
- 해당 이벤트는 필터나 그래프에 표시되지 않습니다.
또한, 차단된 커스텀 이벤트가 현재 Braze의 다른 영역에서 필터 또는 트리거에 의해 참조되고 있는 경우, 해당 이벤트를 참조하는 모든 필터 또는 트리거 인스턴스가 제거되고 보관된다는 경고 모달이 표시됩니다.
커스텀 데이터 차단 및 삭제에 대한 자세한 내용은 커스텀 데이터 차단 목록을 참조하세요.
설명 추가하기
Manage Events, Attributes, Purchases 사용자 권한이 있는 경우, 커스텀 이벤트가 생성된 후 설명을 추가할 수 있습니다. 커스텀 이벤트의 설명 편집을 선택하고 팀을 위한 메모 등 원하는 내용을 입력하세요.
태그 추가하기
“Manage Events, Attributes, Purchases” 사용자 권한이 있는 경우, 커스텀 이벤트가 생성된 후 태그를 추가할 수 있습니다. 태그를 사용하여 이벤트 목록을 필터링할 수 있습니다.
데이터 내보내기
커스텀 이벤트 목록을 CSV 파일로 내보내려면 페이지 상단에서 모두 내보내기를 선택합니다. CSV 파일이 생성되고 다운로드 링크가 이메일로 전송됩니다.

프로필에 정의하거나 저장할 수 있는 고유한 커스텀 이벤트 또는 커스텀 속성의 수에 대한 고정된 대시보드 제한은 없습니다. 실질적인 제한은 데이터 형태, 수집 볼륨 및 워크스페이스 성능에 따라 달라집니다. 매우 많은 수의 이벤트 또는 속성을 추적할 계획이라면, Braze 계정 팀과 모델링 및 데이터 관리(예: 사용하지 않는 데이터 차단 목록 추가)에 대해 상의하세요.
사용량 보고서 보기
사용량 보고서에는 특정 커스텀 이벤트를 사용하는 모든 Canvases, Campaigns 및 Segments가 나열됩니다. 이 목록에는 Liquid 사용은 포함되지 않습니다.
해당 커스텀 이벤트 옆의 체크박스를 선택한 다음 사용량 보고서 보기를 선택하면 한 번에 최대 100개의 사용량 보고서를 볼 수 있습니다.
커스텀 이벤트 기록하기
커스텀 이벤트는 추가 설정이 필요합니다. 커스텀 이벤트를 기록하는 데 사용되는 메서드와 커스텀 이벤트에 속성정보 및 수량을 추가하는 방법에 대해서는 다음 플랫폼 설명서를 참조하세요.
플랫폼별 설명서 펼치기
커스텀 이벤트 저장
고객 프로필에 저장된 모든 데이터(커스텀 이벤트 메타데이터(첫 번째 또는 마지막 발생, 총 횟수, 30일 동안의 X in Y) 포함)는 각 프로필이 활성 상태인 한 무기한 보존됩니다.
사용자의 이벤트 기록 보기

이벤트 기록은 현재 얼리 액세스 중입니다. 참여에 관심이 있으시면 Braze 계정 매니저에게 문의하세요.
사용자 프로필의 이벤트 기록 탭을 사용하여 해당 사용자의 최근 커스텀 이벤트 및 구매를 확인할 수 있습니다. 이를 통해 통합이 이벤트를 올바르게 기록하고 있는지 확인하고, 대시보드에서 직접 사용자 수준의 문제를 해결할 수 있습니다.
사용자의 이벤트 기록을 보려면:
- 오디언스 > 사용자 검색으로 이동한 다음 사용자를 선택하여 프로필을 엽니다.
- 이벤트 기록 탭을 선택합니다.
이 탭에는 최근 30일 동안의 사용자 커스텀 이벤트 및 구매가 최대 100개까지 최신순으로 표시됩니다.
각 이벤트에는 다음 정보가 포함됩니다:
- 이벤트 유형: 해당 이벤트가 커스텀 이벤트인지 구매인지 여부입니다.
- 이벤트 이름: 기록된 이벤트 이름입니다.
- 시간: 이벤트가 발생한 시점입니다.
- 속성정보: 해당 발생에 대한 전체 이벤트 속성정보로, JSON 형식으로 표시됩니다.
일반적인 사용 사례는 다음과 같습니다:
- 개발 중이거나 릴리스 후에 SDK 또는 API 통합이 예상대로 이벤트를 전송하고 있는지 확인합니다.
- 사용자가 이벤트 트리거 Campaign 또는 Canvas에 진입했거나 진입하지 않은 이유를 문제 해결합니다.
- 데이터 내보내기를 설정하지 않고도 특정 사용자에 대한 지원 문제를 조사합니다.

이벤트 기록 탭을 보려면 이벤트 속성정보에 개인 데이터가 포함될 수 있으므로 사용자 검색, PII 보기, 사용자 이벤트 속성정보 보기 사용자 권한이 필요합니다. 자세한 내용은 회사 사용자 권한을 참조하세요.
세분화 필터
다음 표는 커스텀 이벤트별로 사용자를 세분화하는 데 사용할 수 있는 필터를 보여줍니다.
| 세분화 옵션 | 드롭다운 필터 | 입력 옵션 |
|---|---|---|
| 커스텀 이벤트가 X회 초과 발생했는지 확인 | MORE THAN | NUMBER |
| 커스텀 이벤트가 X회 미만 발생했는지 확인 | LESS THAN | NUMBER |
| 커스텀 이벤트가 정확히 X회 발생했는지 확인 | EXACTLY | NUMBER |
| 커스텀 이벤트가 마지막으로 X 날짜 이후에 발생했는지 확인 | AFTER | TIME |
| 커스텀 이벤트가 마지막으로 X 날짜 이전에 발생했는지 확인 | BEFORE | TIME |
| 커스텀 이벤트가 마지막으로 X일 이상 전에 발생했는지 확인 | MORE THAN | NUMBER OF DAYS AGO (양수) |
| 커스텀 이벤트가 마지막으로 X일 미만 전에 발생했는지 확인 | LESS THAN | NUMBER OF DAYS AGO (양수) |
| 커스텀 이벤트가 X회(최대 = 50) 초과 발생했는지 확인 | MORE THAN | 지난 Y일 (Y = 1,3,7,14,21,30) 동안 |
| 커스텀 이벤트가 X회(최대 = 50) 미만 발생했는지 확인 | LESS THAN | 지난 Y일 (Y = 1,3,7,14,21,30) 동안 |
| 커스텀 이벤트가 정확히 X회(최대 = 50) 발생했는지 확인 | EXACTLY | 지난 Y일 (Y = 1,3,7,14,21,30) 동안 |
분석
Braze는 커스텀 이벤트가 발생한 횟수와 각 사용자가 마지막으로 수행한 시간을 기록하여 세분화에 활용합니다. Analytics > 커스텀 이벤트 보고서로 이동하여 이러한 분석을 확인할 수 있습니다.
대시보드의 커스텀 이벤트 보고서 페이지에서 각 커스텀 이벤트가 발생한 빈도를 집계하여 확인할 수 있습니다. 시계열 위에 겹쳐진 회색 선은 마지막으로 Campaign이 전송된 시점을 나타내며, Campaign이 커스텀 이벤트 활동에 어떤 영향을 미쳤는지 확인하는 데 유용합니다.

필터를 사용하여 시간별, 월간 활성 사용자(MAU), Segments 또는 핵심 성과 지표(KPI) 공식별로 커스텀 이벤트를 세분화할 수도 있습니다.


커스텀 속성 증분을 사용하여 커스텀 이벤트와 유사한 사용자 행동에 대한 카운터를 유지할 수 있습니다. 그러나 커스텀 속성 데이터는 시계열로 확인할 수 없습니다. 시계열로 분석할 필요가 없는 사용자 행동은 이 방법을 사용하여 기록해야 합니다.
커스텀 이벤트 분석이 표시되지 않는 이유
커스텀 이벤트 데이터로 생성된 Segments는 생성되기 이전의 과거 기록 데이터를 표시할 수 없습니다.
커스텀 이벤트 속성정보
커스텀 이벤트 속성정보는 이벤트의 특정 발생을 설명하는 커스텀 이벤트 메타데이터 또는 속성입니다. 이러한 속성정보는 트리거 조건을 더 세밀하게 설정하고, 메시징에서 개인화를 강화하며, 전환을 추적하고, 원시 데이터 내보내기를 통해 더 정교한 분석을 생성하는 데 사용할 수 있습니다.
자세한 내용은 커스텀 이벤트 속성정보를 참조하세요.