Overview

Versium is a data technology company that offers an industry leading identity resolution and insights engine to help B2B and B2C marketers improve their effectiveness. Enrich your Lytics audiences with Versium REACH API data to improve your identity resolution and reach.

Authorization

If you haven't already done so, you will need to set up a Versium account before you begin the process described below.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

Select Versium from the list of providers.
Select the Versium API Key method for authorization.
In the Label text box, enter a name for the authorization
(Optional) In the Description text box, enter a description for this authorization
In the API Key password box, enter your API Key credential. See the Versium API documentation for information on creating API keys.
Click Save Authorization.

Import Enrichment Data

Enrich your Lytics audiences with Versium REACH API data to improve your identity resolution and reach.

Integration Details

Implementation Type: Server-side Integration
Implementation Technique: REST API Integration, Audience Trigger Integration
Frequency: Real-time Integration
Resulting data: Existing User Profiles are enriched with data from configured Versium enrichment APIs. The following enrichment APIs are available:

Once a Versium Enrichment Import is started, the job will:

Listen for users entering the selected audience.
When a user enters, the job will attempt to collected enrichment data for the user from Versium. Note: by default, enter events for users who have been enriched within the last 30 days will be ignored to limit API usage. Contact your account manager to adjust this configuration if necessary.
For each of the configured Versium enrichment tools, an enrichment call will be made to the Versium Reach APIs. For each enrichment tool, if a match is found, the job will emit fields to the relevant enrichment tool stream. One event per enrichment tool per user will be emitted.

Fields

The following fields are included in the default mapping of the versium_b2b_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(adroll_emails)	adroll_emails_md5	Adroll Emails - MD5 Hashed	[]string
set(facebook_emails)	facebook_emails_sha256	Facebook Emails - SHA256 Hashed	[]string
set(facebook_firstname)	facebook_firstname_sha256	Facebook First Name - SHA256 Hashed	[]string
set(facebook_lastname)	facebook_lastname_sha256	Facebook Last Name - SHA256 Hashed	[]string
set(facebook_phone_numbers)	facebook_phone_sha256	Facebook Phone Numbers - SHA256 Hashed	[]string
set(generic_emails)	versium_emails_sha256	Versium Generic Emails - SHA256 Hashed	[]string
set(google_country)	google_country	Google Country	[]string
set(google_emails)	google_emails_sha256	Google Emails - SHA256 Hashed	[]string
set(google_firstname)	google_firstname_sha256	Google First Name - SHA256 Hashed	[]string
set(google_lastname)	google_lastname_sha256	Google Last Name - SHA256 Hashed	[]string
set(google_phone_numbers)	google_phone_sha256	Google Phone Numbers - SHA256 Hashed	[]string
set(google_zip)	google_zip	Google Zip	[]string
set(linkedin_apple_idfa)	linkedin_apple_idfa	LinkedIn Apple IDFA	[]string
set(linkedin_company)	linkedin_company	LinkedIn Company	[]string
set(linkedin_country)	linkedin_country	LinkedIn Country	[]string
set(linkedin_emails)	linkedin_emails_sha256	LinkedIn Emails - SHA256 Hashed	[]string
set(linkedin_firstname)	linkedin_firstname	LinkedIn First Name	[]string
set(linkedin_google_id)	linkedin_gaid	LinkedIn Google Advertising ID	[]string
set(linkedin_jobtitle)	linkedin_jobtitle	LinkedIn Job Title	[]string
set(linkedin_lastname)	linkedin_lastname	LinkedIn Last Name	[]string

The following fields are included in the default mapping of the versium_b2c_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(adroll_emails)	adroll_emails_md5	Adroll Emails - MD5 Hashed	[]string
set(facebook_emails)	facebook_emails_sha256	Facebook Emails - SHA256 Hashed	[]string
set(facebook_firstname)	facebook_firstname_sha256	Facebook First Name - SHA256 Hashed	[]string
set(facebook_lastname)	facebook_lastname_sha256	Facebook Last Name - SHA256 Hashed	[]string
set(facebook_phone_numbers)	facebook_phone_sha256	Facebook Phone Numbers - SHA256 Hashed	[]string
set(generic_emails)	versium_emails_sha256	Versium Generic Emails - SHA256 Hashed	[]string
set(google_country)	google_country	Google Country	[]string
set(google_emails)	google_emails_sha256	Google Emails - SHA256 Hashed	[]string
set(google_firstname)	google_firstname_sha256	Google First Name - SHA256 Hashed	[]string
set(google_lastname)	google_lastname_sha256	Google Last Name - SHA256 Hashed	[]string
set(google_phone_numbers)	google_phone_sha256	Google Phone Numbers - SHA256 Hashed	[]string
set(google_zip)	google_zip	Google Zip	[]string
set(linkedin_apple_idfa)	linkedin_apple_idfa	LinkedIn Apple IDFA	[]string
set(linkedin_company)	linkedin_company	LinkedIn Company	[]string
set(linkedin_country)	linkedin_country	LinkedIn Country	[]string
set(linkedin_emails)	linkedin_emails_sha256	LinkedIn Emails - SHA256 Hashed	[]string
set(linkedin_firstname)	linkedin_firstname	LinkedIn First Name	[]string
set(linkedin_google_id)	linkedin_gaid	LinkedIn Google Advertising ID	[]string
set(linkedin_jobtitle)	linkedin_jobtitle	LinkedIn Job Title	[]string
set(linkedin_lastname)	linkedin_lastname	LinkedIn Last Name	[]string

The following fields are included in the default mapping of the versium_firmographic_enrichment stream:

