Rockerbox
Rockerbox is a marketing measurement and multi-touch attribution platform. Datafly Signal delivers your conversion events to Rockerbox’s real-time conversion webhook server-to-server, so attribution no longer depends on a browser pixel that ad blockers and ITP can strip away.
Because Signal sends conversions from your own first-party endpoint with the user’s email and your internal customer ID, Rockerbox can match conversions to marketing touchpoints with higher fidelity than a client-side tag.
Why route Rockerbox through Datafly Signal
- Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so the conversions Rockerbox optimises against are not filtered by the browser.
- One consent decision governs every destination. Rockerbox is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
- No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.
Prerequisites
- A Rockerbox account with measurement enabled.
- Your Advertiser ID. Rockerbox issues this per account — ask your Rockerbox account manager if you do not have it. It is the value in the
advertiserquery parameter on the webhook URL. - The conversion actions you want to measure agreed with your Rockerbox account team (for example
purchase,signup,lead). Each distinctactionstring appears as a named conversion in the Rockerbox dashboard. - Datafly Signal deployed with a pipeline already collecting events from your site via Datafly.js.
Configuration
| Field | Required | Description |
|---|---|---|
| Advertiser ID | Yes | Your Rockerbox Advertiser ID. Sent as the advertiser query parameter on every request. |
Rockerbox’s conversion webhook authenticates solely by the advertiser query parameter. There is no API key or bearer token for this endpoint, so keep your Advertiser ID treated as a shared secret at the deployment level.
Configure in Signal
- In Management UI, open your pipeline and add a new destination.
- Choose Rockerbox from the Attribution category.
- Enter your Advertiser ID.
- Select the Default preset. It maps the standard Signal conversion events (
Order Completed,Signed Up,Lead Generated) to Rockerbox actions and forwardspageviews, and attaches email, phone, and your customer ID for identity matching. - Map any additional events or custom conversion parameters as needed, then save and enable the destination.
API Endpoint
Signal delivers each conversion as a single JSON POST:
POST https://webhooks.getrockerbox.com/webhook/data?advertiser=<ADVERTISER_ID>
Content-Type: application/jsonRockerbox accepts exactly one conversion per request. The four required fields are email, customer_id, action, and timestamp (epoch seconds, UTC). At least one of email or customer_id must be present for a conversion to attribute; Signal sends both whenever they are available.
Identity Signals
Rockerbox performs its own identity resolution and hashing server-side, so Signal sends plaintext email and phone on this first-party webhook — they are not pre-hashed (unlike vendor conversion APIs such as Meta CAPI).
| Signal source | Rockerbox field | Notes |
|---|---|---|
$traits.email | email | Plaintext, lower-cased and trimmed. |
$traits.phone | phone | Plaintext, normalised to E.164. |
user_id | customer_id | Your internal user identifier. |
Event Mapping
Signal’s GA4-style event names map to Rockerbox action values. The Default preset includes:
| Signal event | Rockerbox action | Notes |
|---|---|---|
page | page_view | Page-view signal for path coverage. |
Order Completed | purchase | Carries revenue, order_id. |
Signed Up | signup | |
Lead Generated | lead |
Example
Datafly.js call on your site:
datafly.track("Order Completed", {
order_id: "PRCH11809871",
revenue: 27.50,
currency: "USD"
});Resulting payload Signal delivers to Rockerbox:
{
"email": "jane@example.com",
"customer_id": "user_8842",
"action": "purchase",
"timestamp": 1535147451,
"revenue": 27.50,
"order_id": "PRCH11809871"
}Testing
- Trigger a conversion on your site (or use Signal’s Event Debugger to replay one).
- In the Signal Event Debugger, confirm the Rockerbox destination shows a
2xxresponse and inspect the exact JSON body sent. - In the Rockerbox dashboard, open your conversion report and confirm the conversion appears under the matching
actionwithin Rockerbox’s processing window.
Troubleshooting
- No conversions appearing: confirm the
advertiserquery parameter matches the Advertiser ID issued by your Rockerbox account manager. A wrong or missing value returns a 4xx. - Conversions not matching to touchpoints: ensure at least one of
emailorcustomer_idis populated. Conversions with neither cannot attribute. 400responses: Rockerbox accepts only one conversion per request and only valid JSON. Signal sends one event per request by design, so a 400 usually means a malformed custom field — check your event mappings.- Unexpected actions in the dashboard: every distinct
actionstring is a separate named conversion. Keep yourvendor_event_namevalues stable and snake_case to avoid fragmenting reports.