If you use Branch for mobile app installs and engagement, Rockerbox can take in data from Branch to identify cross-device users. When Branch identifies a "match" between two devices, Rockerbox can use that information to tie together the user's journey across those devices.

📘

Supported Matches

We can only support instances where Branch guarantees a 100% match accuracy (see Branch docs here).

In order to tie on-site visitors to in-app actions, we need to have Branch and Rockerbox hooked up in both places.

On your Website

You must have Branch Web SDK installed on all pages of your website. The Rockerbox pixel will automatically detect the Branch Web SDK and pull in any identifiers for your account.

<!doctype html>
<html>
<head>
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title></title>
  <script>
    // load Branch
      (function(b,r,a,n,c,h,_,s,d,k){if(!b[n]||!b[n]._q){for(;s<_.length;)c(h,_[s++]);d=r.createElement(a);d.async=1;d.src="https://cdn.branch.io/branch-latest.min.js";k=r.getElementsByTagName(a)[0];k.parentNode.insertBefore(d,k);b[n]=h}})(window,document,"script","branch",function(b,r){b[r]=function(){b._q.push([r,arguments])}},{_q:[],_v:1},"addListener applyCode autoAppIndex banner closeBanner closeJourney creditHistory credits data deepview deepviewCta first getCode init link logout redeem referrals removeListener sendSMS setBranchViewData setIdentity track validateCode trackCommerceEvent logEvent disableTracking".split(" "), 0);
    // init Branch
    branch.init('key_live_YOUR_KEY_GOES_HERE');
  </script>
</head>
<body>
</body>
</html>

App Data

Automated (directly from Branch)

In order for Rockerbox to collect information about in-app activity, you can use Branch's webhooks to send the INSTALL, REINSTALL and RB_IDENTIFY events to Rockerbox.

You can create a webhook by going to your Branch dashboard and navigating to Data Import & Export > Data Feeds > Webhooks > Add New Webhook:

Then, using your webhook endpoint (e.g. https://webhooks.getrockerbox.com/branch?advertiser=example_company), configure a POST to be sent for each of those events.

🚧

You will need to repeat the process 3 times to configure webhooks for each of the following Branch events: INSTALL, REINSTALL, RB_IDENTIFY. Each of these events will go to the same Rockerbox URL.

If you have additional events you are tracking with Branch (e.g. COMPLETE_REGISTRATION), feel free to create additional webhooks to send them to Rockerbox.

Once you have the above set up, Rockerbox will be able to use Branch's matching to identify users across devices and be able to attribute the desktop web actions that led a user to install an app on their mobile device.

Integration Overview


Did this page help you?