Source Field	Lytics User Field	Description	Type
business	company_name	Company Name	string
business_address	company_address	Company Address	string
business_city	company_city	Company City	string
business_country	company_country	Company Country	string
business_phone	company_phone	Company Phone Number	string
business_public_or_private	company_public_private	Company Public/Private	string
business_state	company_state	Company State	string
business_zip	company_zip	Company Zip	string
domain	company_domain	Company Domain	string
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
industry	company_industry	Company Industry	string
number_of_employees	company_num_employees	Company Number of Employees	string
sales_volume	company_sales_volume	Company Sales Volume	string
website	company_website	Company Website	string

The following fields are included in the default mapping of the versium_contact_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(address)	versium_postal_addresses	Versium Postal Addresses	[]string
set(city)	versium_cities	Versium Cities	[]string
set(country)	versium_countries	Versium Countries	[]string
set(email_address)	versium_emails	Versium Emails	[]string
set(first_name)	versium_first_names	Versium First Names	[]string
set(last_name)	versium_last_names	Versium Last Names	[]string
set(mobile_phone)	versium_mobile_phone_numbers	Versium Mobile Phone Numbers	[]string
set(phone)	versium_phone_numbers	Versium Phone Numbers	[]string
set(state)	versium_states	Versium States	[]string
set(zip)	versium_zipcodes	Versium Zip Codes	[]string

The following fields are included in the default mapping of the versium_demographic_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(age_range)	versium_age_range	Versium Age Range	[]string
set(education_level)	versium_education_level	Versium Education Level	[]string
set(gender)	versium_gender	Versium Gender	[]string
set(language)	versium_language	Versium Language	[]string
set(occupation)	versium_occupation	Versium Occupation	[]string

The following fields are included in the default mapping of the versium_c2b_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(business)	versium_businesses	Versium Company Names	[]string
set(city)	versium_cities	Versium Cities	[]string
set(domain)	versium_domains	Versium Domains	[]string
set(email_address)	versium_emails	Versium Emails	[]string
set(first_name)	versium_first_names	Versium First Names	[]string
set(industry)	versium_industries	Versium Industry	[]string
set(last_name)	versium_last_names	Versium Last Names	[]string
set(naics)	versium_naics	Versium NAICS Codes	[]string
set(number_of_employees)	versium_num_employees	Versium Number of Employees	[]string
set(postal_address)	versium_postal_addresses	Versium Postal Addresses	[]string
set(sales_volume)	versium_sales_volume	Versium Sales Volume	[]string
set(sic)	versium_sic	Versium SIC Codes	[]string
set(state)	versium_states	Versium States	[]string
set(title)	versium_titles	Versium Titles	[]string
set(year_founded)	versium_year_founded	Versium Year Founded	[]string
set(zip)	versium_zipcodes	Versium Zip Codes	[]string

The following fields are included in the default mapping of the versium_ip_to_domain_enrichment stream:

Source Field	Lytics User Field	Description	Type
email(email)	email `unique id`	Email	string
epochms()	versium_enriched_ts	Versium Enriched Timestamp	date
set(company_address_1)	versium_company_addresses	Versium Company Addresses	[]string
set(company_city_1)	versium_company_cities	Versium Company Cities	[]string
set(company_country_1)	versium_company_countries	Versium Company Countries	[]string
set(company_name_1)	versium_businesses	Versium Company Names	[]string
set(company_state_1)	versium_company_states	Versium Company States	[]string
set(company_zip_1)	versium_company_zipcodes	Versium Company Zip Codes	[]string
set(domain_1)	versium_company_domains	Versium Company Domains	[]string
set(industry_1)	versium_industries	Versium Industry	[]string
set(ip_usage_type)	versium_ip_usage_type	Versium IP Usage Type	[]string
set(naics_1)	versium_naics	Versium NAICS Codes	[]string
set(phone_1)	versium_company_phone_numbers	Versium Company Phone Numbers	[]string
set(sic_1)	versium_sic	Versium SIC Codes	[]string
set(website_home_page_1)	versium_company_websites	Versium Company Websites	[]string
set(year_founded_1)	versium_year_founded	Versium Year Founded	[]string

Configuration

Follow these steps to set up and configure an enrich job for Versium in the Lytics platform. If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

Select Versium from the list of providers.
Select the Enrich Users job type from the list.
Select the Authorization you would like to use or create a new one.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Select the audience to enrich.
Complete the configuration steps for your job.
From the Email Field input, select the field name that contains the user's email.
From the Enrichment Tools selector, select the Versium Enrichment tools to use. Note that your Versium account will need access to all of the tools selected in order for the job to work.
(Optional) Select the Enrich Existing Users checkbox to enrich users who already exist in the selected audience.
(Optional) Toggle Show Advanced Options.
(Optional) From the First Name Field input, select the field name that contains the user's first name.
(Optional) From the Last Name Field input, select the field name that contains the user's last name.
(Optional) From the Full Name Field input, select the field name that contains the user's full name.
(Optional) From the User Phone Number Field input, select the field name that contains the user's phone number.
(Optional) From the User Address Field input, select the field name that contains the user's address.
(Optional) From the User City Field input, select the field name that contains the user's city.
(Optional) From the User State Field input, select the field name that contains the user's state.
(Optional) From the User Zip Field input, select the field name that contains the user's zip code.
(Optional) From the Domain Field input, select the field name that contains the user's company domain.
(Optional) From the Company Name Field input, select the field name that contains the user's company name.
(Optional) From the Company Phone Field input, select the field name that contains the user's company phone number.
(Optional) From the Company Address Field input, select the field name that contains the user's company address.
(Optional) From the Company City Field input, select the field name that contains the user's company city.
(Optional) From the Company State Field input, select the field name that contains the user's company state.
(Optional) From the Company Zip Field input, select the field name that contains the user's company zip.
(optional) From the IP Address input, select the field name that contains the user's IP address.
Click Start Enrich.