Server-side requests are useful for sending information that occurs off your main property in real-time. Common use cases include:
- Passing in-store purchases in real-time
- Back-end events that occur in a sales funnel (i.e. phone call, package shipped, package returned)
In order to setup webhooks, you must also be firing an Identify Pixel with corresponding user data whenever the user is authenticated on your website. This is required for us to match users from the webhook to onsite activity.
Webhooks must be delivered as valid JSON - Rockerbox cannot ingest XML or other formats
You will need the following field from Rockerbox. Please ask your account manager for this field.
- Advertiser ID
Submit a POST request to:
Attach to this post a data object containing the required fields as well as any extra fields that you'd like to send to Rockerbox.
Only one event / conversion should be included per POST request to Rockerbox
email: the email associated with the user (string)
customer_id: your internal identifier for the user (string)
action: the name of the conversion event that the call is associated with (string)
timestamp: the time of the conversion
Depending on your implementation, you may only need to send either email or customer_id. However, it is recommended to include both if available.
- conversion_source: acceptable values include
Rockerbox's server-side integration is designed to be used in real-time (i.e. pinging the Rockerbox's endpoint every time the trackable event occurs). If you are unable to message Rockerbox in real-time and will be sending multiple events at once in batches, make sure to add the parameter below to your requests.
- timestamp: epoch UTC timestamp of the transaction
- Sample: "timestamp":"1535147451"
You can include as many additional parameters as you'd like. Just make sure it's proper JSON
Updated 10 months ago