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.

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

Import Enrichment Data

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

Integration Details

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

  1. Listen for users entering the selected audience.
  2. 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.
  3. 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 FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(adroll_emails)versium_adroll_emails_md5Adroll Emails - MD5 Hashed[]string
set(facebook_emails)versium_facebook_emails_sha256Facebook Emails - SHA256 Hashed[]string
set(facebook_firstname)versium_facebook_firstname_sha256Facebook First Name - SHA256 Hashed[]string
set(facebook_lastname)versium_facebook_lastname_sha256Facebook Last Name - SHA256 Hashed[]string
set(facebook_phone_numbers)versium_facebook_phone_sha256Facebook Phone Numbers - SHA256 Hashed[]string
set(generic_emails)versium_emails_sha256Versium Generic Emails - SHA256 Hashed[]string
set(google_country)versium_google_countryGoogle Country[]string
set(google_emails)versium_google_emails_sha256Google Emails - SHA256 Hashed[]string
set(google_firstname)versium_google_firstname_sha256Google First Name - SHA256 Hashed[]string
set(google_lastname)versium_google_lastname_sha256Google Last Name - SHA256 Hashed[]string
set(google_phone_numbers)versium_google_phone_sha256Google Phone Numbers - SHA256 Hashed[]string
set(google_zip)versium_google_zipGoogle Zip[]string
set(linkedin_apple_idfa)versium_linkedin_apple_idfaLinkedIn Apple IDFA[]string
set(linkedin_company)versium_linkedin_companyLinkedIn Company[]string
set(linkedin_country)versium_linkedin_countryLinkedIn Country[]string
set(linkedin_emails)versium_linkedin_emails_sha256LinkedIn Emails - SHA256 Hashed[]string
set(linkedin_firstname)versium_linkedin_firstnameLinkedIn First Name[]string
set(linkedin_google_id)versium_linkedin_gaidLinkedIn Google Advertising ID[]string
set(linkedin_jobtitle)versium_linkedin_jobtitleLinkedIn Job Title[]string
set(linkedin_lastname)versium_linkedin_lastnameLinkedIn Last Name[]string

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

Source FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(adroll_emails)versium_adroll_emails_md5Adroll Emails - MD5 Hashed[]string
set(facebook_emails)versium_facebook_emails_sha256Facebook Emails - SHA256 Hashed[]string
set(facebook_firstname)versium_facebook_firstname_sha256Facebook First Name - SHA256 Hashed[]string
set(facebook_lastname)versium_facebook_lastname_sha256Facebook Last Name - SHA256 Hashed[]string
set(facebook_phone_numbers)versium_facebook_phone_sha256Facebook Phone Numbers - SHA256 Hashed[]string
set(generic_emails)versium_emails_sha256Versium Generic Emails - SHA256 Hashed[]string
set(google_country)versium_google_countryGoogle Country[]string
set(google_emails)versium_google_emails_sha256Google Emails - SHA256 Hashed[]string
set(google_firstname)versium_google_firstname_sha256Google First Name - SHA256 Hashed[]string
set(google_lastname)versium_google_lastname_sha256Google Last Name - SHA256 Hashed[]string
set(google_phone_numbers)versium_google_phone_sha256Google Phone Numbers - SHA256 Hashed[]string
set(google_zip)versium_google_zipGoogle Zip[]string
set(linkedin_apple_idfa)versium_linkedin_apple_idfaLinkedIn Apple IDFA[]string
set(linkedin_company)versium_linkedin_companyLinkedIn Company[]string
set(linkedin_country)versium_linkedin_countryLinkedIn Country[]string
set(linkedin_emails)versium_linkedin_emails_sha256LinkedIn Emails - SHA256 Hashed[]string
set(linkedin_firstname)versium_linkedin_firstnameLinkedIn First Name[]string
set(linkedin_google_id)versium_linkedin_gaidLinkedIn Google Advertising ID[]string
set(linkedin_jobtitle)versium_linkedin_jobtitleLinkedIn Job Title[]string
set(linkedin_lastname)versium_linkedin_lastnameLinkedIn Last Name[]string

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

Source FieldLytics User FieldDescriptionType
businessversium_company_nameCompany Namestring
business_addressversium_company_addressCompany Addressstring
business_cityversium_company_cityCompany Citystring
business_countryversium_company_countryCompany Countrystring
business_phoneversium_company_phoneCompany Phone Numberstring
business_public_or_privateversium_company_public_privateCompany Public/Privatestring
business_stateversium_company_stateCompany Statestring
business_zipversium_company_zipCompany Zipstring
domainversium_company_domainCompany Domainstring
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
industryversium_company_industryCompany Industrystring
number_of_employeesversium_company_num_employeesCompany Number of Employeesstring
sales_volumeversium_company_sales_volumeCompany Sales Volumestring
websiteversium_company_websiteCompany Websitestring

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

