ADS 广告分析

01 功能介绍与页面分工

从「商品运营 → 广告 → ADS 看板」进入主入口 /ads。顶部模块导航包括「总览」「活动」「商品」「关键词」「ETL 健康度」。模块标签存在不代表账号拥有该模块全部权限。

• 总览：按数据视图、日期与店铺范围观察 KPI、店铺预算效率、广告类型分布、趋势和店铺明细。
• 活动：查看活动汇总、花费诊断和「活动处理队列」，从待关注对象进入活动详情。
• 商品：查看广告商品的汇总、趋势和指标明细，打开商品详情追踪关联广告对象。
• 关键词：读取 SP／SB 的关键词表现；当前独立看板不是搜索词看板，也不包含 SD 关键词。
• ETL 健康度：供有权限人员核查采集状态、成功率、失败原因、每日拉数记录与重跑任务状态。

店铺页不是第六个顶部模块：从总览下方店铺明细的「查看」进入。活动详情从活动行的「诊断」进入，需携带店铺和活动上下文；不要只复制活动 ID 拼接地址。

02 开始前：权限、数据范围与口径

开始查询前，确认自己处于正确租户，并知道要核对的店铺、日期、广告类型和分析对象。当前读取基于 ADS 已落地的事实、汇总或覆盖完整的读取快照；刷新网页是重新读取，不会自动向广告平台拉取最新报表。

总览还要求存在可用「数据视图」。提示「当前账号没有可用的广告数据视图」时，先请管理员核查视图配置及适用范围；不要把它解释为没有广告投放。前端权限辅助模型与个别实际控件的开放范围并不完全相同，应以当前页面和服务端返回为准。

金额必须连同币种阅读：总览 KPI／趋势使用 CNY，总览店铺明细仍显示店铺原币；活动顶部汇总与诊断使用 CNY，全部活动明细按行显示原币；商品默认 CNY，关键词固定 CNY。不要直接把 USD 明细相加后与 CNY 总额对照。

换算读取报告所属月份的汇率，优先使用自定义月汇率，其次来源月汇率，不是当天实时汇率。缺少汇率、未知币种或站点币种异常时，应先读页面金额质量提示；本 Mock 仅设 USD → CNY = 7 的固定样例，不代表真实汇率。

03 查询定位：日期、店铺与筛选联动

1. 进入目标模块，先核对日期控件中的起止日。点击「日期范围」可点选起止日，也可使用「近3天」「近7天」「近14天」「近28天」「本周」「本月」「本年」。完成选择后按本页「应用」提交；关键词页对应「应用筛选」。
2. 总览先选「数据视图」，再按需设置「国家」「店铺」「站点」「广告类型」及 ACOS／ROAS 范围。ACOS 输入按百分数理解，ROAS 按倍数理解。
3. 活动页按国家、店铺、站点、广告类型、负责人、活动状态和活动名称／ID 搜索；商品页按店铺、站点、负责人及 ASIN、Seller SKU、本地 SKU、商品名称搜索。
4. 修改字段后点击「应用」或对应搜索按钮；核对地址栏条件、日期、表格对象和汇总变化。需要重新定位时用「清空」，而不是把无结果认定为业务零值。

不传日期时，总览、商品和关键词通常以各自最新报告日向前取 7 天；活动列表默认取最新报告日单日，而诊断和活动详情有自己的范围逻辑。跨模块比较或进入详情前，应明确应用同一组起止日，并以响应展示的周期为准。可选择某日，不代表该日所有店铺、广告类型都采集完整；最新日期也不等于今天。

通过顶部模块导航切换时，只传递目标模块支持的条件：进入商品保留店铺、站点、日期、负责人及已有商品搜索；进入活动保留国家、店铺、站点、广告类型、负责人和日期。活动搜索／状态、ACOS／ROAS 范围等局部条件不会跟随模块切换。进入关键词只携带店铺，日期及其他条件需重新确认；进入健康度不携带业务筛选。总览预算洞察中的「更多」直接进入活动列表，也需重新设置范围。

关键词页自带独立筛选栏，操作见下文。不要凭地址中曾经出现过某参数，认定所有页面都支持它。

04 总览：读指标与发现待关注对象

1. 应用范围后，先看有无加载失败、金额不可用或混合归因说明，再读 KPI。
2. 在趋势图观察日期与量级；到店铺预算效率核对「花费占比」「销售占比」「差值」和 ROAS。
3. 往下查看店铺明细，确认店铺、站点、广告类型、币种；可在表内搜索、分页并通过「列设置」调整显示列。这里的表内搜索不等于重算顶部汇总。需要继续核查时点击该行「查看」，或切换「活动」后重新确认筛选。

比例按汇总后的分子和分母重新计算，不能简单平均各行百分比。分母为零或必要金额缺失时显示「-」或「--」。例如花费大于零、广告销售额为零时，ACOS 没有有效分母，ROAS 可以为 0；不能把两者都写成 0。

