Setting up the Wistia - HubSpot Integration

Connect Wistia & HubSpot to supercharge your video marketing. With our powers combined... well, you won't be Captain Planet, but you'll be ready to get those sweet, sweet leads and video data into HubSpot for automation.

Haven’t signed up for the integration yet?

Get in touch!

HubSpot is a marketing platform designed to help increase leads and drive better engagement. They are the masters of inbound marketing … heck, they invented it!

This article is all about configuring the Wistia - HubSpot integration for collecting leads and sending video viewing data into contact records. If you’re generally curious about what this integration can do, here’s an overview of the HubSpot integration’s features.

Now let’s get to setting up the integration!

Set up the Hubspot Integration

Tip
Before you get started, you’ll need to be an Account Owner in Wistia, on a plan with the HubSpot integration enabled.

Let’s start with a brief overview. There are 3 key steps to getting fully integrated:

  1. Connect the integration in your Wistia account. This allows us to request your lists and forms, and send leads and viewing data into HubSpot.
  2. Set up a Turnstile or add a HubSpot form to your videos. This is how we identify viewers for proper tracking.
  3. Embed your video on a page with a HubSpot tracking script. The Wistia player and HubSpot script work together to identify viewers and track their activity for display on HubSpot contact records.

The first step is usually a one-time thing, and thereafter you’ll only need to repeat steps 2 and 3 for each video you want to use for tracking.

Connect the HubSpot Integration in Wistia

Head on over to the integrations page within your Wistia account settings: Account > Settings > Integrations

Scroll down to the Marketing Automation Integrations section, and click on HubSpot v2 (with custom forms).

HubSpot V2 connector

When you click Connect, you’ll be prompted to log into HubSpot. Once you log in and authorize the integration, it will show as ✔ Connected and ✔ Primary. Only one integration can be set as Primary, indicating HubSpot as the active integration on your account.

HubSpot Connected and Primary

It’s that easy! This will authorize Wistia to request your HubSpot lists and forms for display within videos. Wistia will also be able to create and update contact records to send leads and viewing data into your HubSpot account. Note that HubSpot does not send leads into Wistia, so the next step will help us identify viewers.

Add a Turnstile to your video

With the HubSpot integration connected, we’re one step closer to enriching our leads with video viewing data for advanced automation. Now we need a method of identifying new and known leads.

The first option is the Wistia Turnstile, which will collect lead information in your Wistia stats and send those leads directly to HubSpot.

  • From the Video Actions > Customize panel, enable Turnstile and set it to the desired time in your video.
  • Select a HubSpot list for the Turnstile to send collected leads. A list must be selected for turnstile entries to display within HubSpot. Only Static Lists are available for Turnstile submissions.

HubSpot list turnstile

With a Turnstile added to the video and connected to a HubSpot list, you can move on to the final step; embed the video on a page with your HubSpot tracking code to start collecting leads!

Tip
Wistia and HubSpot rely on browser cookies 🍪 for tracking data and identifying leads. HubSpot does not send lead data to Wistia, so the cookie in a viewer’s browser is how known leads are recognized. Using a Turnstile or HubSpot form is not always required for tracking known leads, however cookies do not carry over between browsers or devices. Turnstiles and forms help to bridge the gap.

If you’d prefer to use a HubSpot form instead of a Turnstile, the following section has everything you need to know.

Add a HubSpot Form to your Video

Looking for more flexibility around form fields? Our HubSpot v2 integration has the option to embed HubSpot forms within your Wistia videos. Just like Turnstile, form submissions within a video will serve to identify your viewers so they can be tracked properly by the integration.

Using a HubSpot form in a Wistia video provides more control over the form fields and appearance, just like a normal HubSpot form. You can even employ custom styling from within the HubSpot forms editor! The only drawback to a HubSpot form compared to Turnstile is that the data will only be sent to HubSpot, and the leads will not show up within Wistia stats.

HubSpot v2 form example

Once the integration is enabled, a HubSpot Forms section will appear in the Customize panel. From there, you can choose which form to display in your video, when to display it, and add helpful prompt text to encourage viewers to complete your form. Here’s what that looks like:

HubSpot v2 edit form text

Tip
HubSpot forms don’t always have to be in the video for tracking to work. A viewer can still be identified by a HubSpot form on the webpage, or even on a different page — as long as the viewer submits to a form within the same device & browser they use to watch your video. It’s all about setting that HubSpot cookie 🍪 in the browser, which happens on form submission. Having the form inside the video just makes this process a little more reliable, especially if the form is used to gate the video content.

