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

Snowflake ID is now Hyper ID and document new SharedID changes #3542

Merged
merged 9 commits into from
Feb 2, 2022
100 changes: 93 additions & 7 deletions dev-docs/modules/userId.md
Original file line number Diff line number Diff line change
Expand Up @@ -1320,11 +1320,13 @@ pbjs.setConfig({
});
{% endhighlight %}

### Novatiq Snowflake ID
# Novatiq Hyper ID

Novatiq proprietary dynamic snowflake ID is a unique, non sequential and single use identifier for marketing activation. Our in network solution matches verification requests to telco network IDs, safely and securely inside telecom infrastructure. Novatiq snowflake ID can be used for identity validation and as a secured 1st party data delivery mechanism.
The Novatiq proprietary dynamic Hyper ID is a unique, non sequential and single use identifier for marketing activation. Our in network solution matches verification requests to telco network IDs safely and securely inside telecom infrastructure. The Novatiq Hyper ID can be used for identity validation and as a secured 1st party data delivery mechanism.

#### Novatiq Snowflake ID Configuration
 

## Novatiq Hyper ID Configuration

Enable by adding the Novatiq submodule to your Prebid.js package with:

Expand All @@ -1340,21 +1342,105 @@ pbjs.setConfig({
userIds: [{
name: 'novatiq',
params: {
sourceid '1a3', // change to the Partner Number you received from Novatiq
// change to the Partner Number you received from Novatiq
sourceid '1a3'
}
}
}],
auctionDelay: 50 // 50ms maximum auction delay, applies to all userId modules
// 50ms maximum auction delay, applies to all userId modules
auctionDelay: 50
}
});
```
```
 

| Param under userSync.userIds[] | Scope | Type | Description | Example |
### Parameters for the Novatiq Module
| Param | Scope | Type | Description | Example |
| --- | --- | --- | --- | --- |
| name | Required | String | Module identification: `"novatiq"` | `"novatiq"` |
| params | Required | Object | Configuration specifications for the Novatiq module. | |
| params.sourceid | Required | String | This is the Novatiq Partner Number obtained via Novatiq registration. | `1a3` |

 

# Novatiq Hyper ID with Prebid SharedID support
You can make use of the Prebid.js SharedId module as follows.

 

## Novatiq Hyper ID Configuration

Enable by adding the Novatiq and SharedId submodule to your Prebid.js package with:

```
gulp build --modules=novatiqIdSystem,userId,pubCommonId
```

Module activation and configuration:

```javascript
pbjs.setConfig({
userSync: {
userIds: [
{
name: "pubCommonId",
storage: {
type: "cookie",
// optional: will default to _pubcid if left blank
name: "demo_pubcid",

// expires in 1 years
expires: 365
},
bidders: [ 'adtarget' ]
},
{
name: 'novatiq',
params: {
// change to the Partner Number you received from Novatiq
sourceid '1a3',

// Use the sharedID module
useSharedId: true,

// optional: will default to _pubcid if left blank.
// If not left blank must match "name" in the the module above
sharedIdName: 'demo_pubcid'
}
}
}],
// 50ms maximum auction delay, applies to all userId modules
auctionDelay: 50
}
});
```

 

### Parameters for the Novatiq Module
| Param | Scope | Type | Description | Example |
| --- | --- | --- | --- | --- |
| name | Required | String | Module identification: `"novatiq"` | `"novatiq"` |
| params | Required | Object | Configuration specifications for the Novatiq module. | |
| params.sourceid | Required | String | The Novatiq Partner Number obtained via Novatiq | `1a3` |
| params.useSharedId | Optional | Boolean | Use the sharedID module if it's activated. | `true` |
| params.sharedIdName | Optional | String | Same as the SharedID "name" parameter <br /> Defaults to "_pubcid" | `"demo_pubcid"` |

&nbsp;

### Parameters for the SharedID Module
| Param | Scope | Type | Description | Example |
| --- | --- | --- | --- | --- |
| name | Required | String | Module identification: `"pubCommonId"` | `"pubCommonId"` |
| params | Required | Object | Configuration specifications for the SharedID module. | | |
| params.storage | Required | Object | | |
| params.storage.type | Required | String | Storage type, Set to `"cookie"` | `"cookie"` |
| params.storage.name | Optional | String | Storage cookie name. If this is changed must match sharedIdName <br /> in the Novatiq module | `"demo_pubcid"` ||
| params.storage.expires | Required | integer | Time to expire | `365` |


&nbsp;

If you have any questions, please reach out to us at prebid@novatiq.com.

### Parrable ID
Expand Down
2 changes: 1 addition & 1 deletion download.md
Original file line number Diff line number Diff line change
Expand Up @@ -309,7 +309,7 @@ These modules may require accounts with a service provider.<br/>
<label><input type="checkbox" moduleCode="nextrollIdSystem" class="bidder-check-box"> NextRoll ID</label>
</div></div>
<div class="col-md-4"><div class="checkbox">
<label><input type="checkbox" moduleCode="novatiqIdSystem" class="bidder-check-box"> Novatiq Snowflake ID</label>
<label><input type="checkbox" moduleCode="novatiqIdSystem" class="bidder-check-box"> Novatiq Hyper ID</label>
</div></div>
<div class="col-md-4"><div class="checkbox">
<label><input type="checkbox" moduleCode="parrableIdSystem" class="bidder-check-box"> Parrable ID</label>
Expand Down