hermoso
登录 注册
MCP & CLI
API定价
登录 注册

从 Apple Search Ads 导出数据

Apple 提供了报告 API，却没有一个能把数字直接送到你工作地点的导出按钮。Hermoso 连接器会为你拉取报告，并把它放进 Google 表格、Looker Studio 仪表板或 JSON 文件。

Hermoso 连接 Apple Search Ads，并将其作为工具提供给你的智能体调用：Claude、ChatGPT、Cursor、Codex、Cline、CLI 或普通 HTTP。apple_ads_report 会拉取广告系列、广告组、广告、关键词和搜索词的表现，而且返回的是数据行，而不是需要你再搬运到别处的 CSV 下载文件。

Apple Search Ads 连接器

Apple 没有为其广告 API 提供 OAuth 流程，因此连接靠的是密钥交换，而不是点一下按钮：Hermoso 生成签名密钥，你把它的公钥部分粘贴到 Apple Ads，然后把三个 ID 粘贴回来。Apple Search Ads 设置指南会逐步讲解，包括大多数人找不到的 Public Key 字段。一个连接同时服务网页应用、MCP 服务器、CLI 和 REST API，因此同样的导出可以从 Claude、ChatGPT 或 Cursor 发起：只需将 Apple Search Ads 连接到 Claude或连接到 ChatGPT一次，然后提问即可。

报告只是其中一部分。同一个连接还能搭建和运行账户：广告系列、广告组、关键词和否定词、预算订单、定向、关键词推荐和变更历史。Apple Ads 渠道页面列出了每个工具。

报告包含什么

一次调用，五个层级。apple_ads_report 可以在广告系列、广告组、广告、关键词或搜索词层级生成报告，每一行都包含 Apple 自家仪表板显示的指标：展示、点击、安装、花费、点击率、单次点击成本和单次获取成本。你可以要求总计，也可以要求按小时、天、周或月粒度的序列。行按花费从高到低排列，每页最多 5,000 行，并可按需附带总计行。App Store 报告还可以包含没有投放的实体，因此暂停的关键词会显示为零，而不是缺失的一行。

Apple 强制执行两条规则，工具会解释原因而不是悄悄失败：广告系列层级以下的报告需要广告系列 ID（只有广告系列层级的报告才能覆盖整个账户），而搜索词报告按你的组织自己的时区运行，绝不是 UTC。Apple Maps 上的广告也包括在内：商业品牌报告通过同一个工具生成，只需更改一个参数。

将 Apple Search Ads 连接到 Google 表格

这是 Hermoso 自己会写入的唯一目的地。在 Apple Ads 旁边连接 Google Drive（一次 Google 授权即可覆盖 Drive、表格和文档），然后提问：“Pull Apple Search Ads performance by keyword for the last 30 days and put it in a new sheet called Apple Ads.”智能体会调用 apple_ads_report，然后调用 create_sheet，并返回链接。下周再发同样的请求，但说“追加”，就会用 append_to_sheet 添加行，而不是从头开始。

Hermoso 向 Google 请求 drive.file 权限范围，它只能访问自己创建的文件以及你选中的文件，绝不会访问你的整个 Drive。包括替换某个标签页、为其设置格式在内的完整演练，见将 Apple Search Ads 连接到 Google 表格。

将 Apple Search Ads 导出到 Looker Studio

Hermoso 没有原生的 Looker Studio 连接器，我们宁可直说，也不暗示有。它并不需要：Looker Studio 通过自带的内置连接器读取 Google 表格，所以上面那张表格就是桥梁。

  1. 让智能体把报告写入一个标签页。每日粒度，每个关键词每天一行，有标题行和日期列。要求把日期列设置为日期格式（format_sheet 可以完成），这样 Looker Studio 才会把它识别为日期。
  2. 把表格添加为数据源。在 Looker Studio 中新建数据源，选择 Google Sheets，挑选电子表格和该标签页，并保持“使用第一行作为标题”开启。
  3. 一次性搭建报告。按天的花费、按关键词的单次获取成本、按广告系列的安装量：凡是你原本每周一都要在表格里重做的内容，都放在这里。
  4. 持续追加。每周，智能体都会把新行追加到同一个标签页，仪表板会在下一次数据刷新时获取它们。两次运行之间保持列名不变，因为 Looker Studio 通过标题映射字段。

同一张表格也适用于 Power BI 和 Tableau，它们都有自己的 Google Sheets 连接器。

将 Apple Search Ads 导出为 JSON

如果你想要原始数据行而不是电子表格，有三种获取方式，都使用同一个连接。

REST API。每个 Hermoso 工具都可以通过 POST /v1/tools/{name} 调用，使用你在应用的 MCP & CLI 标签页中创建的 API 密钥。请求体就是该工具的参数，响应中的 data 字段是结构化结果，数据行位于 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.json

