# 广告报表 (https://sellersheetai.com/zh/docs/mcp-api/workflows/ads-reports)

> 所有广告类型的表现——从已同步的广告报表立即查询，或在需要时向亚马逊申请新报表——以及品牌指标。



<Callout title="一句话">
  大多数广告问题几秒内就能从已同步的 SP、SB、SD 报表得到答案。需要没有同步的报表形态时，AI 向亚马逊申请、等待生成并读取数据行。
</Callout>

## 取数的两种方式 [#取数的两种方式]

<Steps>
  <Step>
    ### 先查已同步的报表 [#先查已同步的报表]

    广告活动、广告组、关键词、投放、搜索词和展示位置报表按计划同步。`query_report_data` 立即筛选和汇总——“上个月 ACoS 高于 40% 的 SP 广告活动”无需等亚马逊。数据表列在[数据](/zh/docs/data)标签页。
  </Step>

  <Step>
    ### 需要时申请新报表 [#需要时申请新报表]

    `ads_create_async_report` 按你选择的列、分组和日期向亚马逊申请报表。亚马逊在后台生成；`ads_get_async_report` 查询状态，完成后返回数据行。
  </Step>

  <Step>
    ### 品牌指标 [#品牌指标]

    `ads_generate_brand_metrics_report` 和 `ads_get_brand_metrics_report` 返回品牌认知和考虑度指标——同样在后台生成。
  </Step>
</Steps>

## 可以这样问 [#可以这样问]

> “生成上个月 SP 广告活动的表现报表。”

> “拉最近 30 天的搜索词报告，找出转化好但还没投的词。”

> “给我看品牌指标报表。”

## 申请新报表的两种调用方式 [#申请新报表的两种调用方式]

**MCP**——你说：“拿一下上个月 SP 广告活动报表。” AI 调用 `ads_create_async_report`，再轮询 `ads_get_async_report` 直到完成。

<ToolCall tool="ads_create_async_report" args="{ countryCode: &#x22;US&#x22;, body: { name: &#x22;SP campaigns last month&#x22;, startDate: &#x22;2026-09-01&#x22;, endDate: &#x22;2026-09-30&#x22;, configuration: { adProduct: &#x22;SPONSORED_PRODUCTS&#x22;, reportTypeId: &#x22;spCampaigns&#x22;, format: &#x22;GZIP_JSON&#x22;, groupBy: [&#x22;campaign&#x22;], columns: [&#x22;campaignName&#x22;, &#x22;impressions&#x22;, &#x22;clicks&#x22;, &#x22;cost&#x22;, &#x22;sales14d&#x22;], timeUnit: &#x22;SUMMARY&#x22; } } }" lang="zh" />

## 本页用到的工具 [#本页用到的工具]

<ToolList tools="[&#x22;query_report_data&#x22;, &#x22;ads_create_async_report&#x22;, &#x22;ads_get_async_report&#x22;, &#x22;ads_generate_brand_metrics_report&#x22;, &#x22;ads_get_brand_metrics_report&#x22;]" lang="zh" />

## 常见问题 [#常见问题]

### 用已同步的还是新申请的？ [#用已同步的还是新申请的]

按日期范围的问题用已同步的——立即返回，也不占亚马逊的调用限额。需要的形态没有同步时再申请。见[已同步报表](/zh/docs/mcp-api/workflows/reports)。

### 新报表最多能回溯多久？ [#新报表最多能回溯多久]

大多数广告报表类型最多回溯 95 天。

### 有对应的技能吗？ [#有对应的技能吗]

有——`amazon-ads` 技能带有现成的报表请求体。见[安装技能](/zh/docs/start/skills)。