How the Audience Module Identifies Viewers
In this topic you will learn about the different ways the Audience module attempts to identify viewers.
The Audience module tries to identify viewers using a variety of data sources:
- Audience cookie
- Oracle Eloqua GUID
- Marketo Munchkin cookie
- Salesforce ID URL parameter
- Salesforce ID HTML attribute
- HubSpot UTK cookie
- Email parameter
The Audience module will abide by a user's browser settings regarding Do Not Track.
Note: When using a custom integration, you are responsible for identifying the viewer. For information, see Creating Custom Integrations with the Audience Module.
Audience-enabled players will set a 3rd party cookie and use it to associate viewing data with the same user if Audience Tracking is enabled for their account and the player is using it. If a user ever fills out an Audience lead form, Audience will create a profile for that viewer and all their viewing data will be associated with that profile.
The cookie that Audience will set is named _bc_uuid.
Oracle Eloqua GUID
Audience-enabled players with an Eloqua integration will invoke Eloqua’s APIs to obtain the visitor ID, frequently referred to as the Eloqua GUID. This ID is captured in the Audience module’s viewing data and is used to synchronize viewing data to Eloqua.
Eloqua uses its own set of cookies and when a Brightcove Player is configured with an Eloqua integration, Audience captures the GUID in the Eloqua cookie and communicates with Eloqua server-side, to try and figure out who the user is.
Marketo Munchkin cookie
Audience-enabled players with a Marketo integration will refer to the Munchkin cookie (_mkto_trk) which is created in the user's browser. This value is captured in the Audience module’s viewing data and is used to synchronize viewing data to Marketo.
Salesforce ID URL parameter
For Salesforce integrations, the plugin can attempt to identify the viewer by checking the URL for the parameter called bcsfid. This allows Salesforce users to send email campaigns with a landing page URL that is uniquely generated for tracking purposes by providing the lead’s Salesforce ID in the URL.
Salesforce ID HTML attribute
For Salesforce integrations, if the plugin is unable to identify the viewer by checking for the bcsfid URL parameter, it will search for the data-bc-sfid attribute on the
<video> element of the HTML embed publishing code for the video and use its value as the Salesforce ID of the lead if it is set.
HubSpot UTK cookie
The Audience module can also be told who the user is via an email address. Audience will look for a URL parameter titled bcemail. This is useful with email campaigns with a landing page URL that’s been uniquely generated for tracking purposes. If you're sending out a batch email to a list, either from a marketing platform or from a third party email service like MailChimp, you would need to configure the email parameter in the sending platform's settings to dynamically update the link that people click on. Audience will then use this email parameter to look up the user server side and sync viewing data.
If the Audience plugin does not find an email address via the bcemail URL parameter, it will then check the
<video> element of the HTML embed publishing code. It will search for the data-bc-email attribute on the video element and use its value as the email address if it is set.
<video id="player" data-account="0000000001" data-player="default" data-video-id="0000000002" data-bc-email="firstname.lastname@example.org" class="video-js" controls> </video>
Do not track
Audience-enabled players abide by a viewer’s browser setting regarding Do Not Track (DNT) and will not use or set its normal cookie should it see that Do Not Track is enabled. The player plugin can also be instructed to never track should a Video Cloud customer wish to turn it off for all their viewers or on a user by user basis. This is done by using the in-page embed code and setting the
data-do-not-track to a value of 1.
<video-js data-video-id="9240259371001" data-account="3491906377" data-do-not-track="1" data-player="7dccc39d-0e2d-4b27-bea9-af44b2166148" data-embed="default" class="video-js" controls></video-js> <script src="https://players.brightcove.net/1486906377/7dccc39d-0e2d-4b27-bea9-af44b2166148_default/index.min.js"></script>
Marketo supports DNT but leaves it up to the customer to turn it on/off for their particular account. For more information, see the Marketo document Edit "Do Not Track" Browser Support Settings.
HubSpot respects DNT according this document.