FullContact

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.

  1. Select FullContact from the list of providers.
  2. Select the FullContact 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 text box, enter your API Key credential.
  6. Click Save Authorization.
    Screenshot from 2019-05-24 17-20-59

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:

  1. User enters an audience causing a trigger event.
  2. 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.
  3. 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 FieldConditionalLytics User FieldDescriptionType
ageageAge Rangeint
age_rangeage_rangeAge Rangestring
confidencefc_confidenceFC Confidencestring
email(email)email unique idEmail Addressstring
emails.Hash.MD5IF ( EXISTS emails.Hash.MD5 )email_hash_md5Hashed Email Address (MD5)string
emails.Hash.SHA256IF ( EXISTS emails.Hash.SHA256 )email_hash_sha256Hashed Email Address (SHA 256)string
facebook_photofb_photoFacebook Photostring
facebook_usernamefb_usernameFacebook Usernamestring
family_namelast_nameLast Namestring
full_namenameNamestring
gendergenderGenderstring
given_namefirst_nameFirst Namestring
interestsfc_interestsFC Interestsstring
locationlocationLocationstring
twitter_phototw_photoTwitter Photostring
twitter_usernametw_uid unique idTwitter User IDstring

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.

  1. Select FullContact from the list of providers.
  2. 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.
  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.
  8. 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.
  9. (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.
  10. Click Start Job.

FullContact