ส่งออกรายงาน uplift

ส่งออกรายงาน uplift ซึ่งเป็นเมตริก holdout ของแคมเปญหรือ journey ไปยังไฟล์ 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	UUID ของ journey ส่งออกเฉพาะจุด Holdout Split ของ journey นั้น ใช้ร่วมกับ `campaign` ไม่ได้

เว้นว่างทั้ง campaign และ journey เพื่อส่งออกทุกแคมเปญและทุก journey ที่แอปพลิเคชันมีรายงาน

ตัวอย่างคำร้องขอ

{
  "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 ของการส่งออกสถิติข้อความ

ข้อมูลในไฟล์

หนึ่งแถวต่อแคมเปญหรือต่อจุด holdout ของ journey ต่ออีเวนต์เป้าหมาย รายงานต้นทางจะเขียนแถวใหม่ทุกวันสำหรับคู่เดียวกัน และการส่งออกจะเก็บไว้เฉพาะแถวล่าสุด คุณจึงได้ตัวเลขปัจจุบัน ไม่ใช่ประวัติของการรันทุกครั้งที่ผ่านมา

คอลัมน์	คำอธิบาย
`timestamp`	เวลาที่คำนวณแถวนี้
`owner_type`	`TYPE_CAMPAIGN` หรือ `TYPE_JOURNEY`
`owner_id`	รหัสแคมเปญหรือรหัสข้อความสำหรับแถวของแคมเปญ และ UUID ของ journey สำหรับแถวของ journey
`point_uuid`	UUID ของจุด Holdout Split สำหรับแถวของ journey ว่างสำหรับแถวของแคมเปญ
`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`	เมตริกเดียวกับในรายงาน uplift
`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`) ไฟล์จะมีคอลัมน์เฉพาะสกุลเงินที่ปรากฏจริงในแถวที่ส่งออก