> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 客户要小红书投放结案，曝光、阅读、涨粉和流量来源该怎么补齐？

> 先把客户结案问题拆成可交付互动、曝光阅读子集及待补后台证据，保留缺失和口径，避免把一张数据表当完整效果证明。

小红书结案复盘从约定的合作笔记名单开始。点赞、收藏、评论和分享用 `xiaohongshu.app_v2.get_image_note_detail` 或 `xiaohongshu.app_v2.get_video_note_detail` 从公开详情取；客户要看曝光与阅读时，用 `xiaohongshu.pgy.get_note_detail` 按同一批笔记 ID 另取蒲公英指标。涨粉、成交、组件点击和流量来源，要从你有权限的投放后台补对应报表。

例如计划复盘十篇，就在同一张名单上标出每篇拿到了公开互动、蒲公英曝光与阅读，还是仍待补证。写结论时，为每个指标注明对应笔记和观察时间。

## 先把客户问题变成一张取证清单

| 客户问什么             | 先准备什么                   | 怎么判断拿到的材料够不够                               |
| ----------------- | ----------------------- | ------------------------------------------ |
| 这批合作笔记交付了吗，目前表现如何 | 固定名单、作品链接、约定窗口与互动快照     | 一一对上笔记和实际观察时间；失败或缺项仍留在清单。                  |
| 有多少曝光和阅读          | 对应笔记的独立曝光/阅读子集，或有权限后台导出 | 核对指标定义与时间范围；公开 `view_count` 不替代曝光。         |
| 带来多少新粉或成交         | 同一活动的后台归因口径、窗口及必要的订单证据  | 不能用账号总涨粉或评论数冒充本次笔记的贡献。                     |
| 流量主要来自搜索还是推荐      | 对应对象、周期和流量范围的来源报表       | 指标导出脚本不提供流量来源拆分；不能把博主一段时期的数据说成某篇作品本次投放的来源。 |

回答流量来源问题时，要分清“单篇笔记”与“博主某个周期”。另外拿到的来源占比，也要核对算的是曝光还是阅读、自然还是全部流量、30 天还是 90 天；对象和分母不一致的占比不能直接合并排序。

如果客户问「这篇笔记的阅读主要从搜索还是发现页来」，交付清单先写目标笔记 ID、活动起止时间和「阅读来源占比」。手里只有同一博主近 30 天的账号报告时，把账号报告列作账号背景。单篇的来源占比继续待补，拿到同一笔记、同一投放周期的报表再填。

## 交给客户时，怎么解释结果？

给客户的报告先说名单覆盖：计划多少篇、拿到多少篇、哪些缺失、还待补什么。再讲同口径、同观察窗口下能比较的表现，最后写仍需核实的事项。只展示成功数据会把查不到的合作作品藏掉。

例如，**假设**某篇拿到曝光 1000、阅读 200，本地阅读/曝光比是 20%。报告里注明这两个计数和计算方式，不能写“20% 的独立用户转化成读者”，也不能推成购买转化。曝光为 0 或任一值缺失时，不计算比值；原始的 0 仍保留为计数。另一个作品缺阅读，不代表阅读为 0 或表现差。

如果客户问“下轮还要不要投这位博主”，把素材适配、内容质量、评论问题和已证实表现一起交给负责人判断。指标表支持核查，不能自动回答归因、销售回报或是否续约。

## 怎么开始，避免重复买数据？

沿用[投后回收指南](/zh/guides/xiaohongshu-note-metrics)的固定名单、观察时间与原始文件。本轮已有数据就先导出和检查；缺哪个客户需要的指标，再选对应动作，不因客户说“完整报告”就把每个接口都跑一遍。先做小范围核对，确认笔记身份、字段和实际可用性，再批准扩大名单；错误与重查也占预算。

人工另留一张交付清单，记录“指标、对象、周期、来源、已取/待补、负责人”。交付清单是项目工作表，不是脚本自动生成的归因报告。下面列出已有导出脚本实际能做的部分。

## 指标流程具体交付什么？

指标流程交付固定笔记名单的公开互动复盘；需要曝光和阅读时，再交付一张独立的蒲公英字段表。没有哪一次请求能输出完整归因报告。先选定所需字段，再决定取哪些数据：

