Browser SDK API Reference

Engineering Portal Digital Browser SDK API Reference

Browser SDK API Methods & Properties

Method / Property	Event #	DTVR	DAR	Digital Audio	DCR	International (Germany)	Description
loadMetadata (Browser)	3	✔	✔	✔	✔	✔	Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
play (Browser)	5	✔	✘	✘	✔	✔	Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”. VA Beacon: Called when content or ads start playing. The playhead position must be passed.
sendID3 (Browser)	55	✔	✘	✘	✘	✘	Used to send the ID3 metadata.
setPlayheadPosition (Browser)	49	✘	✘	✔	✔	✔	Used to send the playhead position.
stop (Browser)	7	✘	✘	✘	✔	✔	Used when switching between ad and content or content and ad.
end (Browser)	57	✔	✘	✔	✔	✔	This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
staticstart (Browser)	14	✘	✘	✘	✔	✔	Used to send the metadata for the static page.
getOptOutStatus (Browser)	4	✘	✘	✘	✘	✔	VA Beacon Only: Sent only after calling stop. The current position must be passed. Not needed for new International (Germany) implementations.
updateOTT (Browser)	-	✘	✘	✘	✘	✔	Used to notify Browser SDK that the remote OTT device (like Google ChromeCast, Roku, Amazon FireTV, etc.) is connected / disconnected (change of OTT status).
onPaginate (Browser)	30	✘	✘	✘	✔	✔	Used to create a new instance of the SDK object
updateMetadata (Browser)	35	✔	✔	✔	✔	✔	This event is used for updating metadata parameters for the content or ad that is being played.

Browser Opt-Out Implementation

The site in which video content is being measure via Nielsen methodology must provide the means for the user to opt-out of, or opt back into Nielsen Measurement.

For Browser-based applications, opt-out setting is stored via Nielsen cookie. Therefore, it is only necessary that users be made aware of measurement opt-out by incorporating the template below in the user interface.

Sample Opt Out Template

Our properties may feature Nielsen’s proprietary measurement software which will allow to contribute to market research, like Nielsen’s TV Ratings. To learn more about this information, please click here. Nielsen’s software may collect your choices with regards to it.