สถิติแอปพลิเคชันและผู้สมัครรับข้อมูล

getAppStats

รับสถิติของแอปที่ระบุสำหรับช่วงเวลาที่กำหนด

POST https://cp.pushwoosh.com/json/1.3/getAppStats

พารามิเตอร์ของคำขอ

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`auth`	ใช่	string	โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
`application`	ใช่	string	รหัสแอปพลิเคชัน Pushwoosh
`datefrom`	ใช่	string	วันที่และเวลาเริ่มต้นของรอบการรายงาน รูปแบบ: `Y-m-d H:i:s`
`dateto`	ใช่	string	วันที่และเวลาสิ้นสุดของรอบการรายงาน รูปแบบ: `Y-m-d H:i:s`

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

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H",    // จำเป็น โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
    "application": "XXXXX-XXXXX",      // จำเป็น รหัสแอปพลิเคชัน Pushwoosh
    "datefrom": "2013-06-04 00:00:00", // จำเป็น วันที่และเวลา เริ่มต้นของรอบการรายงาน
    "dateto": "2013-06-07 00:00:00"    // จำเป็น วันที่และเวลา สิ้นสุดของรอบการรายงาน
  }
}

ตัวอย่างการตอบกลับ

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

ทำความเข้าใจสถิติ

สถิติแสดงการกระทำที่ลงทะเบียนไว้สำหรับแอปพลิเคชัน อุปกรณ์ หรือข้อความภายในกรอบเวลาที่ระบุ

รายงานจะถูกรวบรวมโดยอัตโนมัติตามกฎต่อไปนี้:

รายปี: หากช่วงเวลานานกว่าหนึ่งปี
รายเดือน: หากช่วงเวลานานกว่าหนึ่งเดือน
รายวัน: หากช่วงเวลานานกว่าหนึ่งวัน
รายชั่วโมง: หากช่วงเวลานานกว่าสามชั่วโมง
รายนาที: ในกรณีอื่นๆ ทั้งหมด

ประเภทการกระทำ

ระดับแอปพลิเคชัน: _open_, _install_
ระดับอุปกรณ์: _register_, _unregister_
ระดับข้อความ: _send_, _open_

รูปแบบการตอบกลับ

อ็อบเจ็กต์สถิติทั้งหมดมีรูปแบบเดียวกัน:

ฟิลด์	ประเภท	คำอธิบาย
`formatter`	string	มาตราส่วนรายงาน: รายปี, รายเดือน, รายวัน, รายชั่วโมง, รายนาที
`rows`	list	มีข้อมูลรายงานสำหรับการกระทำที่ลงทะเบียนไว้แต่ละรายการ

แต่ละแถวของรายงานประกอบด้วย:

ฟิลด์	ประเภท	คำอธิบาย
`count`	int	จำนวนการกระทำที่ลงทะเบียน
`action`	string	ประเภทของการกระทำที่ลงทะเบียน
`datetime`	string	วันที่ที่จัดรูปแบบ: `Y-m-d H:i:s`

การดึงผลลัพธ์ของคำขอที่ตั้งเวลาไว้

เนื้อหาการตอบกลับ

ฟิลด์	ประเภท	คำอธิบาย
`request_id`	string	รหัสคำขอที่ตั้งเวลาไว้ โปรดดูรายละเอียดเพิ่มเติมที่ `/getResults`

เนื้อหาการตอบกลับที่ตั้งเวลาไว้ (/getResults)

ฟิลด์	ประเภท	คำอธิบาย
`applications`	dictionary	สถิติสำหรับแอปพลิเคชัน
`devices`	dictionary	สถิติสำหรับอุปกรณ์
`messages`	dictionary	สถิติสำหรับข้อความ

ตัวอย่าง

{
  "error": {
    "code": 0,
    "message": "OK"
  },
  "json_data": {
    "applications": {
      "formatter": "hourly",
      "rows": [{
        "count": 0,
        "action": "open",
        "datetime": "2013-06-06 00:00:00"
      }, {
        ...
      }]
    }
  }
}

getApplicationSubscribersStats

แสดงรายชื่อผู้สมัครรับข้อมูลของแอปโดยจัดกลุ่มตามประเภทอุปกรณ์ของพวกเขา

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

เนื้อหาของคำขอ

ชื่อ	จำเป็น	ประเภท	คำอธิบาย
`auth`	ใช่	string	โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
`application`	ใช่	string	รหัสแอปพลิเคชัน Pushwoosh

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

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // จำเป็น โทเค็นการเข้าถึง API จาก Pushwoosh Control Panel
    "application": "XXXXX-XXXXX"    // จำเป็น รหัสแอปพลิเคชัน Pushwoosh
  }
}

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "IOS": 1,
    "ANDROID": 1,
    "OSX": 0,
    "WINDOWS": 0,
    "AMAZON": 0,
    "SAFARI": 0,
    "FIREFOX": 0
  }
}

