跳转到内容
Picaro.AI Picaro.AI Prompt Library

生成报告

在本页，AI 会一气呵成地组装月度·周度报告，并以 HTML 幻灯片资料的形式输出。从调查数据 → 确认数据是否齐备的事前检查 → 数据采集 → 幻灯片结构 → HTML 化，既可以用一条指示一次性完成，也可以逐步确认着推进。

本页基本信息

Section titled “本页基本信息”
项目内容
本页能做什么指定对象期间·对比期间，生成汇总了 KPI 与幻灯片的 HTML 报告。同时也可以保存·复用报告设置，以及调查可用的数据源
对象报告（HTML 幻灯片资料）。内容以赞助商品广告（SP）为中心的 KPI·贡献度分析
所需数据·连接已连接账户的广告实绩·搜索数据（无需额外设置）。若要把做好的 HTML 通过 Slack 等分发，需准备好共享对象
执行范围多数为仅生成报告（生成 HTML 等），不更改广告设置。 但提示词 3 的「报告设置的保存·删除」属于设置的记录（持久化），删除无法撤销。各提示词会在「设置变更」中分别标示

这些场景下使用

Section titled “这些场景下使用”
  • 想指定对象期间和对比期间，用一条指示一次性做出月度·周度报告
  • 想逐步确认内容、并先确认数据是否齐备，来组装报告
  • 想把幻灯片结构和阈值保存为设置，以便每月做出相同形式的报告
  • 新建报告设置时，想调查可用的数据源候选
  • 想用表格查看环比的月度对比、年初至今（YTD）汇总、近 3 个月的趋势

执行前需确认

Section titled “执行前需确认”
  • 连接的账户 … 处理多个账户时，先确认对象账户是否正确。
  • 对象期间与对比期间 … 多数提示词会用到。若不指定，则使用最近已确定的期间及其之前同样长度的期间。当天·前一天的数据可能尚未确定，因此已确定的最近期间更安全。
  • 已保存的报告设置（可选） … 若想每月做成相同形式，先用 提示词 3 保存设置，之后的生成便可调用。

提示词速查表

Section titled “提示词速查表”
想做的事能知道·能得到什么设置变更提示词
保存报告设置以便每月复用列表·查看·保存·删除的结果保存·删除设置（记录；删除不可撤销）提示词 3
调查报告可用的数据源候选数据源列表（最多前 5 件）无变更（仅做调查）提示词 4
做出环比的月度对比报告主要 KPI 的本月·上月·差分对比表无变更（仅生成报告）提示词 5
做出年初至今（YTD）汇总按月的 KPI 走势与年度累计表无变更（仅生成报告）提示词 6
确认近 3 个月的广告销售·订单趋势按周的销售·订单推移与原因假设无变更（仅生成报告）提示词 7

提示词 1：保存报告设置以便每月复用

Section titled “提示词 1：保存报告设置以便每月复用”

给报告设置取名保存，使每月生成时能调用相同设置。设置的列表·查看·保存·删除都由本提示词统一处理。

这些场景下使用 — 想把幻灯片结构和阈值固定为设置，以便每月做出相同形式的报告时。

执行前所需信息 — 设置名（例：monthly-standard / agency-client-a）、显示在画面上的显示名、设置本体（幻灯片结构·阈值·要遮蔽的项目等）。

请管理报告设置：
- 给我看列表
- 给我看 {{设置名（例：monthly-standard）}} 的内容
- 把幻灯片结构·阈值·遮蔽设置一起，
  保存为 {{设置名（例：monthly-standard）}}（显示名：{{显示名（例：月度标准）}}）
- 删除 {{设置名（例：monthly-standard）}}


保存的设置会在之后的数据采集·幻灯片结构·
报告生成中被复用。

可更改的条件 — 设置名／显示名／设置本体（幻灯片结构·阈值·要遮蔽的项目等）／执行的操作（列表·查看·保存·删除）。

返回的内容 — 执行的是列表·查看·保存还是删除的结果。保存的设置会在之后的数据采集·幻灯片结构·报告生成中被复用。

