[jrosendahl-opt]

Why

An audit of the README against the code found broken examples, descriptions that no longer match behaviour, references to functions that don't exist, and public features with no documentation.

What Changed

Examples that broke or misbehaved as written

• OptableSDK.cid("id2", "c2") threw (variant must be 0–19); now cid("id2", 2).
• Targeting examples read an undefined targeting variable; now use response and log objects instead of printing [object Object].
• TargetingRequest type corrected to { ids, hids }, with a hashed-email example.
• Error handlers used "${err.message}" in double quotes, so the message was never interpolated.
• ctxSegments().then(loadGAM) passed the raw response to GAM; now passes ctxTargetingKeyValues().
• GAM Secure Signals: { provider, id } objects passed as separate arguments (was value, in one array).
• Prebid analytics: removed the ignored tenant option (tenant comes from node); import path now lib/dist/addons/....
• Multi-node resolver input/return types match the code.

Descriptions corrected

• Bot detection: removed TargetingResolvedThisSession() / MarkTargetingResolved() (they don't exist) and the claim that SkipTargetingForBots() short-circuits RTD; added a working alternative.
• Multi-node resolver priority rules, including that user.data is merged from every rule.
• Contextual pageview timing, context-once-per-instance, ctxSegments() caching on failure, elided example outputs.
• readOnly, deprecated prebidORTB2(), analytics hooks, GPT listener re-calls, identifyAndTokenize edge cases, PAIR storage, OIS change-event detail, source-check timeout, demo host and prerequisites.

Newly documented

• InitConfig: pageContext keys, consent, timeout, sessionID, skipEnrichment, additionalTargetingSignals, abTests, legacyHostCache, mockedIP, insecure.
• npm imports needed for the GPT and tryIdentifyFromParams addons.
• UID2 refresh, setupAB, traffic source, GAM signal-enrichment key-value, persistFlagsFromURL, and an "Other SDK methods" table.
• Table of contents regenerated from the headings (fixes nesting, adds missing sections).

Addon docs

• abTestAssignment.md, prebid/README.md, prebid/analytics.md: import paths now lib/dist/addons/....
• botDetection.md: same RTD correction as the README.
• prebid/analytics.md: initPrebidAnalytics takes your SDK instance; samplingRateFn only applies when samplingRate is between 0 and 1.

[jplaroche]

LGTM