Player Dynamic Parameters

Primis tag is a javascript tag that can be placed on an HTML page anywhere in the BODY tag. The tag contains initial configuration parameters for the player that will be downloaded on the page.

It is highly recommended to set all of the parameters inside the Primis publisher's dashboard.

Each Primis Tag Consists of:

  • script tag of type text/javascript and language javascript
  • A source to the video tag script, as follows: https://live.primis.tech/live/liveView.php
  • Query string parameters that will set the placement specifics

Tag Examples

<script type="text/javascript" language="javascript" src="https://live.primis.tech/live/liveView.php?s=XXXXX&cbuster=[CACHE_BUSTER]"></script>

Parameters List

Here are the possible tag parameters that can be set on the tag. The default value is empty unless stated otherwise.

General Parameters

Parameter

Type

Description

s

integer

Placement id (mandatory)

x

integer

Width of a fixed video player

y

integer

Height of a fixed video player

subId

string

A custom identifier used to logically separate traffic types within same placement bounds

pubUrl

string

URL of the page where the placement is. Needed only in the TAG runs inside a SafeFrame

cbuster

integer

Cache buster

vp_content

string

Video content/playlist id to display

vp_template

string

Video player template id

gdprConsent

string

External GDPR consent string

ccpaConsent

string

External CCPA consent string

schain

string

Publisher's schain encoded data

playerApiId

string

For activation of Primis Player API

Float Parameters

Parameter

Type

Description

Default

floatDirection

string

Position of the floating unit on the page. Possible values:

  • bl - bottom-left
  • br - bottom-right
  • tl - top-left
  • tr - top-right

bl

floatVerticalOffset

integer

Vertical margin between the floating video and the edge of the page (in pixels). If the floatDirection is top-left or top-right, the margin is between the top of the page and the top of the video. And vice versa for the bottom

100

floatHorizontalOffset

integer

Horizontal margin between the floating video and the edge of the page (in pixels). If the floatDirection is top-left or bottom-left, the margin is between the left of the page and the left of the video. And vice versa for the right side

10

floatWidth

integer

Floating video width

400

floatMode

string

Set where the floating unit will appear relative to the Primis tag on the page. Possible values:

  • below
  • above
  • both - below and above
  • belowboth - same like in a "both" mode except that at the first time floating unit will not be shown above the main player and only if the user will scroll down and back and pass the main player unit, the floating will continue moving up

both

floatCloseBtn

integer

Whether the close button is shown (1) or not (0)

1

flowCloseTimeout

integer

Set up the time in minutes the floating won't appear, even after the refresh, after the user has clicked the close button

0

flowCloseButtonPosition

string

Set up the close button on the float player. Possible positions:

  • right
  • left

right

Mobile Application Parameters

Parameter

Type

Description

diaid

string

IOS IDFA or Android AID, plain

appName

string

Mobile application name

appStoreUrl

string

Mobile application page url in Apple or Google Play Store

appBundleId

string

Mobile application bundle Id

appId

string

Application Id (IOS only)

appVersion

string

Application version

appPrivacyPolicy

string

Application privacy policy

appIsPaid

integer

Application is not free

appDeveloper

string

Application developer info

Google Ads Manager Parameters

Parameter

Primis Equivalent

%%CACHEBUSTER%%

cbuster

%%REFERRER_URL_ESC%%

pubUrl

%%WIDTH%%

x

%%HEIGHT%%

y

%%ADVERTISING_IDENTIFIER_PLAIN%%

diaid


Did this page help you?