Legacy: Integrate Clearbit Reveal with Segment

Last Updated: September 25, 2023

🔍 Please note: This article is for customers on Standard Bundle, Enrichment, or Clearbit Platform plans.

Skip Ahead to:

What Can Clearbit Reveal Do with Segment?

Automatically add Reveal data to anonymous users to any of Segment’s tools on their platform.

sV3dZhPU.png

Use cases include:
  • sending Reveal data into Drift via Segment to create a more personalized and targeted chat experience
  • creating dynamic custom audiences with Facebook Ads based on web visits, behavioral events (e.g. clicking on a button), and anonymous Reveal data
  • personalizing messaging across email, website, live chat, and more with Reveal data routed via Segment 

How Does it Work?

The Segment integration listens to the Segment page event. Clearbit then takes the IP address in the page event, adds the Reveal data, and then sends an Identify Event back to Segment enriched with company-level data, if we can match the IP address to a company.

Once the Reveal data has been added, Clearbit data will be available to any of the destinations you've configured for your Segment source. We will only send a Reveal Identify Event once every 24 hours for the unique combination of a given anonymous/User ID and IP address.

How Do I Set It Up?

đź“ť Please note: If you have already added the integration then skip steps 1-3.

  1. Find the Clearbit integration in your Segment account on the Catalog > Destinations page of your Segment Source (or you can add it to your Segment account from the integration's landing page).
    Ne6Lhu64.png
    đź“ť Please note: You can also get to the Clearbit Reveal page with this URL pattern: https://app.segment.com/{{ your project }}/destinations/catalog/clearbit-reveal
  2. Select the Segment project to which you want to apply Reveal.
  3. Enter your Secret Clearbit API key into the Settings page of the Clearbit Integration in Segment.
  4. Click Save Changes and Enable Integration.
    9JMsmM3s.png
  5. Verify that the integration is working correctly by checking the Debugger section of your Segment Source. If everything has been set up correctly, you should start seeing Clearbit data populate in the Identify events—click on the specific event you're interested in to see Clearbit traits. These traits will now be available to other Segment integrations in your account. Notice that all Clearbit traits are prefixed with clearbit_ to ensure they don't conflict with existing traits.
    DdUYvZc4.png

Troubleshooting

Are you sending events of the type 'Page'?

Clearbit Reveal uses the IP address in Segment’s Page Event. For the integration to function, make sure that in your Segment code, a Page Event is being sent. Here is a link to Segment’s documentation for more information on the Identify Call.
 

Is Clearbit Reveal enabled on the correct Segment source?

Because Clearbit Reveal only works with a Page Event, it’s likely that the Clearbit Reveal destination is enabled on the wrong Segment source. Make sure that your Segment source is an app to which you are actively sending page events, like a Javascript source (eg. a Website).
 
Are you using an EU-based Workspace and not receiving enriched events from Clearbit? 
Our Segment integration uses Segment's U.S. (Oregon) endpoint to send enriched data. This means that if your Segment Workspace is using a different data processing region, you will not see the enriched Identify Events in Segment. We recommend speaking with Segment's Support team to create workspaces in other regions. Â