Marketing Tool là hệ thống cung cấp giao diện quản trị và bộ thư viện API toàn diện. Tài liệu này được chia thành 2 phần: Dành cho lập trình viên (Dev/API) trực tiếp vận hành hoặc tích hợp Apidog, và Dành cho người dùng cuối (User/Admin) thao tác trên giao diện màn hình web.
PHẦN A. Dành cho Developer & Tích hợp API (Server / Apidog)#
A.1 Yêu cầu hệ thống và cài đặt#
Dự án được xây dựng và triển khai chuẩn hóa qua hệ sinh thái Docker:Nền tảng: PHP >= 8.1 (Laravel 10+), Node.js, MariaDB/MySQL.
Lưu ý mạng Cronjobs (Bắt buộc): Các API Queue bất đồng bộ cần hệ thống máy chủ Linux tự động kích hoạt ngầm:/cron-search-engine: Kích hoạt crawler check thứ hạng mạng tìm kiếm.
/cron-url-extract: Kích hoạt crawler vào trang lấy danh sách URL content.
A.2 Cấu hình Xác thực (Auth) trên Apidog / Postman#
Phần lớn các API hệ thống đều được wrap qua phân quyền Middleware auth:sanctum. Bạn cần khai báo:1.
Header mặc định: Accept = application/json (Không có header này Laravel sẽ Redirect báo lỗi 302 thay vì báo 401 JSON).
2.
Gọi API POST /api/auth/login với data { "email": "...", "password": "..." }, bạn sẽ nhận trả về JSON chuỗi Token.
3.
Trong tab Auth của endpoint trên Apidog, chọn mục Bearer Token rồi dán nguyên văn mã Token vào để test tiếp các API /api/... khác.
A.3 Mô hình Async API Crawler chuẩn#
Hệ thống tránh để Request quá tải Timeout (504) nên sử dụng Flow bất đồng bộ. Frontend hay API Tester lưu ý flow như sau:(1) Store: Bắn API POST (ví dụ /api/search-engine/store) nạp hàng nghìn keywords lên Server. Hệ thống lưu thành record trạng thái chờ.
(2) Crawl: Tiến trình Cronjob ở A.1 hoặc Webhook Tool nhận dữ liệu, mở Socket/Puppeteer tải HTML, update lại Database thông qua POST /webhook/....
(3) Get Results: Frontend (Máy khách) gọi polling GET Fetch data Data Grid hoặc dùng POST .../download-file Excel zip lưu về máy tính làm file cứng.
PHẦN B. Dành cho Thao tác Giao diện Người dùng cuối (User)#
Dưới đây là phần hướng dẫn tính năng công cụ (Bỏ qua khía cạnh lập trình).B.1 Đăng nhập & Thông tin cá nhân#
Truy cập: Mở giao diện hệ thống đăng nhập tài khoản. Thay đổi thông tin cá nhân Profile và Mật khẩu ở góc Avartar cá nhân của bạn để bảo mật định kỳ.
B.2 Kiểm tra thứ hạng từ khóa SEO (Search Engine)#
Mục đích: Theo dõi vị trí Website khi có người gõ từ khóa trên bộ máy tìm kiếm Google/Bing.
1.
Mở menu tính năng Search Engine.
2.
Bấm "Thêm yêu cầu", rồi sao chép nhập danh sách "Từ khóa" và "Tên miền (Domain)" thương hiệu.
3.
Bấm bắt đầu lệnh quét. Load lại trang để xem khi Tool đã chạy ngầm và cập nhật Bảng xếp hạng.
4.
Bạn có chức năng Tải báo cáo Excel rất mượt để gửi tệp đi trực tiếp.
Mục đích: Vẽ trọn toàn bộ Internal Links (Nội bộ) và External Links (Ngoại dẫn đi) của một trang link landing post website bất kỳ. Tối ưu cực mạnh trong soi điểm chuẩn kỹ thuật PBN On-Page.
Thao tác: Đặt 1 trang đích vào hệ mục URL Extract > Bầu chạy. Chỉ vài giây công cụ trích xuất HTML sẽ chia rành mạch link, tải Excel Grid Grid file báo cáo phân tích rành mạch.
B.4 Phân loại trang vệ tinh (Detect Domain)#
Mục đích: Tính năng giúp ban quản trị ném 1 list lớn (hàng trăm Name Domains) để lọc 100% tự động xem những website nào là Website chính (Mainsite - Web có form Auth/Tương tác) hay là trang tin tạp nham Vệ tinh tĩnh (Satellite).
Thao tác: Nạp danh sách > Bấm Detect phân tích tự động dò quét HTML Input > Tải data danh sách lọc Mainsite và Quyết định Ẩn (Soft Deleted) các Domain không cần thiết ở Database hệ thống.
B.5 Auditing Chuyển hướng chuỗi Link (URL Redirect)#
Mục đích: Theo dõi xem Link chiến dịch A nó điều kiện chuyển về B -> C -> và lọt vào điểm J cuối cùng. Đo lường click qua URL Tracker có bị rò rỉ khi đẩy quảng cáo Ads Facebook/Google đắt tiền không.
Thao tác: Upload List URLs mồi ngắn đầu vào lên Form check > Đợi check Code HTTPS > Ấn Tải Bảng Xuất Excel Export báo cáo tình trạng từng Code 301/302/200 OK và "Đích đến" (Destination Domain).
B.6 Truy tìm Text Link Ẩn (Search Anchor)#
Mục đích: Check xem một URL bài đăng có ẩn chứa "Nội dung Text đính đằng sau liên kết" (Backlinks Anchor Text) để phục vụ cho đi mua SEO từ khóa đúng giá trị thực hay bị Spam lừa.
Thao tác: Vào mục Search Anchor Text > Nạp ngay tên miền mục tiêu và từ khóa rà soát > Bọn Crawler báo kết quả bằng Popup trực quan ngay trên Dashboard để xem Text này nằm bao quanh ở Đoạn Description/Title nào cực dễ đọc.
B.7 Log Truy sâu Request & Quản lý Danh sách an toàn trắng (Whitelist)#
Track Request Sâu: Nạp mã số cắm thẳng vào trang Client đích, theo vết cực sâu những hoạt động Request Ajax bí mật khi User nhấp link hay Event click nào đó. Tính năng nạp Data phi mã vào ổ cứng Elasticsearch (Động cơ máy chủ search) phục vụ search full text.
Danh sách trắng (Whitelist): Lập bảng "luật cấm" chặn Tool làm cháy băng thông tên miền đối tác tốt. Phải thông qua Panel Import List bằng API hoặc file danh sách "Sạch" vào Whitelist để bảo vệ các Domain đó không nằm trong blacklist Scan độc hại của Winads.
Ngày cập nhật 2026-03-25 09:27:34