| 交付物       | 动作及响应位置                                                                    | 导出指标                                                |
| --------- | -------------------------------------------------------------------------- | --------------------------------------------------- |
| 图文公开指标快照  | `xiaohongshu.app_v2.get_image_note_detail`，在data.data\[].note_list\[]中匹配目标 | 点赞、收藏、评论、分享、可选浏览数                                   |
| 视频公开指标快照  | `xiaohongshu.app_v2.get_video_note_detail`，在data.data\[]中匹配目标              | 同一组公开计数列，缺值保留                                       |
| 蒲公英笔记报告子集 | `xiaohongshu.pgy.get_note_detail`，核对data.data.noteId                       | impNum→曝光、readNum→阅读、likeNum→点赞、favNum→收藏、cmtNum→评论 |

导出脚本不拿公开 view_count 替代蒲公英 impNum。蒲公英表中的 read_to_impression_ratio 是导出脚本在本地做的“阅读/曝光”计算，不是独立读者率或平台归因转化率。上表三条响应路径和导出列已在[已存响应指标指南](/zh/guides/xiaohongshu-note-metrics)中实现。

## 从投放名单开始，不用新的搜索结果替换名单

第一轮观察前先固定笔记 ID，随名单保留笔记类型、预期作者、约定复盘窗口和原始链接。按选定的基线与后续时间观察；名单中一篇缺数据时，不用新搜的热门笔记顶替。记录每次真实查询时间，不把不同时间的观察标成平台统一时点的报表。

`xiaohongshu.pgy.get_note_detail` 只接受 note_id，不接受 share_text；指标指南的蒲公英脚本要求每项都是已核对、不重复的 24 位笔记 ID。公开图文/视频详情动作可用已知 ID 或支持的分享链接，按笔记类型选对应动作。免费 Inspect 引用为 `data:xiaohongshu.app_v2.get_image_note_detail`、`data:xiaohongshu.app_v2.get_video_note_detail`、`data:xiaohongshu.pgy.get_note_detail`。

## 最后得到哪些文件，失败项放哪里？

公开指标每轮用指标指南的 targets.json 绑定原响应、预期 ID 与采集时间，公开指标导出脚本只导出已核对的成功项；失败或未采集的目标另记在 failures.json 日志里。公开指标导出脚本遇到无效输入会停止，不把失败目标悄悄写成 0。

蒲公英的 pgy-manifest.json 还记录实际 action/params、HTTP 状态与原文件。用指标指南的完整脚本运行 `python3 pgy_report.py pgy-manifest.json pgy-round-1`，生成 pgy-note-report.csv 和 coverage.json；失败、空结果、部分字段和正常行一起保留。原响应与清单、哈希一并保存。

| PGY行状态              | 怎么使用                                         |
| ------------------- | -------------------------------------------- |
| available           | 五个导出指标齐全，真实0仍保留0                             |
| partial_metrics     | 保留已有指标，缺失列留空                                 |
| no_payload          | 内层成功但没有笔记载荷，不制造全0指标行                         |
| pgy_business_failed | 保留内层失败与请求证据，不用于指标排名                          |
| gateway_failed      | 保留实际HTTP错误及error.request_id，先处理HTTP错误再决定是否重试 |

网络失败且没有响应正文时，记入采集日志，不伪造 JSON。排序前先查 coverage.json。蒲公英导出表不输出笔记归因涨粉、报备品牌登记、流量来源占比或组件点击分档。

## 两轮数据怎样变成可用的投后复盘？

以独立投放名单为分母。公开计数对比区分四种情况：两轮都有、只有基线、只有后续、两轮都缺。用 failures.json 解释缺口，不能仅凭 CSV 缺行就判定笔记被删除、不可得或漏查。

只有两轮都有值才算净变化；负变化保留，缺基线不补 0。点赞、收藏、评论净增不证明投放带来了新增获客。蒲公英单轮导出另外交付曝光/阅读，不把蒲公英的不同列直接塞进公开计数对比，冒充同一口径。

## 预算怎么计算？

固定 10 篇查三轮，是 30 次公开详情请求。三轮都需要蒲公英指标时，再计划 30 次蒲公英笔记详情请求。两种动作按 [BeatAPI 价格页](https://beatapi.io/zh/pricing)分别估算。

本地生成 CSV、重算已存对比不产生查询；刷新当前计数才是新调用。客户需要完整结案报告时，把所需导出子集与另有来源的订单成本、归因证据合并，不把指标表改名成完整平台报告。

[指标导出与双轮对比](/zh/guides/xiaohongshu-note-metrics) · [自然与全部流量](/zh/faq/xiaohongshu-organic-traffic) · [CPE定义与成本范围](/zh/faq/xiaohongshu-pricing-metrics)

依据：公开指标导出按本地已观测的输出合同，蒲公英映射按已文档化的嵌套字段；两个脚本都有离线回归测试，蒲公英映射还没有用收费的真实投放报告核对。