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 |
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:
| 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 |
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 |
Updated 6 months ago