Kết nối Apple Ads và Google Drive với Hermoso, và cả hai sẽ có thể được gọi từ cùng một agent. apple_ads_report lấy các dòng hiệu quả; create_sheet và append_to_sheet đưa chúng vào một bảng tính bạn sở hữu. Không có file xuất, không có kho dữ liệu, không có công cụ thứ ba nào giữ thông tin đăng nhập của bạn.
Trông như thế nào
"Lấy chi tiêu Apple Search Ads tuần trước theo từ khóa và thêm vào sheet Apple Ads của tôi." Agent gọi báo cáo, định hình các dòng và thêm chúng vào. Hỏi lại vào thứ Hai tuần sau, sheet sẽ dài thêm một tuần.
Phạm vi Drive mà Hermoso xin là drive.file, chỉ truy cập các file nó tạo ra hoặc các file bạn chọn, chứ không phải toàn bộ Drive của bạn.
Cách kết nối Apple Search Ads với Google Sheets
- Kết nối cả hai tài khoản. Trong ứng dụng, mở Trình kết nối và kết nối Apple Ads, rồi Google Drive. Sheets và Docs dùng chung cùng một lần cấp quyền Google, nên chỉ có một màn hình đồng ý, không phải ba. Apple Ads là một lần trao đổi key chứ không phải một nút bấm; hướng dẫn cài đặt Apple Search Ads có đầy đủ, kể cả cách kết nối Apple Search Ads với Claude hoặc với ChatGPT, nơi bạn sẽ gõ yêu cầu.
- Yêu cầu lần lấy đầu tiên. "Lấy hiệu quả Apple Search Ads theo chiến dịch 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ồicreate_sheet, và trả về đường link. - Biến nó thành định kỳ. Đúng câu đó nhưng dùng "thêm vào" thay vì "sheet mới", chạy theo lịch từ client bạn dùng (tác vụ định kỳ trong Claude hoặc ChatGPT, hoặc một cron job gọi Hermoso CLI), sẽ thêm một khối dòng mỗi lần. Không có gì bị ghi đè trừ khi bạn yêu cầu.
- Trỏ dashboard vào sheet. Looker Studio, Power BI và Tableau đều đọc Google Sheets bằng connector riêng của chúng.
Sheet trông như thế nào
Một dòng cho mỗi thực thể mỗi kỳ. Các cột theo cấp độ bạn yêu cầu (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) cộng với các chỉ số Apple báo cáo: 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. Yêu cầu độ chi tiết theo ngày thì mỗi thực thể có một dòng mỗi ngày; yêu cầu tổng thì mỗi thực thể chỉ có một dòng. Agent có thể thêm một dòng tổng, và trên báo cáo App Store, nó có thể giữ các thực thể không có lượt hiển thị để một từ khóa đang tạm dừng hiện là số không thay vì biến mất.
Vì agent định hình các dòng trước khi ghi, bạn có thể yêu cầu đúng sheet mình muốn: chỉ các từ khóa vượt ngưỡng chi tiêu, tên chiến dịch đặt cạnh mã của nó, hoặc thay đổi theo tuần đã được tính sẵn trước khi ghi. Đó là công việc mà một file CSV xuất ra sẽ để lại cho bạn.
Thêm, thay thế hay định dạng
Các công cụ Sheets bao phủ toàn bộ việc chỉnh sửa: append_to_sheet thêm dòng, update_sheet ghi một vùng tại chỗ, clear_sheet_range xóa một vùng trước khi bạn muốn thay thế thay vì chồng thêm, format_sheet xử lý tiêu đề, độ rộng cột và định dạng số, và manage_sheet_tabs cho mỗi chiến dịch hoặc mỗi tháng một tab riêng. Yêu cầu "làm mới sheet dashboard" là xóa rồi ghi, trên tab bạn chỉ định.
Xuất Apple Search Ads sang Looker Studio từ sheet
Hermoso không có connector Looker Studio gốc; sheet chính là cầu nối. Trong Looker Studio, tạo một nguồn dữ liệu, chọn Google Sheets, và chọn bảng tính cùng tab mà agent thêm dòng vào. Xây báo cáo một lần rồi để đó. Mỗi lần thêm dòng sẽ hiện trên lần làm mới dữ liệu tiếp theo của dashboard, miễn là tiêu đề cột giữ nguyên giữa các lần chạy. Cách làm này cũng áp dụng được cho Power BI và Tableau.
Muốn JSON thay vì sheet?
Cùng báo cáo đó cũng có dưới dạng JSON thô từ API Hermoso (POST /v1/tools/apple_ads_report) hoặc CLI. Xem Xuất Apple Search Ads sang JSON, và xuất dữ liệu từ Apple Search Ads để biết mọi đích khác.
Câu hỏi thường gặp
Làm thế nào để kết nối Apple Search Ads với Google Sheets?
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ó lấy các dòng bằng apple_ads_report và ghi chúng bằng create_sheet hoặc append_to_sheet, rồi trả về đường link.
Hermoso có cần quyền truy cập toàn bộ Google Drive của tôi không?
Không. Hermoso xin drive.file, phạm vi này bao gồm các file Hermoso tạo ra và các file bạn chọn một cách rõ ràng.
Những cấp độ và chỉ số nào có thể đưa vào sheet?
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ới 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, dưới dạng tổng hoặc chuỗi theo giờ, ngày, tuần hoặc tháng.
Báo cáo định kỳ có ghi đè lên sheet của tôi không?
Không, trừ khi bạn yêu cầu. Thêm vào thì chỉ thêm dòng; thay thế là xóa rồi ghi trên tab bạn chỉ định, và agent chỉ làm việc đó khi yêu cầu nói rõ.
Looker Studio hay Power BI có đọc được kết quả không?
Có. Hermoso không có connector gốc cho cả hai, nhưng cả hai đều đọc Google Sheets bằng connector riêng, nên dashboard xây trên sheet sẽ làm mới khi agent thêm dòng vào.
Báo cáo có thể chạy theo lịch không?
Có, từ client mà agent của bạn chạy: một tác vụ định kỳ trong Claude hoặc ChatGPT, hoặc một cron job gọi CLI hoặc API của Hermoso. Mỗi lần chạy lấy kỳ mới và thêm vào.