Set up Rockerbox

Set up Rockerbox as a destination in RudderStack.

This guide will help you set up Rockerbox as a destination in RudderStack.

Setup

  1. In your RudderStack dashboard, go to Directory > Destinations > Cloud Destinations and search for Rockerbox.
  2. Connect your source and click Continue.

Connection settings

Configure the following settings to set up Rockerbox as a destination in RudderStack:

  • Name: Assign a name to uniquely identify the destination.
  • Advertiser Id: Enter your Rockerbox Advertiser ID. It is a required field for sending events to Rockerbox via cloud mode. To obtain this ID, contact your Rockerbox account manager.

Connection mode

Specify how you want to route events from your source to Rockerbox.

RudderStack supports sending events to Rockerbox via the following connection modes:

Connection ModeWebMobileServer
Device ModeSupported--
Cloud ModeSupportedSupportedSupported
Hybrid ModeSupported--
info
In a web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Rockerbox native SDK from https://${host}/assets/${library}.js domain. See the source code for obtaining the host and library values. Based on your website’s content security policy, you might need to allowlist this domain to load the Rockerbox SDK successfully.

Send events in hybrid mode

Hybrid mode lets you use a destination in cloud mode as well as device mode simultaneously. It means that you can route some calls through server-side and others through the client-side SDK.

For the Rockerbox destination, RudderStack supports:

  • identify and page calls in device mode.
  • track calls in both the cloud and device mode.

Configuration settings

After completing the initial setup, configure the following settings to correctly receive your data in Rockerbox.

Web SDK settings

The following settings are applicable only if you are sending events to Rockerbox via web device mode:

  • Client Auth ID: Enter your Rockerbox Client Auth ID. You can obtain the Client Auth ID from your Rockerbox All Pages tag available in the Rockerbox Attribution platform. For more information, see Rockerbox documentation.
  • Custom Domain: Enter the custom domain from where you want to load the pixels.
info
Rockerbox lets you use a Custom Tracking Domain to load the Rockerbox trackers and pixels from your website’s domain (for example, rb.mysite.com) instead of getrockerbox.com. For more details, see Rockerbox documentation.
  • Enable Cookie Sync: Enable this setting if you are using a custom domain. It ensures that the Custom Tracking Domain functionality works as expected.

Other settings

  • Client-side event filtering: This setting lets you specify which events should be blocked or allowed to flow through to Rockerbox and is applicable only if you’re sending events via the web device mode. See Client-side Event Filtering guide for more information.
  • OneTrust cookie consent settings: This setting lets you associate OneTrust cookie consent groups to the Rockerbox destination.

Event mapping

  • Map your RudderStack events to Rockerbox Events: This setting lets you map the RudderStack events/properties to the Rockerbox custom events and properties. Click Set up mapping and specify the mappings. RudderStack also provides the JSON mapper to set the mappings.
JSON mapper
success
You can map multiple RudderStack events for one Rockerbox event and vice versa.

Questions? Contact us by email or on Slack