The Parrable ID is a Full Device Identifier that can be used to identify a device across different browsers and webviews on a single device including browsers that have third party cookie restrictions.
Add it to your Prebid.js package with:
gulp build –modules=parrableIdSystem
Parrable ID Registration
Please contact Parrable to obtain a Parrable Partner Client ID and/or use the Parrable Partner Client ID provided by the vendor for each Parrable-aware bid adapter you will be using. Note that if you are working with multiple Parrable-aware bid adapters you may use multiple Parrable Partner Client IDs.
Parrable ID Configuration
In addition to the parameters documented above in the Basic Configuration section the following Parrable specific configuration is required:
|Param under userSync.userIds||Scope||Type||Description||Example|
|params||Required||Object||Details for the Parrable ID.|
|params.partners||Required||Array[String]||A list of one or more Parrable Partner Client IDs for the Parrable-aware bid adapters you are using. Please obtain Parrable Partner Client IDs from them and/or obtain your own.||
|params.timezoneFilter||Optional||Object||Configures a timezone or timezone offset filter|
NOTE: The Parrable ID that is delivered to Prebid is encrypted by Parrable with a time-based key and updated frequently in the browser to enforce consumer privacy requirements and thus will be different on every page view, even for the same user.
The Parrable ID system manages a cookie with the name of
_parrable_id containing the ID and optout states of the user.
This cookie is used also by standalone Parrable integrations outside of Prebid.
It is for this reason that the cookie name is not configurable for the Parrable ID system.
Timezone and Timezone Offset Filtering
The Parrable ID system enables a publisher to configure lists of allowed timezones (eg.
Europe/Dublin) and/or timezone offsets (eg.
-4) as well as a lists of blocked timezones and timezone offsets.
- With no configuration (
params.timezoneFilternot set, or all of the lists are empty) all impressions are permitted.
- With only allow lists configured a browser must match either a timezone or timezone offset for it to not be filtered.
- With only block lists configured an impression will be filtered only if it is from a browser matching a blocked timezone or timezone offset.
- An impression from a browser that matches any allowed timezone or timezone offset, but does not match a blocked timezone or timezone offset will engage in the Parrable ID syncronization process.
- If a browser has a stored Parrable ID then it will not be filtered even if the browser is in a timezone or timezone offset that is blocked.
All configured timezones should follow the
TZ database name column from the IANA tz database