Overview

Wistia is a video-hosting platform for businesses. Wistia provides advanced analytics such as heatmaps, engagement graphs, and A/B testing, as well as lead generation tools inline annotations including email capture and marketing CTAs to engage and convert customers during their video experience.

Importing Wistia video activity will enrich Lytics user profiles with video viewing behavior and conversion data. This data can inform targeting for your cross-channel marketing Experiences with Lytics Journey Canvas or stand-alone ads, email, web, or mobile campaigns.

Authorization

If you haven't already done so, you will need to setup a Wistia account before you begin the process described below. To access your Wistia data, you'll need to get an API token from Wistia. Follow the directions in the Wistia Data API docs to create a new API token for Lytics to use.

Note: You will need to select both Read all project and video data and Read detailed stats permissions for the key.

wistia key

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

Select Wistia from the list of providers.
Select the Wistia method for authorization.
Enter a Label to identify your authorization.
(Optional) Enter a Description for further context on your authorization.
Enter your API Token.
Click Save Authorization.

wisita authorization config

Import Activity

Import Wistia video activity to add video viewing behavior data to your user profiles in Lytics. Once imported, this data enables you to target users based on their video viewing habits in your multi-channel marketing experiences orchestrated by Lytics.

Integration Details

Implementation Type: Server-side Integration
Implementation Technique: REST API Integration
Frequency: Hourly Batch Integration.
Resulting data: New User Profiles for Wistia users not already tracked in Lytics. Or new User Fields containing video activity data for users profiles that already exist in Lytics.

This integration utilizes the Wistia Stats API to retrieve event data:

Request activity data from the last hour.
Calculate the time viewed for viewing session.
Ingest the data in the Lytics data stream wistia_activity.

Fields

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

Source Field	Lytics User Field	Description	Type
country	wistia_country	Wistia Last Viewed Country	string
region	wistia_state	Wistia Last Viewed State	string
duration_viewed	wistia_duration_viewed	Wistia Last Viewed Duration	number
media_name	wistia_media_names	Wistia Viewed Media Names	[]string
conversion.last_name	last_name	Last Name	string
city	wistia_city	Wistia Last Viewed City	string
media_id, percent_viewed	wisita_media_percent	Wisita Viewed Media Percent	map[string]number
conversion.first_name	first_name	First Name	string
org	wistia_org	Wistia Last Viewed Org	string
percent_viewed	wistia_percent_viewed	Wistia Last Viewed Percent	number
media_id	wisita_media_ids	Wistia Viewed Media IDs	[]string
media_id, duration_viewed	wistia_media_duation	Wistia Viewed Media Duration	map[string]number
visitor_key	wistia_visitor_key `unique id`	Wistia Visitor Key	string
conversion_data.email	email `unique id`	Email Address	string

Configuration

Follow these steps to set up an import job for Wistia. If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

Select Wistia from the list of providers.
Select the Import Activity Data 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.
(Optional) Enter the Start Date to start importing Wistia activity data from this date. Please use the format yyyy-mm-dd (e.g. 2021-01-25). If left empty, only new viewing activity will be pulled in.
(Optional) Enter the End Date to stop importing Wistia activity data from this date. Please use the format yyyy-mm-dd (e.g. 2021-12-19). If left empty, only new viewing activity will be imported from the current date.
Select Keep Updated to continually pull in activity data. This will take priority over the 'End Date' configuration.
Click Start Import.

wistia import