getSubscribersStatistics

ดึงข้อมูลสถิติผู้สมัครรับข้อมูลของแอปสำหรับช่วงเวลาหนึ่ง

POST https://api.pushwoosh.com/api/v2/statistics/application/getSubscribersStatistics

ส่วนหัว (Headers)

| ชื่อ

| จำเป็น | ประเภท | คำอธิบาย |
|-----------------|----------|--------|--------------------------------------------------------------------------------------------------------------|
| Authorization | ใช่ | string | โทเค็นการเข้าถึง API ในรูปแบบ: Key PKX.......NHg |
| Content-Type | ใช่ | string | ต้องตั้งค่าเป็น application/json |

พารามิเตอร์ของคำขอ

| ชื่อ

| จำเป็น | ประเภท | คำอธิบาย |
|------------------|----------|--------|--------------------------------------------------------------------------|
| application_code | ใช่ | string | รหัสแอปพลิเคชัน Pushwoosh |
| timestamp_from | ใช่ | string | วันที่และเวลาเริ่มต้นของช่วงเวลาสถิติ (รูปแบบ: YYYY-MM-DD hh:mm:ss, UTC+0) |
| timestamp_to | ใช่ | string | วันที่และเวลาสิ้นสุดของช่วงเวลาสถิติ (รูปแบบ: YYYY-MM-DD hh:mm:ss, UTC+0) |

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

curl --location --request POST 'https://go.pushwoosh.com/api/v2/statistics/application/getSubscribersStatistics' \
--header 'Authorization: Key 3a2X......828JreCk48f' \
--header 'Content-Type: application/json' \
--data-raw '{
   "application_code": "12345-67890",        // รหัสแอป Pushwoosh
   "timestamp_from": "2022-08-01 00:00:00",  // UTC+0
   "timestamp_to": "2022-09-01 00:00:00"     // UTC+0
}'

ตัวอย่างการตอบกลับ

{
  "statistics": [{
    "timestamp": "YYYY-MM-DD hh:mm:ss", // UTC+0
    "platform": 1,
    "push_enabled": 100,
    "push_disabled": 100
  }]
}

รหัสการตอบกลับ

{
  "statistics": [{
    "timestamp": "YYYY-MM-DD hh:mm:ss",
    "platform": 1,
    "push_enabled": 100,
    "push_disabled": 100
  }]
}

คำอธิบาย: คำขอสำเร็จและสถิติถูกส่งคืน

{
  // Response
}

คำอธิบาย: คำขอมีไวยากรณ์หรือพารามิเตอร์ที่ไม่ถูกต้อง

{
  // Response
}

คำอธิบาย: เซิร์ฟเวอร์พบข้อผิดพลาด โปรดลองอีกครั้งในภายหลัง

{
  // Response
}

คำอธิบาย: การรับรองความถูกต้องล้มเหลว ตรวจสอบคีย์ API หรือโทเค็นของคุณ

{
  // Response
}

คำอธิบาย: การเข้าถึงถูกปฏิเสธสำหรับรหัสแอปที่ระบุ

{
  // Response
}

คำอธิบาย: ไม่พบรหัสแอปหรือไม่มีอยู่

กฎช่วงเวลาของ Timestamp

โปรดทราบว่าช่วงเวลาระหว่าง timestamp ในการตอบกลับจะขึ้นอยู่กับช่วงเวลาที่คุณส่งในคำขอของคุณ ดังนี้:

หากคุณขอสถิติสำหรับช่วงเวลานานกว่าหนึ่งปี ช่วงเวลาของ timestamp สถิติจะเป็นหนึ่งปี
หากช่วงเวลาสถิติเท่ากับหนึ่งปี ช่วงเวลาระหว่าง timestamp ของการตอบกลับจะเท่ากับหนึ่งเดือน
สำหรับช่วงเวลาที่นานกว่าหนึ่งเดือนแต่ไม่ถึงหนึ่งปี สถิติสำหรับทุกวันจะถูกส่งคืน
สำหรับช่วงเวลาที่น้อยกว่าหนึ่งเดือน การตอบกลับจะรวมสถิติสำหรับทุกชั่วโมง

| ช่วงเวลาที่ขอ

| ช่วงเวลาในการตอบกลับ

|
|-------------------|--------------------|
| มากกว่า 1 ปี | 1 ปี |
| 1 ปี | 1 เดือน |
| 1 เดือน - 1 ปี | 1 วัน |
| น้อยกว่า 1 เดือน| 1 ชั่วโมง |