<!-- TStar documentation · ko · canonical HTML: https://tstar.stream/ko/docs/reports-and-dashboard -->

# 리포트와 길드 대시보드

방송 중에는 콘솔 홈에서 현재 라운드의 실시간 데이터를 확인하세요. 방송 후에는 웹사이트에서 보관된 방송, 방송 간 분석, 건별 선물 내역을 확인하고 CSV / Excel로 내보낼 수 있습니다.

## 방송 중: 콘솔

### 홈 화면 실시간 데이터

**지금 이번 라운드**의 호스트 랭킹과 후원 랭킹, 그리고 현재 게임의 **지난 라운드** 결과와 선물 내역을 한 줄씩 보여줍니다. 자세한 내용은 [콘솔 기능 둘러보기](/docs/console-tour)를 참고하세요.

### 데이터 보고서 탭

"데이터 보고서" 탭에는 웹사이트 보고서로 이동하는 기능만 있습니다. 기본 버튼으로 길드 대시보드를 여세요. 보관 및 업로드가 완료된 방송의 보고서와 CSV / Excel 다운로드는 웹사이트에서 이용할 수 있습니다. 방송 중 라운드 데이터는 콘솔 홈에서 확인하세요.

## 방송 후: 공식 사이트 길드 대시보드

**1. 공식 사이트 로그인**

콘솔의 "데이터 보고서" 탭에서 웹사이트 보고서로 이동하는 기본 버튼을 누른 뒤, **라이선스를 소유한 계정**으로 로그인하세요.

**2. '길드 관리자' 열기**

로그인 후 "내 계정"에서 들어가거나, `/dashboard`로 바로 접속하세요. 어떤 컴퓨터, 어떤 TikTok 계정으로 시작했든 내 계정에 속한 모든 라이선스 키로 진행한 방송이 여기 모여 있습니다.

**3. 방송 기록이 나타날 때까지 기다리기**

방송 종료 후 서버에서 보관 및 업로드를 완료하면 방송이 표시됩니다. 즉시 표시되지 않을 수 있으므로 잠시 기다린 뒤 페이지를 새로고침하세요.

### 최근 한 달 요약

맨 위 네 개 카드는 내 계정에 속한 모든 팀의 최근 30일 합계입니다: 방송 횟수, 총 다이아, 방송 간 대조가 가능한 신원 확인된 후원자 수, "3회 이상 등장하고 2주 안에 다시 온" 단골 시청자 수입니다. 전월 데이터가 있으면 증감이 함께 표시됩니다.

### 방송 기록

방송마다 한 줄씩 나열됩니다: 방(룸), 시작/종료 시각, 진행 시간, 후원자 수, 총액. 여러 팀이 계정 하나를 함께 쓸 때는 "팀별 필터"로 특정 팀만 볼 수 있습니다. 방송 하나를 클릭하면 상세 내역으로 들어갑니다.

### 방송 간 비교

| 탭 | 보는 내용 | 활용법 |
| --- | --- | --- |
| 큰손 시청자 유지율 | 후원자별로 방송을 넘나들며 합산해 "단골" "쿨다운 중" "이탈 중"을 표시 | 한동안 안 보인 사람에게 방송인이 먼저 DM을 보내거나 전용 게임을 준비할 수 있습니다 |
| 호스트 추이 | 각 방송인의 방송 간 다이아와 1인당 평균 기여, 이번 방송을 본인의 최근 5회 중앙값과 비교 | 누가 상승세인지, 누구의 진행 방식을 조정해야 하는지 확인; 방송이 한 번뿐인 방송인은 "방송 횟수가 아직 부족합니다"로 표시되는데, 정상적인 상태입니다 |
| 게임 효율 비교 | 게임 구간별 분당 다이아 산출과 새로 유입된 후원자 수(현재는 라운드 기록이 있는 PK 대결, 데스매치 PK, 프리 스테이지, 응원 벽만 이 표에 반영됩니다) | 편성표를 짤 때 어떤 게임이 가장 잘 버는지, 어떤 게임이 신규 유입을 잘 끄는지 참고 |

#### 지표 계산 방식과 제외 조건

