Wistia

to the tippy ↑

The Wistia-Marketo Integration

Wistia and Marketo go together like peanut butter and jelly -- like Sherlock and Watson, like Meredith and pugs! Want to get in on the fun? Here's our guide to getting the Wistia-Marketo integration working for you.

Haven't signed up for the integration yet?

Get in touch!

With the Wistia-Marketo integration you can:

  • Generate new leads with Turnstile
  • Automatically add leads to a Marketo List
  • Score leads based on video interaction
  • Pipe leads into Smart Lists based on viewing data
  • Send emails with integrated video links
  • Be a video marketing superstar

Get Set Up

Get on the plan

To get the Wistia-Marketo integration working, you'll need to be on a plan with marketing automation integrations enabled. Check out our plans page for more info!

Setting things up in Marketo and Wistia

To send leads from Turnstile into your Marketo account, there are three things you need to create in Marketo:

  • An API-Only User Role
  • An API-Only User (in other words, a robot user on your Marketo account with the aforementioned role 🤖)
  • A Custom Service

Fortunately, our friends at Marketo wrote some lovely documentation about how to complete each step:

Thanks, Marketo. 🙌

After you finish creating your Custom Service, click on View Details on your new service. Copy the Client Id and Client Secret into the Marketo integration area in your Wistia settings.

Next, go to Admin > Integration > Web Services > REST API in Marketo and copy/paste the URLs for Endpoint and Identity into Wistia as well.

Make sure you have all four:

  1. Client Id
  2. Client Secret
  3. REST API Endpoint
  4. REST API Identity

Have those four pieces on information filled in, clicked Connect, and see that the integration is connected? Well then congrats, you're all set up in Wistia! The last thing to do is set up your website.

Setting things up on your website

To track how people watch your videos and use that data to drive automation in Marketo, you first need to have a video embedded on your website. Here's how to do that.

Then just make sure Marketo's Munchkin tracking script is on the same page as your video, and that video viewing data will appear in Marketo automatically.

Note

If for one reason or another you're not set up after following the steps above, contact us and we'll help you out.

Want to learn how to put your fancy new Wistia-Marketo integration to work? The sections that follow contain the information you seek.

Migrating from Marketo v1

The first Wistia-Marketo integration was built on Marketo's SOAP API. We've updated the Marketo integration so it's instead built on Marketo's REST API, which offers a lot more functionality. If you're ready to upgrade the data flow between your Wistia account and your Marketo account, we've got the steps below to make that happen.

To migrate over to Marketo v2 you'll first need to disconnect your Marketo v1 integration. You can do this by visiting the integrations page of your Wistia account settings and selecting the Marketo (SOAP) integration: Account > Settings > Integrations. (Keep in mind, only the Account Owner can get into Account Settings.) You'll see an option to Disconnect in the bottom right corner of that menu.

Once you've disconnected your Marketo v1 integration, you can follow the normal steps for setting everything up to connect to the Marketo v2 integration. Make sure to select the version that asks for your Marketo REST API Endpoint (since that's the Marketo v2 integration).

Once finished, you'll be able to use the more advanced parts of the integration listed below, like sending data to specific lists with Turnstile, and setting up Marketo Forms right within your video.

Collect Leads with Marketo Forms

You can add forms created in your Marketo account to your Wistia videos. They'll act exactly the same as Marketo forms, except that they'll appear in your video like a Turnstile or CTA.

Once the integration is enabled, a Marketo 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:

Note

Make sure that your Marketo Forms settings are adjusted so that fields like Lead Source aren't updated on every form submission.

Collect Leads with Turnstile

