Skip to content

optable-targeting new features: non-blocking early network call + hid + id5 - #6706

Open
justadreamer wants to merge 4 commits into
prebid:masterfrom
Optable:optable-targeting-doc
Open

optable-targeting new features: non-blocking early network call + hid + id5#6706
justadreamer wants to merge 4 commits into
prebid:masterfrom
Optable:optable-targeting-doc

Conversation

@justadreamer

Copy link
Copy Markdown
Contributor

🏷 Type of documentation

  • new feature
  • new examples

📋 Checklist

Changes

New configuration

  • Execution plan: raw-auction-request (starts a non-blocking Targeting API call), bidder-request (awaits it, enriches per bidder), auction-response. Includes a migration section for the legacy processed-auction-request hook and a note on hook timeouts.
  • Traffic controls: enrichment-percentage, bidder-enrichment-percentages, enrich-web, enrich-app. Per-bidder sampling applies to the new configuration only; the legacy hook enriches the whole request before it is split per bidder.
  • EID inserter handling: optable-inserter-eids-merge / -replace / -ignore.

New Targeting API parameters

  • Resolver hints (hid): new hid-prefixes entry, plus a section on how hid= differs from id= (id feeds the identity graph, hid is passed to external resolvers such as ID5).
  • App bundle / ver from bidRequest.app.
  • ID5 signature both directions: user.ext.optable.id5_signature in, ext.prebid.passthrough.optable.id5_signature out.
  • New table documenting all non-identifier query attributes.

Corrections

  • Account-level config example: module params belong under hooks.modules.optable-targeting, and the key is execution-plan, not host-execution-plan. As written it would not load.
  • Analytics tags: documents the new per-bidder optable-enrich-bidder-request activity and marks optable-enrich-request as legacy-only.

cc: @jrosendahl-opt, @softcoder594

Adds the hid-prefixes parameter, a Resolver Hints section explaining how hid
differs from id, and a Targeting API Query Attributes section covering bundle,
ver and id5_signature in both directions. Also adds id5_signature to the
Optable input erasure note.
@netlify

netlify Bot commented Aug 14, 2026

Copy link
Copy Markdown

Deploy Preview for prebid-docs-preview ready!

Name Link
🔨 Latest commit 04826f1
🔍 Latest deploy log https://app.netlify.com/projects/prebid-docs-preview/deploys/6a7efcb9e79c410008bbd95b
😎 Deploy Preview https://deploy-preview-6706--prebid-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant