TF
T-Fluencers Docs
Quay lại Wiki

Import performance metrics#

Mục tiêu: Khi API MXH (TikTok/YouTube/FB) fail hoặc data lệch, Admin import thủ công metrics (views, likes, comments, shares) cho content.

Mục tiêu#

  • Import metrics từ CSV hoặc JSON.
  • Override auto-synced data khi cần.
  • Validate kết quả.

Điều kiện tiên quyết#

  • Quyền Import Performance.
  • Content đã tồn tại trong hệ thống (phải có contentId).

Khi nào dùng?#

  • API MXH fail/rate limit — không crawl được data mới.
  • Influencer khiếu nại — họ khẳng định view đúng là X, API trả khác.
  • Migration — import data legacy từ hệ thống cũ.
  • Partner data — Partner cung cấp data bằng báo cáo Excel.

Các bước thực hiện#

1. Chuẩn bị dữ liệu#

Format CSV:

contentId,view,like,comment,share
507f1f77bcf86cd799439011,15000,500,80,120
507f1f77bcf86cd799439012,22000,750,95,210

Cột:

  • contentId (bắt buộc) — ObjectId của content
  • view, like, comment, share (tùy chọn) — metrics

2. Mở form Import#

  1. Trong menu Data / hoặc nơi có feature Import Performance.
  2. Bấm Import Performance.

3. Upload/paste#

2 cách:

  • Upload CSV file
  • Paste JSON array:
[
  {"contentId": "...", "view": 15000, "like": 500, ...}
]

4. Chọn date#

  • Snapshot date — timestamp cho data này.
  • Default: thời điểm hiện tại.

5. Submit#

  1. Bấm Import.
  2. Backend validate:
    • Content ID tồn tại?
    • Metric > 0?
    • Date hợp lý?
  3. Trả kết quả: thành công / fail (kèm row + lý do).

6. Verify#

Sau import:

  1. Mở chi tiết 1 content → xem stats.
  2. Dashboard Brand nên hiện data mới sau refresh.

Chi tiết từng bước#

Conflict với auto-sync#

Khi next cron crawl MXH → có thể overwrite data Admin vừa import. Solution:

  • Lock statistic (nếu backend support) — flag "manual overridden".
  • Liên hệ DevOps để thêm flag nếu chưa có.

Validation rules#

  • contentId phải đúng format ObjectId (24 hex chars).
  • Metrics không âm.
  • Date không quá xa tương lai (không set 2027 nếu hôm nay 2026).

Import từ Partner (TCB) report#

Partner đôi khi gửi báo cáo Excel với columns khác. Mapping:

  • Partner column "Video ID" → map với contentId trong hệ thống.
  • Có thể cần script trung gian để convert.

Lỗi thường gặp#

1. "Content not found"#

  • contentId sai.
  • Content đã bị xóa trong hệ thống.

2. "Invalid metric"#

  • Metric âm, hoặc null.
  • Format không phải number.

3. Import xong nhưng Dashboard không update#

  • Cache. Chờ vài phút.
  • Force refresh analytics (cron job riêng).

4. Import bị timeout với file lớn#

  • File > 10k rows → chia batch.
  • Dùng API trực tiếp + script thay vì UI.

5. Next cron overwrite data import#

  • Không có lock statistic. Liên hệ DevOps thiết lập.

Câu hỏi thường gặp (FAQ)#

Có template CSV không?

Download template từ form (nếu có nút Download template). Hoặc dùng format ở trên.

Import chỉ update metrics hay tạo content mới?

Chỉ update metrics cho content đã có. Không tạo content mới.

Có audit log cho import này không?

Có. Audit log ghi: Admin nào, content ID, metric trước/sau, timestamp.

Tôi import sai, làm sao undo?

Không có undo tự động. Import lại với giá trị đúng là cách duy nhất.

Import có trigger tính tiền lại không?

Có thể, nếu content thuộc đợt đối soát đang chạy. Cẩn thận với content đã chốt.

Liên kết liên quan#

Tham khảo SRS: admin-portal/13-performance