Integrating Video Cloud with HubSpot Using the Client-Side APIs

The Hubspot integration allows Video Cloud to synchronize viewing data from Brightcove Players to HubSpot. Once in HubSpot, this data can be used for segmentation, reports, lead scoring, and personalizing communications.

For information on how to configure the Player module for use with HubSpot, see Client-side: MAPs connection.

Requirements

To use the MAPs section with HubSpot, you must:

• Have a HubSpot account
• Have your account enabled for the MAPs feature. Contact customer support for enablement
• Use the Advanced Embed (in-page) publishing code when publishing your player; Standard Embed (iframe) publishing code will not work as the plugin will be running inside of an iframe and therefore will be unable to access any parent page URL parameters and may not get the correct cookies

Features

Some of the key features of the Video Cloud - HubSpot integration are:

• Lead forms - Create HubSpot forms that will appear automatically as viewers watch videos. For information, see Creating Custom Lead Forms for HubSpot.
• Data format - Viewing data is delivered as a custom Timeline Event Type. The data that is replicated to HubSpot is as follows:
  • Video Name
  • Video ID
  • Account ID (Video Cloud)
  • Page URL (URL of the referring page)
  • Player ID (Video Cloud player)
  • % Watched (25%, 50%, 75%, 95%)
• Data transfer - Viewing data is sent to HubSpot using an automated process; however, some reports in the HubSpot platform may take some time to refresh
• Data retention - Data collected can optionally be retained in Video Cloud for up to 1 month

Accessing the HubSpot ID

When configuring the integration with Video Cloud, you will be prompted to use your Hubspot Account ID. Follow the steps below to access this value.

1. Login to your HubSpot account.
2. Open the dropdown menu under your Account Name in the top navigation.

   

3. Copy the HubSpot Account ID and save it in a safe place. It will be needed when configuring the MAPs module.

Configuring the integration

1. By default, the Connection Status will be Enabled. The Connection Status determines if Video Cloud video engagement data is sent to Marketo.
   • Enabled - Data is collected and will be sent to Marketo
   • Disabled - No data is collected (integration is disabled)

To remove the integration with Marketo, click Disconnect. The Campaign module supports multiple connections to marketing platforms. Click Add New Connection to configure additional integrations.

Creating a Campaign-enabled player

Video engagement data will only be sent to Marketo when you are using a Campaign-enabled video player. For information on creating a Campaign-enabled Brightcove Player, see Creating a Campaign-enabled Player.

Setting up the connection

Follow these steps to setup the connection between Video Cloud and HubSpot.

Establishing the connection between Video Cloud and HubSpot

1. Open the Campaign module.
2. In the left navigation, click Data Connections.
3. Click Add New Connection.
4. Select HubSpot as the integration.
5. (Optional) Enter a Connection Name.

   

6. Click Connect.
7. Select High Volume (Client-Side API).

   

8. Click Save.

The Video Cloud connection to HubSpot is now set up.

Configuring the integration

Once the Video Cloud to HubSpot connection has been made, follow these steps to configure the integration.

1. The integration requires your HubSpot Account ID. Click the empty link, enter your HubSpot Account ID and then click Save.

   

2. By default, the Connection Status will be Enabled. The Connection Status determines if Video Cloud video engagement data is sent to HubSpot.
   • Enabled - Data is collected and will be sent to HubSpot
   • Disabled - No data is collected (integration is disabled)

To remove the integration with HubSpot, click Disconnect. The Campaign module supports multiple connections to marketing platforms. Click Add New Connection to configure additional integrations.

Passing a tracking ID

The Campaign module supports the ability to pass a tracking ID value to HubSpot. The tracking ID might be used to track a campaign ID for example. The tracking ID can be appended to the URL that displays the Campaign-enabled player or added to the player embed code.

• Example: Appended to URL

    http://www.myurl.com/video.html?bctrackingid=12345

• Example: Added to player embed code

    <video data-video-id="6033402539001" 
           data-account="1486906377" 
           data-player="default" 
           data-embed="default" 
           data-application-id 
           class="video-js"
           data-bc-trackingid="12345" 
           controls></video>
    <script src="//players.brightcove.net/1486906377/default_default/index.min.js"></script>

Campaign will then pass the value along to HubSpot as another field that is synced.

Identifying viewers

For HubSpot integrations, the plugin injects HubSpot’s JavaScript tracking code which drops a hubspotutk cookie on the user’s browser. This cookie is used to keep track of a visitor's identity within HubSpot and associate Brightcove viewing data with a contact. If the user already has a hubspotutk cookie when the player loads, Campaign will make an API request to HubSpot and ask if the cookie value corresponds to a known contact, and if so, Campaign will associate viewing data with that user.