Overview

FullContact is an enrichment service that can add key demographic information to your known audiences, including user interests, age, and location. By utilizing common online identifiers (e.g. email, Twitter handle), FullContact provides profile enrichments allowing you to create more refined and effective audiences.

Use this integration to combine FullContact user profiles with behavioral user data and content affinities powered by data science on Lytics. Building rich, 360 degree views of your customers is an essential step in building truly personalized marketing campaigns.

The FullContact integration supports one job type for enriching audiences, but you can choose the identifying field to enrich the user based off of email address, phone number, or Twitter handle.

Authorization

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

To authorize a FullContact workflow, you must provide a FullContact API key so Lytics can communicate with FullContact's APIs. For instructions on how to create an API key, refer to FullContact's API key documentation.

📘
FullContact will only give your API key once. If it is lost you will have to generate a new one.

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

Select FullContact from the list of providers.
Select the FullContact 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 text box, enter your API Key credential.
Click Save Authorization.

Enrich Audiences

The FullContact enrich audiences job provides additional demographic and social data for enriching user profiles. This can be done across all profiles or for specific audiences, which is often referred to as "selective" enrichment.

Integration Details

Implementation Type: Server-side Integration.
Implementation Technique: REST API Integration with Audience Trigger Integration.
Frequency: Real-time Integration, with an optional one-time Backfill of the audience after setup.
Resulting Data: New, enriched User Fields on existing User Profiles.

This integration utilizes the FullContact API to retrieve user profile data. Each run of the job will proceed as follows:

User enters an audience causing a trigger event.
User is sent to FullContact for enrichment using email address, phone number, or Twitter user ID as the primary lookup ID depending on the selection of the user.
User profile is enriched with data from FullContact and new data is ingested into the fullcontact_users data stream.

Fields

The following fields are included in the default mapping for the fullcontact_users stream.

Source Field	Conditional	Lytics User Field	Description	Type
age		age	Age Range	int
age_range		age_range	Age Range	string
confidence		fc_confidence	FC Confidence	string
email(email)		email `unique id`	Email Address	string
emails.Hash.MD5	IF ( EXISTS emails.Hash.MD5 )	email_hash_md5	Hashed Email Address (MD5)	string
emails.Hash.SHA256	IF ( EXISTS emails.Hash.SHA256 )	email_hash_sha256	Hashed Email Address (SHA 256)	string
facebook_photo		fb_photo	Facebook Photo	string
facebook_username		fb_username	Facebook Username	string
family_name		last_name	Last Name	string
full_name		name	Name	string
gender		gender	Gender	string
given_name		first_name	First Name	string
interests		fc_interests	FC Interests	string
location		location	Location	string
twitter_photo		tw_photo	Twitter Photo	string
twitter_username		tw_uid `unique id`	Twitter User ID	string

Configuration

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

Select FullContact from the list of providers.
Select one of the Import Enrichment Data job types. There are three options: Email, Phone, and Twitter. Select whichever you would like to use as the primary identifier of your users to enrich.
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.
Based on the job type you selected:
- In the Email Field dropdown, select the Lytics user field containing the user's email address.
- In the Phone Field dropdown, select the Lytics user field containing the user's phone number.
- In the Twitter Field dropdown, select the Lytics user field containing the user's Twitter ID.
(Optional) Select the Enrich Existing Users checkbox, to enrich existing users in the audience. Without this option selected, only users who enter the audience after the job is started will be enriched.
Click Start Job.

FullContact