NGUYỄN VĂN PHÚ

Phiếu triển khai · Báo cáo quảng cáo · Facebook Ads → Lark Base · GitHub Actions

Số liệu quảng cáo tự về Lark mỗi sáng

Không phải mở Trình quản lý quảng cáo từng tài khoản. Mỗi sáng máy lấy danh sách tài khoản và số liệu từng quảng cáo theo ngày — chi phí, hiển thị, nhấp, tin nhắn, lượt mua — ghi vào bảng Lark; bảng tổng hợp đọc thẳng từ đó nên luôn mới.

Facebook Ads→GitHub Actions lấy số→Bảng 14.4 + 14.5→Bảng tổng hợp 14.6→Đọc trên điện thoại

550dòng số liệu lần chạy đầu (bản gốc)
17/18lượt lấy tài khoản thành công
16/18lượt lấy số liệu thành công
0máy chủ phải thuê

Hình 1

Facebook → GitHub → Lark, mỗi sáng một lần

Hai lệnh chạy trên GitHub Actions trong kho riêng của bạn, kích hoạt bởi 2 Automation định kỳ trong Lark.

Lark Automation

  • 05:30 gọi lấy tài khoản
  • 05:35 gọi lấy số liệu 7 ngày gần nhất
↓

Facebook Ads

  • mọi tài khoản token nhìn thấy
  • số liệu cấp quảng cáo × ngày
→

GitHub Actions

  • fetch-adaccounts
  • fetch-ads-insights
  • cập nhật, không nhân đôi
→

Lark Base

  • 14.4 tài khoản + tổng chi
  • 14.5 số liệu theo ngày
  • 14.6 bảng tổng hợp

Không cần máy chủ · token Facebook có quyền ads_read

Vì sao làm lại 7 ngày gần nhất mỗi sáng: Facebook chốt số trễ vài ngày; máy cập nhật theo cặp quảng cáo × ngày nên dòng cũ được sửa đúng số, không sinh dòng trùng.

Bảng tổng hợp 14.6

5 thẻ chỉ số, 4 biểu đồ

THẺ CHỈ SỐ (TỔNG)

Đọc trong 5 giây

Tổng chi phícột Tổng chi phí
Hiển thịcột Số lần hiển thị
Nhấpcột Số lần nhấp
Tin nhắncột Số Mess
Lượt muacột Lượt mua

BIỂU ĐỒ

Biết tiền đi đâu

Chi phí theo chiến dịchcột
Chi phí theo tài khoảntròn hoặc cột
Chi phí theo ngàyđường
Tin nhắn theo chiến dịchcột

Tóm lại

Nhận lời mời, dán một khối lệnh. Claude dựng kho riêng, bảng 14.4 + 14.5, nạp khoá.

Dựng 2 Automation và bảng tổng hợp 14.6 theo hướng dẫn trong kho.

Mỗi sáng số tự về. Mở bảng 14.6 là biết tiền quảng cáo đi đâu, ra bao nhiêu tin nhắn.

01

Chuẩn bị

  1. Claude Code — code.claude.com.
  2. Tài khoản GitHub và lời mời vào kho mã hoc-vien-auto-facebook-module — gửi tên GitHub cho người chuyển giao, bấm Accept invitation. Lỡ mất email thì mở trang lời mời. Cùng kho với module Facebook ⇄ Lark — cài một lần dùng được cả đăng bài lẫn báo cáo quảng cáo.
  3. Lark Base + ứng dụng Lark được thêm vào Base quyền Chỉnh sửa.
  4. Token Facebook có quyền ads_read (thêm business_management nếu tài khoản quảng cáo nằm trong Business Manager). Cách lấy token bằng tay: tab Lấy token Facebook trên trang Facebook ⇄ Lark.
02

Copy khối lệnh, dán vào Claude Code

Chỉ điền thông tin không bí mật. Ô để trống thì Claude sẽ hỏi.

✓ Đã copy — dán vào Claude

Trang này không lưu và không gửi đi những gì bạn điền.

03

Claude sẽ làm gì

  1. Tạo kho riêng tư của bạn, bật Actions, nạp Secrets và Variables.
  2. Chạy init-tables.bảng 14.4 và 14.5 hiện trong Base, đủ cột, đủ công thức.
  3. Chạy fetch-adaccounts rồi fetch-ads-insights với toàn bộ lịch sử.14.4 có danh sách tài khoản + tổng chi; 14.5 có số liệu từng quảng cáo theo ngày.
  4. Hướng dẫn bạn dựng 2 Automation định kỳ 05:30 / 05:35 và bảng tổng hợp 14.6 (5 thẻ + 4 biểu đồ).
04

Đọc số cho đúng

  1. Không cộng dồn CPM, CPC, CTR — chỉ số theo từng dòng. Muốn trung bình thì dùng phép Trung bình, hoặc tính lại từ tổng chi phí / tổng nhấp.
  2. Tổng chi tiêu ở 14.4 là luỹ kế toàn thời gian của tài khoản.
  3. Máy không tự xoá dòng — muốn bỏ một tài khoản khỏi báo cáo thì lọc trên bảng tổng hợp và xoá tay dòng cũ.
05

Lỗi hay gặp

“FB_USER_TOKEN thiếu quyền: ads_read”
Cấp lại token có quyền ads_read, cập nhật Secret FB_USER_TOKEN.
Workflow đỏ, log báo token không hợp lệ
Token Facebook hết hạn — cấp token mới, cập nhật Secret, không cần sửa code.
Bảng 14.5 chạy xong mà 0 dòng
Khoảng thời gian không có quảng cáo chạy — chạy lại với date_preset = maximum.
Automation Lark báo lỗi 403 khi gọi GitHub
Thiếu header User-Agent; Kiểu phản hồi phải chọn None (GitHub trả 204 rỗng).

Minh bạch

Đã chạy thật và chưa kiểm chứng

Đã chạy thật (bản của người chuyển giao, GitHub Actions): lấy tài khoản quảng cáo 17/18 lượt, lấy số liệu theo ngày 16/18 lượt thành công (đếm tới 22/09/2026); lần chạy đầu 07/09/2026 kéo về 3 tài khoản và 550 dòng số liệu, dựng bảng tổng hợp 5 thẻ + 4 biểu đồ ra số thật. Kho học viên qua cổng chuyển giao, soát 0 lỗi đỏ. Chưa chạy thử:

  • Trọn quy trình trên tài khoản quảng cáo và kho GitHub của một học viên mới.
  • Dựng bảng tổng hợp 14.6 theo hướng dẫn chữ (bản gốc dựng bằng công cụ dòng lệnh).