设置变更 — 将报告设置保存·删除到账户（记录）。 保存属于设置的持久化，覆盖同名设置会事先确认。删除无法撤销，因此会要求最终确认。不更改广告设置。

接下来做什么 — 保存的设置可从本页的报告生成提示词（提示词 3·提示词 4）中调用。

提示词 2：调查报告可用的数据源

Section titled “提示词 2：调查报告可用的数据源”

在新建报告设置或扩展现有设置时，返回 Picaro 中可获取的数据源候选（最多前 5 件）。

这些场景下使用 — 想调查新报告设置里能纳入哪些数据源的候选时。

执行前所需信息 — 想找的数据种类（例：库存,利润，用逗号分隔）。

在想新建报告、但不知道该用哪些数据时使用。


请就与主题 {{想找的数据（例：ACoS, 搜索词, SQP, 库存）}}（用逗号分隔可指定多个）
相关的 Picaro 数据源候选，按主题各列出前 5 件。


请按下列步骤进行探索。
1. 获取 get_openapi_spec 的 read_data_paths（read 数据面的 path 一览），
   用主题词筛选 path・summary・required 字段来挑选候选。
   这里是候选名称的唯一出处。
2. discover_report_sources 不返回候选名称，只返回件数与置信度，
   因此不要用它来罗列候选，只在指定功能 slug（product-detail、search-term-compare、label 等）时
   作为佐证（found / confidence）一并使用。
   传入指标名（ACoS 等）时即使实际存在也会返回 not_found，不要用于判定。
3. 用 get_data_ingestion_status 确认目标数据的入库状况。
   rollup_status 只要有 1 条 no_data 就会整体倒向 no_data，
   因此务必按 reports[].statuses 的明细来判断。
4. 若候选中包含 SQP 类，请用 list_sqp_date_ranges 获取实际存在的期间候选。


对每个候选，请写明下列各项。
- 可获取的粒度（账户／广告组合／广告活动／ASIN／搜索词 等）。
  依据 required 字段的 type 与聚合轴判断，不要凭推测书写。
- 可获取期间的限制（可用的最新日期・缺失期间・是否必须指定 2 个期间・
  可指定的 frequency）。只写实际取得的范围，不要断定未确认的期间。
- 候选数据的简要说明（用于什么决策）


最后请务必附上「下一工序要指定的参数」。
由于不存在把数据源名称传给下一个提示词的参数，请把选定的候选
翻译成 period / frequency / KPI 标签页 / 聚合层级 的具体值来呈现。


从候选中选定要使用的数据源后，请进入下列之一。
- 若想先确认搜索词或措施的贡献度，请先做贡献度数据的事前检查，再进入正式分析
- 若想从报告的结构开始组装，请使用「确认着分步制作报告」

可更改的条件 — 想找的数据种类／候选的件数（默认最多 5 件）。

返回的内容 — 候选数据源的列表（含在哪里匹配·关联度高低），以及纳入报告设置时的写法示例。

设置变更 — 无变更（仅做调查）。只返回候选，不保存设置。

接下来做什么 — 确定想纳入的数据源后，用 提示词 3 加入报告设置并保存。

提示词 3：做出环比的月度对比报告

Section titled “提示词 3：做出环比的月度对比报告”

对比本月和上月的 SP 广告表现，并生成可视化表格。

这些场景下使用 — 想为月初的经营评审，把主要 KPI 的环比做成一目了然的表格时。

执行前所需信息 — 本月（例：2026-04，不指定则为最近已确定的月份）、上月（例：2026-03，不指定则为其前一月）。

请对比 {{本月（例：2026-04）}} 和 {{上月（例：2026-03）}} 的 SP 广告表现（销售额/广告费/ACoS/ROAS/订单），并生成包含差分（绝对值与 %）的可视化表格（{{上月}} 可作为 {{本月}} 的前一月自动算出）。
目的：把握月度的变化，用于下个月的运营方针判断。


