Hermoso kết nối với Apple Search Ads và cung cấp dữ liệu dưới dạng công cụ mà agent của bạn có thể gọi: Claude, ChatGPT, Cursor, Codex, Cline, CLI hoặc HTTP thuần. apple_ads_report lấy hiệu quả của chiến dịch, nhóm quảng cáo, quảng cáo, từ khóa và cụm từ tìm kiếm, và các dòng dữ liệu trả về dưới dạng dữ liệu có cấu trúc, không phải một file CSV tải xuống rồi bạn phải tự mang đi đâu đó.
Trình kết nối Apple Search Ads
Apple không công bố luồng OAuth cho API quảng cáo của họ, nên kết nối là một lần trao đổi key chứ không phải một nút bấm: Hermoso tạo khóa ký, bạn dán nửa công khai vào Apple Ads và dán lại ba mã. Hướng dẫn cài đặt Apple Search Ads đi qua từng bước, kể cả trường Public Key mà hầu hết mọi người không tìm thấy. Một kết nối duy nhất phục vụ cả ứng dụng web, máy chủ MCP, CLI và REST API, nên cùng một lần xuất dữ liệu chạy được từ Claude, ChatGPT hoặc Cursor: kết nối Apple Search Ads với Claude hoặc với ChatGPT một lần, rồi cứ hỏi.
Báo cáo chỉ là một phần. Cùng kết nối đó cũng xây dựng và vận hành tài khoản: chiến dịch, nhóm quảng cáo, từ khóa và từ khóa phủ định, đơn ngân sách, nhắm mục tiêu, gợi ý từ khóa và lịch sử thay đổi. Trang kênh Apple Ads liệt kê mọi công cụ.
Báo cáo chứa những gì
Một lần gọi, năm cấp độ. apple_ads_report báo cáo ở cấp chiến dịch, nhóm quảng cáo, quảng cáo, từ khóa hoặc cụm từ tìm kiếm, và mỗi dòng mang đầy đủ các chỉ số mà bảng điều khiển của chính Apple hiển thị: lượt hiển thị, lượt chạm, lượt cài đặt, chi tiêu, tỷ lệ nhấp, chi phí mỗi lượt chạm và chi phí mỗi lượt cài đặt. Bạn có thể yêu cầu tổng, hoặc một chuỗi theo độ chi tiết theo giờ, ngày, tuần hoặc tháng. Các dòng được sắp xếp theo chi tiêu, cao nhất trước, tối đa 5.000 dòng mỗi trang, và có thể kèm một dòng tổng nếu bạn yêu cầu. Báo cáo App Store cũng có thể bao gồm các thực thể không có lượt hiển thị, nên một từ khóa đang tạm dừng sẽ hiện là số không thay vì biến mất khỏi danh sách.
Hai quy tắc do Apple áp dụng, và công cụ giải thích rõ chứ không lỗi âm thầm: báo cáo dưới cấp chiến dịch cần một mã chiến dịch (chỉ báo cáo cấp chiến dịch mới bao phủ được toàn bộ tài khoản), và báo cáo cụm từ tìm kiếm chạy theo múi giờ của tổ chức bạn, không bao giờ theo UTC. Quảng cáo trên Apple Maps cũng được bao phủ: báo cáo cho chiến dịch thương hiệu doanh nghiệp đến từ cùng công cụ đó, chỉ cần đổi một tham số.
Kết nối Apple Search Ads với Google Sheets
Đây là đích duy nhất mà chính Hermoso ghi vào. Kết nối Google Drive cùng với Apple Ads (một lần cấp quyền Google bao gồm Drive, Sheets và Docs), rồi yêu cầu: "Lấy hiệu quả Apple Search Ads theo từ khóa trong 30 ngày gần nhất và đưa vào một sheet mới tên Apple Ads." Agent gọi apple_ads_report, rồi create_sheet, và trả về đường link. Tuần sau, cùng yêu cầu đó với từ "thêm vào" thay vì "sheet mới" sẽ dùng append_to_sheet để thêm dòng mới thay vì bắt đầu lại từ đầu.
Hermoso xin Google phạm vi drive.file, chỉ truy cập các file mà nó tạo ra và các file bạn chọn, chứ không phải toàn bộ Drive của bạn. Hướng dẫn đầy đủ, kể cả việc thay thế một tab tại chỗ và định dạng nó, nằm ở Kết nối Apple Search Ads với Google Sheets.
Xuất Apple Search Ads sang Looker Studio
Hermoso không có connector Looker Studio gốc, và chúng tôi thà nói thẳng còn hơn ngụ ý là có. Nhưng không cần: Looker Studio đọc Google Sheets bằng connector tích hợp sẵn của nó, nên sheet ở trên chính là cầu nối.
- Yêu cầu agent ghi báo cáo vào một tab. Độ chi tiết theo ngày, mỗi từ khóa một dòng cho mỗi ngày, một dòng tiêu đề và một cột ngày. Yêu cầu định dạng cột ngày thành kiểu ngày (
format_sheetlàm việc này) để Looker Studio đọc đúng là ngày. - Thêm sheet làm nguồn dữ liệu. Trong Looker Studio, tạo nguồn dữ liệu, chọn Google Sheets, chọn bảng tính và tab đó, và giữ tùy chọn "Use first row as headers" bật.
- Xây báo cáo một lần. Chi tiêu theo ngày, chi phí mỗi lượt cài đặt theo từ khóa, lượt cài đặt theo chiến dịch: bất cứ thứ gì bạn sẽ phải dựng lại trong bảng tính mỗi thứ Hai.
- Tiếp tục thêm dòng. Mỗi tuần, agent thêm dòng mới vào cùng một tab, và dashboard lấy chúng ở lần làm mới dữ liệu tiếp theo. Giữ tên cột giống nhau giữa các lần chạy, vì Looker Studio ánh xạ trường theo tiêu đề.
Cùng sheet đó hoạt động với Power BI và Tableau, vì cả hai đều có connector Google Sheets riêng.
Xuất Apple Search Ads sang JSON
Nếu bạn muốn các dòng dữ liệu thô thay vì một bảng tính, có ba cách để lấy, tất cả đều dùng cùng một kết nối.
REST API. Mọi công cụ Hermoso đều gọi được tại POST /v1/tools/{name} bằng một API key bạn tạo trong ứng dụng, tại tab MCP & CLI. Thân yêu cầu là các tham số của công cụ, và trường data của phản hồi là kết quả có cấu trúc, với các dòng nằm trong data.rows:
curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
-H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
-d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
| jq '.data.rows' > apple-search-ads.jsonCLI. npx -y hermoso call apple_ads_report --json '{...}' --structured in ra cùng kết quả có cấu trúc dưới dạng JSON, sẵn sàng chuyển hướng vào file hoặc đưa vào một script khác.
Agent của bạn. Trong bất kỳ cuộc trò chuyện nào, hãy yêu cầu các dòng dưới dạng JSON và bạn sẽ nhận được chúng ngay trong câu trả lời, đã được định dạng theo đúng cách bạn muốn.
Với báo cáo dài, limit nhận tối đa 5.000 dòng mỗi trang và offset chuyển sang trang kế tiếp; hasMore trong kết quả cho biết có trang nữa hay không. Đọc báo cáo không tiêu tốn credit. Tài liệu API đầy đủ nằm trong tài liệu dành cho nhà phát triển.
Các đích khác
"Trực tiếp" nghĩa là Hermoso tự ghi. Mọi thứ khác là một bước mà công cụ bạn đang dùng tự làm.
- Google Sheets, Google Docs, Google Drive, OneDrive: trực tiếp.
- Looker Studio, Power BI, Tableau: qua sheet, mỗi công cụ dùng connector Google Sheets riêng của nó.
- BigQuery: qua sheet, hoặc qua chính agent của bạn. BigQuery có thể truy vấn một Google Sheet như một bảng ngoài. Nếu agent của bạn chạy ở nơi có BigQuery client và thông tin xác thực dự án của bạn, nó có thể chèn trực tiếp các dòng Hermoso trả về vào một bảng.
- Excel: qua sheet hoặc file. Tải sheet xuống dạng .xlsx, hoặc để agent lưu một file vào Google Drive hay OneDrive.
- PostgreSQL, Redshift, Snowflake hoặc bất kỳ kho dữ liệu nào: qua agent của bạn hoặc API. Hermoso trả về JSON; thứ nắm giữ thông tin đăng nhập cơ sở dữ liệu của bạn sẽ ghi nó vào. Hermoso không giữ thông tin đăng nhập kho dữ liệu.
Tự động hóa việc xuất hàng tuần
Chính câu lệnh là tự động hóa. Một câu như "Mỗi thứ Hai, lấy hiệu quả Apple Search Ads của tuần trước theo từ khóa cho mọi chiến dịch, thêm vào sheet Apple Ads, và cho tôi biết những từ khóa nào thay đổi nhiều nhất về chi phí mỗi lượt cài đặt" đã là một công việc hoàn chỉnh. Chạy nó theo lịch với công cụ lập lịch mà client của bạn đã có (tác vụ định kỳ trong Claude hoặc ChatGPT, hoặc một cron job gọi CLI hay API của Hermoso), và sheet cùng mọi dashboard đọc từ nó sẽ luôn cập nhật.
Vì cùng kết nối đó cũng chỉnh sửa tài khoản, báo cáo và việc sửa lỗi nằm trong cùng một chỗ: agent nhận ra chi phí mỗi lượt cài đặt của một từ khóa tăng gấp đôi có thể tạm dừng nó hoặc thêm từ khóa phủ định ngay trong cùng cuộc trò chuyện.
Câu hỏi thường gặp
Làm thế nào để xuất dữ liệu từ Apple Search Ads?
Kết nối Apple Ads với Hermoso một lần, rồi yêu cầu agent lấy báo cáo bạn muốn, ví dụ hiệu quả theo từ khóa của tuần trước. Công cụ apple_ads_report lấy dữ liệu từ API báo cáo của Apple và agent ghi nó vào Google Sheet, trả về JSON cho bạn, hoặc cả hai.
Tôi có thể kết nối Apple Search Ads với Google Sheets không?
Có. Kết nối Apple Ads và Google Drive trong Hermoso, rồi yêu cầu agent đưa báo cáo vào một sheet. Nó tạo sheet bằng create_sheet, hoặc thêm dòng vào sheet có sẵn bằng append_to_sheet, và có thể lặp lại việc đó mỗi tuần.
Tôi có thể xuất Apple Search Ads sang Looker Studio không?
Có, thông qua Google Sheets. Hermoso không có connector Looker Studio gốc. Agent ghi báo cáo vào một sheet, bạn thêm sheet đó làm nguồn dữ liệu Google Sheets trong Looker Studio một lần, và mỗi lần thêm dòng sẽ hiện trên lần làm mới tiếp theo của dashboard.
Làm thế nào để xuất dữ liệu Apple Search Ads ra JSON?
Gọi POST /v1/tools/apple_ads_report trên API Hermoso bằng một API key rồi đọc data.rows từ phản hồi, hoặc chạy hermoso call apple_ads_report --json '{...}' --structured từ CLI. Cả hai đều trả về cùng các dòng dưới dạng JSON.
Có API báo cáo cho Apple Search Ads không?
Có, và Hermoso được xây dựng trên nó. apple_ads_report bao phủ hiệu quả ở cấp chiến dịch, nhóm quảng cáo, quảng cáo, từ khóa và cụm từ tìm kiếm, còn các công cụ Apple Ads khác dùng để xây dựng và quản lý tài khoản.
Tôi có lấy được báo cáo cụm từ tìm kiếm của Apple Search Ads không?
Có. Yêu cầu cấp cụm từ tìm kiếm và nêu tên chiến dịch. Apple chỉ cung cấp cụm từ tìm kiếm theo từng chiến dịch, theo múi giờ của chính tổ chức.
Một báo cáo có thể trả về bao nhiêu dòng?
Tối đa 5.000 dòng mỗi trang, sắp xếp theo chi tiêu từ cao xuống thấp, kèm một cờ cho agent biết có trang nào nữa không. Báo cáo từ khóa hàng tuần của đa số tài khoản vừa trong một trang.
Điều này có bao phủ quảng cáo trên Apple Maps không?
Có. Báo cáo cho chiến dịch thương hiệu doanh nghiệp đến từ cùng công cụ đó, với loại đối tượng quảng bá được đặt thành Apple Maps thay vì App Store.
Tôi có cần lập trình viên để thiết lập không?
Không. Kết nối Apple Ads một lần trong ứng dụng, rồi hỏi agent bằng ngôn ngữ thường: lấy báo cáo tuần trước theo từ khóa và đưa vào một sheet. API và CLI có đó nếu bạn muốn viết script.