花费占比的分母是当前范围总广告花费；销售占比的分母是当前范围总广告归因销售额。「差值」是两项占比相减，实际单位是百分点，不是增长率。预算效率用于发现需人工核查的对象，不会自动分配预算或调整竞价。

总览转化按各广告类型来源归因汇总：SP 使用 7 天，SB／SD 使用来源默认归因。出现「混合归因窗口」时，完整的 CNY 总览仍可能展示转化与效率指标，但不能解释成统一的 7 天结果。页面没有普通用户可切换的归因窗口控件。总览默认对比周期按上月对应日期构造，与商品／活动详情的上一等长周期不同。

05 活动：从诊断队列进入详情

1. 点击顶部「活动」，确认日期和店铺；在活动搜索中选择「全部字段」「活动名称」或「活动 ID」，输入内容后提交。
2. 阅读活动总数和金额汇总，再看花费诊断分类。点击分类卡片或图表后，队列定位到相应分类；「清除分类」恢复分类选择前的范围。
3. 「待关注」按当前有效规则的需关注标记选取对象；切换「全部活动」核对完整查询结果。全部活动采用服务端分页，待关注队列对已返回的诊断结果分页，二者数量不必相同。
4. 点击行内「诊断」进入活动详情，先核对活动 ID、店铺、当前周期、上一等长周期、币种和数据更新，再读趋势、Placement、配置时间线与对象明细。通过「返回活动列表」返回。

活动不能只靠名称识别；相同名称、不同店铺或广告类型不是同一条记录。负责人来自关联商品／Listing，可能多人负责、关联不完整或未分配；不要据此认定活动无广告数据。活动搜索和状态作用于活动列表；上方诊断请求不包含这两项，所以诊断分类不会必然随着名称／状态搜索缩小。

活动金额提示「部分数据已换算为 CNY」时，顶部金额及 ACOS／ROAS 仅含成功换算部分，必须同时记录覆盖数量；混合归因时活动汇总转化可能不可汇总。这与总览完整 CNY 混合归因展示策略不同。

详情口径边界：当前活动详情页面标注 7 天归因，后端详情汇总读取 7 天字段；它与活动列表对来源默认归因的兼容路径不同。SB／SD 的详情转化能否与列表直接核对尚待业务确认，不能把详情中的 0 当作来源默认归因下没有销售的证明。本次未演示活动详情与真实投放配置历史。

06 商品：趋势、排序与关联明细

1. 点击「商品」，应用店铺、站点、负责人和日期；按商品搜索字段定位 ASIN、SKU、本地 SKU 或名称。
2. 先看顶部汇总，再看「金额与转化」「流量」「效率」趋势组。通过「对比上期」显示或隐藏上一等长周期；缺失的上期金额不补零，也不能据此计算增长率。
3. 在表头按花费、销售等支持排序的指标排序，用分页定位商品；表头说明按钮解释指标，点击说明不改变排序。
4. 点击商品行的「查看」打开「广告商品详情」，核对 Seller SKU、ASIN、SID、站点、日期与币种。依次查看「广告活动」「商品广告」「投放对象」「搜索词」，每个页签有独立明细与覆盖状态；完成后点「关闭」。

商品读取来自广告商品日汇总，并结合 Listing 的本地 SKU、品名和负责人。记录身份包含店铺、站点、Seller SKU、ASIN，详情还携带 product key；不能按同名 SKU 跨店铺唯一匹配，也不能把父 ASIN 或本地 SKU 当作当前页默认聚合粒度。跨广告类型的商品转化可包含来源默认归因，不能因字段历史名称含 7d 就统一称为 7 天。当前商品汇总卡仍使用固定「7 天归因」文案，跨 SP／SB／SD 核对时应以来源字段和广告类型为准，本任务未修改这一业务页面差异。

详情的广告活动、商品广告、投放对象和搜索词是不同分析层，不能把四个页签的金额加起来。当前搜索词明细契约只覆盖 SP；提示覆盖不全、未覆盖或未匹配，均不等于广告没有花费。本次 Mock 演示商品详情的广告活动页签，其余页签未预置业务明细，明确显示未演示。

07 关键词：确认粒度再筛选

1. 点击「关键词」后重新确认日期。依次选择店铺、站点、SP／SB 广告类型、活动、广告组、匹配类型与状态。
2. 可按「全部字段」「关键词文本」或「关键词 ID」搜索。点击「应用筛选」后核对表格中的店铺、活动和广告组；上游选择变化时，检查依赖的下游选项是否仍有效。点击「清空」重新定位。
3. 查看关键词数、曝光、点击、花费、广告销售额及 ACOS／ROAS；通过趋势和表格排序定位对象，再用分页继续查找。筛选改变后页码回到第一页。

同一个关键词文本可存在于不同店铺、活动和广告组。当前汇总行按 SID × 活动 ID × 广告组 ID × 关键词 ID 区分；关键词数不是去重文本数量。搜索词是买家实际搜索内容，当前独立关键词页不提供把二者切换为同一粒度的控件。

