广告报表
所有广告类型的表现——从已同步的广告报表立即查询，或在需要时向亚马逊申请新报表——以及品牌指标。
一句话
大多数广告问题几秒内就能从已同步的 SP、SB、SD 报表得到答案。需要没有同步的报表形态时，AI 向亚马逊申请、等待生成并读取数据行。
取数的两种方式
先查已同步的报表
广告活动、广告组、关键词、投放、搜索词和展示位置报表按计划同步。query_report_data 立即筛选和汇总——“上个月 ACoS 高于 40% 的 SP 广告活动”无需等亚马逊。数据表列在数据标签页。
需要时申请新报表
ads_create_async_report 按你选择的列、分组和日期向亚马逊申请报表。亚马逊在后台生成；ads_get_async_report 查询状态，完成后返回数据行。
品牌指标
ads_generate_brand_metrics_report 和 ads_get_brand_metrics_report 返回品牌认知和考虑度指标——同样在后台生成。
可以这样问
“生成上个月 SP 广告活动的表现报表。”
“拉最近 30 天的搜索词报告，找出转化好但还没投的词。”
“给我看品牌指标报表。”
申请新报表的两种调用方式
MCP——你说：“拿一下上个月 SP 广告活动报表。” AI 调用 ads_create_async_report，再轮询 ads_get_async_report 直到完成。
在 AI 客户端中（MCP）
{
"name": "ads_create_async_report",
"arguments": {
"store": "myStore-US",
"countryCode": "US",
"body": {
"name": "SP campaigns last month",
"startDate": "2026-09-01",
"endDate": "2026-09-30",
"configuration": {
"adProduct": "SPONSORED_PRODUCTS",
"reportTypeId": "spCampaigns",
"format": "GZIP_JSON",
"groupBy": [
"campaign"
],
"columns": [
"campaignName",
"impressions",
"clicks",
"cost",
"sales14d"
],
"timeUnit": "SUMMARY"
}
}
}
}在代码中（Tool API）
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_create_async_report \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"US","body":{"name":"SP campaigns last month","startDate":"2026-09-01","endDate":"2026-09-30","configuration":{"adProduct":"SPONSORED_PRODUCTS","reportTypeId":"spCampaigns","format":"GZIP_JSON","groupBy":["campaign"],"columns":["campaignName","impressions","clicks","cost","sales14d"],"timeUnit":"SUMMARY"}}}'抢先体验 — 如需 Tool API 访问，请 联系我们.
本页用到的工具
| 工具 | 权限 | 作用（英文） |
|---|---|---|
query_report_data | read | Query the synced report warehouse (rpt_* tables) — rows without calling Amazon. |
ads_create_async_report | read | Request an Amazon Advertising performance report (async — not immediately available; poll with ads_get_async_report until status=COMPLETED, then read data.report rows). |
ads_get_async_report | read | Poll an Amazon Advertising report's status; auto-downloads and returns the rows in data.report once status=COMPLETED. |
ads_generate_brand_metrics_report | read | Request a Brand Metrics report — your brand's shopper-funnel metrics in a category against category peers (engaged-shopper rate, customer conversion rate, new-to-brand customer rat |
ads_get_brand_metrics_report | read | Poll a Brand Metrics report; when the server sees it finished, the same call also downloads the file, so there is no separate download step. |
常见问题
用已同步的还是新申请的？
按日期范围的问题用已同步的——立即返回，也不占亚马逊的调用限额。需要的形态没有同步时再申请。见已同步报表。
新报表最多能回溯多久？
大多数广告报表类型最多回溯 95 天。
有对应的技能吗？
有——amazon-ads 技能带有现成的报表请求体。见安装技能。