ADS HUNTER — BẢN 0.2

CÀI MỚI HOẶC NÂNG CẤP TỪ 0.1
1. SAO LƯU TRƯỚC: mở app cũ → Sao lưu JSON → lưu file lại.
2. Gỡ extension cũ nếu muốn cài sạch (việc này xoá dữ liệu trong Chrome; file JSON bạn đã sao lưu vẫn giữ nguyên).
   Nếu chỉ thay file: giải nén ZIP mới đè lên thư mục cũ rồi bấm nút tải lại ở chrome://extensions.
3. Chrome: chrome://extensions → bật Chế độ dành cho nhà phát triển → Tải tiện ích đã giải nén → chọn thư mục ads-hunter-internal.
4. Mở app: bấm extension → Mở app / kết quả. Nhập lại file JSON sao lưu nếu cần (nút Nhập JSON).

QUÉT NHIỀU CHỦ ĐỀ VÀ ĐẨY VỀ WEB (BẢN 0.3)
1. Máy ở nhà: bật, mở Chrome, đăng nhập Facebook bằng tài khoản quét riêng. Giữ Chrome mở.
2. Mở app từ biểu tượng extension. Dán danh sách chủ đề, mỗi dòng một chủ đề, rồi bấm "Bắt đầu quét chủ đề".
3. Extension tự mở Ad Library cho từng chủ đề (Hoa Kỳ, tất cả quảng cáo), tự cuộn, dừng khi không còn quảng cáo mới, rồi chuyển chủ đề tiếp theo.
4. Chỉ giữ quảng cáo bắt đầu trong 14 ngày gần nhất (hoặc chưa rõ ngày).
5. Dán địa chỉ nhận dữ liệu web (https://...) vào ô "Đẩy về web" và bấm "Lưu địa chỉ". Khi hàng đợi xong, extension tự đẩy; có thể bấm "Đẩy dữ liệu về web" để đẩy thủ công.
6. Kết quả vẫn lưu trong extension và có thể xuất JSON/CSV.
- Giữ tab Facebook mở suốt quá trình. Mỗi chủ đề mất khoảng 10 giây đến 2 phút tuỳ số kết quả.
- Gỡ extension hoặc xoá dữ liệu Chrome sẽ mất dữ liệu cục bộ. Đẩy về web để giữ bản lâu dài.
- Địa chỉ web phải nhận POST JSON dạng text/plain. Extension không gửi cookie hoặc mật khẩu Facebook.

DÙNG THỬ
1. Mở Facebook Ad Library, nhập từ khóa hoặc domain, chọn thị trường, chọn Tất cả quảng cáo và Đang hoạt động.
2. Chờ thẻ hiện đủ. Bấm extension → Quét tab Facebook hiện tại.
3. Bảng nhỏ góc phải: Quét phần đã tải, hoặc Tải thêm + quét (tối đa 60 lượt, có nút Dừng).
4. Quay lại tab app: chọn shop, sắp xếp, tìm kiếm, bấm bộ lọc có số đếm.
5. Xuất CSV để mở bằng Excel; Xuất JSON để sao lưu.

Ý NGHĨA CÁC CHỈ SỐ
- "X ads dùng cùng mẫu": số Meta công bố ("X ads use this creative and text"). Chỉ hiện khi Meta có ghi.
- "Có nhiều phiên bản": Meta ghi "Multiple versions". Không tự quy ra số ads.
- "Chưa rõ số ads cùng mẫu": không có thông tin. Không tự đặt số.
- Đây không phải số campaign. Số campaign thật chỉ xem được trong Ads Manager của đối thủ, không suy ra từ dữ liệu này.
- Ads không xuất hiện trong lần quét sau không được coi là đã dừng.
- Chạy lâu hoặc nhiều bản không chứng minh quảng cáo có lãi.

BỘ LỌC (số đếm tính theo shop và tìm kiếm đang chọn)
- Đang chạy: trạng thái Đang hoạt động đã đọc được.
- Chạy trên 30 ngày: đang chạy và ngày bắt đầu cách hôm nay hơn 30 ngày.
- Nhiều bản: đang chạy và có ghi nhiều phiên bản hoặc số ads cùng mẫu > 1.
- Mới trong 7 ngày: đang chạy và bắt đầu trong 7 ngày gần nhất.
- Đã dừng: trạng thái Không hoạt động đã đọc được (không suy luận từ việc vắng mặt).

THẺ QUẢNG CÁO
- Ảnh/thumbnail lấy từ trang đã tải. Nếu thiếu ảnh sẽ ghi "Chưa có ảnh", không chèn ảnh khác.
- Nhãn Mới, Video dựa trên dữ liệu đã đọc.
- "Sản phẩm ↗": link ngoài Facebook đầu tiên trong thẻ. "Quảng cáo ↗": link tới trang Ad Library.
- Thiếu link hoặc ngày: ghi "chưa có".
- Thumbnail có thể hết hạn theo thời gian; khi đó mở Quảng cáo ↗ để xem.

XEM ĐỘC LẬP
- Mở file XEM-THU-GIAO-DIEN.html bằng trình duyệt, bấm Nhập JSON để xem dữ liệu sao lưu.
- Bấm Xem dữ liệu minh họa để xem giao diện với dữ liệu giả. Có nhãn Minh họa và không xuất được file.

GIỚI HẠN TRUNG THỰC
- Bản 0.2 đã kiểm tra bằng trang giả lập và bộ test tự động. CHƯA được thử trên Facebook thật trong phiên xây dựng. Hãy thử trên Chrome của bạn; nếu 0 ads, gửi ảnh thẻ (đã ẩn thông tin riêng) để chỉnh bộ đọc.
- Bộ đọc dựa trên chữ hiển thị (tiếng Anh và tiếng Việt). Giao diện Facebook đổi có thể làm hỏng việc đọc.
- Ngày "Chạy trên 30 ngày" và "Mới trong 7 ngày" chỉ chính xác khi ngày bắt đầu được đọc.
- Số ads cùng mẫu chỉ có khi Meta hiển thị dòng tương ứng. Nhiều thẻ có thể không có số này.
- Kết quả là phần đã tải trong tab; không cam kết đủ mọi ads.
- Lưu tối đa 30 lượt trong Chrome. Gỡ extension sẽ mất dữ liệu trong Chrome; sao lưu JSON định kỳ.
- Không có máy chủ, không đồng bộ giữa nhiều máy hay nhân viên.
- Không đọc cookie, mật khẩu hoặc token; không vượt CAPTCHA; không tải ảnh/video hàng loạt.