【数据获取】
・SP 实绩用 analyze_ad_type_performance，以 campaign_types=["SP"]，对 {{本月}} 与 {{上月}} 各自把 period_start / period_end 明确写为自然月的首日・末日，调用 2 次。不要把两个月合并到 1 次调用里。
・每次都确认响应的 period 是否与请求的月份一致，并把实际返回的期间写进表格脚注。不一致时不要给出数值，而要报告不一致。
・不要把 /bigquery/advertising-performance 用于指定期间的对比。该端点会无提示地忽略 from_date / to_date，在 HTTP 200 的状态下返回另一对自然月。「本月 vs 上月」在形式上看起来是对的，因此察觉不到错误。
・5 个指标全部取自同一响应（analyze_ad_type_performance 的 metrics[]），不要混用出处。get_dashboard 不返回 ROAS，也不是 SP 单独的值，总销售额是不含税且包含非广告部分的另一套汇总，因此不要并列在同一张表里。
・确认 source_row_count 与 fetch_truncations，若存在截断请写明「合计偏小」。


【完整月原则】
・若 {{本月}} 是进行中的月份，不要拿部分月与完整月对比（必定会显示为「恶化」）。用 get_data_ingestion_status 确认已确定的最后一天之后，
　(a) 换成最近的完整月与其前一月来对比，或
　(b) 写明这是部分月，并用日均（期间合计 ÷ 天数）来对比。
　使用日均时务必把分子・分母・天数写进表里。不要把未确定的日期计入天数（是否计入会使正负号反转）。
・不要用 rollup_status 做确定判定（只要有 1 个未投放的广告类型，整天就会落为 no_data）。请看各报表各自的 status。
・即使同为完整月，天数不同（28/29/30/31 天）时，除实数差分外还要一并写出日均的差分。


【订单数的健全性检查】
・对每个月计算 销售额 ÷ 订单 = 平均客单价，确认与最近数月的数量级是否一致。数量级偏离的月份很可能是订单入库不足，因此不要把订单的环比作为数值给出，而要写明「订单数据不一致，无法对比」。不要用推算值填补。


【差分的写法】
・金额・件数：绝对值＝实数差，%＝相对变化（(本月−上月)÷上月）。
・ACoS・ROAS 等比率指标：绝对值＝百分点差（%p），%＝相对变化。不要只写其中一个。
・不要直接照抄 MCP 返回的 delta / changeRate。不同工具的单位分别是绝对差・相对差・bps，同样的变化会变成不同的数值。表中的值请自己从 metrics[] 的实测值计算，并把计算式（分子・分母・天数）写进脚注。


【可视化】
・MCP 不返回图表图片。build_report_slide_spec 只做到图表种类与系列名的规格（spec），不做绘制。对比表请用 Markdown 表格输出。
・仅在需要 PPTX 产物时使用 run_report_command mode=pptx，但这是整个账户的报告，并非 SP 单独的对比表。不要混淆。


请按下列 5 段结构输出。
1. What happened — 主要指标的实绩与环比（绝对值・%）
2. Why — 若有恶化的指标，用「原因诊断」确认其要因（搜索词/出价/CPC/CVR/预算/广告位）并附上 1〜2 点
3. So what — 对业务的意义（机会损失・改善余地）。外推的估算要写明「并非 MCP 的返回值」
4. What was done — 期间内若实施过措施请写明。无法获取时写「无法获取措施记录」（不要断定「未实施任何措施」）
5. What should we do next — 举出下个月需要「继续」「重新评估」的领域 1〜2 项，重新评估交给出价变更的提案・审批流程


【出处的写明】
・在表格脚注写明所用工具名・campaign_types・实际返回的 period・source_row_count・fetch_truncations。
・写明销售额为含税、SP 归因 7 天点击窗口。


【Guardrail】
・下个月制作同样的报告，确认指出的领域是否已改善。

可更改的条件 — 本月／上月。

返回的内容 — 把主要 KPI（销售·广告费·ACoS·ROAS·订单）按本月·上月·差分（绝对值和 %）并列的对比表。

设置变更 — 无变更（仅生成报告）。不更改广告设置。

接下来做什么 — 若要与全年趋势一并查看，使用 提示词 4。

提示词 4：做出年初至今（YTD）汇总

Section titled “提示词 4：做出年初至今（YTD）汇总”

汇总显示从年初到现在的 SP 广告指标。

