Brightcove Campaign FAQ

This topic contains some of the common questions asked about Brightcove Campaign.

Why Campaign & How it Works

Why do I need to track video in my marketing automation solution? Marketing automation solutions do not track video today. If you are investing in video as a powerful piece of content, you should make sure you are tracking its effectiveness and automating communications with leads/users who view your content.
Does Brightcove and the Campaign module make use of any cookies? The Campaign module creates and uses a 3rd party cookie to identify users when an integration is in place. This way, viewers don't get asked to fill out a lead form a second time. The module also makes use of Marketo, HubSpot, and Eloqua APIs, which themselves use cookies to track viewers. When using Campaign Profiles, a Brightcove cookie is used.
Is Brightcove Campaign enabled for all customers? No. Campaign is available as a purchasable add-on to Video Marketing Suite (VMS). Campaign Profiles, however, is available to every Brightcove customer for free. You can think of it as "Campaign-lite".
Who is eligible for Campaign Profiles. Starting in Q4 2017, every VMS customer will have access to Campaign Profiles at no cost. Customers will need to activate it to start tracking data. Enterprise Video Suite (EVS) customers will also have Campaign SSO tracking available.

Viewer Tracking & Limitations

What limitations does Campaign Profiles have compared to the full-featured Campaign module?
  • No integrations with any third party systems
  • No API access
  • No custom lead forms (Campaign lead forms only)
  • 1000 views/24 hour period capture maximum
You can still manually export Campaign data to a CSV or XLS file.
What limitations/requirements does Campaign have when connected to a marketing automation platform? Limitations and requirements are outlined in the documentation for each platform:
Are there any limits on how often the Audience API can be polled? I know there's a 1000 cap on video search results, but are there other frequency related caps to that API endpoint? The max # of view events per API call is actually 100. There's no rate-limiting in place, but if you try to call it too much, it will probably slow down a bit.
Is there any way to get Campaign data faster than the 3 hour delay that is currently present? I'd like to get "close to real-time" metrics. No. If you want real-time metrics, you'd need to write your own plugin and send data to your own system.
is the trigger for an event view to be sent to Campaign? Is it when the video completes, when the player window is closed, or something else? What happens if the user never completes the video and doesn't close their player window? It varies, but, basically, the Campaign plugin sends a heartbeat back to the server every 10 seconds.
When does Campaign consider tracking on a view to be "completed"? Is it when the player window is closed or if they complete the video? What happens if they watch partway through, pause the video and never close the player window? It is when 15 minutes have passed since we last saw a heartbeat, basically lack of activity.
Is it possible for viewer data to change once it's available in the Campaign viewing data? Will that event data ever be updated in the future by some kind of log consolidation? Once the data is available in Campaign via the UI or API, it's considered "settled", and it's not going to change.

Data protection & record retention

Is Campaign GDPR compliant?

Yes, Campaign gives customers the ability to act on behalf of their users, looking up and purging any data they've collected via Campaign.

How long can data be retained in Campaign? MAP integrations can be set to a maximum of 6 months, and non-MAP integrations can be set to 3 years.
How long are GUID lookups cached? 30 days for known and 7 days for unknown (only applies to MAP integrations, no lookups needed for non-MAP integrations)

Marketing automation & viewer analytics

What is different about tracking video from any other media in my marketing automation platform? As opposed to a web page or downloadable white paper, with a video, you can determine exactly how much of the video the viewer watched and, therefore, exactly what content they have been exposed to.
How do you connect with my Eloqua/Marketo/HubSpot account? You are able to log into your Eloqua/Marketo/HubSpot account directly through the Video Marketing Suite in the Campaign module. From there, you are able to create players and lead forms with MAP tracking built-in, so you can start tracking video analytics immediately.
Can I track views on my Eloqua/Marketo/HubSpot pages as well as my non-Eloqua/Marketo/HubSpot landing pages (Sitecore/WordPress/Gallery etc)? Yes, as long as the player being used is “Campaign enabled” (has the Campaign plugin installed), all views will be tracked whether the player resides on a MAP landing page or any other landing page.
What can I track with this integration? With our integration, you can track video viewing analytics (video, video ID, percent viewed, time watched) for known contacts already in your database.
What about unknown contacts? Can I track them too? With Brightcove Campaign, you can track unknown contacts, and then when they submit an Eloqua/HubSpot form (become known), Campaign is able to associate their viewership information with that new contact retroactively. Campaign resubmits viewership information daily to match view data from unknown contacts back to your Oracle Eloqua/HubSpot instance. This depends on which MAP you are using. See the following documentation for Oracle Eloqua, Marketo and HubSpot.
Where in Salesforce will my video viewing data show up? Video views are delivered into Salesforce as a task under the viewer's contact in the Activity section. See Viewing video data in Salesforce for an example of this.
Can I be notified with Salesforce when one of my contacts has watched videos? Not directly. However, you can run reports that would notify you of a contact's activity.
Is there any difference between tracking with Salesforce vs. Oracle Eloqua/Marketo? The biggest difference is that Salesforce does not use cookies to track users. Therefore, a unique identifier should be passed to identify the viewer. See this document for more info. Additionally, Salesforce, being a CRM, does not offer automated follow-ups or lead scoring. However, you can create tasks in Salesforce, which are then assigned to your sales team for real-life follow-ups.
Campaign has a “Custom” integration option, what other platforms can Campaign integrate with using this?

