Documentation / Product / Integrations / Wistia

Wistia: 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 habbits in your multi-channel marketing experiences orchestrated by Lytics.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST API.
  • Frequency: Hourly batch.
  • 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:

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


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

Source FieldLytics User FieldDescriptionType
countrywistia_countryWistia Last Viewed Countrystring
regionwistia_stateWistia Last Viewed Statestring
duration_viewedwistia_duration_viewedWistia Last Viewed Durationnumber
media_namewistia_media_namesWistia Viewed Media Names[]string
conversion.last_namelast_nameLast Namestring
citywistia_cityWistia Last Viewed Citystring
media_id, percent_viewedwisita_media_percentWisita Viewed Media Percentmap[string]number
conversion.first_namefirst_nameFirst Namestring
orgwistia_orgWistia Last Viewed Orgstring
percent_viewedwistia_percent_viewedWistia Last Viewed Percentnumber
media_idwisita_media_idsWistia Viewed Media IDs[]string
media_id, duration_viewedwistia_media_duationWistia Viewed Media Durationmap[string]number
visitor_keywistia_visitor_key unique idWistia Visitor Keystring
conversion_data.emailemail unique idEmail Addressstring


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

  1. Select Wistia from the list of providers.
  2. Select the Import Activity Data 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. (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.
  7. (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.
  8. Select Keep Updated to continually pull in activity data. This will take priority over the 'End Date' configuration.
  9. Click Start Import.

wistia import