When to use the server-side integration
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.
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
Optional Pre-Defined Parameters:
- conversion_source: acceptable values include
Batch Server-side Integration
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