技能介绍

要解决的具体问题

当工程师需要回答“某账户昨天花了多少钱、点击和转化怎样”这类问题时，Bilibili 三连广告体系里真正可用的投放指标通常来自报表接口，而不是广告管理端点。这个技能把一次自定义报表查询约束成可执行流程：先确认 access_token 与 account_id，再按官方维度与指标名组装 POST /open_api/report/v3/custom/query 请求，读取按天或按页返回的数据行。它适合排查 spend、impression、click 等投放表现，不适用于账户余额、预算或现金流查询。

核心能力与关键步骤

只读有消耗的报表行：接口只返回存在 spend 的日期或对象，缺行不表示 API 故障，也不应盲目重试。
先定模式再选指标：账户级查询只带 account_id；对象级查询中，campaign_id、unit_id、creative_id 触发 legacy 模式，而 promotion_id 或 media_id 触发 creative-driven 2.0 模式。两种模式的指标集合不同，不能混用。
一次一天、顺序推进：start_time 与 end_time 必须为同一天；多日范围需要逐日串行查询，失败当天应停止并检查请求，而不是跳过或并发补跑。
金额按精度选择字段：普通字段以元为单位，适合展示；_milli 字段是毫分级整数，1 元 = 100000，适合对账和精确加总。
过滤项要拆开：单个 filter 最多 100 个 ID，且 filters[].values 不能为空；小时粒度会增加行数，需要分页。