Skip to content

Commit

Permalink
New User ID submodule: Rewarded Interest (prebid#5660)
Browse files Browse the repository at this point in the history
* UserID submodule: rewardedInterestIdSystem

* rewardedInterest: wording update

* UserID submodule: rewardedInterestIdSystem - fixed styles

---------

Co-authored-by: Konstantin Mikhalyov <konstantin.mikhalyov@postindustria.com>
Co-authored-by: Eugene Dorfman <eugene.dorfman@gmail.com>
  • Loading branch information
3 people authored Nov 22, 2024
1 parent 7e79420 commit 84c630e
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 1 deletion.
3 changes: 2 additions & 1 deletion dev-docs/modules/userId.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ The table below has the options that are common across ID systems. See the secti
{: .table .table-bordered .table-striped }
| Param under userSync.userIds[] | Scope | Type | Description | Example |
| --- | --- | --- | --- | --- |
| name | Required | String | May be any of the following values: {% for page in userid_pages -%}{% if count == 1 %}{{ name_string │ append: ", " -}}{% endif %}{% assign count = 1 %}`"{{ name_string │ append: name_string -}}{{ name_string │ append: page.useridmodule -}}"`{% endfor %} | `"unifiedId"` |
| name | Required | String | May be any of the following values: {% for page in userid_pages -%}`"{{ page.useridmodule -}}"`{% if forloop.last == false -%}, {% endif -%}{% endfor -%} | `"unifiedId"` |
| params | Based on User ID sub-module | Object | | |
| bidders | Optional | Array of Strings | An array of bidder codes to which this user ID may be sent. | `['bidderA', 'bidderB']` |
| storage | Optional | Object | The publisher can specify some kind of local storage in which to store the results of the call to get the user ID. This can be a cookie, HTML5 storage or both.| |
Expand Down Expand Up @@ -252,6 +252,7 @@ Bidders that want to support the User ID module in Prebid.js need to update thei
| Publisher Link ID | n/a | publinkId | epsilon.com | |
| PubProvided ID | n/a | pubProvidedId | publisher domain | "1111" |
| Quantcast ID | n/a | quantcastId | quantcast.com | "1111" |
| Rewarded Interest ID | Rewarded Interest | rewardedInterestId | rewardedinterest.com | "1111" |
| Tapad ID | Tapad | tapadId | tapad.com | "1111" |
| Teads ID | Teads | teadsId | teads.com | "1111" |
| SharedID (PBJS 5.x) | n/a | pubcid | pubcid.org | "1111" |
Expand Down
36 changes: 36 additions & 0 deletions dev-docs/modules/userid-submodules/rewardedInterest.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
layout: userid
title: Rewarded Interest ID
description: Rewarded Interest User ID Submodule
useridmodule: rewardedInterestIdSystem
---

[Rewarded Interest](https://www.rewardedinterest.com/) is an identity provider that enables users to monetize and manage the exposure of their identity to various ad providers through the Rewarded Interest browser extension.

This submodule passes the Rewarded Interest Identity Token, obtained from the browser extension, into the oRTB request. The Identity Token is included only if the browser has the Rewarded Interest extension installed, and the user has authorized it to share the token.

The Rewarded Interest Identity Token itself does not reveal the user's identity, as it is encrypted and refreshed frequently. Rewarded Interest partners (such as DSPs, SSPs, and publishers) can use the Rewarded Interest Identity Resolution API to resolve the Identity Token into a CMAID (Consumer Mediated Advertising Identifier). The CMAID is a durable, cross-site, cross-device advertising identifier that remains consistent across visits and devices enrolled by a Rewarded Interest user, unless they choose to reset or pause it.

Add this submodule to your Prebid.js wrapper with:

{: .alert.alert-info :}
gulp build --modules=userId,rewardedInterestIdSystem

## Rewarded Interest ID Configuration

{: .table .table-bordered .table-striped }
| Param under usersync.userIds[] | Scope | Type | Description | Example |
|--------------------------------|----------|--------|--------------------------|------------------------|
| name | Required | String | The name of this module. | `"rewardedInterestId"` |

## Rewarded Interest ID Example

```javascript
pbjs.setConfig({
userSync: {
userIds: [{
name: "rewardedInterestId"
}]
}
})
```

0 comments on commit 84c630e

Please sign in to comment.