How to integrate Reveal into Google Analytics

Reveal equips marketers with deep insights about their web traffic. Behind the scenes, Reveal dynamically links IP addresses with specific companies and their relevant firmographics & technographics.

It's especially useful for the following use-cases:

  • Knowing which companies are browsing your site in real-time, even if they haven't submitted a form.
  • Determining attribution & conversion statistics for key accounts and target segments.
  • Customizing engagement for key accounts or company profiles (by size, vertical, or even tech stack).
  • Delivering dynamically personalized content to your site visitors.

Reveal currently comes with a Google Analytics integration out of the box and takes all of 15 minutes to get up and running!

If you have Google Tag Manager, you may need to use this guide instead.  To see guides on best practices, head here.


NOTE: Reveal is currently in limited release, so you'll first need to contact us to enable access for your account if you haven't already. 

Step 1

Create a set of custom dimensions within Google Analytics. You'll need to create a one-to-one mapping of Clearbit attributes to Google Analytics dimensions.

Custom dimensions can be created manually, or through this setup tool (skip to Step 2 after following the steps in the setup tool).

If you'd like to set things up without the tool, navigate to  Custom Definitions and Custom Dimensions within the Google Analytics Admin panel. Create a custom dimension for each of the properties below, with a 'Scope' of 'User'. 

We recommend:

  • Clearbit Company Name
  • Clearbit Employees Range
  • Clearbit Industry Tags
  • Clearbit Tech Stack
  • Clearbit SubIndustry
  • Clearbit Industry
  • Clearbit Industry Group
  • Clearbit Sector
  • Clearbit Company Type
  • Clearbit Domain

You can choose to create as many or as few dimensions as you think is useful. Make sure you keep a note of the dimension numbers, you'll need those later.

Step 2

Add the Clearbit GA plugin code to your site. If you used the setup tool to generate the code, you can copy the code generated without modification. Otherwise, insert the below script underneath the Google Analytics standard `ga('create')` and `ga('send', 'pageview')` sections. Be sure to change the key in the `authorization` param to the publishable key, and take care to adjust the mappings to reflect the custom dimension numbers you created earlier.

<script>
  ga('require', 'Clearbit', {
    mapping: {
      companyName:           'dimension1',
      companyEmployeesRange: 'dimension2',
      companyTags:           'dimension3',
      companyTech:           'dimension4',
      companySubIndustry:    'dimension5',
      companyIndustry:       'dimension6',
      companyIndustryGroup:  'dimension7',
      companySector:         'dimension8',
      companyType:           'dimension9',
      companyDomain:         'dimension10'
    }
  });
</script>

<script async src="https://ga.clearbit.com/v1/ga.js?authorization=pk_YOUR_KEY"></script>

Step 3

The last step is to build some amazing dashboards in Google Analytics. Go to your GA reporting section, then Dashboards, then New Dashboard and create a blank canvas dashboard. Add a Widget, select Standard Table, then use Users as a metric, and the dimension you're displaying as the column.

Then, rinse and repeat this over all your custom dimensions. As data starts flowing in (over the next day or so) you'll see it appear in your dashboard.