Skip to content
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

Backmerge prebid.gihub.io:master to fork master #1

Merged
merged 4 commits into from
Sep 30, 2024
Merged
Show file tree
Hide file tree
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
3 changes: 1 addition & 2 deletions dev-docs/adunit-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ See [Prebid Native Implementation](/prebid/native-implementation.html) for detai
{: .table .table-bordered .table-striped }
| Name | Scope | Type | Description |
|------------------+-------------+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `pos` | Optional | Integer | OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
| `pos` | Optional | Integer | Ad position on screen, see [OpenRTB 2.5 spec][openRTB]. OpenRTB page position value: 0=unknown, 1=above-the-fold, 3=below-the-fold, 4=header, 5=footer, 6=sidebar, 7=full-screen |
| `context` | Recommended | String | The video context, either `'instream'`, `'outstream'`, or `'adpod'` (for long-form videos). Example: `context: 'outstream'`. Defaults to 'instream'. |
| `useCacheKey` | Optional | Boolean | Defaults to `false`. While context `'instream'` always will return an vastUrl in bidResponse, `'outstream'` will not. Setting this `true` will use cache url defined in global options also for outstream responses. |
| `placement` | Recommended | Integer | 1=in-stream, 2=in-banner, 3=in-article, 4=in-feed, 5=interstitial/floating. **Highly recommended** because some bidders require more than context=outstream. |
Expand All @@ -123,7 +123,6 @@ See [Prebid Native Implementation](/prebid/native-implementation.html) for detai
| `minbitrate` | Optional | Integer | Minimum bit rate in Kbps., see [OpenRTB 2.5 spec][openRTB]. |
| `maxbitrate` | Optional | Integer | Maximum bit rate in Kbps., see [OpenRTB 2.5 spec][openRTB]. |
| `delivery` | Optional | Array[Integer] | Supported delivery methods (e.g., streaming, progressive), see [OpenRTB 2.5 spec][openRTB]. |
| `pos` | Optional | Integer | Ad position on screen, see [OpenRTB 2.5 spec][openRTB]. |
| `playbackend` | Optional | Integer | The event that causes playback to end, see [OpenRTB 2.5 spec][openRTB]. |

If `'video.context'` is set to `'adpod'` then the following parameters are also available.
Expand Down
5 changes: 4 additions & 1 deletion dev-docs/bidders/yandex.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,10 @@ privacy_sandbox: topics
This Adapter integrates with Yandex's ad services.

