导出提升度报告
将提升度报告 (uplift report)(即活动或 journey 的 holdout 指标)导出为 CSV 文件,任务生命周期与消息统计导出相同:调用 export,轮询 status,调用 result,然后下载。
POST https://api.pushwoosh.com/api/v2/statistics/exportMessagesStatistics/export
使用 "type": "TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS" 和 export_control_group_analytics 对象,而不是 export_messages_v2。身份验证以及生命周期的其余部分(status、result、lastTasks、delete、下载)与消息统计导出中的说明完全一致。
export_control_group_analytics 接受以下字段:
| 名称 | 必需 | 类型 | 描述 |
|---|---|---|---|
application_code | 是 | String | 应用代码。 |
date_from | 是 | String | 基于报告自身时间戳的时间窗口起点,格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS。仅含日期的值会扩展为当天的开始时间。 |
date_to | 是 | String | 时间窗口终点,格式相同。仅含日期的值会扩展为当天的结束时间。 |
campaign | 否 | String | 活动代码,仅导出该活动的 holdout。与 journey 互斥。 |
journey | 否 | String | Journey UUID,仅导出该 journey 的 Holdout Split 节点。与 campaign 互斥。 |
将 campaign 和 journey 都留空,即可导出该应用拥有报告的所有活动和所有 journey。
请求示例
Anchor link to{ "type": "TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS", "export_control_group_analytics": { "application_code": "XXXXX-XXXXX", "date_from": "2026-08-01", "date_to": "2026-08-31" }}result 返回 export_control_group_analytics_result.file 和 .file_url,结构与消息统计导出的 result 相同。
文件内容
Anchor link to每个活动或每个 journey holdout 节点、每个目标事件对应一行。底层报告每天都会为同一组合写入一条新行,而导出只保留最新的一行,因此您得到的是当前数值,而不是每次历史运行的记录。
| 列 | 描述 |
|---|---|
timestamp | 该行的计算时间。 |
owner_type | TYPE_CAMPAIGN 或 TYPE_JOURNEY。 |
owner_id | 活动行为活动代码或消息代码,journey 行为 journey 的 UUID。 |
point_uuid | journey 行为 Holdout Split 节点的 UUID。活动行为空。 |
event_name | 该行衡量的目标事件。 |
attribution_window_seconds | 所应用的归因窗口,单位为秒。 |
treatment_users、control_users、treatment_conversions、control_conversions、treatment_events、control_events | 下列指标背后的原始计数。 |
uplift_pct、incremental_events、percent_of_treatment、z_score、p_value、confidence_pct | 与提升度报告中的指标相同。 |
significance | TYPE_SIGNIFICANT、TYPE_NOT_SIGNIFICANT 或 TYPE_NOT_ENOUGH_DATA。 |
revenue_tracked | 如果目标事件的收入来源已配置,则为 1;如果该行只是根据旧版回退逻辑推测,则为 0。请参阅报告中的收入。 |
treatment_revenue_<currency>、control_revenue_<currency>、incremental_revenue_<currency> | 每种货币三列,货币代码为小写(例如 treatment_revenue_usd)。文件只包含导出行中实际出现的货币对应的列。 |