- **큰손 유지율**은 TikTok 후원자 신원으로 방송 간 합산합니다. 한 방송에서 여러 번 보내도 방문 방송은 한 번입니다. 신원을 식별할 수 없으면 추측해 합치지 않습니다. 누적 다이아는 수령인이 정해진 선물의 합계이며, 마지막 선물 이후 7일이면 쿨다운, 14일이면 이탈 중으로 분류합니다. 최근 활동 분류일 뿐 이탈 예측이나 보장은 아닙니다.
- **단골**은 최소 3회 방송에 등장한 후원자입니다. 최근 30일 요약에서는 최근 14일 안에 등장한 조건도 필요합니다. 각 카드의 기간과 조건은 해당 라벨을 확인하세요.
- **호스트 1인당 기여**는 호스트가 받은 다이아 ÷ 해당 방송에서 신원을 식별할 수 있는 고유 후원자 수이며, 선물 건별 평균이 아닙니다. 호스트는 점수판 이름으로 연결되므로 이름이 다르면 분리됩니다. 출연 시간은 멤버 순위에 등장한 방송의 전체 길이로 추정하며 개인별 입·퇴장 타이머가 아닙니다.
- **게임 효율**은 포함된 라운드의 다이아 ÷ 해당 게임 라운드 시간으로 분당 표시합니다. 무효 라운드와 시작·종료 시각이 없는 라운드는 제외합니다. 신규 후원자는 그 방송에서 처음 선물을 보낸 라운드에 한 번만 계산됩니다. 기록된 라운드가 있는 게임만 표시되므로, 표에 없다고 수익이 0인 것은 아닙니다.
- 수치는 TStar가 받은 뒤 저장한 방송 이벤트와 귀속 결과이며 TikTok 정산액이나 길드 분배 장부가 아닙니다. CSV는 내보낸 시점의 스냅샷입니다. 방송 종료 후 업로드가 성공해야 웹 대시보드에 나타납니다. 데이터 종류와 보관 기간은 [개인정보 처리방침](/privacy)을 참고하세요.

> **방송 간 대조가 성립하는 전제**
>
시청자는 TikTok 신원으로 방송 간 대조되며, 방송인은 점수판의 표시 이름으로 대조됩니다. 같은 방송인이 방송마다 다른 이름으로 나오면 두 명으로 갈라집니다. [방송인 명단](/docs/console-tour)으로 고정해서 등록하면 이름이 일관되게 유지됩니다.

### 방송 상세 내역

- **게임**: 제목 아래에 이번 방송에서 진행한 게임과 각각 받은 다이아가 표시됩니다(옛 버전에서 기록된 방송은 이름만 있고 다이아는 없습니다). PK는 실제로 한 판 이상 열어야 표시되며, 방송 내내 점수 게임을 열지 않았다면 "이 방송에는 점수 게임이 없습니다"라고 나옵니다. 이때 낙수 비율이 높게 나오는 것은 정상이므로 선물 연동을 고치러 돌아갈 필요가 없습니다.
- **인터랙션 위젯**: 이번 방송에서 낚시나 슬롯머신을 켰다면 게임 아래에 한 줄이 더 나와 몇 번 발동됐는지, 발동시킨 선물이 총 몇 다이아인지 보여 줍니다. 같은 선물이 PK 점수에도 반영되면서 낚시도 발동시킬 수 있으므로 여기의 다이아는 게임과 겹치며, 별도의 수익이 아닙니다.
- **다이아 타임라인**: 방송 전체에서 몇 분마다 얼마의 다이아를 받았는지를 방송인별로 쌓아서 보여 주고, 아래 색 띠는 각 게임 라운드의 시작과 끝입니다. 칸 위에 마우스를 올리면 그 구간의 내역이 보이며, 그래프 아래에 표 버전도 있습니다.
- **멤버 합계와 기여 비중**: 방송인별(또는 게임 수익 버킷별) 받은 다이아와 비중. 같은 방송인이 여러 게임에서 받은 다이아는 한 줄로 합쳐집니다.
- **건별 내역**: 선물 한 건마다의 시간, 후원자, 선물, 다이아, 수령인, 그리고 "어떻게 그 사람에게 계산됐는지" — 플랫폼 지정, 대표 선물 연동, 시청자가 직접 팀 선택, 또는 낙수(대상 미지정). 마지막 열 "수동 재판정"에는 **원래** 누구에게 계산됐는지가 적힙니다. 진행자가 방송 중에 판정을 바꾼 선물에만 값이 있고 비어 있으면 바꾼 적이 없는 것입니다. CSV와 xlsx 모두 이 열이 포함됩니다.

### 월별 정산을 위한 기간 내보내기

방송 목록 위에서 날짜 범위를 선택한 뒤 필터 아래의 **Download range as xlsx**을 누르세요. 게임, 방송 계정, 팀, 그룹 필터와 일치하는 방송이 포함됩니다. Excel에는 방송 요약, 기간별 호스트 합계, 방송별 호스트 내역, 개별 선물이 들어갑니다. 통계에서 제외한 방송도 요약에 표시되지만 합계에는 포함되지 않습니다.

최대 **60일, 200회 방송**까지 가능합니다. 파일이 **20 MB**를 넘으면 기간을 줄이거나 필터를 추가해 다시 시도하세요. 기간 전체 내보내기는 보고서 소유자만 이용할 수 있습니다. 공유받은 보고서는 방송별 CSV/xlsx를 받을 수 있지만 기간 전체를 내보낼 수는 없습니다.
- **라운드 결과**: PK / 데스매치 PK / 프리 스테이지 / 응원 벽 / 모노폴리 매 라운드의 점수와 승자, 무효 처리된 라운드는 표시됩니다. 프리 스테이지와 PK에서 방송 종료 때 아직 정산되지 않은 라운드는 자동으로 기록됩니다(승자는 비어 있음).
- **방송인 닉네임↔계정 대조표**: 이번 방송에 등장한 방송인 이름이 어느 TikTok 계정에 대응하는지 보여줍니다.

