Skip to content
Open
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
15 changes: 10 additions & 5 deletions dev-docs/modules/51DegreesRtdProvider.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,15 @@ The Cloud API is **free** to integrate and use. To increase limits please check

51Degrees module enriches an OpenRTB request with [51Degrees Device Data](https://51degrees.com/documentation/index.html).

51Degrees module sets the following fields of the device object: `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio` - interested bidder adapters may use these fields as needed. In addition the module sets `device.ext.fiftyonedegrees_deviceId` to a permanent device ID which can be rapidly looked up in on premise data exposing over 250 properties including the device age, chip set, codec support, and price, operating system and app/browser versions, age, and embedded features.
51Degrees module sets the following fields of the device object: `devicetype`, `make`, `model`, `os`, `osv`, `h`, `w`, `ppi`, `pxratio`. Interested bidder adapters may use these fields as needed.

The module also adds a `device.ext.fod` extension object (fod == fifty one degrees) and sets `device.ext.fod.deviceId` to a permanent device ID, which can be rapidly looked up in on-premise data, exposing over 250 properties, including device age, chipset, codec support, price, operating system and app/browser versions, age, and embedded features.

It also sets `device.ext.fod.tpc` key to a binary value to indicate whether third-party cookies are enabled in the browser (1 if enabled, 0 if disabled).

The module supports on premise and cloud device detection services with free options for both.

A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation). This is the simplest approach to trial the module.
A free resource key for use with 51Degrees cloud service can be obtained from [51Degrees cloud configuration](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation). This is the simplest approach to trial the module.

An interface compatible self hosted service can be used with .NET, Java, Node, PHP, and Python. See [51Degrees examples](https://51degrees.com/documentation/_examples__device_detection__getting_started__web__on_premise.html).

Expand All @@ -53,14 +57,14 @@ gulp build --modules="rtdModule,51DegreesRtdProvider,appnexusBidAdapter,..."

#### Resource Key

In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:
In order to use the module please first obtain a Resource Key using the [Configurator tool](https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation) - choose the following properties:

* DeviceId
* DeviceType
* HardwareVendor
* HardwareName
* HardwareModel
* PlatformName
* PlatformName
* PlatformVersion
* ScreenPixelsHeight
* ScreenPixelsWidth
Expand All @@ -69,6 +73,7 @@ In order to use the module please first obtain a Resource Key using the [Configu
* ScreenInchesHeight
* ScreenInchesWidth
* PixelRatio
* ThirdPartyCookiesEnabled

The Cloud API is **free** to integrate and use. To increase limits please check [51Degrees pricing](https://51degrees.com/pricing).

Expand Down Expand Up @@ -123,7 +128,7 @@ pbjs.setConfig({
waitForIt: true, // should be true, otherwise the auctionDelay will be ignored
params: {
resourceKey: '<YOUR_RESOURCE_KEY>',
// Get your resource key from https://configure.51degrees.com/HNZ75HT1?utm_source=Prebid&utm_medium=Documentation
// Get your resource key from https://configure.51degrees.com/7bL8jDGz?utm_source=Prebid&utm_medium=Documentation
// alternatively, you can use the on-premise version of the 51Degrees service and connect to your chosen end point
// onPremiseJSUrl: 'https://localhost/51Degrees.core.js'
},
Expand Down