Prebid Server | Endpoints | /setuid

This endpoint is used during cookie syncs to save the results in the Prebid Server uids cookie. For technical details, see the Cookie Sync developer docs.

GET /setuid

This endpoint saves a UserID for a Bidder in the Cookie. Saved IDs will be recognized for 7 days before being considered “stale” and being re-synced.

Query Params

  • bidder: The FamilyName of the Usersyncer (../../usersync/usersync.go) which is being synced.
  • uid: The ID which the Bidder uses to recognize this user. If undefined, the UID for bidder will be deleted.
  • gdpr: This should be 1 if GDPR is in effect, 0 if not, and undefined if the caller isn’t sure
  • gdpr_consent: This is required if gdpr is one, and optional (but encouraged) otherwise. If present, it should be an unpadded base64-URL encoded Vendor Consent String.

If the gdpr and gdpr_consent params are included, this endpoint will not write a cookie unless:

  1. The Vendor ID set by the Prebid Server host company has permission to save cookies for that user.
  2. The Prebid Server host company did not configure it to run with GDPR support.

If in doubt, contact the company hosting Prebid Server and ask if they’re GDPR-ready.

Sample request