Push Tracking
Audit of push notifications delivery
Private Offering feature
To enable Push Tracking, please contact your Customer Success Manager.
Please be aware that Push Tracking is not available for pushes sent to contact lists (via uploading CSV files with target devices' IDs).
As soon as the Push Tracking functionality is enabled, each notification that you send for specific devices returns the unique tracking codes in the response:
Example
1
{
2
"status_code":200,
3
"status_message":"OK",
4
"response":{
5
"Messages":[
6
"CODE_NOT_AVAILABLE"
7
],
8
"TrackingCodes":[
9
"TRACKING_CODE_1"
10
]
11
}
12
}
Copied!
Later you may use the getTrackingLog API method in order to get the tracking logs of notifications:
Method https://cp.pushwoosh.com/json/1.3/getTrackingLog
Example
1
{
2
"request":{
3
"auth":"API TOKEN",
4
"date":"2017-01-02" // optional, date for which tracking log is required
5
}
6
}
Copied!
Response:
Response example
1
{
2
"status_code":200,
3
"status_message":"OK",
4
"response":{
5
"request_id":"2702dd59b826e4a23b2f1af24de53108" // request_id for getResults method
6
}
7
}
Copied!
Then use the /getResults method: https://cp.pushwoosh.com/json/1.3/getResults
Example
1
{
2
"request":{
3
"auth":"API_ACCESS_TOKEN",
4
"request_id":"2702dd59b826e4a23b2f1af24de53108"
5
}
6
}
Copied!
In the results you will get the tracking log link:
Example
1
{
2
"status_code":200,
3
"status_message":"OK",
4
"response":{
5
"fileName":"http://static.pushwoosh.com/tracking_log_link.zip" // direct link to zip file
6
}
7
}
8
Copied!
Please note the push tracking log contains messages created within the last 14 days.
In the ZIP file you will find the CSV list (example below):
1
//timestamp;tracking_code;target_id;hwid;status;description;appCode;payload
2
"2021-04-20 13:01:01";T-D6C2-ABC2228F-C9C305A9;09913CFD-74AD-4A8C-B06E-CCA51200ADDC;09913CFD-74AD-4A8C-B06E-CCA51200ADDC;delivered;Success;C90C0-0E786;"{""aps"":{""alert"":""text"",""badge"":0,""sound"":""""},""md"":{""uid"":11793546856,""user_id"":""09913CFD-74AD-4A8C-B06E-CCA51200ADDC""},""p"":""Zh"",""pw_msg"":""1""}"
Copied!
Where:
    timestamp - time of the specified event
    tracking_code - tracking code generated for a given message
    target_id - device identifier (hwid/pushtoken) that was used for device specifying
    hwid - hardware id
    status - notification status: created, sent, delivered (notification gateway reported that notification was passed for the further delivery), failed (sending was unsuccessful), opened.
    description - additional info
    appCode - code of the app the push was sent to
    payload - push content and settings
To enable logging of push opens, please contact our Customer Support team or your Customer Success Manager.
Last modified 5mo ago
Copy link