Whether you’ve chosen to use HubSpot forms or Turnstile to identify your audience, you’re now ready for the final step — embedding your video for tracking!

Embedding with a HubSpot Tracking Script

The real magic of this integration involves the Wistia player and the HubSpot tracking script working together. First you’ll need a webpage set up with your HubSpot tracking script. Embed your video on that page and you are good to go.

Our friends at HubSpot have some great documentation on finding your HubSpot tracking script and then installing it on your website.

If you’re embedding on a HubSpot landing page or a HubSpot COS page, that script should be installed for you automatically. Wistia media pages (in your account) don’t have the HubSpot tracking code on them. This is why you need to embed your videos out in the wild in order to start pulling data into HubSpot.

Once the page is set up with your HubSpot script, you can embed your video. We recommend going with the inline, Standard embed, or its cousin, the Popover.

Viewing Data in Contact Timelines

The real heart of this integration is getting video viewing data to show up in contact timelines. The Wistia - HubSpot integration uses HubSpot’s powerful Timeline API to pass over data collected from your embedded videos. Once you have this integration set up and the videos embedded for tracking, we’ll send the following events for every identified viewer who plays the video on your page:

  • Engagement milestones: Played 1% (clicked play), 25%, 50%, 75%, and 100%.
  • Links clicked in videos
  • Turnstile or HubSpot forms submitted

HubSpot segmenting viewing behavior

The “Played X%” events are milestones, so they only update at the intervals listed above. This means that if you see someone with a “Played 1%” event, they clicked play and watched between 1% and 24% of the video (at 25%, it would update to the next milestone). For a more detailed look at their viewing data, you can actually access the Heatmap of their session within the HubSpot timeline.

Heatmaps in the timeline

One of the coolest things about this integration is that you’ll see video heatmaps in your contacts' timelines. Click View Video and Heatmap to display them:

Heatmaps in HubSpot contact timeline

This adds some extra detail to your available metrics, showing the exact percentage of the video that was watched, which portions may have been re-watched, and even a preview of the video itself. While the Heatmaps are not directly used for automation, they provide an in-depth look at the viewing behavior of individual contacts.

Segmenting lists, Automation, and Wistia Hubspot v2 Filters

The Wistia events sent to HubSpot can be used for segmenting lists and building automations. For example, you could set up an “Active list” to only show contacts who have watched 75% of a video, indicating their interest in your content. Or you could include a Call-to-Action on your video, and target viewers who convert on that link.

HubSpot refers to these events as filters for your Active lists, and they are applied at multiple levels.

Alert
The events sent to HubSpot from Wistia contain more categories of data than are typically used for automation. HubSpot displays all of these categories in their list of filters or properties. Some filters are more useful than others, which we will clarify below.

Top-Level Wistia Hubspot v2 Filters

First we’ll select a broad, event-based filter around which to build the automation. They are each labelled with Wistia Hubspot V2:

  • Annotation Click
  • Call to Action Click
  • Play
  • Turnstile
  • Viewer identified [unused]

Annotation, Call to Action, and Turnstile filters are all based around fairly specific actions; clicking an Annotation Link, converting on a CTA, or submitting to a Turnstile. The Play filter is the most versatile, as it opens up choices for segmentation based on how much viewing engagement has happened, utilizing the “Played X%” events.

Secondary Wistia Hubspot v2 Filters

Once you’ve chosen the top-level event to focus on, you can configure your automation with more specific filters. There are a wide array of secondary filters to use because HubSpot displays all available Wistia properties. However some are more practical than others:

  • Media ID - The ten-character, alphanumeric ID of the media within Wistia. For example, the Media ID of https://happiness.wistia.com/medias/4kmqltm95j would be 4kmqltm95j. This is the best way to target viewing activity around specific videos.
  • Media Name - The name of the media within Wistia. Keep in mind this is a less reliable option since media names can be changed at any time, and in many cases using Media ID would be preferable.
  • Media URL - The URL where the video is embedded alongside your Hubspot tracking code. Useful for separating activity from specific landing pages or posts.
  • Occurred - Simply put, “this event happened.” It is then further constrained by a date or date range, for example “is before” or “is after” 11/5/2016. Use this for segmenting contacts based on a specific time period.
  • Percent Watched - Used for segmenting based on the “Played x%” events. For example, Percent Watched → is greater than or equal to → 50% would segment contacts who have watched at least 50% of your videos.
