# Hướng dẫn cài đặt Báo cáo livestream PRO

Cài Apps Script cho Báo cáo livestream PRO trong khoảng 5 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** Livestream (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Cài đặt lần đầu — đây là lúc Google hỏi quyền
- **Số file phải dán:** 2 (Code.gs, appsscript.json.txt)
- **Thời gian:** khoảng 5 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/bao-cao-livestream-pro

## Các file trong thư mục 2-Apps-Script

- `Code.gs` (Tập lệnh): menu nhỏ Livestream: cài đặt lần đầu, thêm phiên live mới, mở hồ sơ phiên, tự đánh mã phiên. Không bắt buộc — mọi báo cáo là công thức trong file
- `appsscript.json.txt` (HTML, tuỳ chọn): tệp kê khai: múi giờ GMT+7 và đúng 2 quyền (chỉ bảng tính này, hiện menu). Không dán thì Google hỏi quyền rộng hơn nhưng script vẫn chạy

## Các bước

1. Mở file bằng Google Trang tính (bản sao từ "Tài liệu của tôi" đã có sẵn script, bỏ qua bước 1–2).
2. Tệp › Cài đặt: Ngôn ngữ Việt Nam, Múi giờ (GMT+07:00) Bangkok, Hà Nội, Tính lại "Khi thay đổi và mỗi giờ".
3. Tiện ích mở rộng › Apps Script › dán Code.gs vào Mã.gs.
4. Thêm các file còn lại đúng tên: appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu Livestream hiện cạnh Trợ giúp.
6. Bấm Livestream › Cài đặt lần đầu. Google hỏi quyền: Tiếp tục › chọn tài khoản › "Google chưa xác minh ứng dụng này" › Nâng cao › Chuyển đến … (không an toàn) › Cho phép.

Cảnh báo "chưa được xác minh" là bình thường với mọi Apps Script tự dán vào file của mình; Google chỉ xác minh ứng dụng nộp hồ sơ phát hành công khai.

## Quyền Google hỏi ở mẫu này

- **Xem, sửa bảng tính mà ứng dụng này được cài vào:** đánh mã phiên, thêm dòng phiên mới, đặt mã phiên vào tab Hồ sơ phiên — chỉ trong chính file này, không đọc file khác
- **Hiện và chạy nội dung bên thứ ba:** hiện menu Livestream trong bảng tính. Script không gửi dữ liệu ra ngoài Google, không chạy nền

Dữ liệu nằm trong Google Drive của khách. Script chạy bằng tài khoản Google của khách, không gửi dữ liệu ra ngoài; HiTaVa không xem được file.

## Việc làm một lần

- Menu Livestream › Cài đặt lần đầu: đặt múi giờ GMT+7, đánh mã phiên LV0001… cho dòng chưa có mã, đổi cột Huỷ và Đã chốt số thành ô tích, khoá mức cảnh báo các cột tự tính, ẩn cột phụ. Từ đó gõ ngày live vào dòng mới là tự có mã. Chạy lại lúc nào cũng an toàn.
- Tab Thiết lập: tên shop, giá vốn mặc định (% doanh thu thực), số ngày nhắc chốt số, ngưỡng hoàn / huỷ, ROAS tối thiểu. Bảng Nền tảng và phí sàn: điền phí theo ngành hàng của shop bạn.
- Tab Host: cách trả tiền từng host (phí / buổi, phí / giờ, % doanh thu thực, lương cứng). Tab Sản phẩm: giá bán, giá vốn. Tab Mục tiêu: GMV, lợi nhuận, số phiên, giờ live từng tháng.
- File DEMO: ô Thiết lập › Hôm nay đang cố định 26/10/2026 cho khớp ảnh mẫu — xoá ô đó khi dùng thật.

## Dùng hằng kỳ

1. Đầu tuần — tab Phiên live (hoặc menu › Thêm phiên live mới) lên lịch các phiên: ngày, giờ, thời lượng, nền tảng, host, chủ đề. Tab Lịch live xem cả tuần.
2. Sau mỗi phiên — chép số từ trang phân tích LIVE của sàn: lượt xem, người xem cao nhất, thời gian xem TB, click sản phẩm, đơn, GMV, hoàn / huỷ, chi phí quảng cáo, voucher. Ghi sản phẩm bán ở tab Sản phẩm trong phiên nếu muốn lãi gộp theo sản phẩm.
3. Mỗi sáng — tab Tổng quan › Việc cần xử lý: phiên lỗ, hoàn / huỷ cao, ROAS thấp, phiên chưa nhập số.
4. Hết hạn đổi trả (khoảng 7 ngày) — sửa đơn và giá trị hoàn / huỷ, tích Đã chốt số.
5. Cuối tháng — Tổng quan so tháng trước, tab Phân tích tìm host / khung giờ ra tiền nhất, tab Host lấy số tiền phải trả từng host, tab Mục tiêu đặt mục tiêu tháng sau.

## Trên Excel

Trên Excel 2016 trở lên (và LibreOffice) vẫn đủ 12 tab và mọi công thức: chỉ số, phí sàn, phí host, giá vốn, lợi nhuận, cảnh báo, Tổng quan, Lịch live, Phân tích, Xếp hạng phiên, Hồ sơ phiên, Mục tiêu, Host, Sản phẩm. Không có: menu (thêm phiên mới, mở hồ sơ phiên, tự đánh mã); ô Huỷ / Đã chốt số là TRUE / FALSE.

Trang HTML: https://www.hitava.cloud/huong-dan/bao-cao-livestream-pro