这些场景下使用 — 想为季度·年度评审，汇总年初至今的 KPI 走势与年度累计时。

执行前所需信息 — 对象年（例：2026，不指定则为当年）。

请把 {{对象年（例：2026）}} 年初至今的 SP（商品推广）广告实绩，按下列 5 段结构汇总。


获取步骤（务必按此顺序执行）
1. 先确定当年的「最近已确定月份」。按月确认数据入库状况，当月因处于月中不计入累计。把到已确定月份为止定义为「年初至今」，并在报告开头写明对象期间・月数・覆盖率
   🔴 不要用 rollup_status 做确定判定。 只要有 1 个未投放的广告类型，即使其他报表全部 completed，整个月也会落为 fully_missed / no_data（实测中出现过 completed 13/16 却 rollup_status=fully_missed 的月份）。务必看各报表各自的 status，用自己分析所需的报表（SP 则为 Sponsored Products / Sponsored Product Campaign / Targeting SP）是否 completed 来判定
   🔴 按月看时，报表的集合与按日不同（只有按月才会出现 Subscribe & Save 与 SQP，不会出现 Suggested Bid）。此外按月除了 completed / in_progress / no_data / fully_missed，还会出现 out_of_range 这个值。它不是「获取失败」，而是「超出该报表的保留期间」，不要以此为由整月剔除
2. SP 实绩务必「按月逐个」获取。不要用一次期间指定把年初至今一并取回
3. 做验算。把各月值的合计与同一期间一次性指定取得的值相互核对，若有差异请把两个数值与差分（金额・%）都写进报告。一致时也要写明「已验算」
   🔴 实测中这两者并不一致。 用 3 个月验证时，一次性指定的广告费约低 5%・曝光量约低 7%（按年计会产生千万日元量级的差异）。
   累计值采用各月值的合计，一次性指定的值作为验算用的参考值并列写出。请在报告中写明采用了哪一个。差异的原因尚未查明，不要附上推测性的说明
4. 广告类型仅限 SP。不要把整个账户或包含 DSP・SB・SD 的数值当作 SP 的数值
5. 把指标的出处固定为 1 个，并在报告中写明出处名称。同样是 ACoS，取得来源不同数值也会变，中途不要更换出处
6. 按月逐个确认截断。若截断信息非空，请写明「该月的合计偏小」。
   🔴 广告活动件数（campaign_count / source_row_count）即使更改期间也返回相同的值（实测中单月・3 个月全部为同一值）。不要把它读作「该月在投的广告活动数」。若需要按月的在投件数，请用其他工具获取


输出
1. What happened — 用表格给出按月的广告费/广告销售额/ACoS/ROAS/点击/CPC 的走势，以及到已确定月份为止的累计。无法取得的月份・部分月不要混入累计，要在表外区分写明。各月天数不同（28/29/30/31），因此读走势时请一并写出日均
2. Why — 把累计值的变动要因分解为 ACoS = CPC ÷ RPC（单次点击成本 ÷ 每次点击的广告销售额），用数值说明是 CPC 要因还是 RPC（CVR・单价）要因，并归类到 搜索词/出价/CPC/CVR/预算 之一来解释（也可以使用「原因诊断」）
3. So what — 给出与 {{年度KPI目标（例：ACoS 15% 以下）}} 的对比。该目标值作为使用者的输入值处理（因为年度目标无法从 MCP 获取）。
   🔴 若 MCP 中保存有月度 KPI 目标，请先列出保存的是哪些指标再并列写出。实测中 ACOS 上限未设置，保存的只有 TACOS 上限 与 CPA 上限（而且只有对象年的 1 个月份）。不要把 TACoS 的值当作 ACoS 目标呈现（分母不同，是另一个指标）。请写明 KPI 目标存在多少个月份、其中与对象期间重叠的有多少个月份（目标的覆盖率）。若有偏离，请用 1 行说明对业务的影响
