From 0caf71a85629810f2db76a374a26b49d34526ff8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Krzysztof=20Sok=C3=B3=C5=82?= Date: Mon, 30 Jun 2025 15:36:33 +0200 Subject: [PATCH] add examples --- dev-docs/bidders/equativ.md | 215 ++++++++++++++++++++++++++++++++++++ 1 file changed, 215 insertions(+) diff --git a/dev-docs/bidders/equativ.md b/dev-docs/bidders/equativ.md index c126fe867a..c6f5b27625 100644 --- a/dev-docs/bidders/equativ.md +++ b/dev-docs/bidders/equativ.md @@ -212,6 +212,39 @@ pbjs.que.push(function () { }); ``` +#### Outstream Video + +Following the setup described [here](https://docs.prebid.org/dev-docs/show-outstream-video-ads.html), this adapter supports scenarios where the publisher does not provide a custom renderer. In such cases, the configuration shown below will work, and the outstream ad will be rendered using Equativ's default player. + +```javascript +var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { + sizes: [ + [300, 250] + ] + }, + video: { + context: 'outstream', + mimes: ['video/mp4'], + placement: 3, + playerSize: [300, 250] + } + }, + bids: [ + { + bidder: 'equativ', + params: { + networkId: 42 + } + } + ] + } +]; +``` + #### Native As mentioned in the **Bid Params > Usage** section, when including `'equativ'` as one of the available bidders in an adunit setup, there are two approaches to how publishers can specify parameters. The below example uses the approach using the `params` object. @@ -348,6 +381,188 @@ pbjs.que.push(function () { {: .alert.alert-warning :} **Note**: If a demand partner of Equativ is not capable of reading an audio object, the audio object will be converted into a video object with audio mime types. There is, as of this writing, no built-in/default support for serving audio assets in Prebid, so publishers that wish to do so will need to ensure their ad server setups can process whatever hand-offs are necessary. +#### Multi-formats and multi-sizes examples + +##### Banner, Outstream Video, and Native with different floors + +```javascript +var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { + sizes: [ + [300, 250], + [300, 600] + ] + }, + video: { + context: 'outstream', + mimes: ['video/mp4'], + placement: 3, + playerSize: [300, 250] + }, + native: { + title: { + len: 80, + required: true + }, + image: { + required: true, + sizes: [300, 150] + } + } + }, + floors: { + currency: 'USD', + schema: { + fields: ['mediaType'] + }, + values: { + 'banner': 1.04, + 'video': 1.87, + 'native': 1.35 + } + }, + bids: [ + { + bidder: 'equativ', + params: { + networkId: 42 + } + } + ] + } +]; +``` + +##### Banner, Outstream Video, and Native with one floor + +```javascript +var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { + sizes: [ + [300, 250], + [300, 600] + ] + }, + video: { + context: 'outstream', + mimes: ['video/mp4'], + placement: 3, + playerSize: [300, 250] + }, + native: { + title: { + len: 80, + required: true + }, + image: { + required: true, + sizes: [300, 150] + } + } + }, + floors: { + currency: 'USD', + schema: { + fields: ['mediaType'] + }, + values: { + '*': 1.48 + } + }, + bids: [ + { + bidder: 'equativ', + params: { + networkId: 42 + } + } + ] + } +]; +``` + +##### Multiple Banner sizes with different floors + +```javascript +var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { + sizes: [ + [300, 160], + [300, 250], + [300, 600] + ] + } + }, + floors: { + currency: 'USD', + schema: { + delimiter: '|', + fields: ['mediaType', 'size'] + }, + values: { + 'banner|300x250': 1.37, + 'banner|300x600': 1.52, + 'banner|*': 1.23 + } + }, + bids: [ + { + bidder: 'equativ', + params: { + networkId: 42 + } + } + ] + } +]; +``` + +##### Multiple Banner sizes with one floor + +```javascript +var adUnits = [ + { + code: 'test-div', + mediaTypes: { + banner: { + sizes: [ + [300, 160], + [300, 250], + [300, 600] + ] + } + }, + floors: { + currency: 'USD', + schema: { + delimiter: '|', + fields: ['mediaType', 'size'] + }, + values: { + 'banner|*': 1.19 + } + }, + bids: [ + { + bidder: 'equativ', + params: { + networkId: 42 + } + } + ] + } +]; +``` + ### First Party Data Publishers should use the `ortb2` method of setting [First Party Data](https://docs.prebid.org/features/firstPartyData.html).