Help Center / Personalization / Data connectors / Albacross

Albacross data connector

Overview

NOTE: You need a valid Albacross account to set up Albacross as a data connector.

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 the 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 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.

Set up Albacross

To set up Albacross, you have to install the Albacross API key in the Ninetailed legacy app dashboard:

  1. Log in to the Ninetailed legacy app.

  2. Navigate to the "Data Sources" tab.

    Contentful Personalization: Data Sources tab

  3. Under Albacross, click Connect. The Albacross details page is displayed.

    Contentful Personalization: Albacross

  4. Click Open Albacross to retrieve your API key, and enter it in the Albacross Api Key field.

  5. Click Save API.

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.

financial_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.

Albacross audience

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.

Albacross Merge tags