{: .alert.alert-info :}
Note: For detailed auction analytics, check out our [Analytics Adapter](https://docs.prebid.org/dev-docs/analytics/yandex.html).
For detailed auction analytics, check out our [Analytics Adapter](/dev-docs/analytics/yandex.html).

{: .alert.alert-info :}
To improve the personalization of ads for publishers’ users, check out our [User ID Module](/dev-docs/modules/userid-submodules/yandex.html).

#### Client Bid Params

Expand Down
17 changes: 16 additions & 1 deletion prebid-mobile/pbm-api/android/pbm-targeting-params-android.md
Original file line number Diff line number Diff line change
Expand Up @@ -584,7 +584,22 @@ Example:
PrebidMobile.storeExternalUserId(externalUserIdArray);
```

---
### IDs that Require Additional SDKs

Certain identity vendors require an external dependency to generate user identity and then to pass it via Prebid SDK. Please note that these are references to a 3rd party code and Prebid has not inspected it. Links to the documentations of those references will be listed in this section.

#### Unified ID 2.0 (UID2)

UID2 provides a [native library](https://unifiedid.com/docs/guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) for automatically updating latest UID2
token stored inside [UID2 SDK for Android](https://unifiedid.com/docs/sdks/sdk-ref-android) into Prebid's external user's ID list.

App developers are not required to manually call ```PrebidMobile.setExternalUserId``` method as the native library will do so automatically.

Note:

- [Github repo](https://github.com/IABTechLab/uid2-android-sdk)
- [UID2 Android Integration Documentation](https://unifiedid.com/docs/guides/integration-mobile-overview)
- [UID2+Prebid Integration Instruction](https://unifiedid.com/docs/guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration)

## Targeting Class Methods

Expand Down
18 changes: 17 additions & 1 deletion prebid-mobile/pbm-api/ios/pbm-targeting-ios.md
Original file line number Diff line number Diff line change
Expand Up @@ -456,7 +456,23 @@ Targeting.shared.removeStoredExternalUserId("sharedid.org")
Targeting.shared.removeStoredExternalUserIds()
```

---
### IDs that Require Additional SDKs

Certain identity vendors require an external dependency to generate user identity and then to pass it via Prebid SDK. Please note that these are references to a 3rd party code and Prebid has not inspected it. Links to the documentations of those references will be listed in this section.

#### Unified ID 2.0 (UID2)

UID2 provides a [native library](https://unifiedid.com/docs/guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration) for automatically updating latest UID2
token stored inside [UID2 SDK for iOS](https://unifiedid.com/docs/sdks/sdk-ref-ios) into Prebid's external user's ID list.

App developers are not required to manually call ```Prebid.shared.externalUserIdArray = latestExternalUserIdArray```
as the native library will do so automatically

Note:

- [Github repo](https://github.com/IABTechLab/uid2-ios-sdk)
- [UID2 iOS Integration Documentation](https://unifiedid.com/docs/guides/integration-mobile-overview)
- [UID2+Prebid Integration Instruction](https://unifiedid.com/docs/guides/integration-mobile-client-side#optional-uid2-prebid-mobile-sdk-integration)

## Targeting Class Properties and Methods

Expand Down
3 changes: 2 additions & 1 deletion prebid-server/features/pbs-floors.md
Original file line number Diff line number Diff line change
Expand Up @@ -225,7 +225,8 @@ supported only in Prebid Server, not in Prebid.js.
| size | string | "300x250" | {::nomarkdown}<ul><li>if ORTB imp.banner exists and only one size exists in imp.banner.format, then the rule value is matched against imp.banner.format[0].w and imp.banner.format[0].h</li><li>else if ORTB imp.banner exists and there's no imp.banner.format, then match the rule value against imp.banner.w and imp.banner.h</li><li>else if ORTB imp.video exists, match the rule value against imp.video.w and imp.video.h</li><li>Otherwise the size rule value only matches the "*" condition</li></ul>{:/} |
| gptSlot | string | "/111/homepage" | if imp.ext.data.adserver.name=="gam" then compare the rule value against imp.ext.data.adserver.adslot. Otherwise compare the rule value against imp.ext.data.pbadslot |
| bidder | string | "bidderA" | Compare the rule value against imp.ext.prebid.bidder.BIDDER (Requires PBS-Java 3.5+) |
| **pbAdSlot** | string | "/111/homepage#div1" | Compare the rule value against imp.ext.data.pbadslot |
| **adUnitCode** | string | "/111/homepage" | (PBS-Java 1.101+) Compares the rule value against ORTB fields in this order: {::nomarkdown}<ul><li>imp.ext.gpid</li><li>imp.tagid</li><li>imp.ext.data.pbadslot</li><li>imp.ext.prebid.storedrequest.id</li></ul>{:/} |
| **pbAdSlot** | string | "/111/homepage#div1" | Deprecated - we suggest using adUnitCode instead. Compare the rule value against imp.ext.data.pbadslot |
| **country** | string | "USA" | Compare the rule value against device.geo.country (ISO-3166-1-alpha-3) |
| **deviceType** | string | "desktop", "phone", "tablet" | This is a very simple device-type algorithm: {::nomarkdown}<ul><li>if ORTB device.ua is not present, only rules specifying a wildcard deviceType will match. In other words, there's no default value unless device.ua exists.</li><li>otherwise, match a rule value of "phone" if UA matches one of these patterns: "Phone", "iPhone", "Android.*Mobile", "Mobile.*Android"</li><li>otherwise, match a rule value of "tablet" if UA matches one of these: "tablet", "iPad", "Windows NT.*touch", "touch.*Windows NT", "Android"</li><li>otherwise assume the rule value "desktop" matches all other user agent strings.</li></ul>{:/} |

Expand Down