Campaign can “integrate” with any data platform that:

  1. Uses a unique identifier for each contact record
  2. Has an API that can receive additional data from third-party platforms (like Campaign)
Why are my video views in the Analytics module higher than the amount of views in the Campaign module?

The Analytics & Campaign modules are two separate systems and it should not be expected that the view events are 1:1, as each captures separate use cases.

The Campaign lead form requires a video_view event to have triggered before it can display a lead form. These video_view events trigger when a user initiates playback, which is done by having the user manually click the Play button. As a result, even though it may not look like any content has played back, a video_view has been registered and will appear for your video in the Analytics module.

If you are seeing a higher number of video views in the Analytics module compared to view events in the Campaign module, the most likely reason is that a user was presented your lead form, but did not fill it out to continue through with playback.

Player Lead Forms

When does Campaign display a lead form? The default setting only displays the lead form to an unknown user in your MAP database (the ones you want to convert into a known user). You can override this in the settings if you choose to always display the lead form. This is most useful for testing. Known users are automatically tracked, and that data is associated with the contact in your MAP without the need to display a form.
Can I customize lead forms? You can adjust the text and fields displayed using the UI. You can not modify it beyond what is available in the UI (Gallery can update some styling to make the forms match the site)

General topics

Which embed code should I use? Iframe or in-page? For Campaign to work, it is required that the Advanced embed code is used. If the Standard (iframe) embed code is used, then the player is isolated from the page, which means the Campaign plugin cannot see the unique identifier, and thus, all users will be seen as “unknown”.
What is marketing automation? Marketing automation is a technology that tracks lead/user interaction with different online marketing channels (email, web, forms, content, video, social, etc.). Marketing automation helps marketers market more effectively across these channels and automates repetitive marketing tasks (such as email communications). Marketing automation allows the marketer to set up automated and personalized tasks based on predefined variables. For example, if a user watches 75% of a specific video, send them an email on that specific subject, but if they only watch 12%, send them something else.
Is Brightcove a marketing automation company? No, Brightcove provides a complete solution for video marketing. With our solution, you can get your videos online, organize your content, create players, create video portals, track analytics, and integrate with your own existing marketing automation platform. Brightcove integrates video analytics into marketing automation platforms.
How can I check to see if a Marketo custom activity is set up correctly? Campaign has a hidden URL which offers some debugging tools for certain kinds of integrations, Marketo REST being one.
Campaign settings
What needs to be done to configure a custom integration? Three things need to be done:
  1. You need to expose a unique identifier in the URL or code of the page that Campaign can capture.
  2. Create a script that makes use of the Audience API's to retrieve the data as a JSON file (Brightcove Global Services can help with this).
  3. Map the data to fields in your destination database (think spreadsheet merge).
The following support documentation covers these tasks:
How does Campaign push CDO data to Eloqua? We use the custom object bulk API.
How does Campaign push the external asset activity? How can I control the Campaign, External Asset, and Activity Types used? We using the external activity API ( There's no control over the name of the campaign, asset name or type. We simply create a campaign on our own (named BrightcoveVideoPlay) and then proceed to create activities, also named BrightcoveVideoPlay.
What IP addresses can I whitelist so that Campaign can talk to service X? Campaign has established a set of IP addresses that should be used for IP whitelisting. To see the list, edit an Eloqua connection and click the Unable to see Campaign data in Eloqua? link to see the list of IP addresses.