라운드 표에는 보관된 게임 라운드만 표시됩니다. 게임 시작 전에 받은 선물도 방송 전체 다이아 합계에는 포함되므로 두 합계가 다를 수 있습니다. 라운드 번호는 선물 장부의 번호를 그대로 쓰기 때문에 표가 2라운드부터 시작하거나 번호가 건너뛸 수 있습니다. 예를 들어 시작 전 100다이아, 시작 후 200다이아를 받았다면 방송 전체는 300다이아이지만 라운드 표에는 2라운드의 200다이아만 표시됩니다. 진행 중에 초기화, 다시 시작 또는 게임 전환으로 끝내지 못한 라운드는 '무효'로 표시됩니다. 그 라운드의 점수는 계산되지 않지만 받은 다이아는 방송 전체 합계에 포함됩니다.

### 내보내기

방송 상세 내역 페이지 오른쪽 위에 버튼 두 개가 있습니다:

- **CSV 다운로드**: 건별 내역.
- **xlsx 다운로드(여러 탭)**: Excel 파일 하나에 방송 총괄표, 라운드 데이터, 방송인별로 한 탭씩, 미분류, 방송인 랭킹, 시청자 랭킹, 건별 내역 탭이 있으며, 헤더는 중국어·영어를 함께 표기해 회계나 길드 관리자에게 바로 전달할 수 있습니다.

## 자주 묻는 질문

### 방송을 마쳤는데 대시보드에 이 방송이 없어요

해당 방송에 사용한 라이선스를 소유한 계정으로 로그인했는지 확인하세요. 서버에서 보관 및 업로드를 완료해야 방송이 표시됩니다. 잠시 기다린 뒤 새로고침하고, 그래도 보이지 않으면 고객 지원에 문의하세요.

### 로컬 데모나 테스트 방송도 업로드되나요?

아니요. 실제로 TikTok 방송방에 연결된 방송만 대시보드에 나타납니다.

### 다른 팀이 내 데이터를 볼 수 있나요?

가입된 계정에 수익 보고서와 방송별 CSV/xlsx 다운로드를 공유할 수 있습니다. 기간 전체 내보내기는 보고서 소유자만 이용할 수 있습니다. 기기 제어, 편집, 원본 채팅은 비공개로 유지됩니다.

## 방송 댓글과 상호작용 통계

댓글 보관을 설정하고 활성화하면 방송 상세에 총 댓글 수, 식별 가능한 고유 작성자 수, 분당 타임라인 그래프가 기본으로 표시됩니다. 댓글 기록을 펼치면 시작 후 경과 시간(분:초), 시청자 이름과 내용을 확인하고 필요한 만큼 더 불러올 수 있습니다. TStar가 받은 이벤트만 포함하며 모든 시청자를 측정하지 않습니다. 목록을 스크롤하고 댓글 더 불러오기를 눌러 이후 댓글을 읽을 수 있습니다.

댓글 내용, 시청자 ID, 이름, 시간은 비공개 압축 자료로 방송 종료 후 **30일** 보관합니다. 상호작용 통계는 보고서와 함께 **24개월** 유지합니다. 만료된 자료는 볼 수 없습니다. 불완전한 자료는 표시되며 댓글이 누락될 수 있습니다. 이전 방송을 소급 저장하지 않으며 데이터가 없다고 댓글이 없었던 것은 아닙니다.

저장소 설정과 기능 활성화 후에만 업로드됩니다. 그전에는 댓글이 업로드되지 않으며 수집되지 않은 통계는 사용할 수 없다고 표시됩니다. 보관 및 접근 규칙은 [개인정보 처리방침](/privacy)을 확인하세요.

## 방 보고서 공유

가입된 계정에 수익 보고서와 방송별 CSV/xlsx 다운로드를 공유할 수 있습니다. 기간 전체 내보내기는 보고서 소유자만 이용할 수 있습니다. 기기 제어, 편집, 원본 채팅은 비공개로 유지됩니다.

**보고서 접근 관리**: **방송 계정** → **받는 계정 이메일** → **공유**. **공유받은 보고서**: **공유된 방 보기: 보고서 읽기 및 내보내기만 가능합니다.**. **취소**: 접근 권한을 업데이트했습니다.

### 세션 조정

보고서는 조정된 수익을 표시합니다. 원본 선물, 실시간 점수와 발표된 승패는 바뀌지 않습니다. C 배분은 선물 수량이 0인 별도 금액 행입니다. 지우면 원래 귀속으로 복원됩니다.

읽기 전용입니다. 라이선스 소유자만 세션을 변경할 수 있습니다. 자동 조정에는 완전하고 일치하는 장부가 필요합니다. 선물 기록은 최대 50,000개입니다.

같은 TikTok 계정의 기록 시간이 겹칩니다. 비교한 뒤 중복을 직접 제외하세요. 자동 제외되지 않습니다.

- A · 전후 60초 내 가장 가까운 원본 귀속
- B · 1,000개 초과, 한 대상에게 85% 이상
- C1 · 균등 배분
- C2 · 다이아몬드 비율 배분

미리 보기 → 적용. 조정 지우기 · 변경 기록.