4. What was done — 列出期间内实施的措施。请先写明变更历史的可获取范围（能回溯的天数），若对象期间超出范围、或取得 0 件，不要写「未实施任何措施」，而要写明「无法从 MCP 获取（可获取范围：○○）」。
   变更历史工具在传入超过上限的开始日期时会自动上调到上限，并在注记中返回调整后的开始日期，直接引用该注记中的日期即可。请在开头声明无法覆盖年初至今，措施栏写成「仅可确认最近 ○ 天」这样限定范围的形式
5. What should we do next — 若有偏离较大的月份请写明「需要要因调查」，并按优先级给出接下来的行动


执行条件
- 期间为 {{对象年（例：2026）}} 的 1 月到最近的已确定月份。按月数据取得全部月份，若有缺失的月份请写明
- 未确定日可能返回 0 填充的行，因此请写明无法区分「实绩为 0」与「尚未入库」
- 即使是已确定的月份，也可能因重新入库（re-crawl / backfill）而被改写。不要把过去的数值当作不变的东西呈现（季度更新时数值与上次不同，也不要仅凭这一点断定为故障）
- 若要给出同比，请让对比的 2 个期间的月数・天数一致。无法一致时不要对比
- 每季度更新同一报告，追踪与目标偏离的变化

可更改的条件 — 对象年／年度 KPI 目标（例：ACoS 15% 以下，可选。指定后可对比偏离）。

返回的内容 — 按月的 KPI（销售·广告费·ACoS·ROAS）走势表，以及年度累计表。

设置变更 — 无变更（仅生成报告）。不更改广告设置。

接下来做什么 — 按月的对比使用 提示词 5，近期的周度趋势使用 提示词 7。

提示词 5：确认近 3 个月的广告销售与订单趋势

Section titled “提示词 5：确认近 3 个月的广告销售与订单趋势”

显示近 3 个月 Amazon 广告经由的销售和订单数的趋势。

这些场景下使用 — 想把握近期广告销售·订单数的增减倾向及其原因时。

执行前所需信息 — 无（可直接使用）。

请用周度趋势显示近 3 个月 Amazon 广告经由的销售额与订单数。
对于增减较大的周，请把要因假设归类到 搜索词/出价/CPC/CVR/预算/广告位 之一并附上。
目的：理解趋势变化的背景，用于下一步的措施判断。


数据获取（按此步骤获取）
- 周度序列用 call_picaro_api 的 POST /bigquery/advertising-chart（frequency: "weekly"）获取。
  在 body 中传入 amazon_account_id / frequency / from_date / to_date。
  get_dashboard 即使指定 frequency=weekly 也不返回周度序列，只返回期间合计 1 个点，因此不要用于趋势用途。
  不要把 analyze_ad_type_performance 用长期间一次性指定（窗口越长，越会无提示地少算）。
  /bigquery/advertising-performance 会无提示地丢弃期间指定，不要使用。
- 期间要对齐到「周日开始・周六结束」的周边界。以 {{分析基准日}} 之前最后结束的周六为终点，
  其 13 周前的周日为起点。不对齐周边界时，两端的部分周会被整周无提示地丢掉。
- 获取后务必验算：「返回的周数 × 7」是否与请求天数一致。不一致说明两端的周被丢掉了，
  请重新对齐周边界后再取一次。
- 不要把响应的 tooltip 当作完整性的依据。tooltip 不仅不显示缺失，
  还会把 chart_data 中不存在的周显示为终点。请始终数 chart_data 的行数来判定。
- 「广告经由的订单数」用 purchases。同一响应中的 order_count 是总订单数（包含广告以外），不要混淆。
- 最后一周不要包含未确定日。用 get_data_ingestion_status 确认入库状况。
  但 rollup_status 只要有 1 个未投放的广告类型就会让整天变成 no_data，不要用于确定判定。
  请按报表单位查看 reports[] 来判定。


响应字段的对应（不要凭推测填补）
- 可直接使用：ad_sales（广告销售额）/ purchases（广告经由的订单数）/ ad_spend（广告费）/ acos / cvr /
  ad_clicks（点击）/ impressions（曝光量）/ rpc（＝ ad_sales ÷ ad_clicks）
- 需要导出：CPC 不返回。用 ad_spend ÷ ad_clicks 导出，并注明这是导出值。
- 不要使用：响应中的 aov 字段。该值与 ad_sales÷purchases 和 total_sales÷order_count 都不一致，
  定义未公开。平均客单价务必用 ad_sales ÷ purchases 自行计算。


输出
1. 周度表格 — 周（以周日为起点）／广告销售额／环比上周／广告经由的订单数／环比上周／广告费／ACoS／CPC（导出）／CVR／
   平均客单价（广告销售额÷广告经由的订单数・自行计算）／点击／曝光量
2. 健全性检查 — 务必算出每周的平均客单价。若有与其他周偏离较大的周，
   请明示为「疑似订单数缺失」，并且不要把该周的增减率用作结论的依据
3. 要因假设 — 对广告销售额或订单数环比上周变动 ±15% 以上的周，把要因归类到
   搜索词／出价／CPC／CVR／预算／广告位 之一
   - 出价・CPC・CVR 可以从与上述相同的周度数据源（CPC・CVR・点击・曝光量・广告费）判定，
     因此可以附上数值下断言
   - 搜索词・预算・广告位 属于不同数据源・不同汇总窗口，无法与周度对齐到同一口径（广告位属于另一套表系统，
     汇总窗口不同／搜索词的取得会被截断／预算消耗率在 2 天以上的窗口中单位会失真）。
     若参照了这些，请写明是「另一窗口的辅助假设」，不要下断言


最后请输出以下 3 点。
1. 推荐行动 — 针对近期有恶化倾向的要因，给出写明对象・理由・优先级（按 Impact 排序）・预期效果・确信度・风险的改善行动方案 1〜2 件
2. 执行方法 — 要因若为出价/CPC，接到「原因诊断」或相应的出价调整提示词；若为搜索词，接到否定关键词类提示词。
   ACoS 会因取得来源不同而出现偏差，因此用阈值筛选时请把出处固定为 1 个，并写明是哪个工具的值
3. 测定 — 在 {{进行效果测定的日期（例：措施实施的 4 周后）}}，用与本提示词相同的周边界・相同的取得来源再次获取同一趋势，
   对比措施实施周前后的 ACoS / CPC / CVR / 平均客单价。
   措施是否实际实施，无法用 Picaro 侧的变更历史追踪（变更历史工具在所有条件下都返回 0 件），
   因此实施日请由委托方的记录来确定。
   效果测定的窗口要取得比归因窗口（各广告类型分别为 7 天/14 天，混在一起）更长。实施后紧接着的那一周因归因未完成会显得偏小


执行条件
- 周度数据取得全部期间，并务必在正文写出「返回周数×7」与请求天数的核对结果。
  若有丢失的周，请一并写明丢失的天数，以及该周所含广告销售额占整体的百分比
- 给出比率时务必明示分子・分母・天数
- 广告销售额为含税、广告费的税别未确定、总销售额为不含税，不要把跨这些口径的比值当作「税基一致的值」呈现
- 已确定的过去期间也可能因重新抓取而变动，不要把数值当作不变的东西呈现
- 数据不完整时不要给出关于增减的断定性结论
- 仅读取。不执行写入类操作

可更改的条件 — 分析基准日（可选。作为周边界起点的日期）／进行效果测定的日期（例：措施实施的 4 周后，可选）。

返回的内容 — 按周的销售和订单数推移表，以及增减趋势的原因假设（搜索词 / 出价 / CPC / CVR / 预算 / 广告位）。

设置变更 — 无变更（仅生成报告）。不更改广告设置。

接下来做什么 — 按年的走势使用 提示词 6，若想查看与措施的关联，使用 记录措施与外部事件并验证效果。

报告生成流水线

Section titled “报告生成流水线”
[报告设置的保存（可选，提示词 3）]
   ↓
数据源调查（可选，提示词 4）
   ↓
事前检查（提示词 2 的 Step 1）
   ↓
数据采集
   ↓
幻灯片结构组装
   ↓
HTML 化 → Slack 共享

提示词 1（用一条指示一次性生成）是把上面 事前检查 → 数据采集 → 幻灯片结构 → HTML 化 一次性执行的快捷方式。

相关类别

Section titled “相关类别”