Posting Back Deliveries and Clicks for Campaigns

If you have an API based campaign you can post back Delivery and click through info to your own or a collaborators endpoints for tracking purposes if necessary. This will work for both the Template and Trigger, and Create and Send via API pattern.  

For the template and trigger pattern the postback URLS can be set when executing the campaign using the following params

use these params in you execute/campaign API call as shown below

URL: https://external-api.xtremepush.com/api/external/execute/campaign
POST DATA: 
{
    "apptoken": "APPTOKEN",
    ....,
    "webhook_delivery": "https://example.com/webhook/webpush-delivered",
    "webhook_open": "https://example.com/webhook/webpush-opened",
}

 If you are using the create and send pattern then you can also use the params you simply set then when creating the campaign via API

URL: https://external-api.xtremepush.com/api/external/create/campaign
POST DATA: 
{
    "apptoken": "APPTOKEN",
    ....,
    "webhook_delivery": "https://example.com/webhook/webpush-delivered",
    "webhook_open": "https://example.com/webhook/webpush-opened",
}

 When a message such as a push notification is successfully delivered there will be post back to the webhook_delivery endpoint and if it is clicked/opened then there will be a post back to the webhook_open endpoint. Data will take the following format:

 
{
     "time": TIMESTAMP_OF_EVENT,
     "device": {"id": DEVICE_ID},
     "profile": {"id": PROFILE_ID, "user_id": CUSTOMER_ID}   
     "send": {"id": SEND_ID},
     "campaign": {"id": CAMPAIGN_ID}
}

NOTE: when using the template and trigger pattern to do one to one messaging you can potential construct unique post back urls for each execution if that suits your tracking use case for example:

"webhook_open": "https://example.com/webhook/some-unique-identifier"