히스토그램 블록
원시 값을 읽기 쉬운 구간으로 자동 분류합니다 — 미리 집계된 버킷이 아니라 개별 숫자를 그대로 입력하면 분포를 알아서 계산해줍니다.
작동 방식
이 계열의 다른 형제 차트들과 달리, 히스토그램에는 카테고리나 시리즈 입력 형식이 아예 없습니다. 행 목록은 학생별 시험 점수, 거래별 주문 총액, 요청별 응답 시간처럼 행마다 원시 숫자 하나가 들어가는 단일 값(Value) 열입니다. 구간으로 나누는 작업은 입력 시점이 아니라 렌더링 시점에 이루어집니다 — 구간이나 개수를 직접 입력할 필요가 없습니다. 구간이 정해지고 나면 히스토그램은 단일 시리즈 막대 그래프와 완전히 같은 방식으로 그려집니다 — 내부적으로 막대 그래프 자체의 래스터 파이프라인을 재사용합니다. 그래서 이 계열의 모든 차트가 지키는 "렌더링된 PNG + 항상 표시되는 데이터 표" 원칙도 그대로 이어받습니다. 즉 버킷 개수는 이미지에만 존재하지 않습니다.
구간 개수(Number of bins)(2~20)로 대략 몇 개의 구간을 원하는지 지정할 수 있습니다. 블록은 데이터의 최솟값부터 최댓값까지의 범위를 지정한 개수만큼 동일한 너비의 버킷으로 나누고, 각 버킷에 들어가는 입력값의 개수를 셉니다. 입력한 값이 모두 같으면 범위가 0이 되어 나눌 것이 없습니다. 요청한 구간 개수 중 하나만 실제 막대로, 나머지는 빈 막대로 그리는 대신, 히스토그램은 모든 값을 담은 단일 구간으로 축소됩니다. 서로 다른 값이 정확히 하나뿐인 분포는 원래부터 막대 하나가 맞지, 그 옆에 빈 버킷 N-1개를 늘어놓을 일이 아닙니다.
이미지 아래 데이터 표는 각 구간의 정확한 범위("시작–끝" 형식)를 개수와 함께 나열합니다. 정확한 버킷 경계와 개수를 함께 확인할 수 있는 유일한 곳입니다 — 이미지는 분포의 형태를 한눈에 전달하지만, 구간 개수가 상한에 가까워질수록 막대마다 라벨을 붙이지는 않습니다.
값(Value) 열에서 비어 있거나 숫자가 아닌 셀은 구간 계산 전에 제외되며(빈 셀은 진짜 0이 아니므로), 입력값은 최대 500개까지 읽어들입니다. 직접 입력하는 용도로는 충분히 넉넉한 크기입니다.
이 블록은 직접 입력한 행 전용입니다 — 데이터 소스 연동이나 캠페인 응답 연동 모드가 없습니다. 어떤 네 가지 차트 유형이 연동을 지원하는지는 차트를 실제 데이터에 연동하기에서 확인하세요.
설정 가능한 필드:
- 차트 제목(Chart title) — 이미지 위에 표시됩니다.
- 값(Values) — 행 목록으로, 값 열 하나에 행마다 원시 숫자 하나.
- 구간 개수(Number of bins) — 2~20, 목표로 할 동일 너비 버킷 개수.
- 막대 색상(Bar color) — 모든 구간에 적용되는 기본 팔레트 색상을 덮어씁니다.
- 카드의 배경색, 여백, 테두리, 모서리 둥글기.
- 제목과 범례/표 텍스트에 각각 독립된 색상/글자 크기 쌍.
예시
Subject
This week's order value spread
퀴즈 결과 다이제스트라면 학생별 100점 만점 원점수를 히스토그램으로 표현해, 반 전체가 합격선 근처에 몰려 있는지 아니면 두 그룹으로 나뉘는지 즉시 보여줄 수 있습니다. 지원팀 운영 리포트라면 한 주 동안의 티켓 응답 시간(분 단위)을 히스토그램으로 그려, 대부분의 티켓이 빠르게 처리되고 소수만 긴 꼬리처럼 남는지, 아니면 SLA 경계 부근에 몰려 있는지 한눈에 파악할 수 있습니다. 이커머스 리캡이라면 주문 금액을 히스토그램으로 표현해, 어떤 가격대를 사전에 정하지 않고도 고객이 실제로 구매하는 자연스러운 가격 구간을 확인할 수 있습니다 — 블록이 원시 총액에서 직접 계산해줍니다.
정적 폴백의 모습
<div style="margin:12px 0;padding:16px;background-color:#ffffff;border-radius:8px">
<p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Quiz scores</p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoi...&s=3f9a2b1c..." width="560" height="280"
alt="Histogram: 60–68: 3, 68–76: 5, 76–84: 9, 84–92: 7, 92–100: 4"
style="display:block;max-width:100%;height:auto;margin:8px 0" />
<table style="width:100%;border-collapse:collapse;margin-top:4px">
<tr>
<th style="text-align:left;padding:4px 8px;font-weight:600;font-size:12px;color:#6b7280">Category</th>
<th style="text-align:left;padding:4px 8px;font-weight:600;font-size:12px;color:#6b7280">Count</th>
</tr>
<tr>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">76–84</td>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">9</td>
</tr>
</table>
</div>
각 구간의 정확한 범위와 개수가 평범한 표 행으로 표시됩니다 — 대체 텍스트가 요약하고 막대가 시각화하는 것과 같은 숫자입니다.