Hướng dẫn cài đặt
Nhập Partner ID/Key → hệ thống ký URL và chuyển sang Shopee → bạn đăng nhập & cấp quyền → Shopee tự quay lại đây → hệ thống đổi lấy token và lưu. Sau đó mỗi ngày worker tự lấy số liệu ghi vào Google Sheet.
1. Đăng ký Callback URL trên Shopee Open Platform
Vào Shopee Open Platform → App của bạn → mục Callback URL, khai báo đúng URL callback của app này:
<APP_URL>/callbackVí dụ khi chạy nội bộ:
http://localhost:3000/callback — khi lên VPS đổi thành domain thật (đặt trong biến APP_URL).2. Tạo Google Service Account (để ghi Google Sheet)
Tạo service account trong Google Cloud, bật Google Sheets API + Drive API, tải file JSON key về, đặt đường dẫn vào biến môi trường:
GOOGLE_SERVICE_ACCOUNT_FILE=./data/service-account.jsonMỗi shop sẽ được tạo 1 Sheet riêng và tự chia sẻ cho các email bạn nhập khi thêm shop. Nếu chưa cấu hình, app vẫn chạy và chỉ bỏ qua bước ghi Sheet.
3. Chạy worker cron trên VPS
Worker đọc lịch (cron) của từng shop và tự lấy số liệu ngày hôm trước. Chạy nền bằng pm2:
pm2 start "npm run worker" --name shopee-workerApp web chạy bằng
npm run build && npm run start. Worker chạy riêng để lịch cron không phụ thuộc vào web.12 chỉ số & khả năng lấy được
Lấy được cho shop thường GMV, Đơn hàng, AOV, Chi phí ads, Hoa hồng affiliate, Đơn trả/hoàn, CIR, và (tùy chọn) Tỷ lệ mua lại.
Cần shop brand Lượt hiển thị sản phẩm, Lượt truy cập, CR — chỉ có qua API
principal (bật "Lấy traffic" khi thêm shop).Không có trong Open API Chi phí ads video affiliate — luôn để trống.