本页金额按严格报告月汇率换算 CNY。当前范围有缺失汇率记录时，提示「CNY 汇总暂不完整」，金额及金额派生指标隐藏，曝光和点击仍可能展示。订单与销售使用来源归因数据，不能默认全页统一 7 天。查询失败时点「重试」；筛选选项失败时先重试选项，不要将尚未加载的下拉菜单理解成没有业务对象。

08 数据追踪、规则与导出的实际边界

数据追踪：当前总览必须选数据视图，该路径不显示可操作的原始追踪入口。店铺页的追溯按钮／图表数据点可打开追溯抽屉，核对请求范围以及 output、fact、raw 层；后端要求原始追踪权限。权限不足或来源不可用时保留错误信息，不通过改地址绕过。本次原始追踪未演示。

规则配置：在活动页点击「规则配置」，可读取当前有效规则、分类、条件和版本。系统默认规则与个人规则有区别；复制、保存、保存并启用、启用或删除需要管理权限，预览也须单独请求。诊断分类是辅助判断，不是自动投放执行。规则读取／预览／全部写操作本次均未演示，Mock 不返回保存成功。

导出：当前总览没有可点击的导出按钮，商品和关键词页也不能按其他模块的导出能力推断。店铺页的「导出报表」和活动详情的「导出」会打开导出面板，可选择报告类型、日期、格式及章节，创建任务需要管理权限。先核对 scope、店铺／活动、币种和日期；导出载荷并不包含所有看板筛选，不能承诺与当前数据视图、负责人、搜索条件完全一致。提交排队不是生成完成，须核对任务状态和下载产物。本次创建、轮询和下载导出均未演示。

09 ETL 健康度：核查更新与失败原因

1. 有 ads:ops 或 ads:rerun 权限时点击「ETL 健康度」。该页有独立状态，不承接业务页的日期、店铺筛选。
2. 阅读状态卡、成功率趋势和失败原因分布，再查看每日拉数记录中的报告日期、状态、抓取／保存／事实数量及质量问题。
3. 有失败或部分完成时，展开记录核对广告类型、数据集与错误摘要。数量不完整、尚未运行、执行中、部分完成和失败应分别记录，不能全部按 0 处理。
4. 把报告日、店铺、广告类型、错误和最后成功时间交给负责人员排查；必要时在正式授权流程下处理重跑。

重跑会创建任务，不是普通页面刷新。单日或近期重跑的创建、执行及结果全部未演示。Mock 健康页仅提供预置状态和无任务状态，图表／每日明细没有预置记录；这只说明演示范围，不代表实际 ETL 正常、失败或尚未运行。

10 与利润和销量数据核对

1. 记录 ADS 模块、租户、数据视图、店铺／SID、站点、商品或活动身份、报告日期、广告类型和币种。
2. 到 利润报表 或 销量统计，分别记录它们实际采用的日期字段、范围、币种和数据状态，再判断哪些指标可比较。
3. 先核对来源与范围，再解释差额；仍无法解释时按 数据异常自查 留存双方筛选、指标、截图和更新时间。

广告归因销售额不等于全店销售额；ACOS 的分母是广告归因销售额，不是利润、全店收入或预算。报告日期范围与归因窗口是两回事。商品、活动、关键词、搜索词、MSKU、ASIN、父 ASIN 和经营报表的聚合粒度也不相同，不应强求每行一一对应。

本次没有核实真实租户的月汇率配置、平台归因回补到齐时间、历史刷新后结果是否变化，也未实测利润／销量与 ADS 的真实对账差异。这些不能从 Mock 推断，更不能据此给出历史重算或统一汇率承诺。

11 权限、空态与异常边界

• 加载中：等待完成，别把骨架、横线或暂留的旧图当作本次新结果。
• 查询失败：保留错误；若页面提示「仍显示上次成功数据」，该内容不是新筛选的成功结果。修正条件后重试，不能截图后直接汇报为最新数。
• 没有记录：清除局部条件，核对店铺、日期、视图和身份；「暂无待关注活动」只是没有匹配该队列，切换「全部活动」再判断。
• 显示 0：只表示返回口径下该数值为零；应同时确认覆盖和更新时间。不能把聚合兼容路径补出的 0 当作所有广告类型均无数据的证据。
• 显示 -／--：可能是分母为零、金额缺失、汇率异常、归因不兼容或无对比基数。先查看状态提示和列说明，不手工补零。
• 关联字段缺失：品名、负责人、Listing 或商品身份可能未匹配，先留存 SID、Seller SKU、ASIN 等稳定身份，不因名称为空否认广告事实。
• 未授权：确认登录、租户和对应能力权限；业务读取、规则管理、追踪与健康度不是同一种权限。

验收环境仅支持 2026-09-21 至 09-27 内的读取。超出演示日期或未实现的操作会明确提示 Mock 范围／未演示，不连接真实后台补数。

12 常见问题