How to integrate Reveal into Google Analytics via Segment

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!

To see guides on best practices, head here.


Step 1

Contact us. Reveal is currently in pre-release and we need to enable access for your account.

Step 2

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.

Within the Google Analytics Admin panel, navigate to  Custom Definitions and Custom Dimensions. 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 3

Add the Clearbit GA plugin code to your site. To do so, insert the below script underneath the Segment JavaScript snippet. Be sure to change the key in the `authorization` param to the publishable key as provided to you by Clearbit, and take care to adjust the mappings to reflect the custom dimension numbers you created earlier.

<script>
  analytics.ready(function(){
    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 4

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.