Using the Postback

If you need or want to use a server postback you can send a POST request to https://app.uptick.com/e/postback.

We will send two parameters to you on the landing page: uid and eid. Both of those need to be passed back as parameters to the postback url in addition to an ev parameter for purchase.

POST https://app.uptick.com/e/postback
id: <your integration id>
uid: <from uid query param on landing page>
eid: <from eid query param on landing page>
ev: purchase

HTTP 201

Required Paramers:

  • id: This ID is unique for your integration. We can provide this to you.
  • eid: This will be passed to you on the landing page as eid.
  • ev: This is a static value of purchase

Optional Paramers:

  • uid: This will be passed to you on the landing page as uid.
  • rl: The http referer for the request
  • dl: The current http location (i.e. https://store.com)
  • utm_campaign: The campaign can include a reference to our unique flow_id, which represents an offer flow.
  • utm_content: Unused
  • utm_creative_format: Unused
  • utm_marketing_tactic: Unused
  • utm_medium: Unused
  • utm_source_platform: Unused
  • utm_source: Unused
  • utm_term: Unused
  • ua: The user agent of the users browser
  • index: The index of the offer. This is a zero based index, so the first offer is 0, the second offer is 1.
  • de: The encoding of the users browser or app. Example: UTF-8.
  • sr: The resolution of the users browser or app. Example: 390x844
  • external_type: Name of who is providing the pixel data
  • external_id: If there is a unique external_id associated with this event, add that here.
  • revenue: The revenue associated with a purchase. This should be represented in dollars and cents. 10.00. This is only valid when ev = purchase.
  • currency: The currency for the revenue using the ISO 3 digit code. Example: USD, EUR

Example Implementation

Here’s a complete curl example showing how to send a postback:

curl --verbose 'https://app.uptick.com/e/postback' \
  -F "id=(their integration id)" \
  -F "event_id=(the event id that we passed to them)" \
  -F "ev=purchase"

Response Codes

The API will return different HTTP status codes based on the result:

  • 201 Created: The postback was successfully accepted and ingested.
  • 204 No Content: The postback was received but the event was not ingested (possibly due to invalid event id).
  • 400 Bad Request: Invalid parameters or missing required fields.
  • 401 Unauthorized: Invalid or missing integration ID.