إحصائيات الحملة

getCampaignStats

استرجاع إحصائيات حملة معينة لفترة زمنية محددة.

POST https://api.pushwoosh.com/json/1.3/getCampaignStats

معلمات جسم الطلب

الاسم	مطلوب	النوع	الوصف
auth	نعم	string	API access token من لوحة تحكم Pushwoosh.
campaign	نعم	string	campaign code فريد.
datefrom	نعم	string	بداية فترة التقرير (بتنسيق Y-m-d H:i:s).
dateto	نعم	string	نهاية فترة التقرير (بتنسيق Y-m-d H:i:s).

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

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",     // مطلوب. API access token من لوحة تحكم Pushwoosh
    "campaign": "XXXXX-XXXXX",          // مطلوب. Campaign code
    "datefrom": "2024-05-01 00:00:00",  // مطلوب. بداية فترة التقرير
    "dateto": "2024-05-10 23:59:59"     // مطلوب. نهاية فترة التقرير
  }
}

مثال على الاستجابة

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "request_id": "a3ef436445abfdef6255cc2f65ce7614"
  }
}

استرجاع نتائج الطلب المجدول

مهم

مثل كل طلب مجدول، يتطلب /getCampaignStats طلب /getResults إضافي.

مثال على استجابة getResults

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "formatter": "hourly",
    "rows": [{
      "count": 0,
      "action": "open",
      "datetime": "2024-05-09 00:00:00",
      "platformid": 14
    }, {
      "count": 0,
      "action": "send",
      "datetime": "2024-05-09 00:00:00",
      "platformid": 14
    }, {
      "count": 0,
      "action": "send",
      "datetime": "2024-05-11 00:00:00",
      "platformid": 14
    }],

    // التحويل (إذا كان تتبع الأهداف مسموحًا)
    "conversion": {
      "send": 10,
      "open": 5,
      "events": [{
        "uid": 1,
        "event": "event name",
        "hits": 5,
        "conversion": "100%",
        "revenue": 15.34
      }]
    }
  }
}