You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: prebid-server/endpoints/openrtb2/pbs-endpoint-video.md
+43-47Lines changed: 43 additions & 47 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,22 +27,22 @@ The process is similar to [Prebid.js client side](/prebid-video/video-long-form.
27
27
3. PBS sends a request for bids to selected demand partners by relaying OpenRTB requests to them.
28
28
4. Demand partners return a bid response to PBS. If competitive seperation is enabled, PBS peforms [category translation](/dev-docs/modules/categoryTranslation.html) on each bid. Whether category translation is required or not, the bids are stored in prebid cache.
29
29
5. PBS generates key-value pairs that are comprised of price, category, and duration values. The key is `hb_pb_cat_dur` and each component of the key name after the `hb` represents a related value.
30
-
31
-
`_pb` represents the price bucket.
32
-
`_cat` indicates the industry code that is derived from the [category translation](/dev-docs/modules/categoryTranslation.html).
33
-
`_dur` is the length of the bid response in seconds.
34
-
35
-
A PBS generated key-value of `hb_pb_cat_dur = 1200_399_30s` would indicate:
36
-
37
-
A price bucket of $12.00 (or the local currency).
38
-
The industry represented by id 399.
39
-
A duration of 30 seconds.
40
-
41
-
These key-values are returned to the SSAI server as part of the video response.
30
+
31
+
`_pb` represents the price bucket.
32
+
`_cat` indicates the industry code that is derived from the [category translation](/dev-docs/modules/categoryTranslation.html).
33
+
`_dur` is the length of the bid response in seconds.
34
+
35
+
A PBS generated key-value of `hb_pb_cat_dur = 1200_399_30s` would indicate:
36
+
37
+
A price bucket of $12.00 (or the local currency).
38
+
The industry represented by id 399.
39
+
A duration of 30 seconds.
40
+
41
+
These key-values are returned to the SSAI server as part of the video response.
42
42
43
43
6. The SSAI server parses the returned key-values, appending them as a query string to the ad server request URL and submits the request.
44
44
7. The ad server returns the optimized pod.
45
-
8. The SSAI server requests the creatives from prebid cache.
45
+
8. The SSAI server requests the creatives from prebid cache.
46
46
9. The SSAI server requests the content from the content host and stitches the creatives and content together.
47
47
10. The stitched stream is returned to the application.
48
48
@@ -119,6 +119,7 @@ The `podconfig.durationrangesec` is an array containing integers representing th
119
119
```javascript
120
120
durationrangesec = [15, 30]
121
121
```
122
+
122
123
These values would indicate that ad durations of 15 and 30 seconds were allowed with this bid.
123
124
124
125
If `podconfig.requireexactduration` is set to `false`, then the ads durations will be rounded up to the closest value in the `durationrangesec` array. Implicit minimum bid duration is 0.
@@ -140,7 +141,6 @@ These are the parameters for the `pod` subobject:
140
141
| pod.adpoddurationsec | Required |`Integer`| Duration of the adPod. |
141
142
| pod.configid | Required |`String`| ID of the stored config that corresponds to a single pod request for all included adapters. |
142
143
143
-
144
144
### Video Protocols
145
145
A streaming protocol is a standardized method for delivering multimedia (usually video or audio) over the internet. It defines a method for sending "chunks" of content from one device to another and subsequently the method for reassembling those "chunks" into playable content.
146
146
@@ -165,29 +165,28 @@ The `user.ext.prebid.buyeruids` is an optional, but recommended parameter. It is
165
165
166
166
These are the supported (registered) bidder names.
167
167
168
-
- "33across"
169
-
- "adform"
170
-
- "adkernelAdn"
171
-
- "adtelligent"
172
-
- "appnexus"
173
-
- "audienceNetwork"
174
-
- "beachfront"
175
-
- "brightroll"
176
-
- "eplanning"
177
-
- "epsilon"
178
-
- "grid"
179
-
- "gumgum"
180
-
- "ix"
181
-
- "lifestreet"
182
-
- "openx"
183
-
- "pubmatic"
184
-
- "pulsepoint"
185
-
- "rhythmone"
186
-
- "rubicon"
187
-
- "somoaudience"
188
-
- "sonobi"
189
-
- "sovrn"
190
-
- "yieldmo"
168
+
* "33across"
169
+
* "adform"
170
+
* "adkernelAdn"
171
+
* "adtelligent"
172
+
* "appnexus"
173
+
* "audienceNetwork"
174
+
* "beachfront"
175
+
* "eplanning"
176
+
* "epsilon"
177
+
* "grid"
178
+
* "gumgum"
179
+
* "ix"
180
+
* "lifestreet"
181
+
* "openx"
182
+
* "pubmatic"
183
+
* "pulsepoint"
184
+
* "rhythmone"
185
+
* "rubicon"
186
+
* "somoaudience"
187
+
* "sonobi"
188
+
* "sovrn"
189
+
* "yieldmo"
191
190
192
191
### Price Range
193
192
@@ -215,8 +214,6 @@ Publishers can enable GDPR regulations by setting `regs.ext.gdpr` to `1`. To dis
215
214
216
215
Publishers can comply with CCPA regulations by setting `regs.ext.us.privacy` to one of the accepted string formats outlined in [IAB's CCPA Framework](https://iabtechlab.com/standards/ccpa/) such as `1YNN`.
217
216
218
-
219
-
220
217
## Examples
221
218
222
219
### Post Request
@@ -289,7 +286,7 @@ Publishers can comply with CCPA regulations by setting `regs.ext.us.privacy` to
289
286
290
287
### Post Response
291
288
292
-
The POST response contains an array of `adPod` objects which represents the `adPods` in the request. Each value of the `adPod` object (`podid:1`, `podid:2`, etc) contain the key-value targeting for those bids and optionally any errors encountered.
289
+
The POST response contains an array of `adPod` objects which represents the `adPods` in the request. Each value of the `adPod` object (`podid:1`, `podid:2`, etc) contain the key-value targeting for those bids and optionally any errors encountered.
293
290
294
291
```javascript
295
292
{
@@ -349,11 +346,10 @@ The POST response contains an array of `adPod` objects which represents the `adP
349
346
## SSAI processing of the response
350
347
The SSAI should take the key-values from the response `adPods.[].targeting.[]${key}` and pass it to the primary ad server as keywords. Because `adPods` do not have specific targeting, an `adPod` can target any bid as long as the bid duration matches that of the `adPod`.
351
348
349
+
## Further Reading
352
350
353
-
## Further Reading:
354
-
355
-
-[Prebid Server overview](/prebid-server/overview/prebid-server-overview.html)
0 commit comments