تصدير تقرير uplift

يصدّر تقرير uplift، أي مقاييس holdout لحملة أو Journey، إلى ملف CSV، عبر دورة حياة المهمة نفسها المستخدمة في تصدير إحصائيات الرسائل: استدعِ export، ثم استطلع status، ثم استدعِ result، ثم نزّل الملف.

ليس تصدير مجموعة التحكم

يصدّر TASK_TYPE_EXPORT_CONTROL_GROUP قائمة أعضاء مجموعة التحكم: الأجهزة وأعداد المستخدمين. أما TASK_TYPE_EXPORT_CONTROL_GROUP_ANALYTICS، الموثّق هنا، فيصدّر بدلاً من ذلك مقاييس تقرير uplift: بلا قائمة أعضاء وبلا بيانات أجهزة. إنهما نوعان منفصلان من المهام بوسيطات منفصلة.

الطلب

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 التي يملك التطبيق تقريراً لها.

مهم

لا يمكن أن تتجاوز النافذة 90 يوماً. لا يتم اقتطاع النافذة الأوسع: يفشل الطلب برمز 400 والرسالة exceeded the maximum date interval. Max interval: 90 days. يحتفظ تقرير uplift نفسه بصفوف 90 يوماً، لذا لن يتمكن طلب أوسع من إرجاع أي شيء إضافي على أي حال.

مثال على الطلب

{
  "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). لا يحتوي الملف إلا على أعمدة العملات التي تظهر فعلياً في الصفوف المُصدَّرة.

ملاحظة

عندما تكون قيمة revenue_tracked هي 0، تكون كل خلايا الإيرادات في ذلك الصف فارغة، وليست 0.00. تعني الخلية الفارغة أن المصدر لم يكن مُهيأً، لا أن الإرسال لم يحقق أي إيرادات.