Albacross integration
Overview
Albacross uses reverse IP tracking technology, which allows you to identify the companies that visit a website based on their IP addresses. It then provides detailed information about those companies, including company name, industry, location, website, and contact information for key decision-makers. You can make use of Albacross by automatically enhancing visitor profiles with additional organizational data when Ninetailed events are performed.
When active, the Albacross integration looks up the IPv4 address of any event sent to Ninetailed's Experience API event using the Albacross Reveal API. If the Reveal API identifies an IP address, additional traits about the user and their organization are be added to the visitor's profile. These traits can then be used to create Audiences or as variables for Merge Tags.
If no IP match is found, no new traits are added.
Installation
@ninetailed
scope (Ninetailed SDKs, Ninetailed Plugins, and Ninetailed Utility Libraries).
To install Albacross, you have to install the Albacross API key in the Ninetailed Dashboard:
- Log in to the Ninetailed app.
- Open the Customer Data section, and click Albacross.
- Save your Albacross API key.
Available traits
The following traits are added within the traits.albacross
object when an IP address match is found. These values are also detailed in the Albacross Reveal API documentation.
Property | Description |
---|---|
address.city |
string : The city of the company, all lowercase |
address.state |
string : The state or region of the company, all lowercase |
country |
string : The two letter country code of the organization, e.g. US |
description |
string : A meta description of the organization, typically a sentence long |
employees.from |
number : A lower bound of the number of employees of the organization |
employees.to |
number : An upper bound of the number of employees of the organization |
financial_report.from |
number : A lower bound of the number of employees of the organization |
finacial_report.to |
number : An upper bound of the annual revenue of the organization |
financial_report.currency |
string : The currency in which financial_report.from and financial_report.to are reported |
founded_year |
number : The year the company was founded |
linkedin_industry_code.code |
string : The LinkedIn industry code to which the company belongs |
linkedin_industry_code.category |
string : The associated human-readable name of the LinkedIn industry to which the company belongs |
linkedin_url |
string : The url of the company's page on LinkedIn |
name |
string : The name of the company |
url |
string : The canonical URL of the company's website |
Use
You can access a nested trait value by using the dot .
notation when creating Audiences. When targeting Albacross' trait values for Audience rules or merge tags be sure to prefix the trait name from the table above.
Create Audiences with Albacross
To use any trait values from Albacross for building an Audience rule, use albacross
as a prefix.
Example:
To leverage the trait value employees.from
if it is available, use albacross.employees.from
as a key.
Create Merge Tags with Albacross
If you want to display any trait values from Albacross as a Merge Tag, use traits.albacross
as a prefix.
Example:
To leverage the trait value linkedin_industry_code.category
as a Merge Tag, use traits.albacross.linkedin_industry_code.category
as Merge Tag ID.