CLI。npx -y hermoso call apple_ads_report --json '{...}' --structured 会以 JSON 形式输出相同的结构化结果，可直接重定向到文件，或通过管道交给另一个脚本。

你的智能体。在任何对话中要求以 JSON 返回数据行，回复中就会按你要求的形状直接给出。

对于长报告，limit 每页最多取 5,000 行，offset 翻到下一页；结果中的 hasMore 表示是否还有下一页。读取报告不消耗积分。完整的 API 参考见开发者文档。

其他目的地

“直接”表示由 Hermoso 写入。其他所有方式，都是你已经在用的工具自己完成的一步。

  • Google 表格、Google 文档、Google Drive、OneDrive：直接写入。
  • Looker Studio、Power BI、Tableau：通过表格，各自使用自己的 Google 表格连接器。
  • BigQuery：通过表格，或通过你自己的智能体。BigQuery 可以把 Google 表格当作外部表来查询。如果你的智能体运行在带有 BigQuery 客户端和你的项目凭据的环境中，它可以把 Hermoso 返回的行直接插入一张表。
  • Excel：通过表格或文件。将表格下载为 .xlsx，或让智能体把文件留在 Google Drive 或 OneDrive 中。
  • PostgreSQL、Redshift、Snowflake 或任何数据仓库：通过你自己的智能体或 API。Hermoso 返回 JSON；保存你数据库凭据的那一方负责写入。Hermoso 不保存数据仓库凭据。

自动化每周导出

提示词本身就是自动化。像这样的一句话：“Every Monday, pull last week's Apple Search Ads performance by keyword for every campaign, append it to the Apple Ads sheet, and tell me which keywords moved most on cost per acquisition”，就是一个完整的任务。用你的客户端已有的定时功能按周期运行（Claude 或 ChatGPT 中的定时任务，或调用 Hermoso CLI 或 API 的 cron 任务），表格以及所有读取它的仪表板就会保持最新。

由于同一个连接也能编辑账户，报告和修复都在同一个地方完成：当智能体发现某个关键词的单次获取成本翻倍时，它可以在同一个对话中暂停该关键词或添加一个否定词。

常见问题

如何从 Apple Search Ads 导出数据？

先把 Apple Ads 连接到 Hermoso 一次，然后向你的智能体要求所需的报告，例如上周按关键词的表现。apple_ads_report 工具会从 Apple 的报告 API 拉取数据，智能体会把它写入 Google 表格、交给你 JSON，或两者兼而有之。

我能把 Apple Search Ads 连接到 Google 表格吗？

可以。在 Hermoso 中连接 Apple Ads 和 Google Drive，然后让智能体把报告放进表格。它会用 create_sheet 创建表格，或用 append_to_sheet 向已有表格添加行，并可以每周重复执行。

我能把 Apple Search Ads 导出到 Looker Studio 吗？

可以，通过 Google 表格实现。Hermoso 没有原生的 Looker Studio 连接器。智能体把报告写入表格，你在 Looker Studio 中把该表格添加为一次性的 Google 表格数据源，之后每次追加的数据都会在仪表板下一次刷新时显示。

如何把 Apple Search Ads 数据导出为 JSON？

用 API 密钥调用 Hermoso API 的 POST /v1/tools/apple_ads_report，并从响应中读取 data.rows；或者在 CLI 中运行 hermoso call apple_ads_report --json '{...}' --structured。两者返回的都是相同的 JSON 数据行。

Apple Search Ads 有报告 API 吗？

有，而且 Hermoso 就是构建在它之上的。apple_ads_report 涵盖广告系列、广告组、广告、关键词和搜索词的表现，其他 Apple Ads 工具则负责搭建和管理账户。

我能获取 Apple Search Ads 的搜索词报告吗？

可以。请求搜索词层级并指定广告系列即可。Apple 只按广告系列提供搜索词数据，并使用组织自己的时区。

一份报告最多能返回多少行？

每页最多 5,000 行，按花费从高到低排序，并有一个标记告诉智能体是否还有更多页。对大多数账户来说，每周的关键词报告都能放进一页。

这能覆盖 Apple Maps 上的广告吗？

可以。商业品牌广告系列的报告通过同一个工具生成，只需把推广对象类型设为 Apple Maps，而不是 App Store。

我需要开发人员来设置吗？

不需要。在应用中连接一次 Apple Ads，然后用普通语言向你的智能体提问：按关键词拉取上周数据并放进表格。如果你确实想写脚本，API 和 CLI 也都在那里。

免费开始，无需信用卡，每个套餐都包含全部功能。

免费开始 →   查看价格