Gemius Stream

1. Global variables:

Variable nameTypeDescription
gsmapiurlstringshould be delivered by client, url to the Gemius API
gsmhitcollectorstringgemius hit collector (//.hit.gemius.pl given by Gemius)
gsmidentifierstring‘xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xx’ tag identifier (given by Gemius)
gsencodingstringif not set it will be utf-8
gsmplayeridstringrandom player identifier

2. Media variables:

Variable nameTypeDescription
gsmcustompackagearrayan array of additional criteria that describe the material, CNAME is optinal but recommended, max 6 criteria
gsmadditionalpackagearrayshould be empty
gsmtreeidarrayshould be a list of positive integers, each intiger represents a category tree node
gsmmaterialidentifierstringmaterial identifier, max 64 chars, pattern: <VIDEO_ID>_<VIDEO_TITLE>

3. Example

<html>
    <head>
        <!-- 1. add player source -->
        <script src="PLAYER_SOURCE.js"></script>
    </head>
    <body>

        <!-- 2. add player container element -->
        <div style="width: 890px;height: 500px;background: black;" id="PLAYER_DOM_ID"></div>

        <script type="text/javascript">

            /** 3. setup player configuration object */
            var playerConfig = {
                "gemius": {
                    "gsmapiurl": "https://sdk.hit.gemius.pl/gstream.js",
                    "gsmhitcollector": "https://sdk.hit.gemius.pl",
                    "gsmidentifier": "GSM_IDENTIFIER",
                    "gsencoding": "utf-8",
                    "gsmplayerid": "PLAYER_ID"
                },
                "dataProvider": {
                    "id": "MATERIAL_IDENTIFIER_INTERNAL",  /* NOTE: Remember to add ID for media. */
                    "title": "Tears of steel",
                    "duration": 733,
                    "source": [
                        { "url": "https://bradmax.com/static/video/tos/440272.mpd" }
                    ],
                    "customParams": {
                        "gsmcustompackage": [
                            {"name": "A", "value": "1"},
                            {"name": "B", "value": "2"},
                            {"name": "C", "value": "3"}
                        ],
                        "gsmadditionalpackage": [
                            {"name": "a", "value": "1"},
                            {"name": "b", "value": "2"},
                            {"name": "c", "value": "3"}
                        ],
                        "gsmtreeid": [100, 101, 111],
                        "gsmmaterialidentifier": "GSM_MATERIAL_IDENTIFIER"
                    }
                }
            };
            /** 4. get player container element */
            var element = document.getElementById("PLAYER_DOM_ID");

            /** 5. initialize player */
            var player = window.bradmax.player.create(element, playerConfig);

        </script>

</body>
</html>

Demo page: https://bradmax.com/static/bradmax-player-analytics-demo/gemius.html

Jump to