ÃÛ¶¹ÊÓƵ

DocumentationExperience PlatformWeb SDK Guide

streamingMedia

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

The streamingMedia component helps you collect data related to media sessions on your website.

The collected data can include information about media playbacks, pauses, completions, and other related events. Once collected, you can send this data to ÃÛ¶¹ÊÓƵ Experience Platform and/or ÃÛ¶¹ÊÓƵ Analytics, to generate reports. This feature provides a comprehensive solution for tracking and understanding media consumption behavior on your website.

Prerequisites prerequisites

To use the streamingMedia component of Web SDK, you must meet the following prerequisites:

  • Make sure you have access to ÃÛ¶¹ÊÓƵ Experience Platform and/or ÃÛ¶¹ÊÓƵ Analytics.
  • You must use Web SDK version 2.20.0 or later. See the Web SDK installation overview to learn how to install the latest version.
  • Enable the Media Analytics option for the datastream you are using.
  • Ensure that the schema used by your datastream includes the Media Collection schema fields.
  • Configure the Streaming Media feature in the Web SDK configuration, as shown in this page, either through the tag extension or through the JavaScript library.

Configure streaming media using the Web SDK tag extension tag-extension

To configure streaming media in the Web SDK tag extension, follow the steps below.

  1. Log in to using your ÃÛ¶¹ÊÓƵ ID credentials.
  2. Navigate to Data Collection > Tags.
  3. Select the desired tag property.
  4. Navigate to Extensions, then click Configure on the ÃÛ¶¹ÊÓƵ Experience Platform Web SDK card.
  5. Configure the Streaming Media settings as described in the Web SDK tag extension configuration page.

Configure streaming media using the Web SDK JavaScript library library

To configure streaming media in Web SDK, use the properties described below.

When calling the configure command, add the streamingMedia object.

alloy("configure", {
    streamingMedia: {
        channel: "video channel",
        playerName: "test player",
        appVersion: "Media Analytics with Web SDK 2.20.0",
        mainPingInterval: 10,
        adPingInterval: 10
    }
});
Property
Type
Required
Description
channel
String
Yes
The name of the channel where streaming media collection occurs. Example: Video channel.
playerName
String
Yes
The name of the media player.
appVersion
String
No
The version of the media player application.
mainPingInterval
Integer
No
Frequency of pings for main content, in seconds. The default value is 10. Values can range from 10 to 50 seconds. If no value is specified, the default value is used when using automatically-tracked sessions.
adPingInterval
Integer
No
Frequency of pings for ad content, in seconds. The default value is 10. Values can range from 1 to 10 seconds. If no value is specified, the default value is used when using automatically-tracked sessions.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636