support Contact Support | system status System Status

Connecting to Salesforce

In this topic you will learn how to configure Brightcove Campaign™ for use with Salesforce.

Brightcove Campaign can be configured to integrate with Salesforce. When the integration is configured, video engagement data for videos published using Brightcove Campaign is synchronized to Salesforce. Once in Salesforce, this data can be used for segmentation, campaign logic, reports, lead scoring, and personalizing communications.

Requirements

To use the Brightcove Campaign module with Salesforce, you must:

  • Have a Salesforce account, Salesforce sandbox accounts are not supported
  • 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 you choose to send viewing data to
  • 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.

Features

Some of the key features of the Brightcove Campaign - Salesforce integration are:

  • Data format - Viewing data is mapped to a Salesforce object
  • Data transfer - Viewing data is sent from Brightcove Campaign to Salesforce every hour
  • Lead forms - Create Salesforce forms that will appear automatically as viewers watch videos. For information, see Creating Lead Forms in Salesforce.

Setting up the connection

Follow these steps to setup the connection between Brightcove Campaign and Salesforce.

  1. Login to Brightcove Campaign.
  2. In the navigation header, click the gear icon () and then MAP Connections. A list of current connections (if any) will appear.
  3. Click Add New Connection.
  4. Select Salesforce from the dropdown list and click Connect to Salesforce.
  5. On the login screen that appears, enter your Salesforce Username and Password. Click Log In.
    Salesforce login
  6. If the login is successful, you will prompted to install the Brightcove Video Connect for Salesforce app. Click Allow.
    salesforce allow access
  7. Verify that you receive a message that the connection was successful. You will be redirected back to Brightcove Campaign.
  8. (Optional) Enter a Connection Name.
  9. Select an integration type.
  10. Select a Mapping Type and configure data mapping.
  11. Click Save.
  12. Click the Back to MAP Connections link at the top of the page to return to the MAP Connections page.

Configuring a Pardot integration

Once the Brightcove Campaign to Salesforce connection has been made, you need to configure an integration type. This section covers the steps to use a Pardot integration type.

  1. Select Pardot for the integration type.
  2. 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.

  1. Login to Pardot.
  2. Click the gear icon () and then Settings.
  3. Click the My Profile link at the top of the page.
  4. 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.

  1. In the left navigation, click the Marketing icon and then click Campaigns.
  2. Click on a Campaign Name (or add a campaign if there are no campaigns).
  3. Click View Tracking Code. The piAId and piCId values will be displayed.
  4. Copy the values and paste them into their respective fields.
    salesforce integration type
  5. 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.

salesforce mappping type

Follow these steps to customize the data mapping.

  1. For the Mapping Type, select Advanced.
  2. In the Salesforce Object dropdown list, select a Salesforce object to map the video data to. Typically, when using the Pardot integration type, you will map the view fields to the Salesforce custom object you created.

  3. Map the appropriate View Field to Salesforce fields. The following example shows the video fields being mapped to a custom object.
    salesforce advanced mapping
  4. Click Save to save the changes.

To remove the integration with Salesforce, click Delete.

Passing a tracking ID

Brightcove Campaign 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 page URL that displays the video or added to the 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>

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

Identifying viewers

If your Salesforce connection is configured with a Manual integration type, 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. Brightcove Campaign will then use the URL parameter to look up the user server-side and sync viewing data.

Viewing video data in Salesforce

As videos are viewed, 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.

salesforce task record

Clicking the video name will display detailed information.

salesforce task detail

Page last updated on 22 Apr 2020