# Web and TV-browser players

Source: https://docs.ezoic.com/docs/ctv/web-players/


This guide covers serving Ezoic video ads from browser-based players, on desktop and mobile web and on smart-TV browsers. This is the website lane. Identity comes from your page URL, not from an app bundle.

## Tag template

```
https://g.ezoic.net/ezoic/videoad/vast?url=<ENCODED_PAGE_URL>&adunit=<YOUR_VIDEO_AD_UNIT>&devicetype=<3 on TV browsers>&plcmt=1&v=4&w=<PLAYER_W>&h=<PLAYER_H>&startdelay=0&content_id=<ID>&content_title=<TITLE>&content_cat=<IAB_CAT>&content_len=<SECONDS>&us_privacy=<USP>&gdpr=<0|1>&consent=<TCF>&cb=<RANDOM>
```

- `url` is the full, URL-encoded page URL. It maps the request to your Ezoic property, so the page must be on a domain that is active with Ezoic.
- Send `devicetype=3` on TV-browser deployments. Leave it out on desktop and mobile web.
- The open web has no `ifa`. The browser identity applies to the request itself. If you have universal IDs such as UID2 or RampID, pass them in `eids`.
- The endpoint is CORS-enabled and answers `OPTIONS` preflights. XHR and fetch-based players, including IMA HTML5, work without a proxy.

## IMA HTML5

```javascript
const adsLoader = new google.ima.AdsLoader(adDisplayContainer);
const request = new google.ima.AdsRequest();
request.adTagUrl = buildEzoicTagUrl();
request.linearAdSlotWidth = playerWidth;
request.linearAdSlotHeight = playerHeight;
adsLoader.requestAds(request);
```

## video.js with videojs-ima

```javascript
player.ima({ adTagUrl: buildEzoicTagUrl() });
```

## JW Player

```javascript
jwplayer("player").setup({
  file: contentUrl,
  advertising: { client: "vast", tag: buildEzoicTagUrl() }
});
```

For all three, rebuild the tag URL at each ad break, with a fresh `cb` and the correct `startdelay`. Do not reuse one URL.

## Consent on the web

Most browser integrations run a consent management platform (CMP). Pass its output through:

```
gdpr=<applies>&consent=<TCF string>&us_privacy=<USP string>&gpp=<GPP>&gpp_sid=<sections>
```

If your CMP exposes macros, check that they expand. An unexpanded literal is dropped, and the consent signal is lost without an error.

## Behaviour notes

- An empty VAST document is a no-fill. IMA and JW Player raise their standard "empty response" error. Continue to content.
- If your player autoplays muted, declare it with `playbackmethod=2`. Sound-on autoplay is `1`. Click-to-play is `3`.
- Responses are never cached. Still send `cb` to defeat intermediaries.

## Go-live checklist

- [ ] `url` is a real page URL on your Ezoic-active domain, URL-encoded
- [ ] `adunit` is set to your normal video ad unit name
- [ ] `devicetype=3` on TV-browser deployments
- [ ] Real player `w` and `h`, `startdelay` sent, and a fresh URL for each break
- [ ] CMP signals are wired, and you have checked that they expand
- [ ] Content metadata is populated