The knowledgebase is a categorized collection of answers to frequently asked questions (FAQ) and articles. You can read articles in this category or select a subcategory that you are interested in.
How to integrate with the PixFuture /cookiesync endpoint for PBS adapter synchronization and optional demand-partner synchronization.
Production URL: https://sync.pixfuture.com/cookiesync
Methods: GET, HEAD (OPTIONS for CORS)
Related auction: https://pbs-pix.pixfuture.com/pixservices
Sets a first-party Pixfuture user id cookie (pixfuture_uid on .pixfuture.com) and either:
/setuid (this is what pixfuture.yaml uses), orpix_id.Used by Pixfuture PBS userSync:
userSync:
redirect:
url: "https://sync.pixfuture.com/cookiesync?gdpr={{.GDPR}}&consent={{.GDPRConsent}}&us_privacy={{.USPrivacy}}&redirect={{.RedirectURL}}&gpp={{.GPP}}&gpp_sid={{.GPPSID}}"
userMacro: "${UID}"
| Param | Description |
|---|---|
redirect (or redir) | Publisher PBS setuid URL; must contain ${UID} (or a supported UID macro) |
| Param | Description |
|---|---|
gdpr | 0 or 1 |
consent (or gdpr_consent) | TCF 2.x string (required when gdpr=1) |
us_privacy | CCPA string |
gpp, gpp_sid | GPP privacy strings |
curl -sS -D - -o /dev/null \
"https://sync.pixfuture.com/cookiesync?gdpr=0&consent=&us_privacy=&redirect=$(python3 -c 'import urllib.parse; print(urllib.parse.quote("https://pbs-dev.pixfuture.com/setuid?bidder=pixfuture&uid=${UID}"))')"
302 + Set-Cookie: pixfuture_uid=… + Location with a real UUID (no ${UID} left).
pix_id)Optional helper for matching demand partners for a publisher zone. Not the PBS adapter userSync from pixfuture.yaml.
| Param | Description |
|---|---|
pix_id (or pixid) | Publisher zone ID assigned by PixFuture |
Same privacy parameters as Mode A (gdpr, consent, us_privacy, gpp, gpp_sid).
curl -sS -D - \
"https://sync.pixfuture.com/cookiesync?pix_id=62623&gdpr=0" | head
200 text/html titled “Partner Cookie Sync”, with partner iframes/images.
| Condition | Result |
|---|---|
gdpr=1 and missing/invalid consent | 400 / 403 — no cookie, no redirect |
gdpr=1 and TCF lacks Purpose 1 or Vendor 839 | 403 |
gdpr=0 or gdpr omitted | GDPR check skipped |
us_privacy=1YYN | 403 CCPA opt-out |
Consent query aliases: consent, gdpr_consent (partner mode also accepts adsync).
Pixfuture IAB GVL vendor ID: 839.
| Attribute | Value |
|---|---|
| Name | pixfuture_uid |
| Domain | .pixfuture.com |
| Path | / |
| Flags | HttpOnly, Secure, SameSite=None |
| Lifetime | 1 year |
If the browser already has a valid UUID cookie, it is reused; otherwise a new UUID is created.
| Code | Meaning |
|---|---|
302 | Adapter redirect sync OK |
200 | Partner sync HTML OK |
204 | CORS preflight (OPTIONS) |
400 | Missing redirect/pix_id, bad URL, or missing GDPR consent when gdpr=1 |
403 | TCF / CCPA blocked |
405 | Method not GET/HEAD |
5xx | Temporary service error (partner sync) |
curl -sS -o /dev/null -D - \
"https://sync.pixfuture.com/cookiesync?gdpr=0&redirect=https%3A%2F%2Fpbs-dev.pixfuture.com%2Fsetuid%3Fbidder%3Dpixfuture%26uid%3D%24%7BUID%7D"
curl -sS "https://sync.pixfuture.com/cookiesync?gdpr=0"
curl -sS "https://sync.pixfuture.com/cookiesync?pix_id=62623&gdpr=0" | head -c 200
After synchronization, the publisher's PBS can associate the PixFuture user ID using
/setuid. During subsequent auctions sent to
https://pbs-pix.pixfuture.com/pixservices, this mapping can be used for buyer identification
through OpenRTB fields such as user.buyeruid or
user.ext.prebid.buyeruids, when applicable.
userSync.https://sync.pixfuture.com/cookiesync.userSync config.
Article ID: 83
Category: Publishers