跳到内容

导出提升度报告

将提升度报告 (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否StringJourney 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_typeTYPE_CAMPAIGN 或 TYPE_JOURNEY。
owner_id活动行为活动代码或消息代码,journey 行为 journey 的 UUID。
point_uuidjourney 行为 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与提升度报告中的指标相同。
significanceTYPE_SIGNIFICANT、TYPE_NOT_SIGNIFICANT 或 TYPE_NOT_ENOUGH_DATA。
revenue_tracked如果目标事件的收入来源已配置,则为 1;如果该行只是根据旧版回退逻辑推测,则为 0。请参阅报告中的收入。
treatment_revenue_<currency>、control_revenue_<currency>、incremental_revenue_<currency>每种货币三列,货币代码为小写(例如 treatment_revenue_usd)。文件只包含导出行中实际出现的货币对应的列。