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	Multiple video contents or single 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