Integrate with ConnectID: Prebid Method
Add support for Yahoo ConnectID to your Prebid.js package using:
gulp build –modules=userId,connectIdSystem
Yahoo ConnectID Registration
A Yahoo supplied publisher specific pixel ID is required. Reach out to connectid.support@yahooinc.com for assistance with setup.
Yahoo ConnectID Configuration
Note: Parameters are case-sensitive. ConnectID is the proper name of our product, however, when used in code it is spelled as connectId. Follow the example in the table below.
|
Param under userSync.userIds[] |
Scope |
Type |
Description |
Example |
|
name |
Required |
String |
The name of this module |
"connectId" |
|
params |
Required |
Object |
Container of all module params |
|
|
params.pixelId |
Required |
String |
The Yahoo supplied publisher specific pixel ID |
"0000" |
|
params.he |
Required |
String |
The SHA-256 hashed user email address |
"ed8ddbf5a171981db8ef938596ca297d5e3f84bcc280041c5880dba3baf9c1d4" |
|
storage |
Required |
Object |
Defines where and for how long the results of the call to get a user ID will be stored |
|
|
storage.type |
Required |
String |
Defines where the resolved user ID will be stored (either 'cookie' or 'html5' local storage) |
"html5" |
|
storage.name |
Required |
String |
The name of the 'cookie' or 'html5' local storage where the resolved user ID will be stored |
"connectId" |
|
storage.expires |
Recommended |
Integer |
How long (in days) the user ID information will be stored. |
1 |
Yahoo ConnectID Example
pbjs.setConfig({
userSync: {
userIds: [{
name: "connectId",
params: {
pixelId: "0000",
he: "ed8ddbf5a171981db8ef938596ca297d5e3f84bcc280041c5880dba3baf9c1d4"
},
storage: {
type: "html5",
name: "connectId",
expires: 1
}
}]
}
})
To learn more about ConnectID using the Prebid method go to Prebid.org.
Honoring Privacy Choices
Yahoo ConnectID provides multiple mechanisms for users to manage their privacy choices. Users can manage their choices via ConnectID Control Portal, on the Yahoo Privacy Dashboard and NAI’s Audience Matched Opt Out page. No further actions are required by Publishers as Yahoo will ensure that privacy choices selected by users via one of these methods are honored. We will automatically stop generating ConnectIDs for users who have opted-out.
When desired, additional privacy control can be provided to your users. Within your privacy policy or website privacy settings, Create an Easy Opt-in Opt-out Toggle for ConnectID.
Finally, ConnectID follows all global privacy laws (such as the CCPA) and industry frameworks (such as NAI, DAA and IAB). Yahoo will auto-detect most privacy signals present on the page (including those set by prebid libraries) and not generate a ConnectID for users that have opted-out.