Remember that time you configured Turnstile to connect to your Marketo account? Well now when people enter their names and email addresses (or just email addresses, if you'd prefer) into Turnstile, they'll automatically get passed from Wistia to Marketo as new leads with the lead source set to "Wistia Video: (name of the video here)". You can also optionally add all the leads collected from a specific video in your Wistia account to a static list in your Marketo account.

Alert

Don't see the option to select a list? You must be on an older version of the Wistia-Marketo integration. From your Integration Settings page, disable your existing Marketo integration, set up the new one (it asks for your REST API Endpoint instead of SOAP), and you should be all set. You can read about migrating here.

Here's what Turnstile looks like:

 

So that video was just an example, but if that was your video, you'd probably have a brand new lead right about now. That would be cool.

"But Wistia," you ask, "what if that person was already an identified lead in my Marketo account?" Glad you asked. In that case, only missing fields will be updated. For example, if you already had bob@example.com as a lead in Marketo with a leadSource of Campaign X, but Bob filled out a Turnstile with his name, Bob Smith, only firstName and lastName would be updated. As a result, Bob would be a lead in Marketo with firstName Bob, lastName Smith, email bob@example.com, and leadSource Campaign X.

Fun fact: All of a person's video viewing activity from before they entered their information into Turnstile will be associated with their lead record, so you can see exactly what the path to conversion was in the lead's Activity Log in Marketo.

Yet another fun fact: Their historical viewing data will live in Wistia too! Anytime you get a new lead through Turnstile, the person's info will appear in right in your Wistia stats along all their viewing activity – even from before they used Turnstile.

To get started with Turnstile, go to a video page in your Wistia account and open the Timeline Actions section of the Customize panel.

Setting Up Marketing Automation Based on Video Viewing Data

Wouldn't it be cool if when a person watches at least 50% of a certain video on your website, you could automatically send them an email about that product a few days later? Or if a person entered their email address into Turnstile, you could have a salesperson get notified to follow up?

"Why yes, yes that would be quite cool indeed," you say? Phew! Good thing we built this integration.

Alert

Before you can trigger automation in Marketo based on a Wistia video event on your website, that event will need to occur at least once. So before anything else, go onto your website and do the thing you want to use as a trigger in the embedded video (like watch 50% of the video, or click an Annotation Link) – just like regular visitor to your website would. Then Marketo will let you select it as a trigger.

Have you read the super important note above and done the thing you'd like to use as a trigger? Alrighty then, carry on! Here's how to set the automation up:

  1. Head to the Marketing Activities section in your Marketo account.
  2. Create a new Smart Campaign. Choose a folder, and give the campaign a name. A description too, if you'd like.
  3. In the campaign screen, go to the Triggers section in the panel on the right.
  4. Now here's where it gets a little weird, but hey, that's what this tutorial is here for. All of events related to how people interact with your videos are recorded as "Visits Web Page" triggers in Marketo, even though they don't have much to do with visiting a web page (beyond the fact that the video is embedded on one). The details of the type of event will be in the Trigger's Detail description. So, find the Visits Web Page trigger, and drag that little guy into the "Drag triggers and filters from the right" area.
  5. Now it's time to define the specific video event trigger. If you wanted to run automation when a person watches 75% of a video called "Making French Toast at Wistia", you'd tell Marketo to set the trigger to Web Page --> is --> Wistia Video: "Making French Toast at Wistia" 75% Watched.
  6. Once you've picked the right event for the right video, move onto the Flow step. That's all Marketo's domain, so check out the Marketo documentation for details.

There are a bunch of other things you can automate too, like:

Bravo, Marketo. 👏

Add Video Thumbnail Links to Your Emails

Email is a wonderful way to engage with your customers (and future-customers)... but email with video is an even wonderfuller way.

To add a video thumbnail link to an email campaign, just follow this quick process:

  1. Open the video's page in your Wistia account.
  2. Click on the Video Actions menu, and choose Embed & Share.
  3. On the Link In Email Campaign tab, select Marketo as your email provider.
  4. Adjust the thumbnail image size and choose the URL where you want people to watch the video. It can be the video's page in your Wistia account, or anywhere you have it embedded.
  5. Copy the Email Merge Tag from Wistia and paste it into your email in Marketo.
  6. Profit.

Fun fact: When people receive your email and click through to watch the video, their email addresses will automatically pass through to your Wistia stats.

Learn more about video+email marketing with Wistia.

Marketo Integration Troubleshooting

Is E-v1 present on the Page?

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:

iframe.html
1
<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 Marketo 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.

Alert

At this time, iframe playlists are not able to work with MAP integrations, including Marketo. 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.

Blank Forms List in Wistia

If you're seeing a blank list instead of your forms in the Customize panel, this is likely because of insufficient permissions granted to your Marketo API User. To solve this, you'll need to go into your Marketo account and navigate to the Admin page. You can modify the permissions in the Users & Roles section, specifically in the Roles tab.

The Roles tab allows you to modify the permissions for the API user you've entered in your Wistia-Marketo integration. There are a lot of different permissions you can grant, but the key permissions to get your forms appearing are the Access Admin and Access API permissions. Make sure that those are checked, and save the user to update their permissions.

Form Styles Look Strange

If you've added custom styles to your forms, it's possible that they will affect the styles within your Wistia media page or pages the video is embedded. This is because those styles are injected in a blank <style> element to the page. Sometimes, those styles may appear differently than expected when the form is embedded into your Wistia video.

We recommend using the default Marketo themes for forms when possible. If you need to add styles to your forms, try minimizing the use of tools like !important attributes. This will help minimize potential CSS conflicts.

Still not working? We're happy to take a look! Give us a holler, and we'll jump on the case.