Source FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(address)versium_postal_addressesVersium Postal Addresses[]string
set(city)versium_citiesVersium Cities[]string
set(country)versium_countriesVersium Countries[]string
set(email_address)versium_emailsVersium Emails[]string
set(first_name)versium_first_namesVersium First Names[]string
set(last_name)versium_last_namesVersium Last Names[]string
set(mobile_phone)versium_mobile_phone_numbersVersium Mobile Phone Numbers[]string
set(phone)versium_phone_numbersVersium Phone Numbers[]string
set(state)versium_statesVersium States[]string
set(zip)versium_zipcodesVersium Zip Codes[]string

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

Source FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(age_range)versium_age_rangeVersium Age Range[]string
set(education_level)versium_education_levelVersium Education Level[]string
set(gender)versium_genderVersium Gender[]string
set(language)versium_languageVersium Language[]string
set(occupation)versium_occupationVersium Occupation[]string

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

Source FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(business)versium_businessesVersium Company Names[]string
set(city)versium_citiesVersium Cities[]string
set(domain)versium_domainsVersium Domains[]string
set(email_address)versium_emailsVersium Emails[]string
set(first_name)versium_first_namesVersium First Names[]string
set(industry)versium_industriesVersium Industry[]string
set(last_name)versium_last_namesVersium Last Names[]string
set(naics)versium_naicsVersium NAICS Codes[]string
set(number_of_employees)versium_num_employeesVersium Number of Employees[]string
set(postal_address)versium_postal_addressesVersium Postal Addresses[]string
set(sales_volume)versium_sales_volumeVersium Sales Volume[]string
set(sic)versium_sicVersium SIC Codes[]string
set(state)versium_statesVersium States[]string
set(title)versium_titlesVersium Titles[]string
set(year_founded)versium_year_foundedVersium Year Founded[]string
set(zip)versium_zipcodesVersium Zip Codes[]string

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

Source FieldLytics User FieldDescriptionType
email(email)email unique idEmailstring
epochms()versium_enriched_tsVersium Enriched Timestampdate
set(company_address_1)versium_company_addressesVersium Company Addresses[]string
set(company_city_1)versium_company_citiesVersium Company Cities[]string
set(company_country_1)versium_company_countriesVersium Company Countries[]string
set(company_name_1)versium_businessesVersium Company Names[]string
set(company_state_1)versium_company_statesVersium Company States[]string
set(company_zip_1)versium_company_zipcodesVersium Company Zip Codes[]string
set(domain_1)versium_company_domainsVersium Company Domains[]string
set(industry_1)versium_industriesVersium Industry[]string
set(ip_usage_type)versium_ip_usage_typeVersium IP Usage Type[]string
set(naics_1)versium_naicsVersium NAICS Codes[]string
set(phone_1)versium_company_phone_numbersVersium Company Phone Numbers[]string
set(sic_1)versium_sicVersium SIC Codes[]string
set(website_home_page_1)versium_company_websitesVersium Company Websites[]string
set(year_founded_1)versium_year_foundedVersium 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.

  1. Select Versium from the list of providers.
  2. Select the Enrich Users job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to enrich.
  7. Complete the configuration steps for your job.
    versium configuration
  8. From the Email Field input, select the field name that contains the user's email.
  9. 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.
  10. (Optional) Select the Enrich Existing Users checkbox to enrich users who already exist in the selected audience.
  11. (Optional) Toggle Show Advanced Options.
  12. (Optional) From the First Name Field input, select the field name that contains the user's first name.
  13. (Optional) From the Last Name Field input, select the field name that contains the user's last name.
  14. (Optional) From the Full Name Field input, select the field name that contains the user's full name.
  15. (Optional) From the User Phone Number Field input, select the field name that contains the user's phone number.
  16. (Optional) From the User Address Field input, select the field name that contains the user's address.
  17. (Optional) From the User City Field input, select the field name that contains the user's city.
  18. (Optional) From the User State Field input, select the field name that contains the user's state.
  19. (Optional) From the User Zip Field input, select the field name that contains the user's zip code.
  20. (Optional) From the Domain Field input, select the field name that contains the user's company domain.
  21. (Optional) From the Company Name Field input, select the field name that contains the user's company name.
  22. (Optional) From the Company Phone Field input, select the field name that contains the user's company phone number.
  23. (Optional) From the Company Address Field input, select the field name that contains the user's company address.
  24. (Optional) From the Company City Field input, select the field name that contains the user's company city.
  25. (Optional) From the Company State Field input, select the field name that contains the user's company state.
  26. (Optional) From the Company Zip Field input, select the field name that contains the user's company zip.
  27. (optional) From the IP Address input, select the field name that contains the user's IP address.
  28. Click Start Enrich.