Pro-Tip
It’s possible to use multiple filters in tandem for very specific segmentation. For example, you can use Media ID to focus on a specific video, and then also filter by Percent Watched to get all contacts who have Played X% of a specific media.

Some cool things you can do with this:

  • Find everyone who loaded a particular video but didn’t play it and send that video out to them in an email.
  • Nudge viewers who’ve only watched 25% of a video.
  • Know who your most engaged viewers are.
  • Follow up with users who clicked on annotation links and Calls to Action.

Unused filters

These filters are included with the data we send to Hubspot, however they are largely irrelevant for automation as they are specific to data on the Wistia side:

  • Viewing Session ID
  • Hook ID
  • Event UUID

Migrating from HubSpot v1

If you’re looking for help with the first version of the Wistia - HubSpot integration, head on over to the HubSpot v1 page. We also have a section all about migrating from Hubspot v1 to Hubspot v2 when you’re ready to make the switch.

HubSpot FAQ & Troubleshooting

Do I need a Turnstile or Form on every video?

The short answer is no, you don’t need a Turnstile or form on every video, but it does make the integration a lot more reliable.

As explained in the Turnstile section “tip”, this tracking relies heavily on cookies being set in a viewer’s browser, and those cookies being present any time someone watches your video. These cookies are set upon form submission, so having forms in and around your videos is the best way to ensure that leads are being tracked as expected.

Since cookies don’t carry over between browsers/devices, this creates the possibility for tracking loopholes. For example:

Alyssa, using her work computer, submits to a HubSpot form on one of your landing pages. She then watches a video on a different page set up for integration tracking. By the time she leaves your site, Alyssa has a contact record in HubSpot with her lead data, and you can see her viewing data within the activity feed.

Later that evening, Alyssa is home from work and decides to watch more of your video content. She uses her smart tablet which is her preferred device for personal use. Alyssa, on this different device, goes straight to the video content without completing a form, and watches several videos. This data does not show up in the contact record because this new device does not have a tracking cookie to identify Alyssa as a known lead.

Think of it this way: a Turnstile or Form isn’t always required, but any opportunity for someone to skip or ignore your Turnstile/Form is a possibility that their data may not be passed into HubSpot.

Viewing Data not Showing Up in Contact Records?

The HubSpot integration has a few moving pieces that have to come together for tracking to work as expected. Here is a checklist of things to look out for when the data isn’t showing up:

Double-check all 3 Setup Steps

To be on the safe side, make sure you’ve followed all 3 key setup steps. Each of these steps has an important function for integration tracking. In particular having some kind of Turnstile/form involved for identification, and embedding your video on a page with the HubSpot script are the steps most often overlooked.

Verify that HubSpot is set as the Primary integration

Under Account -> Settings -> Integrations, make sure HubSpot is set to Primary. Only the Primary integration will receive data from Wistia. To fix this, click on the integration to expand its options, and select Make Primary.

HubSpot Make Primary Button

Check the filters in your contact’s Activity Feed

In order to see Wistia events/data, you need to enable the “Wistia HubSpot v2” filter, under Integrations.

HubSpot Activity Filters

Make sure E-v1.js is on the page

E-v1.js is the Wistia javascript library — it essentially is the player, and it controls all the Wistia functionality on your page. Certain embeds, such as the Fallback/iframe embed, can still function for video playback without E-v1.js on the page. However E-v1.js must live on the webpage, just like your HubSpot tracking code, for this integration to work.

If you are using an iframe embed on your page, it’s possible that your CMS has removed the E-v1 script from the embed. E-v1 is the Wistia JavaScript file, and is essential for data transfer. The E-v1 script is after the <iframe> element of the embed and looks like this:

<script src="//fast.wistia.net/assets/external/E-v1.js" async></script>

If there isn’t an instance of E-v1 outside of the iframe, the Wistia and HubSpot scripts will not be able to get the correct information from each other.

The good news is that this is easy to fix by adding the E-v1 script to your page. We recommend adding it to the <head> element of your page. Feel free to copy the example above and paste that right into your page.

Alert
At this time, iframe playlists are not able to work with MAP integrations, including HubSpot. Adding E-v1 outside of an iframe playlists will not solve this issue if you’re using an iframe playlist embed. You can read more about this on our playlist page.

Reach Out to Support

Still stuck? We’re here to help! Send an email to support@wistia.com or use the contact form to reach out. We’re happy to work with you on ironing out the wrinkles.