Document GPT diagnostics attribution and correlation evidence - #1025
Open
prk-Jr wants to merge 1 commit into
Open
Document GPT diagnostics attribution and correlation evidence#1025prk-Jr wants to merge 1 commit into
prk-Jr wants to merge 1 commit into
Conversation
Complete the public guide against the behavior merged in #997. Cover the per-auction hb_auction_id correlation token and the targeting boundary that keeps it out of the ad request, badge delivery labels, creative-bridge failure triggers, Ad Manager identifier normalization, and the adInit refresh context. Add troubleshooting for unattributed and competing refreshes, unconfirmed candidate delivery, and missing correlation evidence. Link the guide from the GPT integration page, use the exact ts_console=1 activation example, and drop the integrations overview claim that diagnostics make no attribution claims.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
hb_auction_idcorrelation token published intowindow.tsjs.bids, and the targeting boundary that keeps it out of the GAM ad request.Changes
docs/guide/integrations/gpt-diagnostics.mdadInitrefresh scoped context alongside Prebid's; three new troubleshooting entries for unattributed/competing refreshes,candidate_unconfirmeddelivery, and missing correlation evidence (all eight attribution reasons); exact?ts_console=1activation and?ts_console=0deactivation examplesdocs/guide/integrations/gpt.mddocs/guide/integrations-overview.mdCloses
Closes #1014
Test plan
cd docs && npm run formatcd docs && npm run lintcd docs && npm run build(VitePress build succeeds;#auction-correlation-tokenanchor and sidebar/integration links resolve in the built output)cargo fmt --all -- --checkcd crates/trusted-server-js/lib && npm run formatcargo test-fastly && cargo test-axum— not run: no Rust source changedcargo clippy-fastly && cargo clippy-axum— not run: no Rust source changedcd crates/trusted-server-js/lib && npx vitest run— not run: no JS source changedcrates/trusted-server-js/lib/src/core/types.tsand.../gpt_diagnostics/store.ts; token minting and gating againstcrates/trusted-server-core/src/publisher.rs; targeting keys againstcrates/trusted-server-js/lib/src/integrations/gpt/index.ts; badge labels against.../gpt_diagnostics/badges.ts; identifier caps against.../gpt_diagnostics/observer.tsChecklist
unwrap()in production code — useexpect("should ...")(documentation only; no code changed)tracingmacros (notprintln!) (documentation only; no code changed)publisher.example.comand a fictional token value