GET Stats / Transactional Notifications
Returns metrics for a given transactional notification group
Endpoint URL: https://api.carnivalmobile.com/v6/transactional/notifications/:group/stats
Parameters
Path Parameters
Name | Type | Required | Definition |
---|---|---|---|
group | string | Yes | Group identifier |
Query Parameters
from | yyyy-mm-dd | ||
to | yyyy-mm-dd |
Examples
cURL
Copy
curl -X GET -u :$API_KEY -H 'Accept: application/json' https://api.carnivalmobile.com/v6/transactional/notifications/$group/stats
cURL
Copy
curl -X GET -u :$API_KEY -H 'Accept: application/json' "https://api.carnivalmobile.com/v6/transactional/notifications/$GROUP/stats?from=2020-08-01&to=2020-12-01"
Result Format
200 OK
Copy
{
"group": "coupon-codes",
"direct_opens": 10,
"indirect_opens": 100,
"notifications_sent": 1000,
"event_conversions": {
"my event": 5
},
"purchase_conversions": [
{
"name": "item_name_1",
"total_value": 10,
"count": 1
},
{
"name": "item_name_2",
"total_value": 100,
"count": 2
}
]
}
Copy
{
"error":"unauthorized"}
403 Forbidden
{"error":{"reason":"unauthorized"}}
This endpoint returns data and metrics for a given transactional notification group. Metrics are updated in real time. Influenced opens (including direct and indirect), events and purchases are counted using our standard attribution windows.
It supports the use of date ranges to filter the result set. This must be done in the format YYYY-mm-dd
.
Field | Type | Description |
---|---|---|
group
|
String
|
The transactional notification group
|
direct_opens
|
Integer
|
How many times users opened the app as a result of tapping the push alert directly
|
indirect_opens
|
Integer
|
How many times users opened the app as a result of receiving a push notification, then opening the app without interacting with the push alert
|
event_conversions
|
Dictionary<String, Integer>
|
A list of custom events where the key is a custom event and the value is the number of occurrences of this event
|
purchase_conversions
|
Array[PurchaseItem<name: String, total_value: Integer, count: Integer>]
|
A list of purchase objects attributed to the transactional push group, containing name, total value and count. Note that
total_value is an integer number of cents, so a purchase worth $10 will show as 1000.
|