Overview
Clearbit Reveal enables you to easily identify your anonymous visitors on your website so you can serve more targeted content and close more named accounts. Clearbit Reveal returns full company firmographics details and integrates seamlessly with Web Personalization Personas. With Clearbit, you'll be able to further personalize your website experience such as:
-
Target custom experience for named accounts
-
Personalize content based on firmographics data such as industry, company size, etc.
-
Show offers only to visitors who match specific criteria
Requirements
-
You must have an active Clearbit Reveal account
-
Your Custom Web Personalization Code must be installed on your website
-
Your Web Personalization account must be "Live"
Integration Setup
1. Insert the following snippet either via your tag manager or directly on your website. The snippet should ideally load as early as possible, and before your existing Web Personalization tag.
NOTE: You must update the CUSTOMER_API_TOKEN value with an active Clearbit publishable key (starts with a pk_).
<!-- BEGIN Clearbit SiteAdapt Integration snippet -->
<script>
(function() {
function verifySessionStorage() {
try {
var t = "__ss_test__";
window.sessionStorage.setItem(t, t);
window.sessionStorage.removeItem(t);
return true;
} catch (e) {
return false;
}
}
var clearbit_data = null;
var isSessionStorageAvailable = verifySessionStorage();
if (isSessionStorageAvailable) {
clearbit_data = window.sessionStorage.getItem("custom_vars_data");
}
if (isSessionStorageAvailable && clearbit_data === null) {
// Replace CUSTOMER_API_KEY with Clearbit publishable API key
var url = "https://reveal.clearbit.com/v1/companies/reveal?authorization=CUSTOMER_API_KEY";
var xhr = new XMLHttpRequest();
xhr.open('GET', url, true);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.responseType = 'json';
xhr.onload = function() {
if (xhr.readyState == xhr.DONE) {
if (xhr.status === 200) {
var custom_vars = {};
var response = xhr.response;
if(response.company){
custom_vars.name = response.company.name;
custom_vars.domain = response.domain;
custom_vars.city = response.geoIP.city;
custom_vars.state = response.geoIP.state;
custom_vars.country = response.geoIP.country;
custom_vars.sector = response.company.category.sector;
custom_vars.industryGroup = response.company.category.industryGroup;
custom_vars.industry = response.company.category.industry;
custom_vars.subIndustry = response.company.category.subIndustry;
custom_vars.sicCode = response.company.category.sicCode;
custom_vars.naicsCode = response.company.category.naicsCode;
custom_vars.employees = response.company.metrics.employees;
custom_vars.employeesRange = response.company.metrics.employeesRange;
custom_vars.annualRevenue = response.company.metrics.annualRevenue;
custom_vars.confidenceScore = response.confidenceScore;
custom_vars.role = response.role;
custom_vars.senority = response.seniority;
}
window.sessionStorage.setItem("custom_vars_data", JSON.stringify(custom_vars));
}
else if (xhr.status !== 200) {
console.log("Error", err);
}
}
};
xhr.send();
}
})();
</script>
<!-- End Clearbit SiteAdapt Integration snippet -->
2. Go to the Web Personalization Studio and select the Personas option from the left nav:
3. Click the + button to create a new Persona.
4. Click the Settings icon next to Custom Variables.
5. A pop up window will appear where you can add the variable keys and values you’d like to define for your persona. Once complete, click the Save & Close button.
NOTE: The keys are defined using a "." notation. Please refer to example below.
Below is a sample of the returned company information from Clearbit. Please refer to the Clearbit Company Attributes page for a full list of attributes.
{
"ip": "184.191.152.104",
"domain": "acme.com",
"type": "company",
"fuzzy": true,
"company": {
"id": "cd401501-bd55-47eb-8ff8-bee9528b8eb2",
"name": "Acme",
"legalName": "Acme Inc",
"domain": "acme.com",
"domainAliases": [
"acme.co",
"acme.us"
],
"site": {
"phoneNumbers": [
"+1 805-391-4683"
],
"emailAddresses": [
"info@acme.com"
]
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software & Services",
"industry": "Internet Software & Services",
"subIndustry": "Internet Software & Services",
"sicCode": "73",
"naicsCode": "54"
},
"metrics": {
"alexaUsRank": 251610,
"alexaGlobalRank": 895018,
"employees": 10,
"employeesRange": "1-10",
"marketCap": null,
"raised": 2420000,
"annualRevenue": null,
"estimatedAnnualRevenue": "$1M-$10M",
"fiscalYearEnd": 12
},
"...": "..."
},
"geoIP": {
"city": "Goleta",
"state": "California",
"stateCode": "CA",
"country": "United States",
"countryCode": "US"
}
}
6. Once your variables have been added in the settings, close the pop up window and click on the word ‘Custom Variables’.
7. Select the variables you’d like to include/exclude in your Persona, then save the Persona so it can be used in your reaction.
8. Create your new reaction and include the persona you created. The reaction will now only appear for visitors matching your persona criteria.
Troubleshoot
Please contact Web Personalization Support via our online chat or email support@metadata.io if you require any assistance with your integration setup.
Comments
0 comments
Article is closed for comments.