Integrating Video Cloud with Salesforce
The Audience module allows Video Cloud to synchronize viewing data from Brightcove Players to Salesforce. Once in Salesforce, this data can be used for campaign logic, reports and personalizing communications. The Audience module integration with Salesforce consists of two main components:
- A Brightcove Player plug-in to enable tracking of video views data
- A synchronization process to send tracking data from Video Cloud to Salesforce
To use the Audience module with Salesforce, you must:
- Have a Professional or Enterprise Video Cloud account
- Have a Salesforce account, Salesforce sandbox accounts are not supported
- Have the Audience module enabled for your account by submitting the required information in the initial splash screen that appears when you open the Audience module
- Click through the service agreement the first time you use the module
- Have a Salesforce.com account with the API Enabled permission and belong to a role which allows you to read and write to the Salesforce object they choose to send viewing data to
- 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 the parent page URL parameters
- If you will be using the Pardot integration, you should complete the steps outlined in the Creating a Custom Salesforce Object for Pardot Integration topic.
Some of the key features of the Video Cloud - Salesforce integration are:
- Data format - Video Cloud viewing data is mapped to a Salesforce object
- Data transfer - Viewing data is sent from Video Cloud to Salesforce every hour
- Lead forms - Create Salesforce forms that will appear automatically as viewers watch videos. For information, see Creating Custom Lead Forms for Salesforce.
Setting up the connection
Follow these steps to setup the connection between Video Cloud and Salesforce.
- Open the Audience module and click Data Connections in the left navigation.
- Click Add New Connection.
- Select Salesforce as the integration.
- (Optional) Enter a Connection Name.
- Click Connect.
- Click Connect to Salesforce.
- On the login screen that appears, enter your Salesforce Username and Password. Click Log In.
- If the login is successful, you will prompted to install the Brightcove Video Connect for Salesforce app. Click Allow.
The Video Cloud connection to Salesforce is now set up and ready to use.
Configuring the integration
Once the Video Cloud to Salesforce connection has been made, you can configure the integration. Click Salesforce User Info to see information about the account that was used when setting up the integration.
- To configure viewer identification, click the Configure how viewers are identified link and then select an option:
- Pardot - Pardot is used to identify viewers. See the Configuring a Pardot integration section below.
- Manual - Your development staff will be responsible for adding logic to identify viewers.
- Enabled - Data is collected and will be sent to Salesforce
- Disabled - No data is collected (integration is disabled)
- Enabled - Data for all viewers is collected and saved in Video Cloud
- Disabled - Data for unknown viewers is not saved in Video Cloud
Configuring a Pardot integration
Once the Brightcove Audience to Salesforce connection has been made, you can choose to use Pardot to identify viewers. This section covers the steps to use Pardot to identify viewers.
- Click the Configure how viewers are identified link.
- Enter your Email and Password you use to login to Pardot.
Get the Pardot API key
To get the value for the API Key field, follow these steps.
- Login to Pardot.
- Click the gear icon () and then Settings.
- Click the My Profile link at the top of the page.
- Copy the value in the API User Key field and paste it into the User Key field.
Get the tracking IDs
To get the value for the Tracking piAld and Tracking piCld fields, follow these steps.
- In the left navigation, click the Marketing icon and then click Campaigns.
- Click on a Campaign Name (or add a campaign if there are no campaigns).
- Click View Tracking Code. The piAId and piCId values will be displayed.
- Copy the values and paste them into their respective fields.
- Click Connect to Pardot.
Typically, when using the Pardot integration type, you will select the Advanced Mapping Type and then map the view fields to the Salesforce custom object you created.
Configuring data mapping
Data mapping determines how video data is mapped to fields in a Salesforce object. By default, the integration will be configured using Simple mapping which maps some video data to the Task object in Salesforce.
Follow these steps to customize the data mapping.
- Click the Configure how data is mapped to fields in a Salesforce Object or click the Mappings link.
- For the Mapping Type, select Advanced.
- In the Salesforce Object dropdown list, select an object to map the video data to.
- Map the appropriate View Field to Salesforce fields.
- Click Save to save the changes.
To remove the integration with Salesforce, click Disconnect. The Audience module supports multiple connections to marketing platforms. Click Add New Connection to configure additional integrations.
Creating an Audience-enabled player
Video engagement data will only be sent to Salesforce when you are using an Audience-enabled video player. For information on creating an Audience-enabled Brightcove Player, see Creating an Audience-enabled Player.
Passing a tracking ID
The Audience module supports the ability to pass a tracking ID value to Salesforce. 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 Audience-enabled player or added to the player embed code.
- Example: Appended to URL
- 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>
Audience will then pass the value along to Salesforce as another field that is synced.
If your Salesforce connection is configured to use Manual viewer identification, it's up to you to identify viewers. For viewer tracking to occur, the user id should be passed as a URL parameter on the page that is displaying the video. Two URL parameters are supported:
- bcemail - To pass the viewer's email address
- bcsfid - To pass the viewer's Salesforce ID
In this scenario, video landing pages would be generated with a URL that’s been uniquely generated for tracking purposes. The Audience module will then use the URL parameter to look up the user server-side and sync viewing data.
In order for the player/plugin to read the URL parameters, the Advanced Embed (in-page) publishing code should be used. The Standard Embed (iframe) publishing code will not work as the plugin will be running inside of an iframe and therefore is unable to access the parent page URL which has the parameter.
Viewing video data in Salesforce
As videos are viewed in Audience-enabled players, video viewing data will be synced to Salesforce. If the Simple data mapping option was selected, video view data will appear as a Task entry inside Salesforce. If the Advanced data mapping option was used, viewing data will appear as part of the Salesforce object that was selecting when the mapping was configured. In the following example, Advanced data mapping was used and the video fields were mapped to a custom BC Video View Salesforce object.
Clicking the video name will display detailed information.