用途
AdCP Measurement 面向测量代理（measurement agent）这一角色，使其能够作为独立的提供方身份运行，或与买方控制的编排器网关集成。测量代理不需要卖方凭证，编排器负责队列一致性、卖方 ID 映射、归一化和披露控制。该技能专注于测量相关的语义，而认证、幂等性、错误恢复和账户解析等基础调用规则由 skills/call-adcp-agent/SKILL.md 覆盖。
主要能力
测量代理可以：
- 通过 get_adcp_capabilities.measurement.metrics[] 发布其计算的指标；
- 在产出可供优化器使用的断言时，声明 measurement.produces_performance_feedback: true；
- 通过编排器的 get_media_buy_delivery 任务获取买方批准的数据；
- 通过 provide_performance_feedback 任务返回紧凑断言，之后由编排器决定向每个卖方发送什么。
测量代理永远不需要卖方凭证。report_usage 是供应商服务消费与计费任务，不是通用测量交换。
发现机制
在提供方的 brand.json 中发布 type: "measurement" 的代理条目。代理的 get_adcp_capabilities 响应包含 supported_protocols、experimental_features 以及 measurement 对象，其中 measurement 包含 produces_performance_feedback 和 metrics 数组。每个指标包含 metric_id、unit、description、methodology_url 和 methodology_version。指标身份由（提供方 BrandRef, metric_id）共同确定，不应假设供应商指标 ID 全局唯一。第一层实验性网关固定了交换任务，而不是协商方法数组。
编排器网关与授权
买方编排器的实验性 measurement_gateway 能力意味着它暴露任务边界，但本身不授予访问权限。编排器在编排器账户上为提供方进行配置，卖方不参与此提供方授权。提供方的已认证主体在其编排器账户上获得两个第一层网关任务：get_media_buy_delivery 和 provide_performance_feedback，read_only 为 false。可使用编排器定义的自定义 scope 名称，但任务列表是规范性的，自定义名称不是。Webhook 和离线交换不属于本层，需要显式注册、凭证、负载和回执契约后才能作为可互操作的 AdCP 路径发布。编排器向提供方暴露面向测量的媒体购买、包和创意 ID，并保留其到每个卖方本地 ID 的映射。
产出反馈
每次任务调用提交一个断言，包含 idempotency_key、media_buy_id、package_id、measurement_period、metric（含 scope、vendor、metric_id）、performance_index、baseline、producer、methodology、methodology_version、study_ref、evidence_ref 和 final 等字段。规则包括：1.0 等于指定基线；紧凑契约生产者（存在 baseline）对越高越好的比率必须使用 observed/baseline，对越低越好的比率（如 CPA）使用 baseline/observed；producer 必须与编排器网关处的已认证提供方身份匹配；study_ref 仅用于关联，绝不要求卖方构建实验组；原始日志、模型系数、身份路径和完整研究数据集应保留在反馈负载之外；修订是带有新 idempotency_key 和来自较早回执的 supersedes_feedback_id 的新断言。
读取回执
网关回执标识编排器存储的断言，通常报告 accepted，但不证明任何卖方使用了该信号。每个卖方向编排器返回单独回执。卖方的 applied 表示信号进入该卖方的优化器输入；not_applied 表示接收端点评估但未纳入该断言，需检查 status_reason。不应从 applied 声称因果交付影响，它仅表示卖方消费了信号，而非信号导致了特定的出价或分配变化。
端到端流程
- 编排器提供数据：提供方调用编排器的 get_media_buy_delivery 任务获取买方批准的数据，编排器在测量前对卖方应用相同的用户或地理队列定义。
- 提供方返回反馈：提供方调用编排器网关的 provide_performance_feedback 任务，已认证提供方身份绑定 producer，原始日志、模型系数和身份路径保留在负载之外。
- 编排器扇出：编排器验证并归一化结果，选择每个卖方应接收的内容，映射到卖方本地 ID，并在买方身份下调用每个卖方的 provide_performance_feedback，同时保留提供方与卖方回执之间的映射以供审计。
适用场景与限制
适用于需要以测量代理身份发布指标、接收买方授权数据并返回性能反馈的场景，尤其适合通过买方编排器进行跨卖方测量协调的流程。限制包括：测量代理不需要卖方凭证；Webhook 和离线交换不在第一层支持范围内；网关回执的 accepted 不代表卖方实际使用；applied 不代表因果影响；指标 ID 不保证全局唯一；原始日志、模型系数、身份路径和完整研究数据集不应放入反馈负载。