Skip to content

add examples #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 2, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
215 changes: 215 additions & 0 deletions dev-docs/bidders/equativ.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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).
Expand Down
Loading