技能介绍

它解决什么问题

投放监测数据通常散落在各家媒体后台，导出口径不一，pv/uv 混用，跨天相加很容易得出假数字。DataMax 广告测量把曝光与点击的采集、汇总、下钻收进同一个 MCP 端点，用一把 Access Key 在同一个工作空间里查询，并把人群包计算与推送也串在同一套编码体系下。

Key 类型与工作空间是两道正交约束

whoami 返回的 scope 只有 read 与 standard，对应只读 Key 与管理 Key；后者才具备建监测、建品牌、撤链接、改工作空间名的能力。
类型与有效期创建后不可改，只读 Key 的 tools/list 里根本不会出现写工具。
每把 Key 必须勾选至少一个授权工作空间，完整值只在创建时可见一次。
tools/list 是唯一权威，文档描述的当前版本不等于你实际连上的工具集。

测量与人群激活是两条线

测量侧先建监测组（monitor_group_code，URL 上的 mg 参数），组内曝光与点击各出一条链接，只有 pairing_state=paired 时该组点击率才算得准。数据侧按 measure_summary、measure_trend、measure_geo 等维度取数。人群激活侧把测量攒下的人推给媒体：estimate_audience 试算 → create_audience_package 异步圈选 → create_audience_push 建完即推 → 可选 generate_audience_portrait 生成画像。

引用数据前必须转述的口径

pv 是次数、uv 是人数；uv 是截至区间末的近 100 天累积去重快照，不能跨天相加，也不能跨行相加。
地域只有 PV，有效曝光过低的地域返回 suppressed=true 且 imp_pv 归零，这是不予展示，不是真实零曝光。
link_id（监测 ID，字符串）与 id（内部主键，数字）是两个东西，用错接口会拿错参数。
所有编码原样传：campaign_code 新旧两代格式并存，brand_code 是品牌 id 的十进制串。
测量侧平台枚举（xhs/dy/tx/ty）与人群激活侧（oceanengine/tencentads 等）是两套，不通用。

边界与注意点

平台授权只能在 DataMax 网页端由用户完成，OAuth 两家必须勾具体投放账户，勾错要到推送时才被拒。
圈选规则只有 and/or，没有差集，「排除已转化人群」这类需求表达不出来。
人群包计算、推送、画像都是异步，服务端没有硬超时阈值，应按 platform_stage 与 parts[].status 判断，别按固定分钟数报「卡住」。
共享演示空间只有测量那半边，人群功能一律被拒；画像文件下载地址 30 分钟过期，页面地址 console_url 不过期，未明说要文件时优先给后者。