HilltopAds MCP là gì?
MCP Server (Model Context Protocol) là trình kết nối chính thức của HilltopAds dành cho các ứng dụng AI. Sau khi kết nối, AI có thể truy cập dữ liệu tài khoản của bạn và, khi được bạn cho phép, thực hiện các thao tác như tạo hoặc cập nhật chiến dịch thông qua một kênh bảo mật chuyên dụng mà không cần bạn phải sao chép và dán dữ liệu thủ công.
Tên đăng nhập và mật khẩu của bạn sẽ không bao giờ được chia sẻ với ứng dụng AI. Kết nối được xác thực bằng API Key mà bạn tự tạo trong tài khoản của mình.
Trình kết nối này cung cấp quyền truy cập vào tài khoản HilltopAds của bạn thông qua một bộ công cụ (Tools). AI sẽ tự động chọn công cụ phù hợp với yêu cầu của bạn, thực hiện thao tác và trình bày kết quả dưới dạng dễ đọc như bảng, bản tóm tắt hoặc thậm chí là biểu đồ.
Bạn có thể làm gì với nó?
Các công cụ được chia thành hai nhóm:
Read Operations (Thao tác đọc): Truy xuất dữ liệu như số dư tài khoản, inventory, thống kê, thông tin chi tiết của một chiến dịch hoặc danh sách nguồn traffic của chiến dịch.
Action Operations (Thao tác thực hiện): Thực hiện thay đổi trên tài khoản của bạn như tạo hoặc cập nhật chiến dịch, khởi động hoặc dừng chiến dịch, điều chỉnh giá thầu (Bid), URL đích và quản lý danh sách đen (Blacklist) hoặc danh sách trắng (Whitelist) của nguồn traffic.
Các công cụ khả dụng phụ thuộc vào loại tài khoản của bạn: Advertiser, Publisher hoặc cả hai. Hiện tại, trình kết nối hỗ trợ 27 thao tác, gồm 23 thao tác dành cho Advertiser và 4 thao tác dành cho Publisher.
Action Operations chỉ được thực hiện sau khi bạn xác nhận. Các ứng dụng AI sẽ đánh dấu công cụ là chỉ đọc (Read-only) hoặc ghi/xóa (Write/Delete) và yêu cầu bạn xác nhận trước khi thực hiện bất kỳ thay đổi nào.
Công cụ tài khoản và báo cáo
Công cụ | Chức năng |
| Hiển thị số dư hiện tại của tài khoản Advertiser. |
| Hiển thị các chiến dịch và quảng cáo của bạn. |
| Hiển thị số liệu thống kê được lọc hoặc nhóm theo ngày, zone, GEO, chiến dịch, hệ điều hành, giờ hoặc nguồn traffic. |
| Hiển thị thông tin chi tiết của một chiến dịch theo Campaign ID. |
Công cụ quản lý chiến dịch
Lưu ý: Trong các ví dụ ở phần sau của hướng dẫn này, trợ lý sẽ tạo mỗi chiến dịch ở trạng thái Inactive để bạn có thể xem lại trước khi chiến dịch bắt đầu tiêu ngân sách. Đây chỉ là thiết lập mặc định do trợ lý lựa chọn, không phải là quy tắc bắt buộc. Nếu bạn muốn chiến dịch được tạo ở trạng thái Inactive hoặc được khởi chạy ngay lập tức, hãy nêu rõ điều đó trong yêu cầu của bạn.
Công cụ | Chức năng |
| Tạo một chiến dịch mới. |
| Cập nhật một phần cài đặt của chiến dịch. |
| Kích hoạt một chiến dịch đã được phê duyệt. |
| Dừng một chiến dịch đang chạy. |
| Chuyển chiến dịch vào kho lưu trữ. |
| Khôi phục chiến dịch từ kho lưu trữ. |
| Thay đổi giá thầu (Bid) cho Wildcard GEO. |
| Thay đổi URL đích của chiến dịch Popunder. |
| Thay thế một tên miền trong tất cả quảng cáo của tài khoản Advertiser. |
Công cụ quản lý Source Blacklist
Công cụ | Chức năng |
| Hiển thị Source Blacklist của một chiến dịch. |
| Thêm nguồn traffic vào Blacklist. |
| Xóa nguồn traffic khỏi Blacklist. |
| Xóa toàn bộ Blacklist của chiến dịch. |
| Thay thế toàn bộ Blacklist và chuyển chiến dịch sang chế độ BLACKLIST. |
Công cụ quản lý Source Whitelist
Công cụ | Chức năng |
| Hiển thị Source Whitelist của một chiến dịch. |
| Thêm nguồn traffic vào Whitelist. |
| Xóa nguồn traffic khỏi Whitelist. |
| Xóa toàn bộ Whitelist của chiến dịch. |
| Thay thế toàn bộ Whitelist và chuyển chiến dịch sang chế độ WHITELIST. |
